wxArt2D
Public Member Functions | List of all members
a2dDocumentTemplateAuto Class Reference

Automatic template, which searches a suitable handler for the document. More...

#include <docviewref.h>

Inheritance diagram for a2dDocumentTemplateAuto:
Inheritance graph
[legend]
Collaboration diagram for a2dDocumentTemplateAuto:
Collaboration graph
[legend]

Public Member Functions

 a2dDocumentTemplateAuto (const wxString &descr, const wxString &filter, const wxString &dir, const wxString &ext, const wxString &docTypeName, wxClassInfo *docClassInfo=(wxClassInfo *) NULL, a2dViewConnector *connector=(a2dViewConnector *) NULL, long flags=a2dTemplateFlag::DEFAULT)
 
 ~a2dDocumentTemplateAuto ()
 Destructor.
 
virtual a2dIOHandlerStrInGetDocumentIOHandlerForLoad (a2dDocumentInputStream &stream, a2dDocument *document)
 if there is an io handler, and it can load the document of this template, return it
 
virtual a2dIOHandlerStrOutGetDocumentIOHandlerForSave (const wxString &filename, a2dDocument *document)
 if there is an io handler, and it can save the document of this template, return it More...
 
- Public Member Functions inherited from a2dDocumentTemplate
 a2dDocumentTemplate (const wxString &descr, const wxString &filter, const wxString &dir, const wxString &ext, const wxString &docTypeName, wxClassInfo *docClassInfo=(wxClassInfo *) NULL, a2dViewConnector *connector=(a2dViewConnector *) NULL, long flags=a2dTemplateFlag::DEFAULT, a2dIOHandlerStrIn *handlerIn=NULL, a2dIOHandlerStrOut *handlerOut=NULL)
 Associate document and view types. They're for identifying what view is associated with what template/document type. More...
 
 ~a2dDocumentTemplate ()
 Destructor.
 
virtual a2dDocumentCreateDocument (const wxFileName &path, a2dDocumentFlagMask flags=a2dREFDOC_NON)
 Creates a new document. More...
 
a2dDocumentSentPreAddCreatedDocumentEvent (a2dDocument *newDoc, a2dDocumentFlagMask flags)
 sents a wxEVT_PRE_ADD_DOCUMENT event to m_connector if available. More...
 
bool SentPostCreateDocumentEvent (a2dDocument *newDoc, a2dDocumentFlagMask flags)
 sents a wxEVT_POST_CREATE_DOCUMENT called in general from a2dDocumentCommandProcessor() when a new document was created. More...
 
wxString GetDefaultExtension () const
 Returns the default file extension for the document data, as passed to the document template constructor.
 
wxString GetDescription () const
 Returns the text description of this template, as passed to the document template constructor.
 
wxString GetDirectory () const
 Returns the default directory, as passed to the document template constructor.
 
wxString GetFileFilter () const
 Returns the file filter, as passed to the document template constructor.
 
const a2dTemplateFlagGetFlags () const
 Returns the flags, as passed to the document template constructor.
 
void SetFlags (a2dTemplateFlagMask flags)
 Sets the internal document template flags (see the constructor description for more details).
 
void SetFlags (a2dTemplateFlag flags)
 Sets the internal document template flags (see the constructor description for more details).
 
bool CheckMask (a2dTemplateFlagMask mask)
 does template mask match
 
wxString GetDocumentTypeName () const
 Returns the document type name, as passed to the document template constructor.
 
void SetFileFilter (const wxString &filter)
 Sets the file filter.
 
void SetDirectory (const wxString &dir)
 Sets the default directory.
 
void SetDescription (const wxString &descr)
 Sets the template description.
 
void SetDefaultExtension (const wxString &ext)
 Sets the default file extension.
 
void SetVisible (bool value)
 Returns true if the document template can be shown in user dialogs, false otherwise.
 
void SetMarked (bool value)
 Returns true if the document template is marked , false otherwise.
 
bool IsVisible () const
 Returns true if the document template can be shown in user dialogs, false otherwise.
 
bool IsMarked () const
 Returns true if the document template is marked , false otherwise.
 
virtual bool FileMatchesTemplate (const wxString &path)
 to test if a file that needs to be loaded, is suitable for this template. More...
 
virtual a2dIOHandlerStrInGetDocumentIOHandlerStrIn ()
 Get Input handler used to store the document using this template.
 
virtual a2dIOHandlerStrOutGetDocumentIOHandlerStrOut ()
 Get output handler used to save the document using this template.
 
virtual void SetDocumentIOHandlerStrIn (a2dIOHandlerStrIn *handler)
 Set Inputhandler used to load the document using this template.
 
virtual void SetDocumentIOHandlerStrOut (a2dIOHandlerStrOut *handler)
 Set output handler used to save the document using this template.
 
a2dViewConnectorGetViewConnector ()
 return the a2dViewConnector that is used for sending the ::wxEVT_POST_CREATE_DOCUMENT too.
 
wxPageSetupDialogData * GetPageSetupData (void) const
 
void SetPageSetupData (const wxPageSetupDialogData &pageSetupData)
 
void SetPageSetupData (wxPageSetupDialogData *pageSetupData)
 
wxClassInfo * GetDocumentClassInfo () const
 
a2dDocumentGetDocumentCreate ()
 if set this will be used instead of m_docClassInfo to initiate new documents
 
void SetDocumentCreate (a2dDocument *documentCreate)
 if set this will be used instead of m_docClassInfo to initiate new documents More...
 
- Public Member Functions inherited from a2dObject
virtual bool ProcessEvent (wxEvent &event)
 
bool SearchDynamicEventTable (wxEvent &event)
 
void Connect (int winid, int lastId, int eventType, wxObjectEventFunction func, wxObject *userData=(wxObject *) NULL, wxEvtHandler *eventSink=(wxEvtHandler *) NULL)
 
bool Disconnect (int winid, int lastId, wxEventType eventType, wxObjectEventFunction func=NULL, wxObject *userData=(wxObject *) NULL, wxEvtHandler *eventSink=(wxEvtHandler *) NULL)
 
void ProcessConnectedEvent (wxEvent &event)
 wxCHECK_VERSION(2,9,0) More...
 
void ConnectEvent (wxEventType type, wxEvtHandler *eventSink)
 
bool DisconnectEvent (wxEventType type, wxEvtHandler *eventSink)
 
bool DisconnectEventAll (wxEvtHandler *eventSink)
 Remove all dynamic events in classA, going to classB (eventSink) More...
 
 a2dObject ()
 constructor
 
virtual ~a2dObject ()
 destructor
 
void operator= (const a2dObject &other)
 assignment operator
 
int GetOwnedBy ()
 like it to be protected, but this does not work with wxList macros More...
 
virtual a2dObjectSetNonDynamic ()
 Call to mark this object as non-dynamic (static/local/auto) More...
 
void CheckReferences ()
 Check zero reference count and delete if count is 0. More...
 
a2dObjectClone (CloneOptions options, a2dRefMap *refs=NULL) const
 create an exact copy of this property
 
 a2dObject (const a2dObject &other, CloneOptions options, a2dRefMap *refs)
 
virtual wxString GetName () const
 Returns the name of this object, if no name is given the internal id will be returned. More...
 
virtual void SetName (const wxString &name)
 Creates the a2dStringProperty PROPID_Name. More...
 
virtual bool IsTemporary_DontSave () const
 Check if this is a temporary object, which should not be saved.
 
void SaveAsDocument (a2dIOHandlerXmlSerOut &out)
 Save this object and all below as an XML document. More...
 
virtual void Save (wxObject *parent, a2dIOHandlerXmlSerOut &out, a2dObjectList *towrite)
 write all needed to an XML type of file called the CVG format More...
 
void LoadFromDocument (a2dIOHandlerXmlSerIn &parser)
 Load this object and all below from an XML document. More...
 
virtual void Load (wxObject *parent, a2dIOHandlerXmlSerIn &parser)
 load object from CVG file More...
 
wxInt64 GetUniqueSerializationId () const
 return a unique id for this object More...
 
virtual bool AlwaysWriteSerializationId () const
 If true, always write an id. More...
 
virtual bool LinkReference (a2dObject *other)
 link a reference in the object to the given value More...
 
virtual void ResolveInform ()
 inform an object that reference resolution was done More...
 
void Walker (wxObject *parent, a2dWalkerIOHandler &handler)
 This is used to recursively walk through an object tree.
 
void SetCheck (bool check)
 general flag use at will. More...
 
bool GetCheck () const
 general flag use at will.
 
void SetRelease (bool value)
 set release flag More...
 
bool GetRelease () const
 get release flag More...
 
a2dAutoZeroPtr< a2dObject > ** GetAutoZeroPtrList ()
 return the list head pointer for autozero pointers to this object More...
 
 DECLARE_PROPERTIES ()
 
a2dNamedPropertyGetProperty (const a2dPropertyId *propertyId, a2dPropertyId::Flags flags=a2dPropertyId::flag_none) const
 get property on this object More...
 
void SetProperty (a2dNamedProperty *propertyHolder, a2dPropertyId::SetFlags flags=a2dPropertyId::set_none)
 Set the property to the this object. More...
 
void SetProperty (const a2dNamedProperty &propertyHolder, a2dPropertyId::SetFlags flags=a2dPropertyId::set_none)
 Set the property to the this object and if enabled, to all childs and object members. More...
 
virtual a2dNamedPropertyFindProperty (const a2dPropertyId *id, a2dPropertyId::Flags flags=a2dPropertyId::flag_none)
 Find a dynamic property with given id in the property list. More...
 
virtual const a2dNamedPropertyFindProperty (const a2dPropertyId *id, a2dPropertyId::Flags flags=a2dPropertyId::flag_none) const
 Find a dynamic property with given id in the property list. More...
 
virtual bool HasProperty (const a2dPropertyId *id, const wxString &stringvalue=wxEmptyString) const
 Check if the object has a property with given id and string representation. More...
 
virtual void OnPropertyChanged (const a2dPropertyId *id)
 This function is called after a property changed. More...
 
virtual bool EditProperties (const a2dPropertyId *id, bool withUndo=true)
 edit properties of the object More...
 
void TakeOverProperties (a2dObject *from, a2dPropertyIdList *listOfIds)
 Properties in the id list are taken from the given object, en set to this. More...
 
wxURI GetURI () const
 quick way to get to PROPID_URI property More...
 
void SetURI (const wxURI &url)
 quickly set a property PROPID_URI More...
 
const a2dNamedPropertyListGetPropertyList () const
 Get the Property List. More...
 
bool HasDynamicProperties () const
 test if there are dynamic properties in the m_propertylist
 
virtual bool RemoveProperty (const a2dPropertyId *id, bool all=true)
 This function is called by a2dPropertyId to remove a property from the list. More...
 
void RemoveTemporaryProperties ()
 remove all temporary properties
 
virtual bool AddProperty (a2dNamedProperty *property)
 This function is called by a2dPropertyId to add a property to the list. More...
 

Additional Inherited Members

- Public Types inherited from a2dObject
enum  CloneOptions {
  clone_members = 0x00000001, clone_properties = 0x00000002, clone_childs = 0x00000004, clone_unused = 0x00000008,
  clone_setoriginal = 0x00000010, clone_seteditcopy = 0x00000020, clone_noReference = 0x00000040, clone_noCameleonRef = 0x00000080,
  clone_toDrag = 0x00000100, clone_flat = 0x00000000, clone_deep = clone_members | clone_properties | clone_childs
}
 options for cloning More...
 
typedef a2dAutoZeroPtr< a2dObjectTAutoZeroPtrListClass
 this is needed inside the smart pointer template code
 
- Static Public Attributes inherited from a2dObject
static a2dPropertyIdBoolPROPID_Check = NULL
 used for linking multiple referenced objects when serializing
 
static a2dPropertyIdUriPROPID_URI = NULL
 attach an URL to the object
 
static a2dPropertyIdStringPROPID_Name = NULL
 Name property, to return name of this object.
 
static a2dPropertyIdVoidPtrPROPID_autozeroptrlist = NULL
 
static const a2dSignal sm_Edit_properties = wxNewId()
 edit properties event, see EditProperties()
 
- Protected Types inherited from a2dObject
enum  { refcount_nondynamic = 0x76543210 }
 special refcount value for non-dynamic objects
 
- Protected Member Functions inherited from a2dDocumentTemplate
a2dObjectDoClone (a2dObject::CloneOptions options, a2dRefMap *refs) const
 
virtual void DoSave (wxObject *parent, a2dIOHandlerXmlSerOut &out, a2dXmlSer_flag xmlparts, a2dObjectList *towrite)
 Save settings.
 
virtual void DoLoad (wxObject *parent, a2dIOHandlerXmlSerIn &parser, a2dXmlSer_flag xmlparts)
 Load settings.
 
- Protected Member Functions inherited from a2dObject
virtual bool DoIgnoreIfNotMember (const a2dPropertyId *id) const
 used to decide if a property shall be ignored, if it is not a member More...
 
virtual void DoWalker (wxObject *parent, a2dWalkerIOHandler &handler)
 iterate over this object and its children More...
 
- Protected Attributes inherited from a2dDocumentTemplate
a2dTemplateFlag m_flags
 The flags passed to the constructor.
 
wxString m_fileFilter
 The file filter (such as *.txt) to be used in file selector dialogs.
 
wxString m_directory
 The default directory for files of this type.
 
wxString m_description
 A short description of this template.
 
wxString m_defaultExt
 The default extension for files of this type.
 
wxString m_docTypeName
 The named type of the document associated with this template.
 
wxClassInfo * m_docClassInfo
 Run-time class information that allows document instances to be constructed dynamically.
 
a2dDocumentPtr m_documentCreate
 if set this will be used instead of m_docClassInfo to initiate new documents
 
a2dSmrtPtr< a2dIOHandlerStrInm_ioHandlerStrIn
 used for reading the document from streams.
 
a2dSmrtPtr< a2dIOHandlerStrOutm_ioHandlerStrOut
 used for writing the document to streams.
 
a2dSmrtPtr< a2dViewConnectorm_connector
 class used to connect new views with Frames and windows.
 
wxPageSetupDialogData * m_pageSetupData
 this is the printer page setup data for all documents with this template
 
- Protected Attributes inherited from a2dObject
a2dNamedPropertyList m_propertylist
 properties
 
int m_refcount
 how many references to this object do exist
 
bool m_check: 1
 used for linking multiple referenced objects when serializing
 
bool m_release: 1
 when set object is treated as being deleted, and wil be deleted in idle time.
 
bool m_recursion_active: 1
 this is used as a recursion stopper
 
bool m_pendingDisconnects: 1
 
unsigned int m_iteratorCount
 
a2dAutoZeroPtr< a2dObject > * m_autozeroptrlist
 this is a list of all a2dAutoZeroPtr object pointing to this object
 

Detailed Description

Automatic template, which searches a suitable handler for the document.

a2dDocviewGlobals->GetDocviewCommandProcessor()->GetDocTemplates() is used to find a template which fits the document type of the template.

An extra test is performed in GetDocumentIOHandlerForLoad() GetDocumentIOHandlerForSave(), to see if that template can be used for saving or loading the document.

This template is handy in use when you what an All Files template. The document with this template, will automatically choose the right handler for files you choose. Extension is not important.

Definition at line 2576 of file docviewref.h.

Member Function Documentation

a2dIOHandlerStrOut * a2dDocumentTemplateAuto::GetDocumentIOHandlerForSave ( const wxString &  filename,
a2dDocument document 
)
virtual

if there is an io handler, and it can save the document of this template, return it

Parameters
filenamewhen not empty, it is/can be used to choose io handler also based on the extension of the filename.
documentthe document that needs to be saved.

Reimplemented from a2dDocumentTemplate.

Definition at line 1983 of file docviewref.cpp.


The documentation for this class was generated from the following files:
a2dDocumentTemplateAuto Class Reference -- Sun Oct 12 2014 17:04:35 -- Sun Oct 12 2014 -- 1.8.5 -- wxArt2D -- . -- Main Page Reference Documentation