summaryrefslogtreecommitdiff
path: root/lib/wx/doc/src/wxRadioBox.xml
blob: a6f007871921c0c1117cae3c83c59176de0ad420 (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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
<?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>wxRadioBox</title>
</header>
<module>wxRadioBox</module>
<modulesummary>Functions for wxRadioBox class</modulesummary>
<description><p>A radio box item is used to select one of number of mutually exclusive choices. It is displayed as a vertical column or horizontal row of labelled buttons.
      </p><p>Styles</p><p>This class supports the following styles:
      </p><p>See: <url href="https://docs.wxwidgets.org/3.1/overview_events.html#overview_events">Overview events</url>, <seeerl marker="wxRadioButton"><c>wxRadioButton</c></seeerl>, <seeerl marker="wxCheckBox"><c>wxCheckBox</c></seeerl>
      </p>
  <p>This class is derived (and can use functions) from: 
    <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_radio_box.html">wxRadioBox</url></p>
  </description><section><title>Events</title><p>Event types emitted from this class: <seeerl marker="wxCommandEvent"><c>command_radiobox_selected</c></seeerl></p></section>
<datatypes><datatype><name name="wxRadioBox"/></datatype></datatypes>

<funcs>
  <func>
    <name name="new" arity="6" clause_i="1" since=""/>
    <fsummary>See: <c>new/7</c></fsummary>
  </func>
  
  <func>
    <name name="new" arity="7" clause_i="1" since=""/>
    <fsummary>Constructor, creating and showing a radiobox. </fsummary>
    <desc><p>Constructor, creating and showing a radiobox. 
      </p><p>See: <seemfa marker="#create/8"><c>create/8</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 radiobox item. </fsummary>
    <desc><p>Destructor, destroying the radiobox item. 
      </p></desc>
  </func>
  
  <func>
    <name name="create" arity="7" clause_i="1" since=""/>
    <fsummary>See: <c>create/8</c></fsummary>
  </func>
  
  <func>
    <name name="create" arity="8" clause_i="1" since=""/>
    <fsummary>Creates the radiobox for two-step construction. </fsummary>
    <desc><p>Creates the radiobox for two-step construction. 
      </p><p>See <seemfa marker="#new/7"><c>new/7</c></seemfa> for further details. 
      </p></desc>
  </func>
  
  <func>
    <name name="enable" arity="1" clause_i="1" since=""/>
    <fsummary>See: <c>enable/2</c></fsummary>
  </func>
  
  <func>
    <name name="enable" arity="2" clause_i="1" since=""/>
  
    <name name="enable" arity="2" clause_i="2" since=""/>
    <fsummary>Enables or disables the radiobox. </fsummary>
    <desc><p>Enables or disables the radiobox. 
      </p><p>See: <seemfa marker="wxWindow#enable/2"><c>wxWindow:enable/2</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="enable" arity="3" clause_i="1" since=""/>
    <fsummary>Enables or disables an individual button in the radiobox. </fsummary>
    <desc><p>Enables or disables an individual button in the radiobox. 
      </p><p>See: <seemfa marker="wxWindow#enable/2"><c>wxWindow:enable/2</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="getSelection" arity="1" clause_i="1" since=""/>
    <fsummary>Returns the index of the selected item or <c>wxNOT_FOUND</c> if no item is selected. </fsummary>
    <desc><p>Returns the index of the selected item or <c>wxNOT_FOUND</c> if no item is selected. 
      </p><p>Return: The position of the current selection.
      </p><p>Remark: This method can be used with single selection list boxes only, you should use <seemfa marker="wxListBox#getSelections/1"><c>wxListBox:getSelections/1</c></seemfa> for the list boxes with wxLB_MULTIPLE style.
      </p><p>See: <seemfa marker="#setSelection/2"><c>setSelection/2</c></seemfa>, <seemfa marker="wxControlWithItems#getStringSelection/1"><c>wxControlWithItems:getStringSelection/1</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="getString" arity="2" clause_i="1" since=""/>
    <fsummary>Returns the label of the item with the given index. </fsummary>
    <desc><p>Returns the label of the item with the given index. 
      </p><p>Return: The label of the item or an empty string if the position was invalid. 
      </p></desc>
  </func>
  
  <func>
    <name name="setSelection" arity="2" clause_i="1" since=""/>
    <fsummary>Sets the selection to the given item. </fsummary>
    <desc><p>Sets the selection to the given item. 
      </p><p>Notice that a radio box always has selection, so <c>n</c> must be valid here and passing <c>wxNOT_FOUND</c> is not allowed. 
      </p></desc>
  </func>
  
  <func>
    <name name="show" arity="2" clause_i="1" since=""/>
    <fsummary>See: <c>show/3</c></fsummary>
  </func>
  
  <func>
    <name name="show" arity="3" clause_i="1" since=""/>
    <fsummary>Shows or hides individual buttons. </fsummary>
    <desc><p>Shows or hides individual buttons. 
      </p><p>Return: true if the item has been shown or hidden or false if nothing was done because it already was in the requested state.
      </p><p>See: <seemfa marker="#show/3"><c>show/3</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="getColumnCount" arity="1" clause_i="1" since=""/>
    <fsummary>Returns the number of columns in the radiobox. </fsummary>
    <desc><p>Returns the number of columns in the radiobox. 
      </p></desc>
  </func>
  
  <func>
    <name name="getItemHelpText" arity="2" clause_i="1" since=""/>
    <fsummary>Returns the helptext associated with the specified <c>item</c> if any or <c>wxEmptyString</c>. </fsummary>
    <desc><p>Returns the helptext associated with the specified <c>item</c> if any or <c>wxEmptyString</c>. 
      </p><p>See: <seemfa marker="#setItemHelpText/3"><c>setItemHelpText/3</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="getItemToolTip" arity="2" clause_i="1" since=""/>
    <fsummary>Returns the tooltip associated with the specified <c>item</c> if any or NULL. </fsummary>
    <desc><p>Returns the tooltip associated with the specified <c>item</c> if any or NULL. 
      </p><p>See: <seemfa marker="#setItemToolTip/3"><c>setItemToolTip/3</c></seemfa>, <seemfa marker="wxWindow#getToolTip/1"><c>wxWindow:getToolTip/1</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="getItemFromPoint" arity="2" clause_i="1" since=""/>
    <fsummary>Returns a radio box item under the point, a zero-based item index, or <c>wxNOT_FOUND</c> if no item is under the point. </fsummary>
    <desc><p>Returns a radio box item under the point, a zero-based item index, or <c>wxNOT_FOUND</c> if no item is under the point. 
      </p></desc>
  </func>
  
  <func>
    <name name="getRowCount" arity="1" clause_i="1" since=""/>
    <fsummary>Returns the number of rows in the radiobox. </fsummary>
    <desc><p>Returns the number of rows in the radiobox. 
      </p></desc>
  </func>
  
  <func>
    <name name="isItemEnabled" arity="2" clause_i="1" since=""/>
    <fsummary>Returns true if the item is enabled or false if it was disabled using <c>enable/3</c>. </fsummary>
    <desc><p>Returns true if the item is enabled or false if it was disabled using <seemfa marker="#enable/3"><c>enable/3</c></seemfa>. 
      </p><p>This function is currently only implemented in wxMSW, wxGTK, wxQT and wxUniversal and always returns true in the other ports.
      </p></desc>
  </func>
  
  <func>
    <name name="isItemShown" arity="2" clause_i="1" since=""/>
    <fsummary>Returns true if the item is currently shown or false if it was hidden using <c>show/3</c>. </fsummary>
    <desc><p>Returns true if the item is currently shown or false if it was hidden using <seemfa marker="#show/3"><c>show/3</c></seemfa>. 
      </p><p>Note that this function returns true for an item which hadn't been hidden even if the entire radiobox is not currently shown.
      </p><p>This function is currently only implemented in wxMSW, wxGTK, wxQT and wxUniversal and always returns true in the other ports.
      </p></desc>
  </func>
  
  <func>
    <name name="setItemHelpText" arity="3" clause_i="1" since=""/>
    <fsummary>Sets the helptext for an item. </fsummary>
    <desc><p>Sets the helptext for an item. 
      </p><p>Empty string erases any existing helptext.
      </p><p>See: <seemfa marker="#getItemHelpText/2"><c>getItemHelpText/2</c></seemfa>
      </p></desc>
  </func>
  
  <func>
    <name name="setItemToolTip" arity="3" clause_i="1" since=""/>
    <fsummary>Sets the tooltip text for the specified item in the radio group. </fsummary>
    <desc><p>Sets the tooltip text for the specified item in the radio group. 
      </p><p>This function is currently only implemented in wxMSW and wxGTK2 and does nothing in the other ports.
      </p><p>See: <seemfa marker="#getItemToolTip/2"><c>getItemToolTip/2</c></seemfa>, <seemfa marker="wxWindow#setToolTip/2"><c>wxWindow:setToolTip/2</c></seemfa>
      </p></desc>
  </func>
  </funcs>
</erlref>