Warning, /graphics/krita/libs/widgetutils/xmlgui/kpartgui.dtd is written in an unsupported language. File is not indexed.
0001 <!-- Originally Copyright (c) 2000 Federico David Sacerdoti <tech@slinuxmachines.com> 0002 Modifications/Extensions by Simon Hausmann <hausmann@kde.org> 0003 Minor updates by Richard J. Moore <rich@kde.org> 0004 0005 This DTD module is identified by the PUBLIC and SYSTEM 0006 identifiers: 0007 PUBLIC "-//KDE Project//KPartGUI DTD//EN" 0008 SYSTEM "kpartgui.dtd" 0009 0010 This DTD should be included at the head of an xmlguibuilder XML file like this: 0011 <!DOCTYPE kpartgui SYSTEM "kpartgui.dtd"> 0012 --> 0013 0014 <!--The root element that must enclose all other tags in the document. This element 0015 replaces the kpartgui element used previously. 0016 0017 NOTE: do not forget to increase the version attribute for each change in 0018 your file or the changes will not be taken!! 0019 --> 0020 <!ELEMENT gui ((ActionProperties | MenuBar | ToolBar | Merge | MergeLocal | DefineGroup | MainWindow | StatusBar | Menu | State)*)> 0021 <!ATTLIST gui 0022 name CDATA #REQUIRED 0023 version CDATA #REQUIRED 0024 library CDATA #IMPLIED 0025 translationDomain CDATA #IMPLIED 0026 > 0027 0028 <!-- DEPRECATED: The old root element that must enclose all other tags in the document. --> 0029 <!ELEMENT kpartgui ((ActionProperties | MenuBar | ToolBar | Merge | MergeLocal | DefineGroup | MainWindow | StatusBar | Menu | State)*)> 0030 <!ATTLIST kpartgui 0031 name CDATA #REQUIRED 0032 version CDATA #REQUIRED 0033 library CDATA #IMPLIED 0034 translationDomain CDATA #IMPLIED 0035 > 0036 0037 <!-- Allows standard actions to be customized --> 0038 <!ELEMENT ActionProperties (Action+)> 0039 0040 <!-- A menu bar --> 0041 <!ELEMENT MenuBar ((Menu | Separator | Action | ActionList | Merge | MergeLocal | DefineGroup )*)> 0042 <!ATTLIST MenuBar 0043 name CDATA #IMPLIED 0044 group CDATA #IMPLIED 0045 > 0046 0047 <!-- A tool bar 0048 - Attributes: name: a unique name for the toolbar, use mainToolBar for the main one 0049 - position: the position of the toolbar in the window (only effective if the user 0050 has never used the application before) 0051 - iconText: whether to show icon or text or both 0052 - iconSize: the size of the icons (0 for default, or usually 22 or 32) 0053 - index: the index in the toolbar dock (see QMainWindow::moveToolBar; starts at 0) 0054 - offset: the X offset in the toolbar dock (see QMainWindow::moveToolBar) 0055 - newline: if true, this toolbar will start a new line (i.e. under the ones before it). 0056 - group: optional group name, for named merging (?) 0057 - hidden: if true, the toolbar is initially hidden. There should be a menu entry for showing it. 0058 - noEdit: if true, the toolbar won't appear in the toolbar editor 0059 - noMerge: if true, the standard toolbar layout from ui_standards.xmlgui won't be used. 0060 - deleted: if true, the toolbar will not be created, even if ui_standards.xmlgui mentions it 0061 --> 0062 <!ELEMENT ToolBar (text?, (Action | Separator | ActionList | Merge | MergeLocal | DefineGroup)*)> 0063 <!ATTLIST ToolBar 0064 name CDATA #REQUIRED 0065 position (top|bottom|left|right) "top" 0066 iconText (icononly|textonly|icontextright|icontextbottom) #IMPLIED 0067 iconSize CDATA #IMPLIED 0068 index CDATA #IMPLIED 0069 offset CDATA #IMPLIED 0070 newline (true|false) "false" 0071 group CDATA #IMPLIED 0072 hidden (true|false) "false" 0073 noEdit (true|false) "false" 0074 noMerge (0|1) "0" 0075 deleted (true|false) "false" 0076 > 0077 0078 <!-- A Menu such as the "File" or "Edit" menu. Can be used to define popup menus as well. 0079 - noMerge: if true, the standard menu layout from ui_standards.xmlgui won't be used. 0080 - deleted: if true, the menu will not be created, even if ui_standards.xmlgui mentions it 0081 --> 0082 <!ELEMENT Menu (text?, (title | Action | ActionList | Separator | TearOffHandle | Merge | MergeLocal | DefineGroup | Menu )*)> 0083 <!ATTLIST Menu 0084 append CDATA #IMPLIED 0085 name CDATA #REQUIRED 0086 group CDATA #IMPLIED 0087 icon CDATA #IMPLIED 0088 noMerge (0|1) "0" 0089 deleted (true|false) "false" 0090 > 0091 0092 <!-- Defines both Standard and app-specific actions. An action can appear in a menu, a toolbar or in a 0093 menubar. 0094 Attributes: 0095 - name of the action: this is matched with the KAction name. 0096 - group: this is used to control the placement of the action when merging 0097 e.g. a part, it matches the name of a DefineGroup in the mainwindow's rc file. 0098 - append: this is used to control the placement of the action during the 0099 merging with ui_standards.xmlgui. This is mapped to MergeLocal tags there. 0100 Note that this feature is currently only available for the mainwindow, not for parts/plugins. 0101 - text, whatsThis, toolTip, iconText, shortcut, icon, priority: all those are mapped 0102 to KAction properties. 0103 --> 0104 <!ELEMENT Action EMPTY> 0105 <!-- We defined only a few standard KAction properties here. Theoretically we can have 0106 any property here --> 0107 <!ATTLIST Action 0108 name CDATA #REQUIRED 0109 group CDATA #IMPLIED 0110 append CDATA #IMPLIED 0111 text CDATA #IMPLIED 0112 whatsThis CDATA #IMPLIED 0113 toolTip CDATA #IMPLIED 0114 iconText CDATA #IMPLIED 0115 shortcut CDATA #IMPLIED 0116 icon CDATA #IMPLIED 0117 priority CDATA #IMPLIED 0118 > 0119 0120 <!-- Inserts a separator item into a menubar or toolbar --> 0121 <!ELEMENT Separator EMPTY> 0122 <!ATTLIST Separator 0123 lineSeparator (true|false) "true" 0124 weakSeparator (true|false) "true" 0125 group CDATA #IMPLIED 0126 > 0127 0128 <!-- Inserts a tear-off handle into a menu --> 0129 <!ELEMENT TearOffHandle EMPTY> 0130 <!ATTLIST TearOffHandle 0131 group CDATA #IMPLIED 0132 > 0133 0134 <!-- Used to insert titles, only for popup menus --> 0135 <!ELEMENT title (#PCDATA)> 0136 <!ATTLIST title 0137 translationDomain CDATA #IMPLIED 0138 icon CDATA #IMPLIED 0139 > 0140 0141 <!-- Used to name a menu, the first letter in is generally preceded by an '&' to specify 0142 the menu's shortcut key --> 0143 <!ELEMENT text (#PCDATA)> 0144 <!ATTLIST text 0145 translationDomain CDATA #IMPLIED 0146 context CDATA #IMPLIED 0147 > 0148 0149 <!-- Specifies a dynamic list of actions, each of which can be changed by plugging/unplugging it --> 0150 <!ELEMENT ActionList EMPTY> 0151 <!ATTLIST ActionList 0152 name CDATA #REQUIRED 0153 > 0154 0155 <!-- Not explicitly defined or in widely used yet. --> 0156 <!ELEMENT MainWindow (ANY)> 0157 0158 <!-- Not explicitly defined or in widely used yet. --> 0159 <!ELEMENT StatusBar (ANY)> 0160 0161 <!-- Specifies the entry index for merging in a gui client --> 0162 <!ELEMENT Merge EMPTY> 0163 <!ATTLIST Merge 0164 name CDATA #IMPLIED 0165 > 0166 0167 <!-- Specifies an entry index for merging application defined actions into 0168 those with positions fixed by the style guide and ui_standards.xmlgui. This 0169 tag should not be used anywhere except ui_standards.xmlgui. --> 0170 <!ELEMENT MergeLocal EMPTY> 0171 <!ATTLIST MergeLocal 0172 name CDATA #IMPLIED 0173 > 0174 0175 <!-- Specifies a entry index for merging, similar to the Merge tag, but with a global scope and 0176 accessible via the group attribute of other tags --> 0177 <!ELEMENT DefineGroup EMPTY> 0178 <!ATTLIST DefineGroup 0179 name CDATA #REQUIRED 0180 > 0181 0182 <!-- Defines a GUI state, esp. which actions to enable and which ones to --> 0183 <!-- disable on entering this state (see KisKXMLGUIClient::stateChanged()) --> 0184 <!ELEMENT State ( (enable, disable?) | disable )> 0185 <!ATTLIST State 0186 name CDATA #REQUIRED 0187 > 0188 0189 <!-- used in State to collect actions to be enabled and disabled, resp., --> 0190 <!-- on entering the state --> 0191 <!ELEMENT enable (Action+)> 0192 <!ELEMENT disable (Action+)>