DWFToolkit::DWFSignatureSection Class Reference
[DWF Package API]

#include "dwf/package/SignatureSection.h"

Inheritance diagram for DWFToolkit::DWFSignatureSection:

Inheritance graph
[legend]
Collaboration diagram for DWFToolkit::DWFSignatureSection:

Collaboration graph
[legend]
List of all members.

Detailed Description

A Signature section encapsulates the ownership of Digital Signatures in the DWF package.

Since:
7.3
The type constant for these object is _DWF_FORMAT_SIGNATURE_TYPE_STRING (defined in dwf/Version.h)

Definition at line 52 of file SignatureSection.h.

Public Types

typedef DWFWCharKeySkipList<
DWFSignatureSection * > 
tMap
 This type defines a mapped collection of DWFSignatureSection pointers.
typedef std::multimap< const
wchar_t *, DWFSignatureSection *,
tDWFWCharCompareLess
tMultiMap
 This type defines a multi-value mapped collection of DWFSignatureSection pointers.

Public Member Functions

typedef _DWFTK_STD_VECTOR (DWFSignatureSection *) tList
 This type defines a list of DWFSignatureSection pointers.
_DWFTK_API DWFSignatureSection (const DWFString &zName, const DWFString &zTitle, DWFPackageReader *pPackageReader) throw ()
_DWFTK_API DWFSignatureSection (const DWFString &zTitle, const DWFString &zObjectID, double nPlotOrder, const DWFSource &rSource) throw ()
virtual _DWFTK_API ~DWFSignatureSection () throw ()
_DWFTK_API DWFInterfacebuildInterface () throw ( DWFException )
_DWFTK_API const DWFResourcereadDescriptor (DWFSectionDescriptorReader *pSectionDescriptorReader=NULL) const throw ( DWFException )
_DWFTK_API void serializeXML (DWFXMLSerializer &rSerializer, unsigned int nFlags) throw ( DWFException )
_DWFTK_API const char * provideName (const char *zName) throw ()
_DWFTK_API const char * provideObjectID (const char *zObjectID) throw ()
_DWFTK_API double provideVersion (double nVersion) throw ()
_DWFTK_API DWFPropertyprovideProperty (DWFProperty *pProperty) throw ()
_DWFTK_API DWFResourceprovideResource (DWFResource *pResource) throw ()
_DWFTK_API DWFSignatureResourceprovideSignatureResource (DWFSignatureResource *pResource) throw ()

Classes

class  Factory
 Class factory for DWFSignatureSection objects. More...


Constructor & Destructor Documentation

_DWFTK_API DWFToolkit::DWFSignatureSection::DWFSignatureSection const DWFString zName,
const DWFString zTitle,
DWFPackageReader pPackageReader
throw ()
 

Constructor

This constructor is generally only used by the parsing process when the DWFPackageReader associated with (and providing read access to) the DWF package file is available. The subsequent binding makes it possible to read section content data from the DWF package.

Parameters:
zName A string that uniquely identifies the section in the DWF package.
zTitle The descriptive and display friendly title text.
pPackageReader Provides access to section content in the DWF package.
Exceptions:
None 

_DWFTK_API DWFToolkit::DWFSignatureSection::DWFSignatureSection const DWFString zTitle,
const DWFString zObjectID,
double  nPlotOrder,
const DWFSource rSource
throw ()
 

Constructor

This constructor is generally used by applications and publishers for creating new section objects.

Parameters:
zTitle The descriptive and display friendly title text.
zObjectID Uniquely identifies the section.
nPlotOrder Indicates the initial position in the package to which the section was/will be published.
rSource Describes the original source of the data in the section (a drawing file, for example.)
Exceptions:
None 

virtual _DWFTK_API DWFToolkit::DWFSignatureSection::~DWFSignatureSection  )  throw () [virtual]
 

Destructor

Exceptions:
None 


Member Function Documentation

_DWFTK_API DWFInterface* DWFToolkit::DWFSignatureSection::buildInterface  )  throw ( DWFException ) [virtual]
 

Returns the interface associated with a data section.

This interface will be defined with the following constant data:

name: DWFInterface::kzSignature_Name href: DWFInterface::kzSignature_HRef id: DWFInterface::kzSignature_ID

Returns:
A pointer to a new interface object. This object will be allocated using the DWFCORE_ALLOC_OBJECT macro and must be deleted by the caller using the DWFCORE_FREE_OBJECT macro.
Exceptions:
DWFException 

Reimplemented from DWFToolkit::DWFSection.

_DWFTK_API const char* DWFToolkit::DWFSignatureSection::provideName const char *  zName  )  throw ()
 

Accepts the section name attribute.

Parameters:
zName The section name.
Returns:
The filtered section name.
Exceptions:
None 

_DWFTK_API const char* DWFToolkit::DWFSignatureSection::provideObjectID const char *  zObjectID  )  throw ()
 

Accepts the section identifier attribute.

Parameters:
zObjectID The section ID.
Returns:
The filtered section ID.
Exceptions:
None 

_DWFTK_API DWFProperty* DWFToolkit::DWFSignatureSection::provideProperty DWFProperty pProperty  )  throw ()
 

Accepts property element objects.

Parameters:
pProperty The new property. The acceptor is responsible for deleting this pointer with DWFCORE_FREE_OBJECT.
Returns:
The filtered property object.
Exceptions:
None 

_DWFTK_API DWFResource* DWFToolkit::DWFSignatureSection::provideResource DWFResource pResource  )  throw ()
 

Accepts resource element objects.

Parameters:
pResource The new resource. The acceptor is responsible for deleting this pointer with DWFCORE_FREE_OBJECT.
Returns:
The filtered resource object.
Exceptions:
None 

_DWFTK_API DWFSignatureResource* DWFToolkit::DWFSignatureSection::provideSignatureResource DWFSignatureResource pResource  )  throw ()
 

Accepts signature resource element objects.

Parameters:
pResource The new resource. The acceptor is responsible for deleting this pointer with DWFCORE_FREE_OBJECT.
Returns:
The filtered resource object.
Exceptions:
None 

_DWFTK_API double DWFToolkit::DWFSignatureSection::provideVersion double  nVersion  )  throw ()
 

Accepts the descriptor document version attribute.

Parameters:
nVersion The document version.
Returns:
The filtered document version.
Exceptions:
None 

_DWFTK_API const DWFResource& DWFToolkit::DWFSignatureSection::readDescriptor DWFSectionDescriptorReader pSectionDescriptorReader = NULL  )  const throw ( DWFException ) [virtual]
 

Locates the one descriptor resource in the section and parses it accordingly with the reader provided or the default reader implementation for this section by this object.

As a specialized section class, this class knows how to parse EPlot section descriptor documents and build a data model from them. It derives this functionality by implementing the DWFSignatureSectionDescriptorReader interface. There are two ways to affect the default parsing process. The first of which is to provide a non-NULL interface pointer to this method via the pSectionDescriptorReader parameter. This will bypass this object entirely and process the descriptor using the reader provided. Alternatively, this object can still be used to read the descriptor document but every provider callback can be intercepted using a filter. A filter is just another implementation of the DWFSignatureSectionDescriptorReader set on this object before this call is made using the DWFSectionDescriptorReader::setFilter() method. When a filter is applied, the reader will provide data to the filter interface first and then, depending on how the filter responds, pass the data into the default (this object) provider callback.

Parameters:
pSectionDescriptorReader An optional interface pointer to an object that knows how to read and parse EPlot section descriptor documents.
Returns:
A reference to the EPlot descriptor document resource.
Exceptions:
DWFException 

Reimplemented from DWFToolkit::DWFSection.

_DWFTK_API void DWFToolkit::DWFSignatureSection::serializeXML DWFXMLSerializer rSerializer,
unsigned int  nFlags
throw ( DWFException ) [virtual]
 

Reimplemented from DWFToolkit::DWFSection.


The documentation for this class was generated from the following file:
Generated on Tue Jan 6 22:40:37 2009 for Autodesk DWF Toolkit by  doxygen 1.4.5