* Originally Copyright (c) 2000 Federico David Sacerdoti >tech@slinuxmachines.com< * Modifications/Extensions Simon Hausmann >hausmann@kde.org< * Minor updates Richard J. Moore >rich@kde.org< * Conversion to XSD (c) 2004 Frans Englich <frans.englich@telia.com> Permission to use, copy, modify and distribute this XSD and its accompanying documentation for any purpose and without fee is hereby granted in perpetuity, provided that the above copyright notice and this paragraph appear in all copies. The copyright holders make no representation about the suitability of the XSD for any purpose. It is provided "as is" without expressed or implied warranty. This is the XML Schema for KDE's XMLGUI framework, a way of describing a application's Graphical User Interface in an XML file. A document of this Schema should have a declaration looking like this: ]]> Where the name and version tag is of your taste. The name used for every name and group attribute. Maps to QObject::name() in most cases. Inserts a separator item into a menubar or toolbar. Inserts a spacer item into a toolbar. 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. 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. The user visible string shown as titles. 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 KAction 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, iconText, shortcut, icon, priority: all those are mapped to KAction properties. Specifies a dynamic list of actions, each of which can be changed by plugging/unplugging it A Menu such as the "File" or "Edit" menu. Can be used to define popup menus as well. 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, otherwise the changes will not be taken into account. A tool bar. Attributes: - name: a unique name for the toolbar, use mainToolBar for the main one - 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) - offset: the X offset in the toolbar dock (see QMainWindow::moveToolBar) TODO: Those APIs are obsolete, are the attribute too? - 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 Defines a GUI state, esp. which actions to enable and which ones to disable on entering this state (see KXMLGUIClient::stateChanged()). Actions listed in "disable" are disabled, and vice versa for "enable". Allows standard actions to be customized.