| absentOptional |
a list of optional properties that are not
present, and should thus not be visible via
com::sun::star::beans::XPropertySet::getPropertySetInfo,
com::sun::star::beans::XPropertySet::addPropertyChangeListener, com::sun::star::beans::XPropertySet::removePropertyChangeListener,
com::sun::star::beans::XPropertySet::addVetoableChangeListener, and com::sun::star::beans::XPropertySet::removeVetoableChangeListener. For consistency reasons, the
given absentOptional should only contain the names of
attributes that represent optional properties that are not present (that
is, the attribute getters and setters always throw a
com::sun::star::beans::UnknownPropertyException), and should
contain each such name only once. If an optional property is not present
(that is, the corresponding attribute getter and setter always throw a
com::sun::star::beans::UnknownPropertyException) but is not
contained in the given absentOptional, then it will be
visible via
com::sun::star::beans::XPropertySet::getPropertySetInfo as a
com::sun::star::beans::Property with a set
com::sun::star::beans::PropertyAttribute::OPTIONAL. If the
given implements specifies that
com::sun::star::beans::XPropertySet is not supported, then
the given absentOptional is effectively ignored and can be
empty.
|