Methods' Summary |
startSchema |
receives notification that a schema description is started.
|
endSchema |
receives notification that the current schema description is complete.
|
importComponent |
receives notification that the schema depends on templates
from a different component.
|
startComponent |
receives notification that a component description is started.
|
endComponent |
receives notification that a component description is complete.
|
startGroupTemplate |
receives notification that a template description is started for a group.
|
startSetTemplate |
receives notification that a template description is started for a set.
|
endTemplate |
receives notification that a template description is complete.
|
startGroup |
receives notification that a group description is started.
|
startSet |
receives notification that a set description is started.
|
endNode |
receives notification that a node description is complete.
|
addProperty |
receives notification that a property is added to the current node.
|
addPropertyWithDefault |
receives notification that a property having a default value
is added to the current node.
|
addInstance |
receives notification that the current group has a child node
that is an instance of a specified template.
|
addItemType |
receives notification that the current set can contain items
that are instances of a specified template.
|
Methods' Details |
startSchema
- Description
- receives notification that a schema description is started.
The schema descrption may comprise components templates or both.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if a schema is already started (and has not been ended).
|
|
endSchema
- Description
- receives notification that the current schema description is complete.
Must match a previous call to startSchema .
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if invalid data is detected in the schema,
if there is a unfinished component or template in progress or
if no schema is started at all.
|
|
importComponent
void
importComponent( |
[in] string
raises(
|
aName )
MalformedDataException,
::com::sun::star::container::NoSuchElementException,
::com::sun::star::lang::IllegalArgumentException ); |
- Description
- receives notification that the schema depends on templates
from a different component.
- Parameter aName
-
specifies the name of the component.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there is a unfinished component or template in progress or
if no schema is started at all
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid component name.
- Throws
- com::sun::star::container::NoSuchElementException
if the requested component is not found.
Not every implementation can detect this condition
|
|
startComponent
void
startComponent( |
[in] string
raises(
|
aName )
MalformedDataException,
::com::sun::star::container::ElementExistException,
::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::lang::NoSupportException ); |
- Description
- receives notification that a component description is started.
Subsequent calls describe the schema of the component
until a matching call to endComponent
is encountered.
- Parameter aName
-
specifies the name of the component.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there is a unfinished component or template in progress or
if no schema is started at all
- Throws
- com::sun::star::container::ElementExistException
if there already is a component data tree of this name.
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid component name.
- Throws
- com::sun::star::lang::NoSupportException
if the instance supports no component schemas (only templates).
|
|
endComponent
- Description
- receives notification that a component description is complete.
Must match a previous call to startComponent .
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if invalid data is detected in the component,
if there is a unfinished subnode in progress or
if no component has been started at all
- Throws
- com::sun::star::lang::NoSupportException
if the instance supports no component schemas (only templates).
|
|
startGroupTemplate
void
startGroupTemplate( |
[in] TemplateIdentifier
[in] short
raises(
|
aTemplate,
aAttributes )
MalformedDataException,
::com::sun::star::container::ElementExistException,
::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::lang::NoSupportException ); |
- Description
- receives notification that a template description is started for a group.
Subsequent calls describe the members and properties of the template
until a matching call to endTemplate
is encountered.
- Parameter aTemplate
-
specifies the identity of the template.
- Parameter aAttributes
-
specifies the attributes of the template.
The value is a combination of
SchemaAttribute flags.
SchemaAttribute::EXTENSIBLE can be used
to describe a template for a node with an extensible
set of properties.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there is a unfinished component or template in progress or
if no schema is started at all
- Throws
- com::sun::star::container::ElementExistException
if there already is a template with that identifier.
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid template identifier or
if the attributes are not valid for a group.
- Throws
- com::sun::star::lang::NoSupportException
if the instance supports no templates (only component schemas).
- See also
- com::sun::star::configuration::backend::SchemaAttribute
|
|
startSetTemplate
void
startSetTemplate( |
[in] TemplateIdentifier
[in] short
[in] TemplateIdentifier
raises(
|
aTemplate,
aAttributes,
aItemType )
MalformedDataException,
::com::sun::star::container::ElementExistException,
::com::sun::star::container::NoSuchElementException,
::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::lang::NoSupportException ); |
- Description
- receives notification that a template description is started for a set.
Subsequent calls describe the members and properties of the template
until a matching call to endTemplate
is encountered.
- Parameter aTemplate
-
specifies the identity of the template.
- Parameter aAttributes
-
specifies the attributes of the template.
The value is a combination of
SchemaAttribute flags.
SchemaAttribute::EXTENSIBLE can be used
to describe a template for a node with an extensible
set of properties.
- Parameter aItemType
-
specifies the (default) template for set items.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there is a unfinished component or template in progress or
if no schema is started at all
- Throws
- com::sun::star::container::ElementExistException
if there already is a template with that identifier.
- Throws
- com::sun::star::container::NoSuchElementException
if the item-type template is not found.
Not every implementation can detect this condition
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name or item-type are not valid template identifiers or
if the attributes are not valid for a set.
- Throws
- com::sun::star::lang::NoSupportException
if the instance supports no templates (only component schemas).
- See also
- com::sun::star::configuration::backend::SchemaAttribute
|
|
endTemplate
- Description
- receives notification that a template description is complete.
Must match a previous call to startGroupTemplate
or startSetTemplate .
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if invalid data is detected in the template,
if there is a unfinished subnode in progress or
if no template has been started at all
- Throws
- com::sun::star::lang::NoSupportException
if the instance supports no templates (only component schemas).
|
|
startGroup
void
startGroup( |
[in] string
[in] short
raises(
|
aName,
aAttributes )
MalformedDataException,
::com::sun::star::container::ElementExistException,
::com::sun::star::lang::IllegalArgumentException ); |
- Description
- receives notification that a group description is started.
Subsequent calls describe the members and properties of the group
until a matching call to endNode
is encountered.
- Parameter aName
-
specifies the name of the group.
- Parameter aAttributes
-
specifies the attributes of the node.
The value is a combination of
SchemaAttribute flags.
SchemaAttribute::EXTENSIBLE can be used
to describe a group with an extensible set of properties.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there isn't a group node in progress currently
- Throws
- com::sun::star::container::ElementExistException
if there already is a node with that name.
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid node name or
if the attributes are not valid for a group.
- See also
- com::sun::star::configuration::backend::SchemaAttribute
|
|
startSet
void
startSet( |
[in] string
[in] short
[in] TemplateIdentifier
raises(
|
aName,
aAttributes,
aItemType )
MalformedDataException,
::com::sun::star::container::ElementExistException,
::com::sun::star::container::NoSuchElementException,
::com::sun::star::lang::IllegalArgumentException ); |
- Description
- receives notification that a set description is started.
Subsequent calls describe the item-types and properties of the set
until a matching call to endNode
is encountered.
- Parameter aName
-
specifies the name of the set.
- Parameter aAttributes
-
specifies the attributes of the node.
The value is a combination of
SchemaAttribute flags.
SchemaAttribute::EXTENSIBLE can be used
to describe a set with an extensible set of properties.
- Parameter aItemType
-
specifies the (default) template for set items.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there isn't a group node in progress currently
- Throws
- com::sun::star::container::ElementExistException
if there already is a node with that name.
- Throws
- com::sun::star::container::NoSuchElementException
if the item-type template is not found.
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid node name or
if the item-type is not a valid template identifier or
if the attributes are not valid for a set.
- See also
- com::sun::star::configuration::backend::SchemaAttribute
|
|
endNode
- Description
- receives notification that a node description is complete.
Must match the last open call to startGroup
or startSet .
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if the name is not a the name of the node in progress or
if invalid data is detected in the node or
if no node has been started at all
|
|
addProperty
void
addProperty( |
[in] string
[in] short
[in] type
raises(
|
aName,
aAttributes,
aType )
MalformedDataException,
::com::sun::star::beans::PropertyExistException,
::com::sun::star::beans::IllegalTypeException,
::com::sun::star::lang::IllegalArgumentException ); |
- Description
- receives notification that a property is added to the current node.
The property will have a default value of NULL
(unless it is SchemaAttribute::REQUIRED ).
- Parameter aName
-
specifies the name of the new property.
- Parameter aAttributes
-
specifies the attributes of the new property.
The value is a combination of
SchemaAttribute flags.
- Parameter aType
-
specifies the type of the new property.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there isn't a group or extensible node in progress currently
- Throws
- com::sun::star::beans::PropertyExistException
if a property with the same name already exists.
- Throws
- com::sun::star::beans::IllegalTypeException
if the specified type is not allowed
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid property name or
if the attributes are not valid for a property.
- See also
- com::sun::star::configuration::backend::SchemaAttribute
|
|
addPropertyWithDefault
void
addPropertyWithDefault( |
[in] string
[in] short
[in] any
raises(
|
aName,
aAttributes,
aDefaultValue )
MalformedDataException,
::com::sun::star::beans::PropertyExistException,
::com::sun::star::beans::IllegalTypeException,
::com::sun::star::lang::IllegalArgumentException ); |
- Description
- receives notification that a property having a default value
is added to the current node.
- Parameter aName
-
specifies the name of the new property.
- Parameter aAttributes
-
specifies the attributes of the new property.
The value is a combination of
SchemaAttribute flags.
- Parameter aDefaultValue
-
specifies the value of the new property.
The value also determines the type.
Therefore the value must not be void .
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there isn't a group or extensible node in progress currently
- Throws
- com::sun::star::beans::PropertyExistException
if a property with the same name already exists.
- Throws
- com::sun::star::beans::IllegalTypeException
if the type of the default value is not an allowed type,
or if the default value is void .
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid property name or
if the attributes are not valid for a property.
- See also
- com::sun::star::configuration::backend::SchemaAttribute
|
|
addInstance
void
addInstance( |
[in] string
[in] TemplateIdentifier
raises(
|
aName,
aTemplate )
MalformedDataException,
::com::sun::star::container::ElementExistException,
::com::sun::star::container::NoSuchElementException,
::com::sun::star::lang::IllegalArgumentException ); |
- Description
- receives notification that the current group has a child node
that is an instance of a specified template.
- Parameter aName
-
specifies the name of the new node.
- Parameter aTemplate
-
specifies a template that describes the new node.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there isn't a group node in progress currently
- Throws
- com::sun::star::container::ElementExistException
if there already is a node with that name.
- Throws
- com::sun::star::container::NoSuchElementException
if the template is not found.
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name or template name are not valid
|
|
addItemType
- Description
- receives notification that the current set can contain items
that are instances of a specified template.
- Parameter aItemType
-
specifies a template that is accepted as valid item type
for the current set node.
- Throws
- drafts::com::sun::star::configuration::backend::MalformedDataException
if there isn't a set node in progress currently
- Throws
- com::sun::star::container::NoSuchElementException
if the template is not found.
- Throws
- com::sun::star::lang::IllegalArgumentException
if the name is not a valid template name.
|
|
Copyright © 2003 Sun Microsystems, Inc.