X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/dd3c394ae4e6f6a0041b69e036d4fdf0a085fe39..9cc73180521b0df3d99ad2003e74acbe126d8c81:/docs/latex/wx/checklst.tex?ds=sidebyside diff --git a/docs/latex/wx/checklst.tex b/docs/latex/wx/checklst.tex index fbb5812bd7..5795f09f35 100644 --- a/docs/latex/wx/checklst.tex +++ b/docs/latex/wx/checklst.tex @@ -3,10 +3,13 @@ A checklistbox is like a listbox, but allows items to be checked or unchecked. This class is currently implemented under Windows and GTK. When using this -class under Windows wxWindows must be compiled with USE\_OWNER\_DRAWN set to 1. +class under Windows wxWidgets must be compiled with USE\_OWNER\_DRAWN set to 1. Only the new functions for this class are documented; see also \helpref{wxListBox}{wxlistbox}. +Please note that wxCheckListBox uses client data in its implementation, +and therefore this is not available to the application. + \wxheading{Derived from} \helpref{wxListBox}{wxlistbox}\\ @@ -27,7 +30,7 @@ See \helpref{wxListBox}{wxlistbox}. \twocolwidtha{7cm} \begin{twocollist}\itemsep=0pt -\twocolitem{{\bf EVT\_CHECKLISTBOX(id, func)}}{Process a wxEVT\_COMMAND\_CHECKLISTBOX\_TOGGLE event, +\twocolitem{{\bf EVT\_CHECKLISTBOX(id, func)}}{Process a wxEVT\_COMMAND\_CHECKLISTBOX\_TOGGLED event, when an item in the check list box is checked or unchecked.} \end{twocollist} @@ -38,7 +41,7 @@ when an item in the check list box is checked or unchecked.} \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxCheckListBox::wxCheckListBox}\label{wxchecklistboxconstr} +\membersection{wxCheckListBox::wxCheckListBox}\label{wxchecklistboxctor} \func{}{wxCheckListBox}{\void} @@ -49,6 +52,11 @@ Default constructor. \param{int}{ n}, \param{const wxString }{choices[] = NULL},\rtfsp \param{long}{ style = 0}, \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``listBox"}} +\func{}{wxCheckListBox}{\param{wxWindow*}{ parent}, \param{wxWindowID}{ id},\rtfsp +\param{const wxPoint\&}{ pos}, \param{const wxSize\&}{ size},\rtfsp +\param{const wxArrayString\& }{choices},\rtfsp +\param{long}{ style = 0}, \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``listBox"}} + Constructor, creating and showing a list box. \wxheading{Parameters} @@ -72,11 +80,14 @@ appropriately.} \docparam{name}{Window name.} -\pythonnote{The wxCheckListBox constructor in wxPython reduces the \tt{n} -and \tt{choices} arguments are to a single argument, which is +\pythonnote{The wxCheckListBox constructor in wxPython reduces the {\tt n} +and {\tt choices} arguments are to a single argument, which is a list of strings.} -\membersection{wxCheckListBox::\destruct{wxCheckListBox}} +\perlnote{In wxPerl there is just an array reference in place of {\tt n} +and {\tt choices}.} + +\membersection{wxCheckListBox::\destruct{wxCheckListBox}}\label{wxchecklistboxdtor} \func{void}{\destruct{wxCheckListBox}}{\void} @@ -84,21 +95,22 @@ Destructor, destroying the list box. \membersection{wxCheckListBox::Check}\label{wxchecklistboxcheck} -\func{void}{Check}{\param{int }{item}, \param{bool}{ check = TRUE}} +\func{void}{Check}{\param{int }{item}, \param{bool}{ check = true}} -Checks the given item. +Checks the given item. Note that calling this method doesn't result in +wxEVT\_COMMAND\_CHECKLISTBOX\_TOGGLE being emitted. \wxheading{Parameters} \docparam{item}{Index of item to check.} -\docparam{check}{TRUE if the item is to be checked, FALSE otherwise.} +\docparam{check}{true if the item is to be checked, false otherwise.} \membersection{wxCheckListBox::IsChecked}\label{wxchecklistboxischecked} \constfunc{bool}{IsChecked}{\param{int}{ item}} -Returns TRUE if the given item is checked, FALSE otherwise. +Returns true if the given item is checked, false otherwise. \wxheading{Parameters}