PB Contains general structures used to hide a single option or an option tabpage or a whole option group. Describes one single option. Should this option be hidden?. Describes one options tabpage. Should this page be hidden? An optional set to allow to hide single options of this page. Describes a group of options tabpages. Should this whole group of options tabpages be hidden? An optional set to allow to hide single options tabpages of this group. Defines a Module. The options dialog displays entries in its tree view only if they are defined to belong to the Module for which the options dialog is being displayed. The exception is the options dialog which is invoked from the Extension Manager, where the Module is irrelevant. A set member countains a Node (see type Node) which has been assigned to this Module. Also entities which do not own the Module may add members to the set. Please look at the specification for applying restrictions (http://specs.openoffice.org/appwide/packagemanager/options_dialog_for_extensions.odt) The actual Node|s are kept in a separate set (OptionsDialog/Nodes), to prevent redundancy, because a Node can be assigned to several Module|s. The position of a node (the tree view element) within the tree view of the options dialog is determined by the property Index of each set member. The position can be different dependent on the Module. Therefore the order is determined per Module. Only the owner of the Module should set the position (property Index). The order is undefined if two or more members have the same value for the Index property. See also the description for OrderedNode. Defines a node (the tree view element) which can be displayed in the tree view of the options dialog. The localized name which is displayed next to the node in the options dialog. If two different nodes (the tree view element) happen to have the same localized name then both are displayed. URL which references the dialog editor resource. This options page should only contain information for the user and should not accept input. If true then this Node shall be displayed independent of the Module for which the options dialog is displayed - that is, always. In this case it must not be assigned directly to one ore more Module|s. That is, it must not exist as member in Module/Nodes of no existing Module. This is an optimization so that an extension need not provide entries for all Module|s. The default value is false. false Identifies a group of Node|s. All nodes (the tree view elements) which refer to the same group are displayed next to each other. If this property is set then GroupIndex must also have a value. The group will be used by Node|s which have been added to existing Module|s. If one defines a Module AND Node|s which are used in this Module, then GroupId must not be set. In this case one uses Module/Nodes/Index to determine the position of the nodes (the tree view element). The empty string is no valid identifier and represents nil. See also GroupIndex. The index of the Node within the group. The index starts with null. If this property is set then property GroupId must also have a value. If a Node of this group is displayed depends on the respective Module to which it is assigned. For example, if there are the Nodes A(index 0), B (index 1), and C (index 2) in a group, and B is assigned to a different Module, then only A and B are displayed together although there indices are 0 and 2 (B has 1). The value -1 is regarded as nil. Actually one could have allowed to define a group per Module, so that the order could be different depending on the Module. But this would have added more complexity to the data structures. -1 Leaves which are assigned to this node. Extensions can add to this set new Leaf|s. Defines a leaf (the tree view element). A Leaf must be assigned to exactly one Node. The unique identifier of the Leaf. This must be the extension identifier if this Leaf was defined by an extension. The localized name that is displayed for the leaf in the options dialog. A URL which references the window resource. Name of the event handler service which is used as argument in com.sun.star.awt.XContainerWindowProvider.createContainerWindow. This handler does not even process events from the options page but also provides for saving and reading the respective values. Identifies a group of Leaf|s. All Leaf|s which have the same GroupId form a group and the corresponding entries in the tree view are displayed next to each other. If this property is set then the property GroupIndex must also be set. The GroupIndex represents the position within the group. If one owns the Node (e.g. defined it oneself) then one can set the GroupId to the name of the Node to which this Leaf is assigned. The Leaf|s of this particular group are displayed first under the node (the tree view element) before any other groups. If one does not own the Node then one should not use the Node name as group id. The empty string is regarded as nil. The index of the Leaf within the group. The index starts with null. If this property is set then GroupId must also have a value. If there are two Leaf|s with the same index in the same group then then their order is undefined. The value -1 is regarded as nil. -1 Represents a reference to a Node and an optional index. Instances of this type are used in a set (see Module). The name of the set member must be the same as the one of the respective Node. The index determines the position of the node (the tree view element) in the options dialog for a particular Module. Determines the position of the node in the options dialog. The index starts with null. That is, the corresponding node appears at the first position in the tree view of the options dialog. If the value is -1 then the index is undefined. If one adds Node|s to a Module which one does not define oneself (e.g. the Module is owned by someone else), then one must not set the Index. This applies, for example, to extensions which add their Node|s to existing Module|s. The value -1 is regarded as nil. -1 Contains the set of single options, options tabpages and options groups which should be hidden. Hidden options List of availabe application contexts List of available nodes.