File: checkbox.tex

package info (click to toggle)
wxwidgets2.8 2.8.10.1-3
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 239,052 kB
  • ctags: 289,550
  • sloc: cpp: 1,838,857; xml: 396,717; python: 282,506; ansic: 126,171; makefile: 51,406; sh: 14,581; asm: 299; sql: 258; lex: 194; perl: 139; yacc: 128; pascal: 95; php: 39; lisp: 38; tcl: 24; haskell: 20; java: 18; cs: 18; erlang: 17; ruby: 16; ada: 9; ml: 9; csh: 9
file content (171 lines) | stat: -rw-r--r-- 5,858 bytes parent folder | download | duplicates (7)
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
\section{\class{wxCheckBox}}\label{wxcheckbox}

A checkbox is a labelled box which by default is either on (checkmark is
visible) or off (no checkmark). Optionally (when the wxCHK\_3STATE style flag
is set) it can have a third state, called the mixed or undetermined state.
Often this is used as a "Does Not Apply" state.

\wxheading{Derived from}

\helpref{wxControl}{wxcontrol}\\
\helpref{wxWindow}{wxwindow}\\
\helpref{wxEvtHandler}{wxevthandler}\\
\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/checkbox.h>

\wxheading{Window styles}

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{\windowstyle{wxCHK\_2STATE}}{Create a 2-state checkbox. This is the default.}
\twocolitem{\windowstyle{wxCHK\_3STATE}}{Create a 3-state checkbox.
Not implemented in wxMGL, wxOS2 and wxGTK built against GTK+ 1.2.}
\twocolitem{\windowstyle{wxCHK\_ALLOW\_3RD\_STATE\_FOR\_USER}}{By default a user can't set a 3-state checkbox
to the third state. It can only be done from code. Using this flags allows the user to set the checkbox to the third state by clicking. }
\twocolitem{\windowstyle{wxALIGN\_RIGHT}}{Makes the text appear on the left of the checkbox.}
\end{twocollist}

See also \helpref{window styles overview}{windowstyles}.

\wxheading{Event handling}

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_CHECKBOX(id, func)}}{Process a wxEVT\_COMMAND\_CHECKBOX\_CLICKED event,
when the checkbox is clicked.}
\end{twocollist}

\wxheading{See also}

\helpref{wxRadioButton}{wxradiobutton}, \helpref{wxCommandEvent}{wxcommandevent}

\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxCheckBox::wxCheckBox}\label{wxcheckboxctor}

\func{}{wxCheckBox}{\void}

Default constructor.

\func{}{wxCheckBox}{\param{wxWindow* }{parent}, \param{wxWindowID}{ id},\rtfsp
\param{const wxString\& }{label}, \param{const wxPoint\& }{pos = wxDefaultPosition},\rtfsp
\param{const wxSize\& }{size = wxDefaultSize}, \param{long}{ style = 0},\rtfsp
\param{const wxValidator\& }{val}, \param{const wxString\& }{name = ``checkBox"}}

Constructor, creating and showing a checkbox.

\wxheading{Parameters}

\docparam{parent}{Parent window. Must not be NULL.}

\docparam{id}{Checkbox identifier. A value of -1 indicates a default value.}

\docparam{label}{Text to be displayed next to the checkbox.}

\docparam{pos}{Checkbox position. If the position (-1, -1) is specified then a default position is chosen.}

\docparam{size}{Checkbox size. If the default size (-1, -1) is specified then a default size is chosen.}

\docparam{style}{Window style. See \helpref{wxCheckBox}{wxcheckbox}.}

\docparam{validator}{Window validator.}

\docparam{name}{Window name.}

\wxheading{See also}

\helpref{wxCheckBox::Create}{wxcheckboxcreate}, \helpref{wxValidator}{wxvalidator}

\membersection{wxCheckBox::\destruct{wxCheckBox}}\label{wxcheckboxdtor}

\func{}{\destruct{wxCheckBox}}{\void}

Destructor, destroying the checkbox.

\membersection{wxCheckBox::Create}\label{wxcheckboxcreate}

\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID}{ id},\rtfsp
\param{const wxString\& }{label}, \param{const wxPoint\& }{pos = wxDefaultPosition},\rtfsp
\param{const wxSize\& }{size = wxDefaultSize}, \param{long}{ style = 0},\rtfsp
\param{const wxValidator\& }{val}, \param{const wxString\& }{name = ``checkBox"}}

Creates the checkbox for two-step construction. See \helpref{wxCheckBox::wxCheckBox}{wxcheckboxctor}\rtfsp
for details.

\membersection{wxCheckBox::GetValue}\label{wxcheckboxgetvalue}

\constfunc{bool}{GetValue}{\void}

Gets the state of a 2-state checkbox.

\wxheading{Return value}

Returns \true if it is checked, \false otherwise.

\membersection{wxCheckBox::Get3StateValue}\label{wxcheckboxgetthreestatevalue}

\constfunc{wxCheckBoxState}{Get3StateValue}{\void}

Gets the state of a 3-state checkbox.

\wxheading{Return value}

Returns wxCHK\_UNCHECKED when the checkbox is unchecked, wxCHK\_CHECKED
 when it is checked and wxCHK\_UNDETERMINED when it's in the undetermined
state. Asserts when the function is used with a 2-state checkbox.

\membersection{wxCheckBox::Is3rdStateAllowedForUser}\label{wxcheckboxis3rdstateallowedforuser}

\constfunc{bool}{Is3rdStateAllowedForUser}{\void}

Returns whether or not the user can set the checkbox to the third state.

\wxheading{Return value}

Returns \true if the user can set the third state of this checkbox, \false if it can only be set
programmatically or if it's a 2-state checkbox.

\membersection{wxCheckBox::Is3State}\label{wxcheckboxis3state}

\constfunc{bool}{Is3State}{\void}

Returns whether or not the checkbox is a 3-state checkbox.

\wxheading{Return value}

Returns \true if this checkbox is a 3-state checkbox, \false if it's a 2-state checkbox.

\membersection{wxCheckBox::IsChecked}\label{wxcheckboxischecked}

\constfunc{bool}{IsChecked}{\void}

This is just a maybe more readable synonym for 
\helpref{GetValue}{wxcheckboxgetvalue}: just as the latter, it returns 
\true if the checkbox is checked and \false otherwise.

\membersection{wxCheckBox::SetValue}\label{wxcheckboxsetvalue}

\func{void}{SetValue}{\param{bool}{ state}}

Sets the checkbox to the given state. This does not cause a
wxEVT\_COMMAND\_CHECKBOX\_CLICKED event to get emitted.

\wxheading{Parameters}

\docparam{state}{If \true, the check is on, otherwise it is off.}

\membersection{wxCheckBox::Set3StateValue}\label{wxcheckboxset3statevalue}

\func{void}{Set3StateValue}{\param{const wxCheckBoxState}{ state}}

Sets the checkbox to the given state. This does not cause a
wxEVT\_COMMAND\_CHECKBOX\_CLICKED event to get emitted.

\wxheading{Parameters}

\docparam{state}{Can be one of: wxCHK\_UNCHECKED (Check is off), wxCHK\_CHECKED
 (Check is on) or wxCHK\_UNDETERMINED (Check is mixed). Asserts when the checkbox
 is a 2-state checkbox and setting the state to wxCHK\_UNDETERMINED.}