docs/latex/wx/doctempl.tex

   1 \section{\class{wxDocTemplate}}\label{wxdoctemplate}
   2
   3 The wxDocTemplate class is used to model the relationship between a
   4 document class and a view class.
   5
   6 \wxheading{Derived from}
   7
   8 \helpref{wxObject}{wxobject}
   9
  10 \wxheading{Include files}
  11
  12 <wx/docview.h>
  13
  14 \wxheading{See also}
  15
  16 \helpref{wxDocTemplate overview}{wxdoctemplateoverview}, \helpref{wxDocument}{wxdocument}, \helpref{wxView}{wxview}
  17
  18 \latexignore{\rtfignore{\wxheading{Members}}}
  19
  20 \membersection{wxDocTemplate::m\_defaultExt}
  21
  22 \member{wxString}{m\_defaultExt}
  23
  24 The default extension for files of this type.
  25
  26 \membersection{wxDocTemplate::m\_description}
  27
  28 \member{wxString}{m\_description}
  29
  30 A short description of this template.
  31
  32 \membersection{wxDocTemplate::m\_directory}
  33
  34 \member{wxString}{m\_directory}
  35
  36 The default directory for files of this type.
  37
  38 \membersection{wxDocTemplate::m\_docClassInfo}
  39
  40 \member{wxClassInfo* }{m\_docClassInfo}
  41
  42 Run-time class information that allows document instances to be constructed dynamically.
  43
  44 \membersection{wxDocTemplate::m\_docTypeName}
  45
  46 \member{wxString}{m\_docTypeName}
  47
  48 The named type of the document associated with this template.
  49
  50 \membersection{wxDocTemplate::m\_documentManager}
  51
  52 \member{wxDocTemplate*}{m\_documentManager}
  53
  54 A pointer to the document manager for which this template was created.
  55
  56 \membersection{wxDocTemplate::m\_fileFilter}
  57
  58 \member{wxString}{m\_fileFilter}
  59
  60 The file filter (such as {\tt *.txt}) to be used in file selector dialogs.
  61
  62 \membersection{wxDocTemplate::m\_flags}
  63
  64 \member{long}{m\_flags}
  65
  66 The flags passed to the constructor.
  67
  68 \membersection{wxDocTemplate::m\_viewClassInfo}
  69
  70 \member{wxClassInfo*}{m\_viewClassInfo}
  71
  72 Run-time class information that allows view instances to be constructed dynamically.
  73
  74 \membersection{wxDocTemplate::m\_viewTypeName}
  75
  76 \member{wxString}{m\_viewTypeName}
  77
  78 The named type of the view associated with this template.
  79
  80 \membersection{wxDocTemplate::wxDocTemplate}
  81
  82 \func{}{wxDocTemplate}{\param{wxDocManager* }{manager}, \param{const wxString\& }{descr}, \param{const wxString\& }{filter},
  83  \param{const wxString\& }{dir}, \param{const wxString\& }{ext}, \param{const wxString\& }{docTypeName},
  84  \param{const wxString\& }{viewTypeName}, \param{wxClassInfo* }{docClassInfo = NULL},
  85  \param{wxClassInfo* }{viewClassInfo = NULL}, \param{long}{ flags = wxDEFAULT\_TEMPLATE\_FLAGS}}
  86
  87 Constructor. Create instances dynamically near the start of your application after creating
  88 a wxDocManager instance, and before doing any document or view operations.
  89
  90 {\it manager} is the document manager object which manages this template.
  91
  92 {\it descr} is a short description of what the template is for. This string will be displayed in the
  93 file filter list of Windows file selectors.
  94
  95 {\it filter} is an appropriate file filter such as {\tt *.txt}.
  96
  97 {\it dir} is the default directory to use for file selectors.
  98
  99 {\it ext} is the default file extension (such as txt).
 100
 101 {\it docTypeName} is a name that should be unique for a given type of document, used for
 102 gathering a list of views relevant to a particular document.
 103
 104 {\it viewTypeName} is a name that should be unique for a given view.
 105
 106 {\it docClassInfo} is a pointer to the run-time document class information as returned
 107 by the CLASSINFO macro, e.g. CLASSINFO(MyDocumentClass). If this is not supplied,
 108 you will need to derive a new wxDocTemplate class and override the CreateDocument
 109 member to return a new document instance on demand.
 110
 111 {\it viewClassInfo} is a pointer to the run-time view class information as returned
 112 by the CLASSINFO macro, e.g. CLASSINFO(MyViewClass). If this is not supplied,
 113 you will need to derive a new wxDocTemplate class and override the CreateView
 114 member to return a new view instance on demand.
 115
 116 {\it flags} is a bit list of the following:
 117
 118 \begin{itemize}\itemsep=0pt
 119 \item wxTEMPLATE\_VISIBLE The template may be displayed to the user in dialogs.
 120 \item wxTEMPLATE\_INVISIBLE The template may not be displayed to the user in dialogs.
 121 \item wxDEFAULT\_TEMPLATE\_FLAGS Defined as wxTEMPLATE\_VISIBLE.
 122 \end{itemize}
 123
 124 \perlnote{In wxPerl {\tt docClassInfo} and {\tt viewClassInfo} can be
 125 either {\tt Wx::ClassInfo} objects or strings which contain the name
 126 of the perl packages which are to be used as {\tt Wx::Document} and
 127 {\tt Wx::View} classes (they must have a constructor named {\tt
 128 new}):
 129
 130 \indented{2cm}{\begin{twocollist}
 131 \twocolitem{{\bf Wx::DocTemplate->new( docmgr, descr, filter, dir,
 132 ext, docTypeName, viewTypeName, docClassInfo, viewClassInfo, flags
 133 )}}{ will construct document and view objects from the class information}
 134 \twocolitem{{\bf Wx::DocTemplate->new( docmgr, descr, filter, dir,
 135 ext, docTypeName, viewTypeName, docClassName, viewClassName, flags
 136 )}}{ will construct document and view objects from perl packages}
 137 \twocolitem{{\bf Wx::DocTemplate->new( docmgr, descr, filter, dir,
 138 ext, docTypeName, viewTypeName )}}{
 139 {\tt Wx::DocTemplate::CreateDocument()} and
 140 {\tt Wx::DocTemplate::CreateView()} must be overridden}
 141 \end{twocollist}}}
 142
 143 \membersection{wxDocTemplate::\destruct{wxDocTemplate}}
 144
 145 \func{void}{\destruct{wxDocTemplate}}{\void}
 146
 147 Destructor.
 148
 149 \membersection{wxDocTemplate::CreateDocument}
 150
 151 \func{wxDocument *}{CreateDocument}{\param{const wxString\& }{path}, \param{long}{ flags = 0}}
 152
 153 Creates a new instance of the associated document class. If you have not supplied
 154 a wxClassInfo parameter to the template constructor, you will need to override this
 155 function to return an appropriate document instance.
 156
 157 \membersection{wxDocTemplate::CreateView}
 158
 159 \func{wxView *}{CreateView}{\param{wxDocument *}{doc}, \param{long}{ flags = 0}}
 160
 161 Creates a new instance of the associated view class. If you have not supplied
 162 a wxClassInfo parameter to the template constructor, you will need to override this
 163 function to return an appropriate view instance.
 164
 165 \membersection{wxDocTemplate::GetDefaultExtension}
 166
 167 \func{wxString}{GetDefaultExtension}{\void}
 168
 169 Returns the default file extension for the document data, as passed to the document template constructor.
 170
 171 \membersection{wxDocTemplate::GetDescription}
 172
 173 \func{wxString}{GetDescription}{\void}
 174
 175 Returns the text description of this template, as passed to the document template constructor.
 176
 177 \membersection{wxDocTemplate::GetDirectory}
 178
 179 \func{wxString}{GetDirectory}{\void}
 180
 181 Returns the default directory, as passed to the document template constructor.
 182
 183 \membersection{wxDocTemplate::GetDocumentManager}
 184
 185 \func{wxDocManager *}{GetDocumentManager}{\void}
 186
 187 Returns a pointer to the document manager instance for which this template was created.
 188
 189 \membersection{wxDocTemplate::GetDocumentName}
 190
 191 \func{wxString}{GetDocumentName}{\void}
 192
 193 Returns the document type name, as passed to the document template constructor.
 194
 195 \membersection{wxDocTemplate::GetFileFilter}
 196
 197 \func{wxString}{GetFileFilter}{\void}
 198
 199 Returns the file filter, as passed to the document template constructor.
 200
 201 \membersection{wxDocTemplate::GetFlags}
 202
 203 \func{long}{GetFlags}{\void}
 204
 205 Returns the flags, as passed to the document template constructor.
 206
 207 \membersection{wxDocTemplate::GetViewName}
 208
 209 \func{wxString}{GetViewName}{\void}
 210
 211 Returns the view type name, as passed to the document template constructor.
 212
 213 \membersection{wxDocTemplate::IsVisible}
 214
 215 \func{bool}{IsVisible}{\void}
 216
 217 Returns true if the document template can be shown in user dialogs, false otherwise.
 218
 219 \membersection{wxDocTemplate::SetDefaultExtension}
 220
 221 \func{void}{SetDefaultExtension}{\param{const wxString\& }{ext}}
 222
 223 Sets the default file extension.
 224
 225 \membersection{wxDocTemplate::SetDescription}
 226
 227 \func{void}{SetDescription}{\param{const wxString\& }{descr}}
 228
 229 Sets the template description.
 230
 231 \membersection{wxDocTemplate::SetDirectory}
 232
 233 \func{void}{SetDirectory}{\param{const wxString\& }{dir}}
 234
 235 Sets the default directory.
 236
 237 \membersection{wxDocTemplate::SetDocumentManager}
 238
 239 \func{void}{SetDocumentManager}{\param{wxDocManager *}{manager}}
 240
 241 Sets the pointer to the document manager instance for which this template was created.
 242 Should not be called by the application.
 243
 244 \membersection{wxDocTemplate::SetFileFilter}
 245
 246 \func{void}{SetFileFilter}{\param{const wxString\& }{filter}}
 247
 248 Sets the file filter.
 249
 250 \membersection{wxDocTemplate::SetFlags}
 251
 252 \func{void}{SetFlags}{\param{long }{flags}}
 253
 254 Sets the internal document template flags (see the constructor description for more details).
 255