Difference between revisions of "Documentation/DevGuide/Extensions/Options Dialog"
OOoWikiBot (Talk | contribs) m (Robot: Changing Category:Documentation/Developers Guide/Extensions) |
m |
||
(3 intermediate revisions by 3 users not shown) | |||
Line 4: | Line 4: | ||
|NextPage=Documentation/DevGuide/Extensions/Creating the GUI of the Options Page | |NextPage=Documentation/DevGuide/Extensions/Creating the GUI of the Options Page | ||
}} | }} | ||
+ | {{Documentation/DevGuideLanguages|Documentation/DevGuide/Extensions/{{SUBPAGENAME}}}} | ||
{{DISPLAYTITLE:Options Dialog}} | {{DISPLAYTITLE:Options Dialog}} | ||
− | Extensions can add options pages to {{ | + | Extensions can add options pages to {{AOo}}'s options dialog. They should '''not''' create their own menu or menu entries for the sole purpose of configuring the extension. This is what the options dialog is for. |
+ | |||
+ | It is also possible to start an options dialog from within the Extension Manager on behalf of a particular extension. An options page represents a child window that is displayed within the options dialog. An extension can provide multiple options pages. It can determine that they can be added to already existing nodes, such as “OpenOffice Writer” or “Internet Settings”. It is also possible to create completely new nodes. | ||
The specification for this feature can be found at: http://specs.openoffice.org/appwide/packagemanager/options_dialog_for_extensions.odt | The specification for this feature can be found at: http://specs.openoffice.org/appwide/packagemanager/options_dialog_for_extensions.odt | ||
− | In the following paragraphs we will show what has to be done in order to add options pages to an extension. Along the way we will go into some details where necessary. It is assumed that the reader has already knowledge about extension programming and that he or she knows how the {{ | + | In the following paragraphs we will show what has to be done in order to add options pages to an extension. Along the way we will go into some details where necessary. It is assumed that the reader has already knowledge about extension programming and that he or she knows how the {{AOo}}'s registry (including xcs and xcu files) works. |
+ | |||
+ | A note about writing some terms. When we refer to elements from the configuration schema of {{AOo}} then we use the respective uppercase names, for example Node, Module. The plural will expressed by adding a pipe symbol and the respective postfix, for example Nodes, Modules. | ||
+ | |||
+ | === Available samples === | ||
− | + | * [[API/Samples/Java/Office/OptionsPageDemo]] | |
{{PDL1}} | {{PDL1}} | ||
[[Category:Documentation/Developer's Guide/Extensions]] | [[Category:Documentation/Developer's Guide/Extensions]] |
Latest revision as of 13:27, 14 December 2020
Extensions can add options pages to Apache OpenOffice's options dialog. They should not create their own menu or menu entries for the sole purpose of configuring the extension. This is what the options dialog is for.
It is also possible to start an options dialog from within the Extension Manager on behalf of a particular extension. An options page represents a child window that is displayed within the options dialog. An extension can provide multiple options pages. It can determine that they can be added to already existing nodes, such as “OpenOffice Writer” or “Internet Settings”. It is also possible to create completely new nodes.
The specification for this feature can be found at: http://specs.openoffice.org/appwide/packagemanager/options_dialog_for_extensions.odt
In the following paragraphs we will show what has to be done in order to add options pages to an extension. Along the way we will go into some details where necessary. It is assumed that the reader has already knowledge about extension programming and that he or she knows how the Apache OpenOffice's registry (including xcs and xcu files) works.
A note about writing some terms. When we refer to elements from the configuration schema of Apache OpenOffice then we use the respective uppercase names, for example Node, Module. The plural will expressed by adding a pipe symbol and the respective postfix, for example Nodes, Modules.
Available samples
Content on this page is licensed under the Public Documentation License (PDL). |