A listbox is used to select one or more of a list of strings.
The strings are displayed in a scrolling box, with the selected string(s) marked in reverse video. A listbox can be single selection (if an item is selected, the previous selection is removed) or multiple selection (clicking an item toggles the item on or off independently of other selections).
List box elements are numbered from zero. Their number may be limited under some platforms.
A listbox callback gets an event wxEVT_COMMAND_LISTBOX_SELECTED for single clicks, and wxEVT_COMMAND_LISTBOX_DOUBLECLICKED for float clicks.
This class supports the following styles:
Handlers bound for the following event types will receive a CommandEvent parameter.
See also
__init__ | Default constructor. |
Create | Creates the listbox for two-step construction. |
Deselect | Deselects an item in the list box. |
EnsureVisible | Ensure that the item with the given index is currently shown. |
FindString | Finds an item whose label matches the given string. |
GetCount | Returns the number of items in the control. |
GetSelection | Returns the index of the selected item or NOT_FOUND if no item is selected. |
GetSelections | Fill an array of ints with the positions of the currently selected items. |
GetString | Returns the label of the item with the given index. |
HitTest | Returns the item located at point, or NOT_FOUND if there is no item located at point. |
InsertItems | Insert the given number of strings before the specified position. |
IsSelected | Determines whether an item is selected. |
IsSorted | Return True if the listbox has LB_SORT style. |
SetFirstItem | Set the specified item to be the first visible item. |
SetSelection | Sets the selection to the given item n or removes the selection entirely if n == NOT_FOUND . |
SetString | Sets the label for the given item. |
SetStringSelection |
Count | See GetCount |
Selection | See GetSelection and SetSelection |
Selections | See GetSelections |
A listbox is used to select one or more of a list of strings.
Possible constructors:
ListBox()
ListBox(parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize,
choices=[], style=0, validator=DefaultValidator,
name=ListBoxNameStr)
Overloaded Implementations:
__init__ (self)
Default constructor.
__init__ (self, parent, id=ID_ANY, pos=DefaultPosition, size=DefaultSize, choices=[], style=0, validator=DefaultValidator, name=ListBoxNameStr)
Constructor, creating and showing a list box.
See the other ListBox constructor; the only difference is that this overload takes a ArrayString instead of a pointer to an array of String.
Parameters: |
---|
Creates the listbox for two-step construction.
See ListBox for further details.
Deselects an item in the list box.
Parameters: | n (int) – The zero-based item to deselect. |
---|
Note
This applies to multiple selection listboxes only.
Ensure that the item with the given index is currently shown.
Scroll the listbox if necessary.
This method is currently only implemented in wxGTK and wxOSX and does nothing in other ports.
Parameters: | n (int) – |
---|
See also
Finds an item whose label matches the given string.
Parameters: |
|
---|---|
Return type: | int |
Returns: | The zero-based position of the item, or NOT_FOUND if the string was not found. |
Returns the number of items in the control.
Return type: | int |
---|
See also
IsEmpty
Returns the index of the selected item or NOT_FOUND if no item is selected.
Return type: | int |
---|---|
Returns: | The position of the current selection. |
Note
This method can be used with single selection list boxes only, you should use ListBox.GetSelections for the list boxes with LB_MULTIPLE style.
See also
SetSelection , GetStringSelection
Fill an array of ints with the positions of the currently selected items.
A reference to an ArrayInt instance that is used to store the result of the query.
Return type: | list of integers |
---|---|
Returns: | The number of selections. |
Note
Use this with a multiple selection listbox.
See also
ControlWithItems.GetSelection , ControlWithItems.GetStringSelection , ControlWithItems.SetSelection
Returns the label of the item with the given index.
Parameters: | n (int) – The zero-based index. |
---|---|
Return type: | string |
Returns: | The label of the item or an empty string if the position was invalid. |
Overloaded Implementations:
HitTest (self, point)
Returns the item located at point, or NOT_FOUND if there is no item located at point.
It is currently implemented for wxMSW, Mac and wxGTK2 ports.
Parameters: | point (Point) – Point of item (in client coordinates) to obtain |
---|---|
Return type: | int |
Returns: | Item located at point, or NOT_FOUND if unimplemented or the item does not exist. |
New in version 2.7.0.
HitTest (self, x, y)
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Parameters: |
|
---|---|
Return type: | int |
Insert the given number of strings before the specified position.
Parameters: |
|
---|
Determines whether an item is selected.
Parameters: | n (int) – The zero-based item index. |
---|---|
Return type: | bool |
Returns: | True if the given item is selected, False otherwise. |
Return True if the listbox has LB_SORT style.
This method is mostly meant for internal use only.
Return type: | bool |
---|
Overloaded Implementations:
SetFirstItem (self, n)
Set the specified item to be the first visible item.
Parameters: | n (int) – The zero-based item index that should be visible. |
---|
SetFirstItem (self, string)
Set the specified item to be the first visible item.
Parameters: | string (string) – The string that should be visible. |
---|
Sets the selection to the given item n or removes the selection entirely if n == NOT_FOUND .
Note that this does not cause any command events to be emitted nor does it deselect any other items in the controls which support multiple selections.
Parameters: | n (int) – The string position to select, starting from zero. |
---|
See also
Sets the label for the given item.
Parameters: |
|
---|
Overloaded Implementations:
SetStringSelection (self, s, select)
Parameters: |
|
---|---|
Return type: | bool |
SetStringSelection (self, string)
Selects the item with the specified string in the control.
This method doesn’t cause any command events to be emitted.
Notice that this method is case-insensitive, i.e. the string is compared with all the elements of the control case-insensitively and the first matching entry is selected, even if it doesn’t have exactly the same case as this string and there is an exact match afterwards.
Parameters: | string (string) – The string to select. |
---|---|
Return type: | bool |
Returns: | True if the specified string has been selected, False if it wasn’t found in the control. |
See GetSelection and SetSelection
See GetSelections