.. wxPython Phoenix documentation
This file was generated by Phoenix's sphinx generator and associated
tools, do not edit by hand.
Copyright: (c) 2011-2020 by Total Control Software
License: wxWindows License
.. include:: headings.inc
.. currentmodule:: wx.lib.docview
.. highlight:: python
.. _wx.lib.docview.DocTemplate:
==========================================================================================================================================
|phoenix_title| **wx.lib.docview.DocTemplate**
==========================================================================================================================================
The :class:`DocTemplate` class is used to model the relationship between a
document class and a view class.
|
|class_hierarchy| Class Hierarchy
=================================
.. raw:: html

Inheritance diagram for class
DocTemplate:
|
|super_classes| Known Superclasses
==================================
:class:`wx.Object`
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.lib.docview.DocTemplate.__init__` Constructor. Create instances dynamically near the start of your
:meth:`~wx.lib.docview.DocTemplate.CreateDocument` Creates a new instance of the associated document class. If you have
:meth:`~wx.lib.docview.DocTemplate.CreateView` Creates a new instance of the associated document view. If you have
:meth:`~wx.lib.docview.DocTemplate.FileMatchesTemplate` Returns ``True`` if the path's extension matches one of this template's
:meth:`~wx.lib.docview.DocTemplate.GetDefaultExtension` Returns the default file extension for the document data, as passed to
:meth:`~wx.lib.docview.DocTemplate.GetDescription` Returns the text description of this template, as passed to the
:meth:`~wx.lib.docview.DocTemplate.GetDirectory` Returns the default directory, as passed to the document template
:meth:`~wx.lib.docview.DocTemplate.GetDocumentManager` Returns the document manager instance for which this template was
:meth:`~wx.lib.docview.DocTemplate.GetDocumentName` Returns the document type name, as passed to the document template
:meth:`~wx.lib.docview.DocTemplate.GetDocumentType` Returns the Python document class, as passed to the document template
:meth:`~wx.lib.docview.DocTemplate.GetFileFilter` Returns the file filter, as passed to the document template
:meth:`~wx.lib.docview.DocTemplate.GetFlags` Returns the flags, as passed to the document template constructor.
:meth:`~wx.lib.docview.DocTemplate.GetIcon` Returns the icon, as passed to the document template
:meth:`~wx.lib.docview.DocTemplate.GetViewName` Returns the view type name, as passed to the document template
:meth:`~wx.lib.docview.DocTemplate.GetViewType` Returns the Python view class, as passed to the document template
:meth:`~wx.lib.docview.DocTemplate.IsNewable` Returns true if the document template can be shown in "New" dialogs,
:meth:`~wx.lib.docview.DocTemplate.IsVisible` Returns true if the document template can be shown in user dialogs,
:meth:`~wx.lib.docview.DocTemplate.SetDefaultExtension` Sets the default file extension.
:meth:`~wx.lib.docview.DocTemplate.SetDescription` Sets the template description.
:meth:`~wx.lib.docview.DocTemplate.SetDirectory` Sets the default directory.
:meth:`~wx.lib.docview.DocTemplate.SetDocumentManager` Sets the document manager instance for which this template was
:meth:`~wx.lib.docview.DocTemplate.SetFileFilter` Sets the file filter.
:meth:`~wx.lib.docview.DocTemplate.SetFlags` Sets the internal document template flags (see the constructor
:meth:`~wx.lib.docview.DocTemplate.SetIcon` Sets the icon.
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: DocTemplate(wx.Object)
The :class:`DocTemplate` class is used to model the relationship between a
document class and a view class.
.. method:: __init__(self, manager, description, filter, dir, ext, docTypeName, viewTypeName, docType, viewType, flags=DEFAULT_TEMPLATE_FLAGS, icon=None)
Constructor. Create instances dynamically near the start of your
application after creating a wxDocManager instance, and before doing
any document or view operations.
manager is the document manager object which manages this template.
description is a short description of what the template is for. This
string will be displayed in the file filter list of Windows file
selectors.
filter is an appropriate file filter such as \*.txt.
dir is the default directory to use for file selectors.
ext is the default file extension (such as txt).
docTypeName is a name that should be unique for a given type of
document, used for gathering a list of views relevant to a
particular document.
viewTypeName is a name that should be unique for a given view.
docClass is a Python class. 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.
viewClass is a Python class. 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.
flags is a bit list of the following:
``TEMPLATE_VISIBLE``: The template may be displayed to the user in
dialogs.
``TEMPLATE_INVISIBLE``: The template may not be displayed to the user in
dialogs.
``DEFAULT_TEMPLATE_FLAGS``: Defined as ``TEMPLATE_VISIBLE``.
.. method:: CreateDocument(self, path, flags)
Creates a new instance of the associated document class. If you have
not supplied a class to the template constructor, you will need to
override this function to return an appropriate document instance.
.. method:: CreateView(self, doc, flags)
Creates a new instance of the associated document view. If you have
not supplied a class to the template constructor, you will need to
override this function to return an appropriate view instance.
.. method:: FileMatchesTemplate(self, path)
Returns ``True`` if the path's extension matches one of this template's
file filter extensions.
.. method:: GetDefaultExtension(self)
Returns the default file extension for the document data, as passed to
the document template constructor.
.. method:: GetDescription(self)
Returns the text description of this template, as passed to the
document template constructor.
.. method:: GetDirectory(self)
Returns the default directory, as passed to the document template
constructor.
.. method:: GetDocumentManager(self)
Returns the document manager instance for which this template was
created.
.. method:: GetDocumentName(self)
Returns the document type name, as passed to the document template
constructor.
.. method:: GetDocumentType(self)
Returns the Python document class, as passed to the document template
constructor.
.. method:: GetFileFilter(self)
Returns the file filter, as passed to the document template
constructor.
.. method:: GetFlags(self)
Returns the flags, as passed to the document template constructor.
(see the constructor description for more details).
.. method:: GetIcon(self)
Returns the icon, as passed to the document template
constructor.
.. method:: GetViewName(self)
Returns the view type name, as passed to the document template
constructor.
.. method:: GetViewType(self)
Returns the Python view class, as passed to the document template
constructor.
.. method:: IsNewable(self)
Returns true if the document template can be shown in "New" dialogs,
false otherwise.
.. method:: IsVisible(self)
Returns true if the document template can be shown in user dialogs,
false otherwise.
.. method:: SetDefaultExtension(self, defaultExt)
Sets the default file extension.
.. method:: SetDescription(self, description)
Sets the template description.
.. method:: SetDirectory(self, dir)
Sets the default directory.
.. method:: SetDocumentManager(self, manager)
Sets the document manager instance for which this template was
created. Should not be called by the application.
.. method:: SetFileFilter(self, filter)
Sets the file filter.
.. method:: SetFlags(self, flags)
Sets the internal document template flags (see the constructor
description for more details).
.. method:: SetIcon(self, flags)
Sets the icon.