\section{\class{wxDocument}}\label{wxdocument}
The document class can be used to model an application's file-based
-data. It is part of the document/view framework supported by wxWindows,
+data. It is part of the document/view framework supported by wxWidgets,
and cooperates with the \helpref{wxView}{wxview}, \helpref{wxDocTemplate}{wxdoctemplate}\rtfsp
and \helpref{wxDocManager}{wxdocmanager} classes.
<wx/docview.h>
+\wxheading{Library}
+
+\helpref{wxCore}{librarieslist}
+
\wxheading{See also}
\helpref{wxDocument overview}{wxdocumentoverview}, \helpref{wxView}{wxview},\rtfsp
\latexignore{\rtfignore{\wxheading{Members}}}
-\membersection{wxDocument::m\_commandProcessor}
+\membersection{wxDocument::m\_commandProcessor}\label{wxdocumentmcommandprocessor}
\member{wxCommandProcessor*}{m\_commandProcessor}
A pointer to the command processor associated with this document.
-\membersection{wxDocument::m\_documentFile}
+\membersection{wxDocument::m\_documentFile}\label{wxdocumentmdocumentfile}
\member{wxString}{m\_documentFile}
Filename associated with this document (``" if none).
-\membersection{wxDocument::m\_documentModified}
+\membersection{wxDocument::m\_documentModified}\label{wxdocumentmdocumentmodified}
\member{bool}{m\_documentModified}
true if the document has been modified, false otherwise.
-\membersection{wxDocument::m\_documentTemplate}
+\membersection{wxDocument::m\_documentTemplate}\label{wxdocumentmdocumenttemplate}
\member{wxDocTemplate *}{m\_documentTemplate}
A pointer to the template from which this document was created.
-\membersection{wxDocument::m\_documentTitle}
+\membersection{wxDocument::m\_documentTitle}\label{wxdocumentmdocumenttitle}
\member{wxString}{m\_documentTitle}
to collate a list of alternative view types that can be used on this kind of
document. Do not change the value of this variable.
-\membersection{wxDocument::m\_documentViews}
+\membersection{wxDocument::m\_documentViews}\label{wxdocumentmdocumentviews}
\member{wxList}{m\_documentViews}
List of wxView instances associated with this document.
-\membersection{wxDocument::wxDocument}
+\membersection{wxDocument::wxDocument}\label{wxdocumentctor}
\func{}{wxDocument}{\void}
Constructor. Define your own default constructor to initialize application-specific
data.
-\membersection{wxDocument::\destruct{wxDocument}}
+\membersection{wxDocument::\destruct{wxDocument}}\label{wxdocumentdtor}
\func{}{\destruct{wxDocument}}{\void}
Destructor. Removes itself from the document manager.
-\membersection{wxDocument::AddView}
+\membersection{wxDocument::AddView}\label{wxdocumentaddview}
\func{virtual bool}{AddView}{\param{wxView *}{view}}
If the view is not already in the list of views, adds the view and calls OnChangedViewList.
-\membersection{wxDocument::Close}
+\membersection{wxDocument::Close}\label{wxdocumentclose}
\func{virtual bool}{Close}{\void}
Closes the document, by calling OnSaveModified and then (if this returned true) OnCloseDocument.
This does not normally delete the document object: use DeleteAllViews to do this implicitly.
-\membersection{wxDocument::DeleteAllViews}
+\membersection{wxDocument::DeleteAllViews}\label{wxdocumentdeleteviews}
\func{virtual bool}{DeleteAllViews}{\void}
in turns calls wxDocument::OnChangedViewList, whose default implemention is to
save and delete the document if no views exist.
-\membersection{wxDocument::GetCommandProcessor}
+\membersection{wxDocument::GetCommandProcessor}\label{wxdocumentgetcommandprocessor}
\constfunc{wxCommandProcessor*}{GetCommandProcessor}{\void}
See \helpref{wxCommandProcessor}{wxcommandprocessor}.
-\membersection{wxDocument::GetDocumentTemplate}
+\membersection{wxDocument::GetDocumentTemplate}\label{wxdocumentgetdocumenttemplate}
\constfunc{wxDocTemplate*}{GetDocumentTemplate}{\void}
Gets a pointer to the template that created the document.
-\membersection{wxDocument::GetDocumentManager}
+\membersection{wxDocument::GetDocumentManager}\label{wxdocumentgetdocumentmanager}
\constfunc{wxDocManager*}{GetDocumentManager}{\void}
Gets a pointer to the associated document manager.
-\membersection{wxDocument::GetDocumentName}
+\membersection{wxDocument::GetDocumentName}\label{wxdocumentgetdocumentname}
\constfunc{wxString}{GetDocumentName}{\void}
Gets the document type name for this document. See the comment for \helpref{documentTypeName}{documenttypename}.
-\membersection{wxDocument::GetDocumentWindow}
+\membersection{wxDocument::GetDocumentWindow}\label{wxdocumentgetdocumentwindow}
\constfunc{wxWindow*}{GetDocumentWindow}{\void}
Intended to return a suitable window for using as a parent for document-related
dialog boxes. By default, uses the frame associated with the first view.
-\membersection{wxDocument::GetFilename}
+\membersection{wxDocument::GetFilename}\label{wxdocumentgetfilename}
\constfunc{wxString}{GetFilename}{\void}
See also: \helpref{GetViews}{wxdocumentgetviews}
-\membersection{wxDocument::GetPrintableName}
-
-\constfunc{virtual void}{GetPrintableName}{\param{wxString\& }{name}}
+\membersection{wxDocument::GetUserReadableName}\label{wxdocumentgetuserreadablentablename}
-Copies a suitable document name into the supplied {\it name} buffer. The default
-function uses the title, or if there is no title, uses the filename; or if no
-filename, the string {\bf unnamed}.
+\constfunc{virtual wxString}{GetUserReadableName}{\void}
-\perlnote{In wxPerl this function must return the modified name rather
-than just modifying the argument.}
+Return the document name suitable to be shown to the user. The default
+implementation uses the document title, if any, of the name part of the
+document filename if it was set or, otherwise, the string {\bf unnamed}.
-\membersection{wxDocument::GetTitle}
+\membersection{wxDocument::GetTitle}\label{wxdocumentgettitle}
\constfunc{wxString}{GetTitle}{\void}
See also \helpref{Modify}{wxdocumentmodify}.
-\membersection{wxDocument::LoadObject}
+\membersection{wxDocument::LoadObject}\label{wxdocumentloadobject}
\func{virtual istream\&}{LoadObject}{\param{istream\& }{stream}}
streaming your own data. LoadObject is called by the framework
automatically when the document contents need to be loaded.
-Note that only one of these forms exists, depending on how wxWindows
+Note that only one of these forms exists, depending on how wxWidgets
was configured.
\membersection{wxDocument::Modify}\label{wxdocumentmodify}
See also \helpref{IsModified}{wxdocumentismodified}.
-\membersection{wxDocument::OnChangedViewList}
+\membersection{wxDocument::OnChangedViewList}\label{wxdocumentonchangedviewlist}
\func{virtual void}{OnChangedViewList}{\void}
implementation saves and deletes the document if no views exist (the last
one has just been removed).
-\membersection{wxDocument::OnCloseDocument}
+\membersection{wxDocument::OnCloseDocument}\label{wxdocumentonclosedocument}
\func{virtual bool}{OnCloseDocument}{\void}
sets the modified flag to false. Override this to
supply additional behaviour when the document is closed with Close.
-\membersection{wxDocument::OnCreate}
+\membersection{wxDocument::OnCreate}\label{wxdocumentoncreate}
\func{virtual bool}{OnCreate}{\param{const wxString\& }{path}, \param{long}{ flags}}
template associated with the document to create an initial view.
If this function returns false, the document is deleted.
-\membersection{wxDocument::OnCreateCommandProcessor}
+\membersection{wxDocument::OnCreateCommandProcessor}\label{wxdocumentoncreatecommandprocessor}
\func{virtual wxCommandProcessor*}{OnCreateCommandProcessor}{\void}
See \helpref{wxCommandProcessor}{wxcommandprocessor}.
-\membersection{wxDocument::OnNewDocument}
+\membersection{wxDocument::OnNewDocument}\label{wxdocumentonnewdocument}
\func{virtual bool}{OnNewDocument}{\void}
The default implementation calls OnSaveModified and DeleteContents, makes a default title for the
document, and notifies the views that the filename (in fact, the title) has changed.
-\membersection{wxDocument::OnOpenDocument}
+\membersection{wxDocument::OnOpenDocument}\label{wxdocumentonopendocument}
\func{virtual bool}{OnOpenDocument}{\param{const wxString\& }{filename}}
views are notified that the filename has changed, to give windows an opportunity
to update their titles. All of the document's views are then updated.
-\membersection{wxDocument::OnSaveDocument}
+\membersection{wxDocument::OnSaveDocument}\label{wxdocumentonsavedocument}
\func{virtual bool}{OnSaveDocument}{\param{const wxString\& }{filename}}
and calls SaveObject. If SaveObject returns true, the document is set to
unmodified; otherwise, an error message box is displayed.
-\membersection{wxDocument::OnSaveModified}
+\membersection{wxDocument::OnSaveModified}\label{wxdocumentonsavemodified}
\func{virtual bool}{OnSaveModified}{\void}
document is marked as unmodified and the function succeeds. If Cancel, the
function fails.
-\membersection{wxDocument::RemoveView}
+\membersection{wxDocument::RemoveView}\label{wxdocumentremoveview}
\func{virtual bool}{RemoveView}{\param{wxView* }{view}}
Removes the view from the document's list of views, and calls OnChangedViewList.
-\membersection{wxDocument::Save}
+\membersection{wxDocument::Save}\label{wxdocumentsave}
\func{virtual bool}{Save}{\void}
Saves the document by calling OnSaveDocument if there is an associated filename,
or SaveAs if there is no filename.
-\membersection{wxDocument::SaveAs}
+\membersection{wxDocument::SaveAs}\label{wxdocumentsaveas}
\func{virtual bool}{SaveAs}{\void}
Prompts the user for a file to save to, and then calls OnSaveDocument.
-\membersection{wxDocument::SaveObject}
+\membersection{wxDocument::SaveObject}\label{wxdocumentsaveobject}
\func{virtual ostream\&}{SaveObject}{\param{ostream\& }{stream}}
streaming your own data. SaveObject is called by the framework
automatically when the document contents need to be saved.
-Note that only one of these forms exists, depending on how wxWindows
+Note that only one of these forms exists, depending on how wxWidgets
was configured.
-\membersection{wxDocument::SetCommandProcessor}
+\membersection{wxDocument::SetCommandProcessor}\label{wxdocumentsetcommandprocessor}
\func{virtual void}{SetCommandProcessor}{\param{wxCommandProcessor *}{processor}}
See \helpref{wxCommandProcessor}{wxcommandprocessor}.
-\membersection{wxDocument::SetDocumentName}
+\membersection{wxDocument::SetDocumentName}\label{wxdocumentsetdocumentname}
\func{void}{SetDocumentName}{\param{const wxString\& }{name}}
Sets the document type name for this document. See the comment for \helpref{documentTypeName}{documenttypename}.
-\membersection{wxDocument::SetDocumentTemplate}
+\membersection{wxDocument::SetDocumentTemplate}\label{wxdocumentsetdocumenttemplate}
\func{void}{SetDocumentTemplate}{\param{wxDocTemplate* }{templ}}
Sets the pointer to the template that created the document. Should only be called by the
framework.
-\membersection{wxDocument::SetFilename}
+\membersection{wxDocument::SetFilename}\label{wxdocumentsetfilename}
\func{void}{SetFilename}{\param{const wxString\& }{filename}, \param{bool}{ notifyViews = false}}
If {\it notifyViews} is true, wxView::OnChangeFilename is called for all views.
-\membersection{wxDocument::SetTitle}
+\membersection{wxDocument::SetTitle}\label{wxdocumentsettitle}
\func{void}{SetTitle}{\param{const wxString\& }{title}}
projects / wxWidgets.git / blobdiff