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+)>