CountPerPage = property(GetCountPerPage,doc="See `GetCountPerPage`")
EditControl = property(GetEditControl,doc="See `GetEditControl`")
FocusedItem = property(GetFocusedItem,doc="See `GetFocusedItem`")
- ImageList = property(GetImageList,SetImageList,doc="See `GetImageList` and `SetImageList`")
ItemCount = property(GetItemCount,SetItemCount,doc="See `GetItemCount` and `SetItemCount`")
MainWindow = property(GetMainWindow,doc="See `GetMainWindow`")
SelectedItemCount = property(GetSelectedItemCount,doc="See `GetSelectedItemCount`")
"""IsBold(self, TreeItemId item) -> bool"""
return _controls_.TreeCtrl_IsBold(*args, **kwargs)
+ def IsEmpty(*args, **kwargs):
+ """IsEmpty(self) -> bool"""
+ return _controls_.TreeCtrl_IsEmpty(*args, **kwargs)
+
def GetChildrenCount(*args, **kwargs):
"""GetChildrenCount(self, TreeItemId item, bool recursively=True) -> size_t"""
return _controls_.TreeCtrl_GetChildrenCount(*args, **kwargs)
"""Collapse(self, TreeItemId item)"""
return _controls_.TreeCtrl_Collapse(*args, **kwargs)
+ def CollapseAllChildren(*args, **kwargs):
+ """CollapseAllChildren(self, TreeItemId item)"""
+ return _controls_.TreeCtrl_CollapseAllChildren(*args, **kwargs)
+
+ def CollapseAll(*args, **kwargs):
+ """CollapseAll(self)"""
+ return _controls_.TreeCtrl_CollapseAll(*args, **kwargs)
+
def CollapseAndReset(*args, **kwargs):
"""CollapseAndReset(self, TreeItemId item)"""
return _controls_.TreeCtrl_CollapseAndReset(*args, **kwargs)
#---------------------------------------------------------------------------
class SearchCtrl(TextCtrl):
- """Proxy of C++ SearchCtrl class"""
+ """
+ A search control is a composite of a `wx.TextCtrl` with optional
+ bitmap buttons and a drop-down menu. Controls like this can typically
+ be found on a toolbar of applications that support some form of search
+ functionality. On the Mac this control is implemented using the
+ native HISearchField control, on the other platforms a generic control
+ is used, although that may change in the future as more platforms
+ introduce native search widgets.
+
+ If you wish to use a drop-down menu with your wx.SearchCtrl then you
+ will need to manage its content and handle the menu events yourself,
+ but this is an easy thing to do. Simply build the menu, pass it to
+ `SetMenu`, and also bind a handler for a range of EVT_MENU events.
+ This gives you the flexibility to use the drop-down menu however you
+ wish, such as for a history of searches, or as a way to select
+ different kinds of searches. The ToolBar.py sample in the demo shows
+ one way to do this.
+
+ Since the control derives from `wx.TextCtrl` it is convenient to use
+ the styles and events designed for `wx.TextCtrl`. For example you can
+ use the ``wx.TE_PROCESS_ENTER`` style and catch the
+ ``wx.EVT_TEXT_ENTER`` event to know when the user has pressed the
+ Enter key in the control and wishes to start a search.
+
+ """
thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
__repr__ = _swig_repr
def __init__(self, *args, **kwargs):
Point pos=DefaultPosition, Size size=DefaultSize,
long style=0, Validator validator=DefaultValidator,
String name=SearchCtrlNameStr) -> SearchCtrl
+
+ A search control is a composite of a `wx.TextCtrl` with optional
+ bitmap buttons and a drop-down menu. Controls like this can typically
+ be found on a toolbar of applications that support some form of search
+ functionality. On the Mac this control is implemented using the
+ native HISearchField control, on the other platforms a generic control
+ is used, although that may change in the future as more platforms
+ introduce native search widgets.
+
+ If you wish to use a drop-down menu with your wx.SearchCtrl then you
+ will need to manage its content and handle the menu events yourself,
+ but this is an easy thing to do. Simply build the menu, pass it to
+ `SetMenu`, and also bind a handler for a range of EVT_MENU events.
+ This gives you the flexibility to use the drop-down menu however you
+ wish, such as for a history of searches, or as a way to select
+ different kinds of searches. The ToolBar.py sample in the demo shows
+ one way to do this.
+
+ Since the control derives from `wx.TextCtrl` it is convenient to use
+ the styles and events designed for `wx.TextCtrl`. For example you can
+ use the ``wx.TE_PROCESS_ENTER`` style and catch the
+ ``wx.EVT_TEXT_ENTER`` event to know when the user has pressed the
+ Enter key in the control and wishes to start a search.
+
"""
_controls_.SearchCtrl_swiginit(self,_controls_.new_SearchCtrl(*args, **kwargs))
self._setOORInfo(self)
return _controls_.SearchCtrl_Create(*args, **kwargs)
def SetMenu(*args, **kwargs):
- """SetMenu(self, Menu menu)"""
+ """
+ SetMenu(self, Menu menu)
+
+ Sets the search control's menu object. If there is already a menu
+ associated with the search control it is deleted.
+ """
return _controls_.SearchCtrl_SetMenu(*args, **kwargs)
def GetMenu(*args, **kwargs):
- """GetMenu(self) -> Menu"""
+ """
+ GetMenu(self) -> Menu
+
+ Returns a pointer to the search control's menu object or None if there
+ is no menu attached.
+ """
return _controls_.SearchCtrl_GetMenu(*args, **kwargs)
def ShowSearchButton(*args, **kwargs):
- """ShowSearchButton(self, bool show)"""
+ """
+ ShowSearchButton(self, bool show)
+
+ Sets the search button visibility value on the search control. If
+ there is a menu attached, the search button will be visible regardless
+ of the search button visibility value. This has no effect in Mac OS X
+ v10.3
+ """
return _controls_.SearchCtrl_ShowSearchButton(*args, **kwargs)
def IsSearchButtonVisible(*args, **kwargs):
- """IsSearchButtonVisible(self) -> bool"""
+ """
+ IsSearchButtonVisible(self) -> bool
+
+ Returns the search button visibility value. If there is a menu
+ attached, the search button will be visible regardless of the search
+ button visibility value. This always returns false in Mac OS X v10.3
+ """
return _controls_.SearchCtrl_IsSearchButtonVisible(*args, **kwargs)
def ShowCancelButton(*args, **kwargs):
- """ShowCancelButton(self, bool show)"""
+ """
+ ShowCancelButton(self, bool show)
+
+ Shows or hides the cancel button.
+ """
return _controls_.SearchCtrl_ShowCancelButton(*args, **kwargs)
def IsCancelButtonVisible(*args, **kwargs):
- """IsCancelButtonVisible(self) -> bool"""
+ """
+ IsCancelButtonVisible(self) -> bool
+
+ Indicates whether the cancel button is visible.
+ """
return _controls_.SearchCtrl_IsCancelButtonVisible(*args, **kwargs)
+ def SetDescriptiveText(*args, **kwargs):
+ """
+ SetDescriptiveText(self, String text)
+
+ Set the text to be displayed when the user has not yet typed anything
+ in the control.
+ """
+ return _controls_.SearchCtrl_SetDescriptiveText(*args, **kwargs)
+
+ def GetDescriptiveText(*args, **kwargs):
+ """
+ GetDescriptiveText(self) -> String
+
+ Get the text to be displayed when the user has not yet typed anything
+ in the control.
+ """
+ return _controls_.SearchCtrl_GetDescriptiveText(*args, **kwargs)
+
def SetSearchBitmap(*args, **kwargs):
- """SetSearchBitmap(self, Bitmap ?)"""
+ """
+ SetSearchBitmap(self, Bitmap ?)
+
+ Sets the bitmap to use for the search button. This currently does not
+ work on the Mac.
+ """
return _controls_.SearchCtrl_SetSearchBitmap(*args, **kwargs)
def SetSearchMenuBitmap(*args, **kwargs):
- """SetSearchMenuBitmap(self, Bitmap ?)"""
+ """
+ SetSearchMenuBitmap(self, Bitmap ?)
+
+ Sets the bitmap to use for the search button when there is a drop-down
+ menu associated with the search control. This currently does not work
+ on the Mac.
+ """
return _controls_.SearchCtrl_SetSearchMenuBitmap(*args, **kwargs)
def SetCancelBitmap(*args, **kwargs):
- """SetCancelBitmap(self, Bitmap ?)"""
+ """
+ SetCancelBitmap(self, Bitmap ?)
+
+ Sets the bitmap to use for the cancel button. This currently does not
+ work on the Mac.
+ """
return _controls_.SearchCtrl_SetCancelBitmap(*args, **kwargs)
Menu = property(GetMenu,SetMenu)
SearchButtonVisible = property(IsSearchButtonVisible,ShowSearchButton)
CancelButtonVisible = property(IsCancelButtonVisible,ShowCancelButton)
+ DescriptiveText = property(GetDescriptiveText,SetDescriptiveText)
_controls_.SearchCtrl_swigregister(SearchCtrl)
SearchCtrlNameStr = cvar.SearchCtrlNameStr
val = _controls_.new_PreSearchCtrl(*args, **kwargs)
return val
-wxEVT_COMMAND_SEARCHCTRL_CANCEL = _controls_.wxEVT_COMMAND_SEARCHCTRL_CANCEL
-wxEVT_COMMAND_SEARCHCTRL_SEARCH = _controls_.wxEVT_COMMAND_SEARCHCTRL_SEARCH
-EVT_SEARCHCTRL_CANCEL = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_CANCEL, 1)
-EVT_SEARCHCTRL_SEARCH = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_SEARCH, 1)
+wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN = _controls_.wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN
+wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN = _controls_.wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN
+EVT_SEARCHCTRL_CANCEL_BTN = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_CANCEL_BTN, 1)
+EVT_SEARCHCTRL_SEARCH_BTN = wx.PyEventBinder( wxEVT_COMMAND_SEARCHCTRL_SEARCH_BTN, 1)
projects / wxWidgets.git / blobdiff