X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e5e10e234e2325fa6e25b23098470c5015e07a01..1b7751aaa9a86d76a850b9267bc0c201e3cea30f:/interface/wx/treectrl.h diff --git a/interface/wx/treectrl.h b/interface/wx/treectrl.h index 8327401803..58ce8ade7d 100644 --- a/interface/wx/treectrl.h +++ b/interface/wx/treectrl.h @@ -73,73 +73,73 @@ Begin dragging with the left mouse button. If you want to enable left-dragging you need to intercept this event and explicitly call wxTreeEvent::Allow(), as it's vetoed by default. - Processes a @c wxEVT_COMMAND_TREE_BEGIN_DRAG event type. + Processes a @c wxEVT_TREE_BEGIN_DRAG event type. @event{EVT_TREE_BEGIN_RDRAG(id, func)} Begin dragging with the right mouse button. If you want to enable right-dragging you need to intercept this event and explicitly call wxTreeEvent::Allow(), as it's vetoed by default. - Processes a @c wxEVT_COMMAND_TREE_BEGIN_RDRAG event type. + Processes a @c wxEVT_TREE_BEGIN_RDRAG event type. @event{EVT_TREE_END_DRAG(id, func)} End dragging with the left or right mouse button. - Processes a @c wxEVT_COMMAND_TREE_END_DRAG event type. + Processes a @c wxEVT_TREE_END_DRAG event type. @event{EVT_TREE_BEGIN_LABEL_EDIT(id, func)} Begin editing a label. This can be prevented by calling Veto(). - Processes a @c wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT event type. + Processes a @c wxEVT_TREE_BEGIN_LABEL_EDIT event type. @event{EVT_TREE_END_LABEL_EDIT(id, func)} Finish editing a label. This can be prevented by calling Veto(). - Processes a @c wxEVT_COMMAND_TREE_END_LABEL_EDIT event type. + Processes a @c wxEVT_TREE_END_LABEL_EDIT event type. @event{EVT_TREE_DELETE_ITEM(id, func)} An item was deleted. - Processes a @c wxEVT_COMMAND_TREE_DELETE_ITEM event type. + Processes a @c wxEVT_TREE_DELETE_ITEM event type. @event{EVT_TREE_GET_INFO(id, func)} Request information from the application. - Processes a @c wxEVT_COMMAND_TREE_GET_INFO event type. + Processes a @c wxEVT_TREE_GET_INFO event type. @event{EVT_TREE_SET_INFO(id, func)} Information is being supplied. - Processes a @c wxEVT_COMMAND_TREE_SET_INFO event type. + Processes a @c wxEVT_TREE_SET_INFO event type. @event{EVT_TREE_ITEM_ACTIVATED(id, func)} The item has been activated, i.e. chosen by double clicking it with mouse or from keyboard. - Processes a @c wxEVT_COMMAND_TREE_ITEM_ACTIVATED event type. + Processes a @c wxEVT_TREE_ITEM_ACTIVATED event type. @event{EVT_TREE_ITEM_COLLAPSED(id, func)} The item has been collapsed. - Processes a @c wxEVT_COMMAND_TREE_ITEM_COLLAPSED event type. + Processes a @c wxEVT_TREE_ITEM_COLLAPSED event type. @event{EVT_TREE_ITEM_COLLAPSING(id, func)} The item is being collapsed. This can be prevented by calling Veto(). - Processes a @c wxEVT_COMMAND_TREE_ITEM_COLLAPSING event type. + Processes a @c wxEVT_TREE_ITEM_COLLAPSING event type. @event{EVT_TREE_ITEM_EXPANDED(id, func)} The item has been expanded. - Processes a @c wxEVT_COMMAND_TREE_ITEM_EXPANDED event type. + Processes a @c wxEVT_TREE_ITEM_EXPANDED event type. @event{EVT_TREE_ITEM_EXPANDING(id, func)} The item is being expanded. This can be prevented by calling Veto(). - Processes a @c wxEVT_COMMAND_TREE_ITEM_EXPANDING event type. + Processes a @c wxEVT_TREE_ITEM_EXPANDING event type. @event{EVT_TREE_ITEM_RIGHT_CLICK(id, func)} The user has clicked the item with the right mouse button. - Processes a @c wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK event type. + Processes a @c wxEVT_TREE_ITEM_RIGHT_CLICK event type. @event{EVT_TREE_ITEM_MIDDLE_CLICK(id, func)} The user has clicked the item with the middle mouse button. This is only supported by the generic control. - Processes a @c wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK event type. + Processes a @c wxEVT_TREE_ITEM_MIDDLE_CLICK event type. @event{EVT_TREE_SEL_CHANGED(id, func)} Selection has changed. - Processes a @c wxEVT_COMMAND_TREE_SEL_CHANGED event type. + Processes a @c wxEVT_TREE_SEL_CHANGED event type. @event{EVT_TREE_SEL_CHANGING(id, func)} Selection is changing. This can be prevented by calling Veto(). - Processes a @c wxEVT_COMMAND_TREE_SEL_CHANGING event type. + Processes a @c wxEVT_TREE_SEL_CHANGING event type. @event{EVT_TREE_KEY_DOWN(id, func)} A key has been pressed. - Processes a @c wxEVT_COMMAND_TREE_KEY_DOWN event type. + Processes a @c wxEVT_TREE_KEY_DOWN event type. @event{EVT_TREE_ITEM_GETTOOLTIP(id, func)} The opportunity to set the item tooltip is being given to the application (call wxTreeEvent::SetToolTip). Windows only. - Processes a @c wxEVT_COMMAND_TREE_ITEM_GETTOOLTIP event type. + Processes a @c wxEVT_TREE_ITEM_GETTOOLTIP event type. @event{EVT_TREE_ITEM_MENU(id, func)} The context menu for the selected item has been requested, either by a right click or by using the menu key. - Processes a @c wxEVT_COMMAND_TREE_ITEM_MENU event type. + Processes a @c wxEVT_TREE_ITEM_MENU event type. @event{EVT_TREE_STATE_IMAGE_CLICK(id, func)} - The state image has been clicked. Windows only. - Processes a @c wxEVT_COMMAND_TREE_STATE_IMAGE_CLICK event type. + The state image has been clicked. + Processes a @c wxEVT_TREE_STATE_IMAGE_CLICK event type. @endEventTable @@ -158,7 +158,7 @@ @library{wxcore} @category{ctrl} - @appearance{treectrl.png} + @appearance{treectrl} @see wxDataViewTreeCtrl, wxTreeEvent, wxTreeItemData, @ref overview_treectrl, wxListBox, wxListCtrl, wxImageList @@ -339,6 +339,18 @@ public: virtual wxTextCtrl *EditLabel(const wxTreeItemId& item, wxClassInfo* textCtrlClass = wxCLASSINFO(wxTextCtrl)); + /** + Enable or disable a beep if there is no match for the currently + entered text when searching for the item from keyboard. + + The default is to not beep in this case except in wxMSW where the + beep is always generated by the native control and cannot be disabled, + i.e. calls to this function do nothing there. + + @since 2.9.5 + */ + void EnableBellOnNoMatch(bool on = true); + /** Ends label editing. If @a cancelEdit is @true, the edit will be cancelled. @@ -691,8 +703,8 @@ public: /** Inserts an item before one identified - by its position (@a before). @a before must be less than the number of - children. + by its position (@a pos). @a pos must be less than or equal to + the number of children. The @a image and @a selImage parameters are an index within the normal image list specifying the image to use for unselected and selected @@ -700,7 +712,7 @@ public: image is used for both selected and unselected items. */ wxTreeItemId InsertItem(const wxTreeItemId& parent, - size_t before, + size_t pos, const wxString& text, int image = -1, int selImage = -1, @@ -714,7 +726,7 @@ public: virtual bool IsBold(const wxTreeItemId& item) const; /** - Returns @true if the control is empty (i.e. has no items, even no root + Returns @true if the control is empty (i.e.\ has no items, even no root one). */ bool IsEmpty() const; @@ -783,7 +795,7 @@ public: currently selected item if the value of @a select is @false. Notice that calling this method will generate - @c wxEVT_COMMAND_TREE_SEL_CHANGING and @c wxEVT_COMMAND_TREE_SEL_CHANGED + @c wxEVT_TREE_SEL_CHANGING and @c wxEVT_TREE_SEL_CHANGED events and that the change could be vetoed by the former event handler. */ virtual void SelectItem(const wxTreeItemId& item, bool select = true); @@ -1043,7 +1055,7 @@ public: The state image has been clicked. @endEventTable - @library{wxbase} + @library{wxcore} @category{events} @see wxTreeCtrl @@ -1108,25 +1120,25 @@ public: }; -wxEventType wxEVT_COMMAND_TREE_BEGIN_DRAG; -wxEventType wxEVT_COMMAND_TREE_BEGIN_RDRAG; -wxEventType wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT; -wxEventType wxEVT_COMMAND_TREE_END_LABEL_EDIT; -wxEventType wxEVT_COMMAND_TREE_DELETE_ITEM; -wxEventType wxEVT_COMMAND_TREE_GET_INFO; -wxEventType wxEVT_COMMAND_TREE_SET_INFO; -wxEventType wxEVT_COMMAND_TREE_ITEM_EXPANDED; -wxEventType wxEVT_COMMAND_TREE_ITEM_EXPANDING; -wxEventType wxEVT_COMMAND_TREE_ITEM_COLLAPSED; -wxEventType wxEVT_COMMAND_TREE_ITEM_COLLAPSING; -wxEventType wxEVT_COMMAND_TREE_SEL_CHANGED; -wxEventType wxEVT_COMMAND_TREE_SEL_CHANGING; -wxEventType wxEVT_COMMAND_TREE_KEY_DOWN; -wxEventType wxEVT_COMMAND_TREE_ITEM_ACTIVATED; -wxEventType wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK; -wxEventType wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK; -wxEventType wxEVT_COMMAND_TREE_END_DRAG; -wxEventType wxEVT_COMMAND_TREE_STATE_IMAGE_CLICK; -wxEventType wxEVT_COMMAND_TREE_ITEM_GETTOOLTIP; -wxEventType wxEVT_COMMAND_TREE_ITEM_MENU; +wxEventType wxEVT_TREE_BEGIN_DRAG; +wxEventType wxEVT_TREE_BEGIN_RDRAG; +wxEventType wxEVT_TREE_BEGIN_LABEL_EDIT; +wxEventType wxEVT_TREE_END_LABEL_EDIT; +wxEventType wxEVT_TREE_DELETE_ITEM; +wxEventType wxEVT_TREE_GET_INFO; +wxEventType wxEVT_TREE_SET_INFO; +wxEventType wxEVT_TREE_ITEM_EXPANDED; +wxEventType wxEVT_TREE_ITEM_EXPANDING; +wxEventType wxEVT_TREE_ITEM_COLLAPSED; +wxEventType wxEVT_TREE_ITEM_COLLAPSING; +wxEventType wxEVT_TREE_SEL_CHANGED; +wxEventType wxEVT_TREE_SEL_CHANGING; +wxEventType wxEVT_TREE_KEY_DOWN; +wxEventType wxEVT_TREE_ITEM_ACTIVATED; +wxEventType wxEVT_TREE_ITEM_RIGHT_CLICK; +wxEventType wxEVT_TREE_ITEM_MIDDLE_CLICK; +wxEventType wxEVT_TREE_END_DRAG; +wxEventType wxEVT_TREE_STATE_IMAGE_CLICK; +wxEventType wxEVT_TREE_ITEM_GETTOOLTIP; +wxEventType wxEVT_TREE_ITEM_MENU;