Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

wxChoice (3erl)

Name

wxChoice - Functions for wxChoice class

Synopsis

Please see following description for synopsis

Description

wxChoice(3)                Erlang Module Definition                wxChoice(3)



NAME
       wxChoice - Functions for wxChoice class

DESCRIPTION
       A  choice  item  is  used  to select one of a list of strings. Unlike a
       wxListBox, only the selection is visible until the user pulls down  the
       menu of choices.

       Styles

       This class supports the following styles:

       See: wxListBox, wxComboBox, wxCommandEvent

       This  class is derived (and can use functions) from: wxControlWithItems
       wxControl wxWindow wxEvtHandler

       wxWidgets docs: wxChoice

EVENTS
       Event types emitted from this class: command_choice_selected

DATA TYPES
       wxChoice() = wx:wx_object()

EXPORTS
       new() -> wxChoice()

              Default constructor.

              See: create/7, wxValidator (not implemented in wx)

       new(Parent, Id) -> wxChoice()

              Types:

                 Parent = wxWindow:wxWindow()
                 Id = integer()

       new(Parent, Id, Options :: [Option]) -> wxChoice()

              Types:

                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Option =
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {choices, [unicode:chardata()]} |
                     {style, integer()} |
                     {validator, wx:wx_object()}

              Constructor, creating and showing a choice.

              See: create/7, wxValidator (not implemented in wx)

       destroy(This :: wxChoice()) -> ok

              Destructor, destroying the choice item.

       create(This, Parent, Id, Pos, Size, Choices) -> boolean()

              Types:

                 This = wxChoice()
                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Pos = {X :: integer(), Y :: integer()}
                 Size = {W :: integer(), H :: integer()}
                 Choices = [unicode:chardata()]

       create(This, Parent, Id, Pos, Size, Choices, Options :: [Option]) ->
                 boolean()

              Types:

                 This = wxChoice()
                 Parent = wxWindow:wxWindow()
                 Id = integer()
                 Pos = {X :: integer(), Y :: integer()}
                 Size = {W :: integer(), H :: integer()}
                 Choices = [unicode:chardata()]
                 Option = {style, integer()} | {validator, wx:wx_object()}

       delete(This, N) -> ok

              Types:

                 This = wxChoice()
                 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  wxControlWithItems:getSelection/1  returns a
              valid index greater than or equal to n, the selection is invali-
              dated when this function is called. However if the selected item
              appears before the item being deleted,  the  selection  is  pre-
              served unchanged.

              See: wxControlWithItems:clear/1

       getColumns(This) -> integer()

              Types:

                 This = wxChoice()

              Gets the number of columns in this choice item.

              Remark:  This  is  implemented for GTK and Motif only and always
              returns 1 for the other platforms.

       setColumns(This) -> ok

              Types:

                 This = wxChoice()

       setColumns(This, Options :: [Option]) -> ok

              Types:

                 This = wxChoice()
                 Option = {n, integer()}

              Sets the number of columns in this choice item.

              Remark: This is implemented for GTK and Motif only  and  doesn't
              do anything under other platforms.



wxWidgets team.                    wx 2.1.1                        wxChoice(3)