X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/29548835934ad15172eb84782599a5c07e713035..b87b399c4883e7f20abcf8f18ca7880e265be8e4:/interface/wx/docview.h diff --git a/interface/wx/docview.h b/interface/wx/docview.h index dd5f3bcc19..14bf99ba6a 100644 --- a/interface/wx/docview.h +++ b/interface/wx/docview.h @@ -3,7 +3,7 @@ // Purpose: interface of various doc/view framework classes // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -43,13 +43,13 @@ public: A name that should be unique for a given view. @param docClassInfo A pointer to the run-time document class information as returned by - the CLASSINFO() macro, e.g. CLASSINFO(MyDocumentClass). If this is + the wxCLASSINFO() macro, e.g. wxCLASSINFO(MyDocumentClass). If this is not supplied, you will need to derive a new wxDocTemplate class and override the CreateDocument() member to return a new document instance on demand. @param viewClassInfo A pointer to the run-time view class information as returned by the - CLASSINFO() macro, e.g. CLASSINFO(MyViewClass). If this is not + wxCLASSINFO() macro, e.g. wxCLASSINFO(MyViewClass). If this is not supplied, you will need to derive a new wxDocTemplate class and override the CreateView() member to return a new view instance on demand. @@ -363,8 +363,48 @@ public: */ void AssociateTemplate(wxDocTemplate* temp); + /** + Search for a particular document template. + + Example: + @code + // creating a document instance of the specified document type: + m_doc = (MyDoc*)docManager->FindTemplate(CLASSINFO(MyDoc))-> + CreateDocument(wxEmptyString, wxDOC_SILENT); + @endcode + + @param classinfo + Class info of a document class for which a wxDocTemplate had been + previously created. + + @return + Pointer to a wxDocTemplate, or @NULL if none found. + + @since 2.9.2 + */ + wxDocTemplate* FindTemplate(const wxClassInfo* classinfo); + + /** + Closes the specified document. + + If @a force is @true, the document is closed even if it has unsaved + changes. + + @param doc + The document to close, must be non-@NULL. + @param force + If @true, close the document even if wxDocument::Close() returns + @false. + @return + @true if the document was closed or @false if closing it was + cancelled by user (only in @a force = @false case). + */ + bool CloseDocument(wxDocument *doc, bool force = false); + /** Closes all currently opened documents. + + @see CloseDocument() */ bool CloseDocuments(bool force = true);