X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4e28924cdb58dfbba0ec6cd5d52ef1346d0cb569..719493e14bd4c9222e64da2006ec496e7c0ba7b1:/docs/latex/wx/helpprov.tex diff --git a/docs/latex/wx/helpprov.tex b/docs/latex/wx/helpprov.tex index ba99934fa4..d7ccdf33ef 100644 --- a/docs/latex/wx/helpprov.tex +++ b/docs/latex/wx/helpprov.tex @@ -10,6 +10,10 @@ wxHelpProvider::Set(). No base class +\wxheading{Include files} + + + \wxheading{See also} \helpref{wxContextHelp}{wxcontexthelp}, \helpref{wxContextHelpButton}{wxcontexthelpbutton}, @@ -24,12 +28,13 @@ No base class Virtual destructor for any base class. -\membersection{wxHelpProvider::Set}\label{wxhelpproviderset} +\membersection{wxHelpProvider::AddHelp}\label{wxhelpprovideraddhelp} -\func{wxHelpProvider*}{Set}{\param{wxHelpProvider* }{helpProvider}} +\func{void}{AddHelp}{\param{wxWindowBase* }{window}, \param{const wxString\& }{text}} -Get/set the current, application-wide help provider. Returns -the previous one. +Associates the text with the given window or id. Although all help +providers have these functions to allow making \helpref{wxWindow::SetHelpText}{wxwindowsethelptext} +work, not all of them implement the functions. \membersection{wxHelpProvider::Get}\label{wxhelpproviderget} @@ -46,27 +51,34 @@ Gets the help string for this window. Its interpretation is dependent on the hel except that empty string always means that no help is associated with the window. -\membersection{wxHelpProvider::ShowHelp}\label{wxhelpprovidershowhelp} +\func{void}{AddHelp}{\param{wxWindowID }{id}, \param{const wxString\& }{text}} -\func{bool}{ShowHelp}{\param{wxWindowBase* }{window}} +This version associates the given text with all windows with this id. +May be used to set the same help string for all Cancel buttons in +the application, for example. -Shows help for the given window. Uses \helpref{GetHelp}{wxhelpprovidergethelp} internally if -applicable. +\membersection{wxHelpProvider::RemoveHelp}\label{wxhelpproviderremovehelp} -Returns TRUE if it was done, or FALSE if no help was available -for this window. +\func{void}{RemoveHelp}{\param{wxWindowBase* }{window}} -\membersection{wxHelpProvider::AddHelp}\label{wxhelpprovideraddhelp} +Removes the association between the window pointer and the help text. This is +called by the wxWindow destructor. Without this, the table of help strings will fill up +and when window pointers are reused, the wrong help string will be found. -\func{void}{AddHelp}{\param{wxWindowBase* }{window}, \param{const wxString\& }{text}} +\membersection{wxHelpProvider::Set}\label{wxhelpproviderset} -Associates the text with the given window or id. Although all help -providers have these functions to allow making \helpref{wxWindow::SetHelpText}{wxwindowsethelptext} -work, not all of them implement the functions. +\func{wxHelpProvider*}{Set}{\param{wxHelpProvider* }{helpProvider}} -\func{void}{AddHelp}{\param{wxWindowID }{id}, \param{const wxString\& }{text}} +Get/set the current, application-wide help provider. Returns +the previous one. -This version associates the given text with all windows with this id. -May be used to set the same help string for all Cancel buttons in -the application, for example. +\membersection{wxHelpProvider::ShowHelp}\label{wxhelpprovidershowhelp} + +\func{bool}{ShowHelp}{\param{wxWindowBase* }{window}} + +Shows help for the given window. Uses \helpref{GetHelp}{wxhelpprovidergethelp} internally if +applicable. + +Returns true if it was done, or false if no help was available +for this window.