1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 * This file is part of the LibreOffice project.
4 *
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8 *
9 * This file incorporates work covered by the following license notice:
10 *
11 *   Licensed to the Apache Software Foundation (ASF) under one or more
12 *   contributor license agreements. See the NOTICE file distributed
13 *   with this work for additional information regarding copyright
14 *   ownership. The ASF licenses this file to you under the Apache
15 *   License, Version 2.0 (the "License"); you may not use this file
16 *   except in compliance with the License. You may obtain a copy of
17 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
18 -->
19<!DOCTYPE oor:component-schema SYSTEM "../../../../component-schema.dtd">
20<oor:component-schema xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" oor:name="Addons" oor:package="org.openoffice.Office" xml:lang="en-US">
21  <info>
22    <desc>Contains general structures used to integrate external components into the Office user interface.</desc>
23  </info>
24  <templates>
25    <group oor:name="MenuItem">
26      <info>
27        <desc>Describes a menu item representing a function of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes.</desc>
28      </info>
29      <prop oor:name="URL" oor:type="xs:string">
30        <info>
31          <desc>A command URL which represents the function to execute.</desc>
32        </info>
33      </prop>
34      <prop oor:name="Title" oor:type="xs:string" oor:localized="true">
35        <info>
36          <desc>A localized string used to as the menu item title.</desc>
37        </info>
38      </prop>
39      <prop oor:name="ImageIdentifier" oor:type="xs:string">
40        <info>
41          <desc>A base name for an image to be used for the given URL. _26.bmp and _16.bmp are
42                appended to that base name for large or small size icons respectively. Has higher
43                priority than images defined in the Images set.</desc>
44        </info>
45      </prop>
46      <prop oor:name="Target" oor:type="xs:string">
47        <info>
48          <desc>This is the target URL which is used for the dispatch command. There are special URL's to address certain targets: _self, current frame; _default, default; _blank, create new frame.</desc>
49        </info>
50      </prop>
51      <prop oor:name="Context" oor:type="xs:string">
52        <info>
53          <desc>An property to define the context of a menu item that has a sub menu. It can be empty or a colon separated list of the supported application modules.</desc>
54        </info>
55      </prop>
56      <set oor:name="Submenu" oor:node-type="MenuItem">
57        <info>
58          <desc>An optional set to allow sub menus.</desc>
59        </info>
60      </set>
61    </group>
62    <group oor:name="PopupMenu">
63      <info>
64        <desc>Describes a menu item/toolbar item representing a function of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes.</desc>
65      </info>
66      <prop oor:name="Title" oor:type="xs:string" oor:localized="true">
67        <info>
68          <desc>A localized string used to as the menu title.</desc>
69        </info>
70      </prop>
71      <prop oor:name="Context" oor:type="xs:string">
72        <info>
73          <desc>An property to define the context of a top-level popup-menu . It can be empty or a colon separated list of the supported application modules.</desc>
74        </info>
75      </prop>
76      <set oor:name="Submenu" oor:node-type="MenuItem">
77        <info>
78          <desc>An optional set to allow sub menus. This property cannot be used for toolbar item definitions.</desc>
79        </info>
80      </set>
81    </group>
82    <group oor:name="MergeMenuInstruction">
83      <info>
84        <desc>Describes a merge menu instruction of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes. A menu instruction describes how the attached menu items should be merged into the Office menubar.</desc>
85      </info>
86      <prop oor:name="MergePoint" oor:type="xs:string">
87        <info>
88          <desc>A command path describe the reference point for the merge command.</desc>
89        </info>
90      </prop>
91      <prop oor:name="MergeCommand" oor:type="xs:string">
92        <info>
93          <desc>A command to be processed for this merge menu instruction.</desc>
94        </info>
95      </prop>
96      <prop oor:name="MergeCommandParameter" oor:type="xs:string">
97        <info>
98          <desc>Optional parameters for a merge command. Interpretation depends on the individual command.</desc>
99        </info>
100      </prop>
101      <prop oor:name="MergeFallback" oor:type="xs:string">
102        <info>
103          <desc>A fallback command to be used if MergeCommand cannot be applied.</desc>
104        </info>
105      </prop>
106      <prop oor:name="MergeContext" oor:type="xs:string">
107        <info>
108          <desc>A property to define the context of this merge instruction. It can be empty or a colon separated list of the supported application modules.</desc>
109        </info>
110      </prop>
111      <set oor:name="MenuItems" oor:node-type="MenuItem">
112        <info>
113          <desc>Defines the menu item(s) to be merged into the menu bar.</desc>
114        </info>
115      </set>
116    </group>
117    <group oor:name="MergeToolBarInstruction">
118      <info>
119        <desc>Describes a merge menu instruction of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes. A menu instruction describes how the attached menu items should be merged into the Office menubar.</desc>
120      </info>
121      <prop oor:name="MergeToolBar" oor:type="xs:string">
122        <info>
123          <desc>Defines the toolbar resource URL.</desc>
124        </info>
125      </prop>
126      <prop oor:name="MergePoint" oor:type="xs:string">
127        <info>
128          <desc>Describes the command that should be used as a reference point for the merge command.</desc>
129        </info>
130      </prop>
131      <prop oor:name="MergeCommand" oor:type="xs:string">
132        <info>
133          <desc>A command to be processed for this merge menu instruction.</desc>
134        </info>
135      </prop>
136      <prop oor:name="MergeCommandParameter" oor:type="xs:string">
137        <info>
138          <desc>Optional parameters for a merge command. Interpretation depends on the individual command.</desc>
139        </info>
140      </prop>
141      <prop oor:name="MergeFallback" oor:type="xs:string">
142        <info>
143          <desc>A fallback command to be used if MergeCommand cannot be applied.</desc>
144        </info>
145      </prop>
146      <prop oor:name="MergeContext" oor:type="xs:string">
147        <info>
148          <desc>A property to define the context of this merge instruction. It can be empty or a colon separated list of the supported application modules.</desc>
149        </info>
150      </prop>
151      <set oor:name="ToolBarItems" oor:node-type="ToolBarItem">
152        <info>
153          <desc>Contains a list of toolbar items used by an Add-On.</desc>
154        </info>
155      </set>
156    </group>
157    <group oor:name="ToolBarItem">
158      <info>
159        <desc>Describes a toolbar item representing a function of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes.</desc>
160      </info>
161      <prop oor:name="URL" oor:type="xs:string">
162        <info>
163          <desc>A command URL which represents the function to execute.</desc>
164        </info>
165      </prop>
166      <prop oor:name="Title" oor:type="xs:string" oor:localized="true">
167        <info>
168          <desc>A localized string used to as the menu item title.</desc>
169        </info>
170      </prop>
171      <prop oor:name="ImageIdentifier" oor:type="xs:string">
172        <info>
173          <desc>A base name for an image to be used for the given URL. _26.bmp and _16.bmp are
174                appended to that base name for large or small size icons respectively. Has higher
175                priority than images defined in the Images set.</desc>
176        </info>
177      </prop>
178      <prop oor:name="Target" oor:type="xs:string">
179        <info>
180          <desc>This is the target URL which is used for the dispatch command. There are special URL's to address certain targets: _self, current frame; _default, default; _blank, create new frame.</desc>
181        </info>
182      </prop>
183      <prop oor:name="Context" oor:type="xs:string">
184        <info>
185          <desc>A property to define the context of a toolbar item. It can be empty or a colon separated list of the supported application modules.</desc>
186        </info>
187      </prop>
188      <prop oor:name="ControlType" oor:type="xs:string">
189        <info>
190          <desc>A property to define the control type of the toolbar item. It will be interpreted as OpenOffice.org default toggle button.</desc>
191        </info>
192      </prop>
193      <prop oor:name="Width" oor:type="xs:long">
194        <info>
195          <desc>A property to define the size of a toolbar item. This property works only ControlTypes which can have a dynamic size (e.g. comboboxes, edit fields, spin fields)</desc>
196        </info>
197      </prop>
198    </group>
199    <group oor:name="MergeStatusBarInstruction">
200      <info>
201        <desc>Describes a merge status bar instruction of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes. A merge instruction describes how the attached status bar items should be merged into the Office status bar.</desc>
202      </info>
203      <prop oor:name="MergePoint" oor:type="xs:string">
204        <info>
205          <desc>Describes the command that should be used as a reference point for the merge command.</desc>
206        </info>
207      </prop>
208      <prop oor:name="MergeCommand" oor:type="xs:string">
209        <info>
210          <desc>A command to be processed for this merge instruction.</desc>
211        </info>
212      </prop>
213      <prop oor:name="MergeCommandParameter" oor:type="xs:string">
214        <info>
215          <desc>Optional parameters for a merge command. Interpretation depends on the individual command.</desc>
216        </info>
217      </prop>
218      <prop oor:name="MergeFallback" oor:type="xs:string">
219        <info>
220          <desc>A fallback command to be used if MergeCommand cannot be applied.</desc>
221        </info>
222      </prop>
223      <prop oor:name="MergeContext" oor:type="xs:string">
224        <info>
225          <desc>A property to define the context of this merge instruction. It can be empty or a colon separated list of the supported application modules.</desc>
226        </info>
227      </prop>
228      <set oor:name="StatusBarItems" oor:node-type="StatusBarItem">
229        <info>
230          <desc>Contains a list of status bar items used by an Add-On.</desc>
231        </info>
232      </set>
233    </group>
234    <group oor:name="StatusBarItem">
235      <info>
236        <desc>Describes a status bar item representing a function of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes.</desc>
237      </info>
238      <prop oor:name="Context" oor:type="xs:string">
239        <info>
240          <desc>A property to define the context of a status bar item. It can be empty or a colon separated list of the supported application modules.</desc>
241        </info>
242      </prop>
243      <prop oor:name="URL" oor:type="xs:string">
244        <info>
245          <desc>A command URL which represents the function to execute.</desc>
246        </info>
247      </prop>
248      <prop oor:name="Title" oor:type="xs:string" oor:localized="true">
249        <info>
250          <desc>A localized string used as the status bar item label.</desc>
251        </info>
252        <value></value>
253      </prop>
254      <prop oor:name="Alignment" oor:type="xs:string">
255        <info>
256          <desc>The alignment of the status bar item.</desc>
257        </info>
258        <constraints>
259          <enumeration oor:value="left">
260            <info>
261              <desc>The status bar control is aligned to the left</desc>
262            </info>
263          </enumeration>
264          <enumeration oor:value="center">
265            <info>
266              <desc>The status bar control is aligned in the center</desc>
267            </info>
268          </enumeration>
269          <enumeration oor:value="right">
270            <info>
271              <desc>The status bar control is aligned to the right</desc>
272            </info>
273          </enumeration>
274        </constraints>
275        <value>left</value>
276      </prop>
277      <prop oor:name="AutoSize" oor:type="xs:boolean">
278        <info>
279          <desc>Specifies whether the size of the status bar item is fixed (false) or not (true).</desc>
280        </info>
281        <value>false</value>
282      </prop>
283      <prop oor:name="OwnerDraw" oor:type="xs:boolean">
284        <info>
285          <desc>Specifies whether the contents of the status bar item are drawn by the client (true) or by the internal implementation (false).</desc>
286        </info>
287        <value>false</value>
288      </prop>
289      <prop oor:name="Mandatory" oor:type="xs:boolean">
290        <info>
291          <desc>Specifies whether the element can be hidden (false) or not (true) if status bar width is not sufficient to fit all elements.</desc>
292        </info>
293        <value>true</value>
294      </prop>
295      <prop oor:name="Width" oor:type="xs:long">
296        <info>
297          <desc>A property to define the size of a status bar item.</desc>
298        </info>
299        <value>0</value>
300      </prop>
301    </group>
302    <group oor:name="MergeNotebookBarInstruction">
303      <info>
304        <desc>Describes a merge menu instruction of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes. A menu instruction describes how the attached menu items should be merged into the Office menubar.</desc>
305      </info>
306      <prop oor:name="MergeNotebookBar" oor:type="xs:string">
307        <info>
308          <desc>Defines the notebookbar interface.</desc>
309        </info>
310      </prop>
311      <prop oor:name="MergePoint" oor:type="xs:string">
312        <info>
313          <desc>Describes the command that should be used as a reference point for the merge command.</desc>
314        </info>
315      </prop>
316      <prop oor:name="MergeCommand" oor:type="xs:string">
317        <info>
318          <desc>A command to be processed for this merge menu instruction.</desc>
319        </info>
320      </prop>
321      <prop oor:name="MergeCommandParameter" oor:type="xs:string">
322        <info>
323          <desc>Optional parameters for a merge command. Interpretation depends on the individual command.</desc>
324        </info>
325      </prop>
326      <prop oor:name="MergeFallback" oor:type="xs:string">
327        <info>
328          <desc>A fallback command to be used if MergeCommand cannot be applied.</desc>
329        </info>
330      </prop>
331      <prop oor:name="MergeContext" oor:type="xs:string">
332        <info>
333          <desc>A property to define the context of this merge instruction. It can be empty or a colon separated list of the supported application modules.</desc>
334        </info>
335      </prop>
336      <set oor:name="NotebookBarItems" oor:node-type="NotebookBarItem">
337        <info>
338          <desc>Contains a list of notebookbar items used by an Add-On.</desc>
339        </info>
340      </set>
341    </group>
342    <group oor:name="NotebookBarItem">
343      <info>
344        <desc>Describes a toolbar item representing a function of an external component. The name must be unique and should be written using a package-scheme like org.openoffice.external.applicationexecuter to minimize name clashes.</desc>
345      </info>
346      <prop oor:name="URL" oor:type="xs:string">
347        <info>
348          <desc>A command URL which represents the function to execute.</desc>
349        </info>
350      </prop>
351      <prop oor:name="Title" oor:type="xs:string" oor:localized="true">
352        <info>
353          <desc>A localized string used to as the menu item title.</desc>
354        </info>
355      </prop>
356      <prop oor:name="ImageIdentifier" oor:type="xs:string">
357        <info>
358          <desc>A base name for an image to be used for the given URL. _26.bmp and _16.bmp are
359                appended to that base name for large or small size icons respectively. Has higher
360                priority than images defined in the Images set.</desc>
361        </info>
362      </prop>
363      <prop oor:name="Target" oor:type="xs:string">
364        <info>
365          <desc>This is the target URL which is used for the dispatch command. There are special URL's to address certain targets: _self, current frame; _default, default; _blank, create new frame.</desc>
366        </info>
367      </prop>
368      <prop oor:name="Context" oor:type="xs:string">
369        <info>
370          <desc>A property to define the context of a notebookbar item. It can be empty or a colon separated list of the supported application modules.</desc>
371        </info>
372      </prop>
373      <prop oor:name="ControlType" oor:type="xs:string">
374        <info>
375          <desc>A property to define the control type of the notebookbar item. It will be interpreted as OpenOffice.org default toggle button.</desc>
376        </info>
377      </prop>
378      <prop oor:name="Width" oor:type="xs:long">
379        <info>
380          <desc>A property to define the size of a toolbar item. This property works only ControlTypes which can have a dynamic size (e.g. comboboxes, edit fields, spin fields)</desc>
381        </info>
382      </prop>
383      <prop oor:name="Style" oor:type="xs:string">
384        <info>
385          <desc>A property to define the style of item in a notebookbar (e.g  text, icon, text + icon)</desc>
386        </info>
387      </prop>
388    </group>
389    <group oor:name="UserDefinedImages">
390      <info>
391        <desc>A group of optional user-defined images. There are two ways to define image - 1. Embed the image data directly into the configuration. 2. Use file URLs to address external bitmap files. Embedded image data has a higher priority than file URLs.</desc>
392      </info>
393      <prop oor:name="ImageSmall" oor:type="xs:hexBinary">
394        <info>
395          <desc>Binary bitmap data used for menu images and small toolbox buttons. Standard size of a small image is 16x16 pixel.</desc>
396        </info>
397      </prop>
398      <prop oor:name="ImageBig" oor:type="xs:hexBinary">
399        <info>
400          <desc>Binary bitmap data used for big toolbox buttons. Standard size of a big image is 26x26 pixel.</desc>
401        </info>
402      </prop>
403      <prop oor:name="ImageSmallHC" oor:type="xs:hexBinary">
404        <info>
405          <desc>Binary bitmap data used for high contrast displays. Standard size of a small image is 16x16 pixel.</desc>
406        </info>
407      </prop>
408      <prop oor:name="ImageBigHC" oor:type="xs:hexBinary">
409        <info>
410          <desc>Binary bitmap data used for high contrast displays. Standard size of a big image is 26x26 pixel.</desc>
411        </info>
412      </prop>
413      <prop oor:name="ImageSmallURL" oor:type="xs:string">
414        <info>
415          <desc>A file URL to address an external bitmap file used for menu images and/or small toolbox buttons. Standard size of a small image is 16x16 pixel.</desc>
416        </info>
417      </prop>
418      <prop oor:name="ImageBigURL" oor:type="xs:string">
419        <info>
420          <desc>A file URL to address an external bitmap file used for big toolbox buttons. Standard size of a big image is 26x26 pixel.</desc>
421        </info>
422      </prop>
423      <prop oor:name="ImageSmallHCURL" oor:type="xs:string">
424        <info>
425          <desc>A file URL to address an external bitmap file used for high contrast menu images and/or toolbox buttons. Standard size of a small image is 16x16 pixel.</desc>
426        </info>
427      </prop>
428      <prop oor:name="ImageBigHCURL" oor:type="xs:string">
429        <info>
430          <desc>A file URL to address an external bitmap file used for big high contrast toolbox buttons. Standard size of a big image is 26x26 pixel.</desc>
431        </info>
432      </prop>
433    </group>
434    <group oor:name="Images">
435      <info>
436        <desc>A group that associates images to a command URL</desc>
437      </info>
438      <prop oor:name="URL" oor:type="xs:string">
439        <info>
440          <desc>The command URL that is bound to the defined images.</desc>
441        </info>
442      </prop>
443      <node-ref oor:name="UserDefinedImages" oor:node-type="UserDefinedImages">
444        <info>
445          <desc>An user-defined images group.</desc>
446        </info>
447      </node-ref>
448    </group>
449    <set oor:name="ToolBarItems" oor:node-type="ToolBarItem">
450      <info>
451        <desc>Contains a list of toolbar items used by an Add-On.</desc>
452      </info>
453    </set>
454    <set oor:name="MergeMenuItems" oor:node-type="MergeMenuInstruction">
455      <info>
456        <desc>Contains a list of merge menu instructions defined by an Add-On which specify how to merge menu items into the Office menubar.</desc>
457      </info>
458    </set>
459    <set oor:name="NotebookBarItems" oor:node-type="NotebookBarItem">
460      <info>
461        <desc>Contains a list of notebookbar items used by an Add-On.</desc>
462      </info>
463    </set>
464    <set oor:name="MergeToolBarItems" oor:node-type="MergeToolBarInstruction">
465      <info>
466        <desc>Contains a list of merge toolbar instructions defined by an Add-On which specify how to merge toolbar items into an existing toolbar.</desc>
467      </info>
468    </set>
469    <set oor:name="MergeStatusBarItems" oor:node-type="MergeStatusBarInstruction">
470      <info>
471        <desc>Contains a list of merge status bar instructions defined by an Add-On which specify how to merge status bar items into an existing status bar.</desc>
472      </info>
473    </set>
474    <set oor:name="MergeNotebookBarItems" oor:node-type="MergeNotebookBarInstruction">
475      <info>
476        <desc>Contains a list of merge notebookbar instructions defined by an Add-On which specify how to merge notebookbar items into an existing toolbar.</desc>
477      </info>
478    </set>
479  </templates>
480  <component>
481    <group oor:name="AddonUI">
482      <info>
483        <desc>Contains information about the structure of addon user interface.</desc>
484      </info>
485      <set oor:name="AddonMenu" oor:node-type="MenuItem">
486        <info>
487          <desc>Contains the structure of the addon menu used by the Office. It provides functions of external components to the user.</desc>
488        </info>
489      </set>
490      <set oor:name="Images" oor:node-type="Images">
491        <info>
492          <desc>Contains the structure for user-defined images which can be used by menu items and toolbar buttons.</desc>
493        </info>
494      </set>
495      <set oor:name="OfficeMenuBar" oor:node-type="PopupMenu">
496        <info>
497          <desc>Contains the structure of addon popup-menus inserted into the Office menubar. It provides functions of external components to the user.</desc>
498        </info>
499      </set>
500      <set oor:name="OfficeMenuBarMerging" oor:node-type="MergeMenuItems">
501        <info>
502          <desc>Contains a list of menu merging instructions of different add-ons.</desc>
503        </info>
504      </set>
505      <set oor:name="OfficeToolBar" oor:node-type="ToolBarItems">
506        <info>
507          <desc>Contains a list of sets of toolbar items that are part of add-on toolbars.</desc>
508        </info>
509      </set>
510      <set oor:name="OfficeToolbarMerging" oor:node-type="MergeToolBarItems">
511        <info>
512          <desc>Contains a list of toolbar merging instructions of different add-ons. </desc>
513        </info>
514      </set>
515      <set oor:name="OfficeStatusbarMerging" oor:node-type="MergeStatusBarItems">
516        <info>
517          <desc>Contains a list of status bar merging instructions of different add-ons. </desc>
518        </info>
519      </set>
520      <set oor:name="OfficeHelp" oor:node-type="MenuItem">
521        <info>
522          <desc>Contains a list of functions inserted into the Office help menu. The optional property 'Submenu' will be ignored for this set.</desc>
523        </info>
524      </set>
525      <set oor:name="OfficeNotebookBar" oor:node-type="NotebookBarItems">
526        <info>
527          <desc>Contains a list of sets of notebookbar items that are part of add-on notebookbar.</desc>
528        </info>
529      </set>
530      <set oor:name="OfficeNotebookBarMerging" oor:node-type="MergeNotebookBarItems">
531        <info>
532          <desc>Contains a list of notebookbar merging instructions of different add-ons. </desc>
533        </info>
534      </set>
535    </group>
536  </component>
537</oor:component-schema>
538