]>
Commit | Line | Data |
---|---|---|
1 | \section{\class{wxCheckListBox}}\label{wxchecklistbox} | |
2 | ||
3 | A checklistbox is like a listbox, but allows items to be checked or unchecked. | |
4 | ||
5 | This class is currently implemented under Windows and GTK. When using this | |
6 | class under Windows wxWindows must be compiled with USE\_OWNER\_DRAWN set to 1. | |
7 | ||
8 | Only the new functions for this class are documented; see also \helpref{wxListBox}{wxlistbox}. | |
9 | ||
10 | \wxheading{Derived from} | |
11 | ||
12 | \helpref{wxListBox}{wxlistbox}\\ | |
13 | \helpref{wxControl}{wxcontrol}\\ | |
14 | \helpref{wxWindow}{wxwindow}\\ | |
15 | \helpref{wxEvtHandler}{wxevthandler}\\ | |
16 | \helpref{wxObject}{wxobject} | |
17 | ||
18 | \wxheading{Include files} | |
19 | ||
20 | <wx/checklst.h> | |
21 | ||
22 | \wxheading{Window styles} | |
23 | ||
24 | See \helpref{wxListBox}{wxlistbox}. | |
25 | ||
26 | \wxheading{Event handling} | |
27 | ||
28 | \twocolwidtha{7cm} | |
29 | \begin{twocollist}\itemsep=0pt | |
30 | \twocolitem{{\bf EVT\_CHECKLISTBOX(id, func)}}{Process a wxEVT\_COMMAND\_CHECKLISTBOX\_TOGGLE event, | |
31 | when an item in the check list box is checked or unchecked.} | |
32 | \end{twocollist} | |
33 | ||
34 | \wxheading{See also} | |
35 | ||
36 | \helpref{wxListBox}{wxlistbox}, \helpref{wxChoice}{wxchoice}, \helpref{wxComboBox}{wxcombobox}, \helpref{wxListCtrl}{wxlistctrl}, | |
37 | \rtfsp\helpref{wxCommandEvent}{wxcommandevent} | |
38 | ||
39 | \latexignore{\rtfignore{\wxheading{Members}}} | |
40 | ||
41 | \membersection{wxCheckListBox::wxCheckListBox}\label{wxchecklistboxconstr} | |
42 | ||
43 | \func{}{wxCheckListBox}{\void} | |
44 | ||
45 | Default constructor. | |
46 | ||
47 | \func{}{wxCheckListBox}{\param{wxWindow*}{ parent}, \param{wxWindowID}{ id},\rtfsp | |
48 | \param{const wxPoint\&}{ pos = wxDefaultPosition}, \param{const wxSize\&}{ size = wxDefaultSize},\rtfsp | |
49 | \param{int}{ n}, \param{const wxString }{choices[] = NULL},\rtfsp | |
50 | \param{long}{ style = 0}, \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``listBox"}} | |
51 | ||
52 | Constructor, creating and showing a list box. | |
53 | ||
54 | \wxheading{Parameters} | |
55 | ||
56 | \docparam{parent}{Parent window. Must not be NULL.} | |
57 | ||
58 | \docparam{id}{Window identifier. A value of -1 indicates a default value.} | |
59 | ||
60 | \docparam{pos}{Window position.} | |
61 | ||
62 | \docparam{size}{Window size. If the default size (-1, -1) is specified then the window is sized | |
63 | appropriately.} | |
64 | ||
65 | \docparam{n}{Number of strings with which to initialise the control.} | |
66 | ||
67 | \docparam{choices}{An array of strings with which to initialise the control.} | |
68 | ||
69 | \docparam{style}{Window style. See \helpref{wxCheckListBox}{wxchecklistbox}.} | |
70 | ||
71 | \docparam{validator}{Window validator.} | |
72 | ||
73 | \docparam{name}{Window name.} | |
74 | ||
75 | \pythonnote{The wxCheckListBox constructor in wxPython reduces the {\tt n} | |
76 | and {\tt choices} arguments are to a single argument, which is | |
77 | a list of strings.} | |
78 | ||
79 | \membersection{wxCheckListBox::\destruct{wxCheckListBox}} | |
80 | ||
81 | \func{void}{\destruct{wxCheckListBox}}{\void} | |
82 | ||
83 | Destructor, destroying the list box. | |
84 | ||
85 | \membersection{wxCheckListBox::Check}\label{wxchecklistboxcheck} | |
86 | ||
87 | \func{void}{Check}{\param{int }{item}, \param{bool}{ check = TRUE}} | |
88 | ||
89 | Checks the given item. | |
90 | ||
91 | \wxheading{Parameters} | |
92 | ||
93 | \docparam{item}{Index of item to check.} | |
94 | ||
95 | \docparam{check}{TRUE if the item is to be checked, FALSE otherwise.} | |
96 | ||
97 | \membersection{wxCheckListBox::IsChecked}\label{wxchecklistboxischecked} | |
98 | ||
99 | \constfunc{bool}{IsChecked}{\param{int}{ item}} | |
100 | ||
101 | Returns TRUE if the given item is checked, FALSE otherwise. | |
102 | ||
103 | \wxheading{Parameters} | |
104 | ||
105 | \docparam{item}{Index of item whose check status is to be returned.} | |
106 | ||
107 |