<!-- Originally Copyright (c) 2000 Federico David Sacerdoti <tech@slinuxmachines.com> Modifications/Extensions by Simon Hausmann <hausmann@kde.org> Minor updates by Richard J. Moore <rich@kde.org> This DTD module is identified by the PUBLIC and SYSTEM identifiers: PUBLIC "-//KDE Project//KPartGUI DTD//EN" SYSTEM "kpartgui.dtd" This DTD should be included at the head of an xmlguibuilder XML file like this: <!DOCTYPE kpartgui SYSTEM "kpartgui.dtd"> --> <!--The root element that must enclose all other tags in the document. This element replaces the kpartgui element used previously. NOTE: do not forget to increase the version attribute for each change in your file or the changes will not be taken!! --> <!ELEMENT gui ((ActionProperties | MenuBar | ToolBar | Merge | MergeLocal | DefineGroup | MainWindow | StatusBar | Menu | State)*)> <!ATTLIST gui name CDATA #REQUIRED version CDATA #REQUIRED library CDATA #IMPLIED > <!-- DEPRECATED: The old root element that must enclose all other tags in the document. --> <!ELEMENT kpartgui ((ActionProperties | MenuBar | ToolBar | Merge | MergeLocal | DefineGroup | MainWindow | StatusBar | Menu | State)*)> <!ATTLIST kpartgui name CDATA #REQUIRED version CDATA #REQUIRED library CDATA #IMPLIED > <!-- Allows standard actions to be customized --> <!ELEMENT ActionProperties (Action+)> <!-- A menu bar --> <!ELEMENT MenuBar ((Menu | Separator | Action | ActionList | Merge | MergeLocal | DefineGroup )*)> <!ATTLIST MenuBar name CDATA #IMPLIED group CDATA #IMPLIED > <!-- A tool bar - Attributes: name: a unique name for the toolbar, use mainToolBar for the main one - fullWidth: if true (default), the toolbar extends to the full width of the window - position: the position of the toolbar in the window - iconText: whether to show icon or text or both - iconSize: the size of the icons (0 for default, or usually 22 or 32) - index: the index in the toolbar dock (see QMainWindow::moveToolBar; starts at 0) - offset: the X offset in the toolbar dock (see QMainWindow::moveToolBar) - newline: if true, this toolbar will start a new line (i.e. under the ones before it). - group: optional group name, for named merging (?) - hidden: if true, the toolbar is initially hidden. There should be a menu entry for showing it. - noEdit: if true, the toolbar won't appear in the toolbar editor --> <!ELEMENT ToolBar (text?, (Action | Separator | WeakSeparator | ActionList | Merge | MergeLocal | DefineGroup)*)> <!ATTLIST ToolBar name CDATA #REQUIRED fullWidth (true|false) "true" position (top|bottom|left|right) "top" iconText (icononly|textonly|icontextright|icontextbottom) #IMPLIED iconSize CDATA #IMPLIED index CDATA #IMPLIED offset CDATA #IMPLIED newline (true|false) "false" group CDATA #IMPLIED hidden (true|false) "false" noEdit (true|false) "false" > <!-- A Menu such as the "File" or "Edit" menu. Can be used to define popup menus as well. --> <!ELEMENT Menu (text?, (title | Action | ActionList | Separator | WeakSeparator | TearOffHandle | Merge | MergeLocal | DefineGroup | Menu )*)> <!ATTLIST Menu append CDATA #IMPLIED name CDATA #REQUIRED group CDATA #IMPLIED icon CDATA #IMPLIED noMerge (0|1) "0" > <!-- Defines both Standard and app-specific actions. An action can appear in a menu, a toolbar or in a menubar. Attributes: - name of the action: this is matched with the TDEAction name. - group: this is used to control the placement of the action when merging e.g. a part, it matches the name of a DefineGroup in the mainwindow's rc file. - append: this is used to control the placement of the action during the merging with ui_standards.rc. This is mapped to MergeLocal tags there. Note that this feature is currently only available for the mainwindow, not for parts/plugins. - text, whatsThis, toolTip, shortText, shortcut, icon: all those are mapped to TDEAction properties. --> <!ELEMENT Action EMPTY> <!-- We defined only a few standard TDEAction properties here. Theoritically we can have any property here --> <!ATTLIST Action name CDATA #REQUIRED group CDATA #IMPLIED append CDATA #IMPLIED text CDATA #IMPLIED whatsThis CDATA #IMPLIED toolTip CDATA #IMPLIED shortText CDATA #IMPLIED shortcut CDATA #IMPLIED icon CDATA #IMPLIED > <!-- Inserts a separator item into a menubar or toolbar --> <!ELEMENT Separator EMPTY> <!ATTLIST Separator lineSeparator (true|false) "true" group CDATA #IMPLIED > <!ELEMENT WeakSeparator EMPTY> <!-- Inserts a tear-off handle into a menu --> <!ELEMENT TearOffHandle EMPTY> <!ATTLIST TearOffHandle group CDATA #IMPLIED > <!-- Used to insert titles, only for popup menus --> <!ELEMENT title (#PCDATA)> <!ATTLIST title icon CDATA #IMPLIED > <!-- Used to name a menu, the first letter in is generally preceded by an '&' to specify the menu's shortcut key --> <!ELEMENT text (#PCDATA)> <!ATTLIST text context CDATA #IMPLIED > <!-- Specifies a dynamic list of actions, each of which can be changed by plugging/unplugging it --> <!ELEMENT ActionList EMPTY> <!ATTLIST ActionList name CDATA #REQUIRED > <!-- Not explicitly defined or in widely used yet. --> <!ELEMENT MainWindow (ANY)> <!-- Not explicitly defined or in widely used yet. --> <!ELEMENT StatusBar (ANY)> <!-- Specifies the entry index for merging in a gui client --> <!ELEMENT Merge EMPTY> <!ATTLIST Merge name CDATA #IMPLIED > <!-- Specifies an entry index for merging application defined actions into those with positions fixed by the style guide and ui_standards.rc. This tag should not be used anywhere except ui_standards.rc. --> <!ELEMENT MergeLocal EMPTY> <!ATTLIST MergeLocal name CDATA #IMPLIED > <!-- Specifies a entry index for merging, similar to the Merge tag, but with a global scope and accessible via the group attribute of other tags --> <!ELEMENT DefineGroup EMPTY> <!ATTLIST DefineGroup name CDATA #REQUIRED > <!-- Defines a GUI state, esp. which actions to enable and which ones to --> <!-- disable on entering this state (see KXMLGUIClient::stateChanged()) --> <!ELEMENT State ( enable | disable | (enable, disable))> <!ATTLIST State name CDATA #REQUIRED > <!-- used in State to collect actions to be enabled and disabled, resp., --> <!-- on entering the state --> <!ELEMENT enable (Action+)> <!ELEMENT disable (Action+)>