X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/b52401b28745ff0e05e89d2fdddc5fe9596ccfa7..9f057af5efcd64383486a6d56b8a4703a0118abd:/docs/latex/wx/vlbox.tex?ds=sidebyside diff --git a/docs/latex/wx/vlbox.tex b/docs/latex/wx/vlbox.tex index 6e3b7c8a2a..be8dd54485 100644 --- a/docs/latex/wx/vlbox.tex +++ b/docs/latex/wx/vlbox.tex @@ -13,9 +13,9 @@ wxVListBox is a listbox-like control with the following two main differences from a regular listbox: it can have an arbitrarily huge number of items because -it doesn't store them itself but uses \helpref{OnDrawItem()}{wxvlistboxondrawitem} +it doesn't store them itself but uses \helpref{OnDrawItem()}{wxvlistboxondrawitem} callback to draw them (so it is a {\Large V}irtual listbox) and its items can -have variable height as determined by +have variable height as determined by \helpref{OnMeasureItem()}{wxvlistboxonmeasureitem} (so it is also a listbox with the lines of {\Large V}ariable height). @@ -28,10 +28,14 @@ derive your own class, such as \helpref{wxHtmlListBox}{wxhtmllistbox}, from it. However it emits the same events as \helpref{wxListBox}{wxlistbox} and the same event macros may be used with it. - + \wxheading{Derived from} -\helpref{wxVScrolledWindow}{wxvscrolledwindow} +\helpref{wxVScrolledWindow}{wxvscrolledwindow}\\ +\helpref{wxPanel}{wxpanel}\\ +\helpref{wxWindow}{wxwindow}\\ +\helpref{wxEvtHandler}{wxevthandler}\\ +\helpref{wxObject}{wxobject} \wxheading{Include files} @@ -62,11 +66,11 @@ Deletes all items from the control. \func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id = wxID\_ANY}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize}, \param{long }{style = 0}, \param{const wxString\& }{name = wxVListBoxNameStr}} -Creates the control. To finish creating it you also should call +Creates the control. To finish creating it you also should call \helpref{SetItemCount()}{wxvlistboxsetitemcount} to let it know about the number of items it contains. -The only special style which may be used with wxVListBox is {\tt wxLB\_MULTIPLE} +The only special style which may be used with wxVListBox is {\tt wxLB\_MULTIPLE} which indicates that the listbox should support multiple selection. Returns {\tt true} on success or {\tt false} if the control couldn't be created @@ -92,7 +96,7 @@ This method is only valid for multi selection listboxes. \constfunc{int}{GetFirstSelected}{\param{unsigned long\& }{cookie}} -Returns the index of the first selected item in the listbox or +Returns the index of the first selected item in the listbox or {\tt wxNOT\_FOUND} if no items are currently selected. \arg{cookie} is an opaque parameter which should be passed to the subsequent @@ -129,7 +133,7 @@ Get the number of items in the control. \constfunc{wxPoint}{GetMargins}{\void} Returns the margins used by the control. The {\tt x} field of the returned -point is the horizontal margine and the {\tt y} field is the vertical one. +point is the horizontal margin and the {\tt y} field is the vertical one. \wxheading{See also} @@ -170,7 +174,7 @@ may only return $0$ or $1$ however. \constfunc{int}{GetSelection}{\void} -Get the currently selected item or $-1$ if there is no selection. +Get the currently selected item or {\tt wxNOT\_FOUND} if there is no selection. \membersection{wxVListBox::GetSelectionBackground}\label{wxvlistboxgetselectionbackground} @@ -202,7 +206,7 @@ listbox. Returns {\tt true} if this item is the current one, {\tt false} otherwise. Current item is always the same as selected one for the single selection -listbox and in this case this method is equivalent to +listbox and in this case this method is equivalent to \helpref{IsSelected}{wxvlistboxisselected} but they are different for multi selection listboxes where many items may be selected but only one (at most) is current. @@ -282,7 +286,7 @@ equal to {\tt wxNOT\_FOUND}). Return {\tt true} if the items selection status has changed or {\tt false} otherwise. -This function is only valid for the multiple selection listboxes, use +This function is only valid for the multiple selection listboxes, use \helpref{SetSelection}{wxvlistboxsetselection} for the single selection ones. @@ -317,6 +321,7 @@ This method is only valid for multi selection listboxes. \helpref{SelectAll}{wxvlistboxselectall}, \helpref{Select}{wxvlistboxselect} +\membersection{wxVListBox::SetItemCount}\label{wxvlistboxsetitemcount} \func{void}{SetItemCount}{\param{size\_t }{count}} @@ -355,7 +360,7 @@ This method may be used both with single and multiple selection listboxes. \func{void}{SetSelectionBackground}{\param{const wxColour\& }{col}} Sets the colour to be used for the selected cells background. The background of -the standard cells may be changed by simply calling +the standard cells may be changed by simply calling \helpref{SetBackgroundColour}{wxwindowsetbackgroundcolour}. \wxheading{See also} @@ -375,4 +380,3 @@ This method is only valid for multi selection listboxes. \wxheading{See also} \helpref{Select}{wxvlistboxselect} -