wxControlWithItems - Functions for wxControlWithItems class
Please see following description for synopsis
wxControlWithItems(3) Erlang Module Definition wxControlWithItems(3)
NAME
wxControlWithItems - Functions for wxControlWithItems class
DESCRIPTION
This is convenience class that derives from both wxControl and wxItem-
Container (not implemented in wx). It is used as basis for some wxWid-
gets controls (wxChoice and wxListBox).
See: wxItemContainer (not implemented in wx), wxItemContainerImmutable
(not implemented in wx)
This class is derived (and can use functions) from: wxControl wxWindow
wxEvtHandler
wxWidgets docs: wxControlWithItems
DATA TYPES
wxControlWithItems() = wx:wx_object()
EXPORTS
append(This, Item) -> integer()
Types:
This = wxControlWithItems()
Item = unicode:chardata()
Appends item into the control.
Return: The return value is the index of the newly inserted
item. Note that this may be different from the last one if the
control is sorted (e.g. has wxLB_SORT or wxCB_SORT style).
append(This, Item, ClientData) -> integer()
Types:
This = wxControlWithItems()
Item = unicode:chardata()
ClientData = term()
Appends item into the control.
Return: The return value is the index of the newly inserted
item. Note that this may be different from the last one if the
control is sorted (e.g. has wxLB_SORT or wxCB_SORT style).
appendStrings(This, Items) -> integer()
Types:
This = wxControlWithItems()
Items = [unicode:chardata()]
Appends several items at once into the control.
Notice that calling this method is usually much faster than
appending them one by one if you need to add a lot of items.
appendStrings(This, Items, ClientsData) -> integer()
Types:
This = wxControlWithItems()
Items = [unicode:chardata()]
ClientsData = [term()]
Appends several items at once into the control.
Notice that calling this method is usually much faster than
appending them one by one if you need to add a lot of items.
clear(This) -> ok
Types:
This = wxControlWithItems()
Removes all items from the control.
clear/1 also deletes the client data of the existing items if it
is owned by the control.
delete(This, N) -> ok
Types:
This = wxControlWithItems()
N = integer()
Deletes an item from the control.
The client data associated with the item will be also deleted if
it is owned by the control. Note that it is an error (signalled
by an assert failure in debug builds) to remove an item with the
index negative or greater or equal than the number of items in
the control.
If there is a currently selected item below the item being
deleted, i.e. if getSelection/1 returns a valid index greater
than or equal to n, the selection is invalidated when this func-
tion is called. However if the selected item appears before the
item being deleted, the selection is preserved unchanged.
See: clear/1
findString(This, String) -> integer()
Types:
This = wxControlWithItems()
String = unicode:chardata()
findString(This, String, Options :: [Option]) -> integer()
Types:
This = wxControlWithItems()
String = unicode:chardata()
Option = {bCase, boolean()}
Finds an item whose label matches the given string.
Return: The zero-based position of the item, or wxNOT_FOUND if
the string was not found.
getClientData(This, N) -> term()
Types:
This = wxControlWithItems()
N = integer()
Returns a pointer to the client data associated with the given
item (if any).
It is an error to call this function for a control which doesn't
have typed client data at all although it is OK to call it even
if the given item doesn't have any client data associated with
it (but other items do).
Notice that the returned pointer is still owned by the control
and will be deleted by it, use DetachClientObject() (not imple-
mented in wx) if you want to remove the pointer from the con-
trol.
Return: A pointer to the client data, or NULL if not present.
setClientData(This, N, Data) -> ok
Types:
This = wxControlWithItems()
N = integer()
Data = term()
Associates the given typed client data pointer with the given
item: the data object will be deleted when the item is deleted
(either explicitly by using delete/2 or implicitly when the con-
trol itself is destroyed).
Note that it is an error to call this function if any untyped
client data pointers had been associated with the control items
before.
getCount(This) -> integer()
Types:
This = wxControlWithItems()
Returns the number of items in the control.
See: isEmpty/1
getSelection(This) -> integer()
Types:
This = wxControlWithItems()
Returns the index of the selected item or wxNOT_FOUND if no item
is selected.
Return: The position of the current selection.
Remark: This method can be used with single selection list boxes
only, you should use wxListBox:getSelections/1 for the list
boxes with wxLB_MULTIPLE style.
See: setSelection/2, getStringSelection/1
getString(This, N) -> unicode:charlist()
Types:
This = wxControlWithItems()
N = integer()
Returns the label of the item with the given index.
Return: The label of the item or an empty string if the position
was invalid.
getStringSelection(This) -> unicode:charlist()
Types:
This = wxControlWithItems()
Returns the label of the selected item or an empty string if no
item is selected.
See: getSelection/1
insert(This, Item, Pos) -> integer()
Types:
This = wxControlWithItems()
Item = unicode:chardata()
Pos = integer()
Inserts item into the control.
Return: The return value is the index of the newly inserted
item. If the insertion failed for some reason, -1 is returned.
insert(This, Item, Pos, ClientData) -> integer()
Types:
This = wxControlWithItems()
Item = unicode:chardata()
Pos = integer()
ClientData = term()
Inserts item into the control.
Return: The return value is the index of the newly inserted
item. If the insertion failed for some reason, -1 is returned.
insertStrings(This, Items, Pos) -> integer()
Types:
This = wxControlWithItems()
Items = [unicode:chardata()]
Pos = integer()
Inserts several items at once into the control.
Notice that calling this method is usually much faster than
inserting them one by one if you need to insert a lot of items.
Return: The return value is the index of the last inserted item.
If the insertion failed for some reason, -1 is returned.
insertStrings(This, Items, Pos, ClientsData) -> integer()
Types:
This = wxControlWithItems()
Items = [unicode:chardata()]
Pos = integer()
ClientsData = [term()]
Inserts several items at once into the control.
Notice that calling this method is usually much faster than
inserting them one by one if you need to insert a lot of items.
Return: The return value is the index of the last inserted item.
If the insertion failed for some reason, -1 is returned.
isEmpty(This) -> boolean()
Types:
This = wxControlWithItems()
Returns true if the control is empty or false if it has some
items.
See: getCount/1
select(This, N) -> ok
Types:
This = wxControlWithItems()
N = integer()
This is the same as setSelection/2 and exists only because it is
slightly more natural for controls which support multiple selec-
tion.
setSelection(This, N) -> ok
Types:
This = wxControlWithItems()
N = integer()
Sets the selection to the given item n or removes the selection
entirely if n == wxNOT_FOUND.
Note that this does not cause any command events to be emitted
nor does it deselect any other items in the controls which sup-
port multiple selections.
See: setString/3, setStringSelection/2
setString(This, N, String) -> ok
Types:
This = wxControlWithItems()
N = integer()
String = unicode:chardata()
Sets the label for the given item.
setStringSelection(This, String) -> boolean()
Types:
This = wxControlWithItems()
String = unicode:chardata()
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.
Return: true if the specified string has been selected, false if
it wasn't found in the control.
wxWidgets team. wx 2.1.1 wxControlWithItems(3)