docs/latex/wx/helpprov.tex

   1 \section{\class{wxHelpProvider}}\label{wxhelpprovider}
   2
   3 wxHelpProvider is an abstract class used by a program implementing context-sensitive help to
   4 show the help text for the given window.
   5
   6 The current help provider must be explicitly set by the application using
   7 wxHelpProvider::Set().
   8
   9 \wxheading{Derived from}
  10
  11 No base class
  12
  13 \wxheading{See also}
  14
  15 \helpref{wxHelpContext}{wxhelpcontext}, \helpref{wxHelpContextButton}{wxhelpcontextbutton},
  16 \helpref{wxSimpleHelpProvider}{wxsimplehelpprovider}, \helpref{wxHelpControllerHelpProvider}{wxhelpcontrollerhelpprovider},
  17 \helpref{wxWindow::SetHelpText}{wxwindowsethelptext}, \helpref{wxWindow::GetHelpText}{wxwindowgethelptext}
  18
  19 \latexignore{\rtfignore{\wxheading{Members}}}
  20
  21 \membersection{wxHelpProvider::\destruct{wxHelpProvider}}\label{wxhelpproviderdtor}
  22
  23 \func{}{\destruct{wxHelpProvider}}{\void}
  24
  25 Virtual destructor for any base class.
  26
  27 \membersection{wxHelpProvider::Set}\label{wxhelpproviderset}
  28
  29 \func{wxHelpProvider*}{Set}{\param{wxHelpProvider* }{helpProvider}}
  30
  31 Get/set the current, application-wide help provider. Returns
  32 the previous one.
  33
  34 \membersection{wxHelpProvider::Get}\label{wxhelpproviderget}
  35
  36 \func{wxHelpProvider*}{Get}{\void}
  37
  38 Unlike some other classes, the help provider is not created on demand.
  39 This must be explicitly done by the application.
  40
  41 \membersection{wxHelpProvider::GetHelp}\label{wxhelpprovidergethelp}
  42
  43 \func{wxString}{GetHelp}{\param{const wxWindowBase* }{window}}
  44
  45 Gets the help string for this window. Its interpretation is dependent on the help provider
  46 except that empty string always means that no help is associated with
  47 the window.
  48
  49 \membersection{wxHelpProvider::ShowHelp}\label{wxhelpprovidershowhelp}
  50
  51 \func{bool}{ShowHelp}{\param{wxWindowBase* }{window}}
  52
  53 Shows help for the given window. Uses \helpref{GetHelp}{wxhelpprovidergethelp} internally if
  54 applicable.
  55
  56 Returns TRUE if it was done, or FALSE if no help was available
  57 for this window.
  58
  59 \membersection{wxHelpProvider::AddHelp}\label{wxhelpprovideraddhelp}
  60
  61 \func{void}{AddHelp}{\param{wxWindowBase* }{window}, \param{const wxString\& }{text}}
  62
  63 Associates the text with the given window or id. Although all help
  64 providers have these functions to allow making \helpref{wxWindow::SetHelpText}{wxwindowsethelptext}
  65 work, not all of them implement the functions.
  66
  67 \membersection{wxHelpProvider::AddHelp}\label{wxhelpprovideraddhelp}
  68
  69 \func{void}{AddHelp}{\param{wxWindowID }{id}, \param{const wxString\& }{text}}
  70
  71 This version associates the given text with all windows with this id.
  72 May be used to set the same help string for all Cancel buttons in
  73 the application, for example.
  74