X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/56b88f1276ea4049a21f6174842b56ca9f280a3f..d60156ac9d764d9ee6cf866a87084732d341abb9:/docs/latex/wx/choice.tex diff --git a/docs/latex/wx/choice.tex b/docs/latex/wx/choice.tex index 6db8e3e733..b4a3c2337c 100644 --- a/docs/latex/wx/choice.tex +++ b/docs/latex/wx/choice.tex @@ -1,3 +1,14 @@ +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Name: treectrl.tex +%% Purpose: wxChoice documentation +%% Author: wxWidgets Team +%% Modified by: +%% Created: +%% RCS-ID: $Id$ +%% Copyright: (c) wxWidgets Team +%% License: wxWindows license +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \section{\class{wxChoice}}\label{wxchoice} A choice item is used to select one of a list of strings. Unlike a @@ -37,7 +48,8 @@ when an item on the list is selected.} \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxChoice::wxChoice}\label{wxchoiceconstr} + +\membersection{wxChoice::wxChoice}\label{wxchoicector} \func{}{wxChoice}{\void} @@ -87,35 +99,30 @@ a list of strings.} \perlnote{In wxPerl there is just an array reference in place of {\tt n} and {\tt choices}.} -\membersection{wxChoice::\destruct{wxChoice}} + +\membersection{wxChoice::\destruct{wxChoice}}\label{wxchoicedtor} \func{}{\destruct{wxChoice}}{\void} Destructor, destroying the choice item. + \membersection{wxChoice::Create}\label{wxchoicecreate} \func{bool}{Create}{\param{wxWindow *}{parent}, \param{wxWindowID}{ id},\rtfsp \param{const wxPoint\& }{pos}, \param{const wxSize\&}{ size},\rtfsp \param{int}{ n}, \param{const wxString }{choices[]},\rtfsp -\param{long}{ style = 0}, \param{const wxString\& }{name = ``choice"}} +\param{long}{ style = 0}, \param{const wxValidator\& }{validator = wxDefaultValidator},\rtfsp +\param{const wxString\& }{name = ``choice"}} \func{bool}{Create}{\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 wxString\& }{name = ``choice"}} +\param{long}{ style = 0}, \param{const wxValidator\& }{validator = wxDefaultValidator},\rtfsp +\param{const wxString\& }{name = ``choice"}} -Creates the choice for two-step construction. See \helpref{wxChoice::wxChoice}{wxchoiceconstr}. +Creates the choice for two-step construction. See \helpref{wxChoice::wxChoice}{wxchoicector}. -\membersection{wxChoice::Delete}\label{wxchoicedelete} - -\func{void}{Delete}{\param{int }{n}} - -Deletes the item with the given index from the control. - -\wxheading{Parameters} - -\docparam{n}{The item to delete.} \membersection{wxChoice::GetColumns}\label{wxchoicegetcolumns} @@ -128,6 +135,23 @@ Gets the number of columns in this choice item. This is implemented for Motif only and always returns $1$ for the other platforms. + +\membersection{wxChoice::GetCurrentSelection}\label{wxchoicegetcurrentselection} + +\constfunc{int}{GetCurrentSelection}{\void} + +Unlike \helpref{GetSelection}{wxcontrolwithitemsgetselection} which only +returns the accepted selection value, i.e. the selection in the control once +the user closes the dropdown list, this function returns the current selection. +That is, while the dropdown list is shown, it returns the currently selected +item in it. When it is not shown, its result is the same as for the other +function. + +\newsince{2.6.2} (before this version +\helpref{GetSelection}{wxcontrolwithitemsgetselection} itself behaved like +this). + + \membersection{wxChoice::SetColumns}\label{wxchoicesetcolumns} \func{void}{SetColumns}{\param{int}{ n = 1}}