docs/latex/wx/xmlresh.tex

   1 %
   2 % automatically generated by HelpGen $Revision$ from
   3 % xmlres.h at 22/Jan/02 23:08:28
   4 %
   5
   6 \section{\class{wxXmlResourceHandler}}\label{wxxmlresourcehandler}
   7
   8 wxXmlResourceHandler is an abstract base class for resource handlers
   9 capable of creating a control from an XML node.
  10
  11 See \helpref{XML-based resource system overview}{xrcoverview} for details.
  12
  13 \wxheading{Derived from}
  14
  15 \helpref{wxObject}{wxobject}
  16
  17 \wxheading{Include files}
  18
  19 <wx/xrc/xmlres.h>
  20
  21 \wxheading{Library}
  22
  23 \helpref{wxXrc}{librarieslist}
  24
  25 \latexignore{\rtfignore{\wxheading{Members}}}
  26
  27 \membersection{wxXmlResourceHandler::wxXmlResourceHandler}\label{wxxmlresourcehandlerctor}
  28
  29 \func{}{wxXmlResourceHandler}{\void}
  30
  31 Default constructor.
  32
  33 \membersection{wxXmlResourceHandler::\destruct{wxXmlResourceHandler}}\label{wxxmlresourcehandlerdtor}
  34
  35 \func{}{\destruct{wxXmlResourceHandler}}{\void}
  36
  37 Destructor.
  38
  39 \membersection{wxXmlResourceHandler::AddStyle}\label{wxxmlresourcehandleraddstyle}
  40
  41 \func{void}{AddStyle}{\param{const wxString\& }{name}, \param{int }{value}}
  42
  43 Add a style flag (e.g. wxMB\_DOCKABLE) to the list of flags
  44 understood by this handler.
  45
  46 \membersection{wxXmlResourceHandler::AddWindowStyles}\label{wxxmlresourcehandleraddwindowstyles}
  47
  48 \func{void}{AddWindowStyles}{\void}
  49
  50 Add styles common to all wxWindow-derived classes.
  51
  52 \membersection{wxXmlResourceHandler::CanHandle}\label{wxxmlresourcehandlercanhandle}
  53
  54 \func{bool}{CanHandle}{\param{wxXmlNode* }{node}}
  55
  56 Returns true if it understands this node and can create
  57 a resource from it, false otherwise.
  58
  59 \wxheading{Note}
  60
  61 You must {\bf not} call any wxXmlResourceHandler methods except
  62 \helpref{IsOfClass}{wxxmlresourcehandlerisofclass} from this method! The instance
  63 is not yet initialized with node data at the time CanHandle is called and it is only
  64 safe to operate on {\it node} directly or to call IsOfClass.
  65
  66 \membersection{wxXmlResourceHandler::CreateChildren}\label{wxxmlresourcehandlercreatechildren}
  67
  68 \func{void}{CreateChildren}{\param{wxObject* }{parent}, \param{bool }{this\_hnd\_only = false}}
  69
  70 Creates children.
  71
  72 \membersection{wxXmlResourceHandler::CreateChildrenPrivately}\label{wxxmlresourcehandlercreatechildrenprivately}
  73
  74 \func{void}{CreateChildrenPrivately}{\param{wxObject* }{parent}, \param{wxXmlNode* }{rootnode = NULL}}
  75
  76 Helper function.
  77
  78 \membersection{wxXmlResourceHandler::CreateResFromNode}\label{wxxmlresourcehandlercreateresfromnode}
  79
  80 \func{wxObject*}{CreateResFromNode}{\param{wxXmlNode* }{node}, \param{wxObject* }{parent}, \param{wxObject* }{instance = NULL}}
  81
  82 Creates a resource from a node.
  83
  84 \membersection{wxXmlResourceHandler::CreateResource}\label{wxxmlresourcehandlercreateresource}
  85
  86 \func{wxObject*}{CreateResource}{\param{wxXmlNode* }{node}, \param{wxObject* }{parent}, \param{wxObject* }{instance}}
  87
  88 Creates an object (menu, dialog, control, ...) from an XML node.
  89 Should check for validity. {\it parent} is a higher-level object (usually window, dialog or panel)
  90 that is often necessary to create the resource.
  91 If {\bf instance} is non-NULL it should not create a new instance via 'new' but
  92 should rather use this one, and call its Create method.
  93
  94 \membersection{wxXmlResourceHandler::DoCreateResource}\label{wxxmlresourcehandlerdocreateresource}
  95
  96 \func{wxObject*}{DoCreateResource}{\void}
  97
  98 Called from CreateResource after variables
  99 were filled.
 100
 101 \membersection{wxXmlResourceHandler::GetAnimation}\label{wxxmlresourcehandlergetanimation}
 102
 103 \func{wxAnimation}{GetAnimation}{\param{const wxString\& }{param = wxT("animation")}}
 104
 105 Creates a \helpref{animation}{wxanimation} from the filename specified in \arg{param}.
 106
 107 \membersection{wxXmlResourceHandler::GetBitmap}\label{wxxmlresourcehandlergetbitmap}
 108
 109 \func{wxBitmap}{GetBitmap}{\param{const wxString\& }{param = wxT("bitmap")}, \param{wxSize }{size = wxDefaultSize}}
 110
 111 Gets a bitmap.
 112
 113 \membersection{wxXmlResourceHandler::GetBool}\label{wxxmlresourcehandlergetbool}
 114
 115 \func{bool}{GetBool}{\param{const wxString\& }{param}, \param{bool }{defaultv = false}}
 116
 117 Gets a bool flag (1, t, yes, on, true are true, everything else is false).
 118
 119 \membersection{wxXmlResourceHandler::GetColour}\label{wxxmlresourcehandlergetcolour}
 120
 121 \func{wxColour}{GetColour}{\param{const wxString\& }{param}, \param{const wxColour\& }{default = wxNullColour}}
 122
 123 Gets colour in HTML syntax (\#RRGGBB).
 124
 125 \membersection{wxXmlResourceHandler::GetCurFileSystem}\label{wxxmlresourcehandlergetcurfilesystem}
 126
 127 \func{wxFileSystem\&}{GetCurFileSystem}{\void}
 128
 129 Returns the current file system.
 130
 131 \membersection{wxXmlResourceHandler::GetDimension}\label{wxxmlresourcehandlergetdimension}
 132
 133 \func{wxCoord}{GetDimension}{\param{const wxString\& }{param}, \param{wxCoord }{defaultv = 0}}
 134
 135 Gets a dimension (may be in dialog units).
 136
 137 \membersection{wxXmlResourceHandler::GetFont}\label{wxxmlresourcehandlergetfont}
 138
 139 \func{wxFont}{GetFont}{\param{const wxString\& }{param = wxT("font")}}
 140
 141 Gets a font.
 142
 143 \membersection{wxXmlResourceHandler::GetID}\label{wxxmlresourcehandlergetid}
 144
 145 \func{int}{GetID}{\void}
 146
 147 Returns the XRCID.
 148
 149 \membersection{wxXmlResourceHandler::GetIcon}\label{wxxmlresourcehandlergeticon}
 150
 151 \func{wxIcon}{GetIcon}{\param{const wxString\& }{param = wxT("icon")}, \param{wxSize }{size = wxDefaultSize}}
 152
 153 Returns an icon.
 154
 155 \membersection{wxXmlResourceHandler::GetLong}\label{wxxmlresourcehandlergetlong}
 156
 157 \func{long}{GetLong}{\param{const wxString\& }{param}, \param{long }{defaultv = 0}}
 158
 159 Gets the integer value from the parameter.
 160
 161 \membersection{wxXmlResourceHandler::GetName}\label{wxxmlresourcehandlergetname}
 162
 163 \func{wxString}{GetName}{\void}
 164
 165 Returns the resource name.
 166
 167 \membersection{wxXmlResourceHandler::GetNodeContent}\label{wxxmlresourcehandlergetnodecontent}
 168
 169 \func{wxString}{GetNodeContent}{\param{wxXmlNode* }{node}}
 170
 171 Gets node content from wxXML\_ENTITY\_NODE.
 172
 173 \membersection{wxXmlResourceHandler::GetParamNode}\label{wxxmlresourcehandlergetparamnode}
 174
 175 \func{wxXmlNode*}{GetParamNode}{\param{const wxString\& }{param}}
 176
 177 Finds the node or returns NULL.
 178
 179 \membersection{wxXmlResourceHandler::GetParamValue}\label{wxxmlresourcehandlergetparamvalue}
 180
 181 \func{wxString}{GetParamValue}{\param{const wxString\& }{param}}
 182
 183 Finds the parameter value or returns the empty string.
 184
 185 \membersection{wxXmlResourceHandler::GetPosition}\label{wxxmlresourcehandlergetposition}
 186
 187 \func{wxPoint}{GetPosition}{\param{const wxString\& }{param = wxT("pos")}}
 188
 189 Gets the position (may be in dialog units).
 190
 191 \membersection{wxXmlResourceHandler::GetSize}\label{wxxmlresourcehandlergetsize}
 192
 193 \func{wxSize}{GetSize}{\param{const wxString\& }{param = wxT("size")}}
 194
 195 Gets the size (may be in dialog units).
 196
 197 \membersection{wxXmlResourceHandler::GetStyle}\label{wxxmlresourcehandlergetstyle}
 198
 199 \func{int}{GetStyle}{\param{const wxString\& }{param = wxT("style")}, \param{int }{defaults = 0}}
 200
 201 Gets style flags from text in form "flag | flag2| flag3 |..."
 202 Only understands flags added with AddStyle.
 203
 204 \membersection{wxXmlResourceHandler::GetText}\label{wxxmlresourcehandlergettext}
 205
 206 \func{wxString}{GetText}{\param{const wxString\& }{param}}
 207
 208 Gets text from param and does some conversions:
 209
 210 \begin{itemize}\itemsep=0pt
 211 \item replaces $\backslash$n, $\backslash$r, $\backslash$t by respective characters (according to C syntax)
 212 \item replaces {\tt\$} by {\tt\&} and {\tt\$\$} by {\tt\$} (needed for {\tt\_File} to {\tt\&File}
 213 translation because of XML syntax)
 214 \item calls wxGetTranslations (unless disabled in wxXmlResource)
 215 \end{itemize}
 216
 217 \membersection{wxXmlResourceHandler::HasParam}\label{wxxmlresourcehandlerhasparam}
 218
 219 \func{bool}{HasParam}{\param{const wxString\& }{param}}
 220
 221 Check to see if a parameter exists.
 222
 223 \membersection{wxXmlResourceHandler::IsOfClass}\label{wxxmlresourcehandlerisofclass}
 224
 225 \func{bool}{IsOfClass}{\param{wxXmlNode* }{node}, \param{const wxString\& }{classname}}
 226
 227 Convenience function. Returns true if the node has a property class equal to classname,
 228 e.g. <object class="wxDialog">.
 229
 230 \membersection{wxXmlResourceHandler::SetParentResource}\label{wxxmlresourcehandlersetparentresource}
 231
 232 \func{void}{SetParentResource}{\param{wxXmlResource* }{res}}
 233
 234 Sets the parent resource.
 235
 236 \membersection{wxXmlResourceHandler::SetupWindow}\label{wxxmlresourcehandlersetupwindow}
 237
 238 \func{void}{SetupWindow}{\param{wxWindow* }{wnd}}
 239
 240 Sets common window options.
 241