X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/801a492c49f0e4641046b4fbb3f2d18111b1b387..a947a1e5e8a15b76d142eb91cb08e2e9ffb95def:/docs/latex/wx/choice.tex?ds=sidebyside diff --git a/docs/latex/wx/choice.tex b/docs/latex/wx/choice.tex index 80099cfac4..7ef251b085 100644 --- a/docs/latex/wx/choice.tex +++ b/docs/latex/wx/choice.tex @@ -6,6 +6,7 @@ menu of choices. \wxheading{Derived from} +\helpref{wxControlWithItems}{wxcontrolwithitems}\\ \helpref{wxControl}{wxcontrol}\\ \helpref{wxWindow}{wxwindow}\\ \helpref{wxEvtHandler}{wxevthandler}\\ @@ -36,7 +37,7 @@ 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} @@ -47,6 +48,11 @@ Default constructor. \param{int}{ n}, \param{const wxString }{choices[]},\rtfsp \param{long}{ style = 0}, \param{const wxValidator\& }{validator = wxDefaultValidator}, \param{const wxString\& }{name = ``choice"}} +\func{}{wxChoice}{\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 = ``choice"}} + Constructor, creating and showing a choice. \wxheading{Parameters} @@ -81,48 +87,27 @@ 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::Append}\label{wxchoiceappend} - -\func{int}{Append}{\param{const wxString\& }{ item}} - -Adds the item to the end of the choice control. - -\func{int}{Append}{\param{const wxString\& }{ item}, \param{void* }{clientData}} - -Adds the item to the end of the combobox, associating the given data -with the item. - -\wxheading{Parameters} - -\docparam{item}{String to add.} - -\docparam{clientData}{Client data to associate with the item.} - -\wxheading{Return value} - -The index of the newly added item, may be different from the last one if the -control has {\tt wxLB\_SORT} style. - -\membersection{wxChoice::Clear}\label{wxchoiceclear} - -\func{void}{Clear}{\void} - -Clears the strings from 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"}} -Creates the choice for two-step construction. See \helpref{wxChoice::wxChoice}{wxchoiceconstr}. +\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 wxValidator\& }{validator = wxDefaultValidator},\rtfsp +\param{const wxString\& }{name = ``choice"}} + +Creates the choice for two-step construction. See \helpref{wxChoice::wxChoice}{wxchoicector}. \membersection{wxChoice::Delete}\label{wxchoicedelete} @@ -134,20 +119,6 @@ Deletes the item with the given index from the control. \docparam{n}{The item to delete.} -\membersection{wxChoice::FindString}\label{wxchoicefindstring} - -\constfunc{int}{FindString}{\param{const wxString\& }{string}} - -Finds a choice matching the given string. - -\wxheading{Parameters} - -\docparam{string}{String to find.} - -\wxheading{Return value} - -Returns the position if found, or -1 if not found. - \membersection{wxChoice::GetColumns}\label{wxchoicegetcolumns} \constfunc{int}{GetColumns}{\void} @@ -156,77 +127,8 @@ Gets the number of columns in this choice item. \wxheading{Remarks} -This is implemented for Motif only. - -\membersection{wxChoice::GetClientData}\label{wxchoicegetclientdata} - -\constfunc{void*}{GetClientData}{\param{int}{ n}} - -Returns a pointer to the client data associated with the given item (if any). - -\wxheading{Parameters} - -\docparam{n}{An item, starting from zero.} - -\wxheading{Return value} - -A pointer to the client data, or NULL if the item was not found. - -\membersection{wxChoice::GetCount}\label{wxchoicegetcount} - -\constfunc{int}{GetCount}{\void} - -Returns the number of items in the choice. - -\membersection{wxChoice::GetSelection}\label{wxchoicegetselection} - -\constfunc{int}{GetSelection}{\void} - -Gets the id (position) of the selected string, or -1 if there is no selection. - -\membersection{wxChoice::GetString}\label{wxchoicegetstring} - -\constfunc{wxString}{GetString}{\param{int}{ n}} - -Returns the string at the given position. - -\wxheading{Parameters} - -\docparam{n}{The zero-based position.} - -\wxheading{Return value} - -The string at the given position, or the empty string if {\it n} is invalid. - -\membersection{wxChoice::GetStringSelection}\label{wxchoicegetstringselection} - -\constfunc{wxString}{GetStringSelection}{\void} - -Gets the selected string, or the empty string if no string is selected. - -\membersection{wxChoice::Number}\label{wxchoicenumber} - -\constfunc{int}{Number}{\void} - -{\bf Obsolescence note:} This method is obsolete and was replaced with -\helpref{GetCount}{wxchoicegetcount}, please use the new method in the new -code. This method is only available if wxWindows was compiled with -{\tt WXWIN\_COMPATIBILITY\_2\_2} defined and will disappear completely in -future versions. - -Returns the number of strings in the choice control. - -\membersection{wxChoice::SetClientData}\label{wxchoicesetclientdata} - -\func{void}{SetClientData}{\param{int}{ n}, \param{void* }{data}} - -Associates the given client data pointer with the given item. - -\wxheading{Parameters} - -\docparam{n}{The zero-based item.} - -\docparam{data}{The client data.} +This is implemented for Motif only and always returns $1$ for the other +platforms. \membersection{wxChoice::SetColumns}\label{wxchoicesetcolumns} @@ -240,50 +142,6 @@ Sets the number of columns in this choice item. \wxheading{Remarks} -This is implemented for Motif only. - -\membersection{wxChoice::SetSelection}\label{wxchoicesetselection} - -\func{void}{SetSelection}{\param{int}{ n}} - -Sets the choice by passing the desired string position. This does not cause -a wxEVT\_COMMAND\_CHOICE\_SELECTED event to get emitted. - -\wxheading{Parameters} - -\docparam{n}{The string position to select, starting from zero.} - -\wxheading{See also} - -\membersection{wxChoice::SetString}\label{wxchoicesetstring} - -\func{void}{SetString}{\param{int }{n}, \param{const wxString\& }{text}} - -Replaces the specified string in the control with another one. - -\wxheading{Parameters} - -\docparam{n}{The zero-based index of the string to replace} - -\docparam{text}{The new value for this item} - -{\bf NB:} This method is currently not implemented in wxGTK. - -\helpref{wxChoice::SetStringSelection}{wxchoicesetstringselection} - -\membersection{wxChoice::SetStringSelection}\label{wxchoicesetstringselection} - -\func{void}{SetStringSelection}{\param{const wxString\& }{ string}} - -Sets the choice by passing the desired string. This does not cause -a wxEVT\_COMMAND\_CHOICE\_SELECTED event to get emitted. - -\wxheading{Parameters} - -\docparam{string}{The string to select.} - -\wxheading{See also} - -\helpref{wxChoice::SetSelection}{wxchoicesetselection} - +This is implemented for Motif only and doesn't do anything under other +platforms.