From 4fcbc84d657413b157ac3ef89bf8fbccbcf899ba Mon Sep 17 00:00:00 2001 From: Julian Smart Date: Mon, 13 Aug 2007 17:18:32 +0000 Subject: [PATCH] Documented new menu label functions git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@48055 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- docs/latex/wx/menu.tex | 97 +++++++++++++++++++++++++++++++++++++- docs/latex/wx/menuitem.tex | 61 +++++++++++++++++++++++- 2 files changed, 155 insertions(+), 3 deletions(-) diff --git a/docs/latex/wx/menu.tex b/docs/latex/wx/menu.tex index 80dd3c0e08..824d341009 100644 --- a/docs/latex/wx/menu.tex +++ b/docs/latex/wx/menu.tex @@ -435,9 +435,27 @@ The item label, or the empty string if the item was not found. \wxheading{See also} -\helpref{wxMenu::SetLabel}{wxmenusetlabel} +\helpref{wxMenu::GetLabelText}{wxmenugetlabeltext}, \helpref{wxMenu::SetLabel}{wxmenusetlabel} +\membersection{wxMenu::GetLabelText}\label{wxmenugetlabeltext} + +\constfunc{wxString}{GetLabelText}{\param{int}{ id}} + +Returns a menu item label, without any of the original mnemonics and accelerators. + +\wxheading{Parameters} + +\docparam{id}{The menu item identifier.} + +\wxheading{Return value} + +The item label, or the empty string if the item was not found. + +\wxheading{See also} + +\helpref{wxMenu::GetLabel}{wxmenugetlabel}, \helpref{wxMenu::SetLabel}{wxmenusetlabel} + \membersection{wxMenu::GetMenuItemCount}\label{wxmenugetmenuitemcount} \constfunc{size\_t}{GetMenuItemCount}{\void} @@ -462,7 +480,7 @@ Returns the title of the menu. \wxheading{Remarks} This is relevant only to popup menus, use -\helpref{wxMenuBar::GetLabelTop}{wxmenubargetlabeltop} for the menus in the +\helpref{wxMenuBar::GetMenuLabel}{wxmenubargetmenulabel} for the menus in the menubar. \wxheading{See also} @@ -962,6 +980,8 @@ The menu label, or the empty string if the menu was not found. Use only after the menubar has been associated with a frame. +This function is deprecated in favour of \helpref{GetMenuLabel}{wxmenubargetmenulabel} and \helpref{GetMenuLabelText}{wxmenubargetmenulabeltext}. + \wxheading{See also} \helpref{wxMenuBar::SetLabelTop}{wxmenubarsetlabeltop} @@ -981,6 +1001,56 @@ Returns the menu at {\it menuIndex} (zero-based). Returns the number of menus in this menubar. +\membersection{wxMenuBar::GetMenuLabel}\label{wxmenubargetmenulabel} + +\constfunc{wxString}{GetMenuLabel}{\param{int}{ pos}} + +Returns the label of a top-level menu. Note that the returned string +includes the accelerator characters that have been specified in the menu +title string during its construction. + +\wxheading{Parameters} + +\docparam{pos}{Position of the menu on the menu bar, starting from zero.} + +\wxheading{Return value} + +The menu label, or the empty string if the menu was not found. + +\wxheading{Remarks} + +Use only after the menubar has been associated with a frame. + +\wxheading{See also} + +\helpref{wxMenuBar::GetMenuLabelText}{wxmenubargetmenulabeltext}, \helpref{wxMenuBar::SetMenuLabel}{wxmenubarsetmenulabel} + + +\membersection{wxMenuBar::GetMenuLabelText}\label{wxmenubargetmenulabeltext} + +\constfunc{wxString}{GetMenuLabelText}{\param{int}{ pos}} + +Returns the label of a top-level menu. Note that the returned string does not +include any accelerator characters that may have been specified in the menu +title string during its construction. + +\wxheading{Parameters} + +\docparam{pos}{Position of the menu on the menu bar, starting from zero.} + +\wxheading{Return value} + +The menu label, or the empty string if the menu was not found. + +\wxheading{Remarks} + +Use only after the menubar has been associated with a frame. + +\wxheading{See also} + +\helpref{wxMenuBar::GetMenuLabel}{wxmenubargetmenulabel}, \helpref{wxMenuBar::SetMenuLabel}{wxmenubarsetmenulabel} + + \membersection{wxMenuBar::Insert}\label{wxmenubarinsert} \func{bool}{Insert}{\param{size\_t }{pos}, \param{wxMenu *}{menu}, \param{const wxString\& }{title}} @@ -1137,7 +1207,30 @@ Sets the label of a top-level menu. Use only after the menubar has been associated with a frame. +This function has been deprecated in favour of \helpref{SetMenuLabel}{wxmenubarsetmenulabel}. + \wxheading{See also} \helpref{wxMenuBar::GetLabelTop}{wxmenubargetlabeltop} + +\membersection{wxMenuBar::SetMenuLabel}\label{wxmenubarsetmenulabel} + +\func{void}{SetMenuLabel}{\param{int}{ pos}, \param{const wxString\& }{label}} + +Sets the label of a top-level menu. + +\wxheading{Parameters} + +\docparam{pos}{The position of a menu on the menu bar, starting from zero.} + +\docparam{label}{The menu label.} + +\wxheading{Remarks} + +Use only after the menubar has been associated with a frame. + +\wxheading{See also} + +\helpref{wxMenuBar::GetMenuLabel}{wxmenubargetmenulabel}, \helpref{wxMenuBar::GetMenuLabelText}{wxmenubargetmenulabeltext} + diff --git a/docs/latex/wx/menuitem.tex b/docs/latex/wx/menuitem.tex index 02dca14d64..430d5e4e24 100644 --- a/docs/latex/wx/menuitem.tex +++ b/docs/latex/wx/menuitem.tex @@ -153,6 +153,32 @@ Returns the help string associated with the menu item. Returns the menu item identifier. +\membersection{wxMenuItem::GetItemLabel}\label{wxmenuitemgetitemlabel} + +\constfunc{wxString}{GetItemLabel}{\void} + +Returns the text associated with the menu item including any accelerator +characters that were passed to the constructor or SetItemLabel. + +\wxheading{See also} + +\helpref{GetItemLabelText}{wxmenuitemgetitemlabeltext}, +\helpref{GetLabelText}{wxmenuitemgetlabeltext} + + +\membersection{wxMenuItem::GetItemLabelText}\label{wxmenuitemgetitemlabeltext} + +\constfunc{wxString}{GetItemLabelText}{\void} + +Returns the text associated with the menu item, without any accelerator +characters. + +\wxheading{See also} + +\helpref{GetItemLabel}{wxmenuitemgetitemlabel}, +\helpref{GetLabelText}{wxmenuitemgetlabeltext} + + \membersection{wxMenuItem::GetKind}\label{wxmenuitemgetkind} \constfunc{wxItemKind}{GetKind}{\void} @@ -168,11 +194,31 @@ Returns the item kind, one of {\tt wxITEM\_SEPARATOR}, {\tt wxITEM\_NORMAL}, Returns the text associated with the menu item without any accelerator characters it might contain. +This function is deprecated in favour of \helpref{GetItemLabelText}{wxmenuitemgetitemlabeltext}. + \wxheading{See also} \helpref{GetText}{wxmenuitemgettext}, \helpref{GetLabelFromText}{wxmenuitemgetlabelfromtext} +\membersection{wxMenuItem::GetLabelText}\label{wxmenuitemgetlabeltext} + +\func{static wxString}{GetLabelText}{\param{const wxString\& }{text}} + +Strips all accelerator characters and mnemonics from the given {\it text}. +For example, + +\begin{verbatim} +wxMenuItem::GetLabelFromText("&Hello\tCtrl-H"); +\end{verbatim} + +will return just {\tt "Hello"}. + +\wxheading{See also} + +\helpref{GetItemLabelText}{wxmenuitemgetitemlabeltext}, +\helpref{GetItemLabel}{wxmenuitemgetitemlabel} + \membersection{wxMenuItem::GetLabelFromText}\label{wxmenuitemgetlabelfromtext} @@ -187,6 +233,8 @@ wxMenuItem::GetLabelFromText("&Hello\tCtrl-H"); will return just {\tt "Hello"}. +This function is deprecated; please use \helpref{wxMenuItem::GetLabelText}{wxmenuitemgetlabeltext} instead. + \wxheading{See also} \helpref{GetText}{wxmenuitemgettext}, @@ -214,7 +262,7 @@ Returns the menu this menu item is in, or NULL if this menu item is not attached Returns the text associated with the menu item. {\bf NB:} this function is deprecated, please use -\helpref{GetText}{wxmenuitemgettext} or \helpref{GetLabel}{wxmenuitemgetlabel} +\helpref{GetItemLabel}{wxmenuitemgetitemlabel} or \helpref{GetItemLabelText}{wxmenuitemgetitemlabeltext} instead. @@ -225,6 +273,8 @@ instead. Returns the text associated with the menu item, such as it was passed to the wxMenuItem constructor, i.e. with any accelerator characters it may contain. +This function is deprecated in favour of \helpref{GetItemLabel}{wxmenuitemgetitemlabel}. + \wxheading{See also} \helpref{GetLabel}{wxmenuitemgetlabel}, @@ -318,6 +368,13 @@ Sets the font associated with the menu item (Windows only). Sets the help string. +\membersection{wxMenuItem::SetItemLabel}\label{wxmenuitemsetitemlabel} + +\func{void}{SetItemLabel}{\param{const wxString\& }{label}} + +Sets the label associated with the menu item. + + \membersection{wxMenuItem::SetMarginWidth}\label{wxmenuitemsetmarginwidth} \constfunc{void}{SetMarginWidth}{\param{int}{ width}} @@ -345,6 +402,8 @@ Sets the submenu of this menu item. Sets the text associated with the menu item. +This function is deprecated in favour of \helpref{SetItemLabel}{wxmenuitemsetitemlabel}. + \membersection{wxMenuItem::SetTextColour}\label{wxmenuitemsettextcolour}