summaryrefslogtreecommitdiff
path: root/lib/wx/doc/src/wxChoice.xml
blob: 3f35f45645093fc1428e858e4dd923b923d6acdb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE erlref SYSTEM "erlref.dtd">

<!-- THIS FILE IS GENERATED DO NOT EDIT -->


<erlref>
<header>
  <copyright>
    <year>2020</year><year>2021</year>
    <holder>wxWidgets team.</holder></copyright>
  <legalnotice>Licensed under the wxWindows Free Documentation Licence, Version 3
  </legalnotice>
  <title>wxChoice</title>
</header>
<module>wxChoice</module>
<modulesummary>Functions for wxChoice class</modulesummary>
<description><p>A choice item is used to select one of a list of strings. Unlike a <seeerl marker="wxListBox"><c>wxListBox</c></seeerl>, only the selection is visible until the user pulls down the menu of choices.
      </p><p>Styles</p><p>This class supports the following styles:
      </p><p>See: <seeerl marker="wxListBox"><c>wxListBox</c></seeerl>, <seeerl marker="wxComboBox"><c>wxComboBox</c></seeerl>, <seeerl marker="wxCommandEvent"><c>wxCommandEvent</c></seeerl>
      </p>
  <p>This class is derived (and can use functions) from: 
    <seeerl marker="wxControlWithItems"><c>wxControlWithItems</c></seeerl> <seeerl marker="wxControl"><c>wxControl</c></seeerl> <seeerl marker="wxWindow"><c>wxWindow</c></seeerl> <seeerl marker="wxEvtHandler"><c>wxEvtHandler</c></seeerl></p>
  
  <p>wxWidgets docs: <url href="https://docs.wxwidgets.org/3.1/classwx_choice.html">wxChoice</url></p>
  </description><section><title>Events</title><p>Event types emitted from this class: <seeerl marker="wxCommandEvent"><c>command_choice_selected</c></seeerl></p></section>
<datatypes><datatype><name name="wxChoice"/></datatype></datatypes>

<funcs>
  <func>
    <name name="new" arity="0" clause_i="1" since=""/>
    <fsummary>Default constructor. </fsummary>
    <desc><p>Default constructor. 
      </p><p>See: <seemfa marker="#create/7"><c>create/7</c></seemfa>, <c>wxValidator</c> (not implemented in wx)
      </p></desc>
  </func>
  
  <func>
    <name name="new" arity="2" clause_i="1" since=""/>
    <fsummary>See: <c>new/3</c></fsummary>
  </func>
  
  <func>
    <name name="new" arity="3" clause_i="1" since=""/>
    <fsummary>Constructor, creating and showing a choice. </fsummary>
    <desc><p>Constructor, creating and showing a choice. 
      </p><p>See: <seemfa marker="#create/7"><c>create/7</c></seemfa>, <c>wxValidator</c> (not implemented in wx)
      </p></desc>
  </func>
  
  <func>
    <name name="destroy" arity="1" clause_i="1" since=""/>
    <fsummary>Destructor, destroying the choice item. </fsummary>
    <desc><p>Destructor, destroying the choice item. 
      </p></desc>
  </func>
  
  <func>
    <name name="create" arity="6" clause_i="1" since=""/>
    <fsummary>See: <c>create/7</c></fsummary>
  </func>
  
  <func>
    <name name="create" arity="7" clause_i="1" since=""/>
    <fsummary/>
    <desc/>
  </func>
  
  <func>
    <name name="delete" arity="2" clause_i="1" since=""/>
    <fsummary>Deletes an item from the control. </fsummary>
    <desc><p>Deletes an item from the control. 
      </p><p>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.
      </p><p>If there is a currently selected item below the item being deleted, i.e. if <seemfa marker="wxControlWithItems#getSelection/1"><c>wxControlWithItems:getSelection/1</c></seemfa> returns a valid index greater than or equal to <c>n</c>, the selection is invalidated when this function is called. However if the selected item appears before the item being deleted, the selection is preserved unchanged.
      </p><p>See: <seemfa marker="wxControlWithItems#clear/1"><c>wxControlWithItems:clear/1</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="getColumns" arity="1" clause_i="1" since=""/>
    <fsummary>Gets the number of columns in this choice item. </fsummary>
    <desc><p>Gets the number of columns in this choice item. 
      </p><p>Remark: This is implemented for GTK and Motif only and always returns 1 for the other platforms. 
      </p></desc>
  </func>
  
  <func>
    <name name="setColumns" arity="1" clause_i="1" since=""/>
    <fsummary>See: <c>setColumns/2</c></fsummary>
  </func>
  
  <func>
    <name name="setColumns" arity="2" clause_i="1" since=""/>
    <fsummary>Sets the number of columns in this choice item. </fsummary>
    <desc><p>Sets the number of columns in this choice item. 
      </p><p>Remark: This is implemented for GTK and Motif only and doesn’t do anything under other platforms. 
      </p></desc>
  </func>
  </funcs>
</erlref>