||describes the property categories used by the property handlers.
||retrieves an index in a global property ordering, for a given property name
||describes a set of factories for creating XPropertyHandlers
||indicates that the object inspector should have a help section.
||denotes the minimum number of lines of text to be reserved for the help
||denotes the maximum number of lines of text to be reserved for the help
||determines whether the object inspector's UI should be read-only.
- describes the property categories used by the property handlers.
Properties can be sorted into different categories, described by the LineDescriptor::Category
attribute, which is filled in XPropertyHandler::describePropertyLine
method of your property handler.
Those names provided by the handlers are programmatic names. All other information
about categories is part of the PropertyCategoryDescriptor, and
describeCategories assembles information about all categories which
all property handlers provided by the model use.
- a sequence of category descriptors. Their relative ordering also describes
the relative ordering of the categories in the ObjectInspector's
The sequence must not contain two entries with the same programmatic name.
The model implementation might return an empty sequence here, in this case, the ObjectInspector
automatically builds its category information from the categories provided by the
- See also
- PropertyCategoryDescriptor, LineDescriptor::Category
|| PropertyName );
- retrieves an index in a global property ordering, for a given property name
In the user interface of an ObjectInspector, single properties are represented by
single lines, and those lines are displayed successively. To determine an order of
the property lines, the inspector model can associate an "order index" with each property.
The ObjectInspector will then sort the property lines in a way that they
have the same relative ordering as the "order indexes" of their properties.
Note that the concrete value the model returns for a given property does not
matter. All what matters is that if you want a certain property
to be displayed after another property
Bar, then the order index
Foo should be greater than the order index of
If for two different properties the same order index is returned, the
ObjectInspector will assume the order in which those properties
were provided by the respective property handler
If two such properties originate from different handlers, they will be ordered according
to the order of the handlers, as provided in the HandlerFactories attribute.
- Parameter PropertyName
- the property whose global order index should be retrieved
- the global order index of PropertyName.
Top of Page
|[ readonly ] sequence< any > HandlerFactories;
- describes a set of factories for creating XPropertyHandlers
Every element of the sequence must contain information to create a
XPropertyHandler instance. Two ways are currently supported:
- A sevice name:
If a sequence element contains a string, this string is interpreted
as service name, and an ::com::sun::star::lang::XMultiComponentFactory
is asked to create an instance of this service.
- A factory:
If a sequence element contains an instance implementing the
::com::sun::star::lang::XSingleComponentFactory interface, this factory
is used to create a property handler.
This attribute is usually only evaluated by the ObjectInspector instance
which the model is currently bound to.
The order of factories is important: If two property handlers declare themself responsible
for the same property, the one whose factory is listed last wins. Also,
if a handler
B wants to supersede a property of another handler
A's factory must precede the factory of
- See also
- XPropertyHandler::getSupportedProperties, XPropertyHandler::getSupersededProperties
|[ readonly ] boolean HasHelpSection;
- indicates that the object inspector should have a help section.
The object inspector displays lines of property/values, optionally grouped
into categories, as described by the property handlers.
Additionally, the inspector can optionally display a section dedicated to help
texts. Clients could use this section to display context-sensitive help, for
instance short texts explaining the currently selected property.
- OOo 2.2
|[ bound ] boolean IsReadOnly;
- determines whether the object inspector's UI should be read-only.
In this case, the user is able to browse through all properties, but cannot
change any of them.
In a read-only object inspector, the property controls are readonly or
disabled themself, and the primary and secondary buttons of a property line
are both disabled.
- See also
- XPropertyControl, LineDescriptor
Copyright © 2013, The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache, the Apache feather logo, Apache OpenOffice and OpenOffice.org are trademarks of The Apache Software Foundation. Other names may be trademarks of their respective owners.