qdr.app.tools/UILayoutDefinitionFormat/Definitions/abstract-controls.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Abstract Control Definitions for UI Layout Definition Format -->
<!-- Version: 1.0 -->
<patterns xmlns="ui-layout-patterns">
  
  <!-- Base Abstract Control -->
  <control name="CommonControl" type="base" category="abstract">
    <description>Base abstract control defining common attributes for all UI controls</description>
    <constraints>
      <allowed-parents>any</allowed-parents>
      <allowed-children>depends-on-implementation</allowed-children>
      <container>depends-on-implementation</container>
    </constraints>
    <attributes>
      <attribute name="name" type="string" required="true" />
      <attribute name="enabled" type="bool" default="true" />
      <attribute name="text" type="string" default="" />
      <attribute name="visible" type="bool" default="true" />
      <attribute name="data-source" type="string" default="" />
      <attribute name="dock" type="enum" values="none,left,right,top,bottom" default="none" />
      <attribute name="tooltip" type="string" default="" />
      <attribute name="width" type="int" min="0" max="2000" />
      <attribute name="height" type="int" min="0" max="2000" />
      <attribute name="x" type="int" />
      <attribute name="y" type="int" />
      <attribute name="anchor" type="enum" values="none,left,right,top,bottom,all" default="none" />
      <attribute name="margin" type="string" default="0,0,0,0" />
      <attribute name="padding" type="string" default="0,0,0,0" />
      <attribute name="background-color" type="string" default="transparent" />
      <attribute name="foreground-color" type="string" default="black" />
      <attribute name="font-family" type="string" default="system" />
      <attribute name="font-size" type="int" min="6" max="72" default="12" />
      <attribute name="font-style" type="enum" values="normal,italic,bold,bold-italic" default="normal" />
      <attribute name="tab-index" type="int" default="0" />
      <attribute name="access-key" type="string" default="" />
    </attributes>
    <behavior>
      <event name="click" />
      <event name="double-click" />
      <event name="mouse-enter" />
      <event name="mouse-leave" />
      <event name="key-press" />
      <event name="focus" />
      <event name="blur" />
    </behavior>
  </control>

  <!-- DISPLAY CONTROLS -->
  
  <control name="Label" type="display" category="basic" inherits="CommonControl">
    <description>Text display control for showing read-only text information</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,StatusBar,ToolBar,FormField</allowed-parents>
      <allowed-children>none</allowed-children>
      <container>false</container>
    </constraints>
    <attributes>
      <attribute name="auto-size" type="bool" default="true" />
      <attribute name="text-align" type="enum" values="left,center,right,justify" default="left" />
      <attribute name="vertical-align" type="enum" values="top,middle,bottom" default="middle" />
      <attribute name="word-wrap" type="bool" default="false" />
      <attribute name="use-mnemonic" type="bool" default="true" />
      <attribute name="associated-control" type="string" default="" />
    </attributes>
    <behavior>
      <event name="text-changed" />
    </behavior>
  </control>

  <control name="Separator" type="visual" category="basic" inherits="CommonControl">
    <description>Visual separator control for dividing interface sections</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,StatusBar,ToolBar,Menu</allowed-parents>
      <allowed-children>none</allowed-children>
      <container>false</container>
    </constraints>
    <attributes>
      <attribute name="orientation" type="enum" values="horizontal,vertical" default="horizontal" />
      <attribute name="line-style" type="enum" values="solid,dashed,dotted,double,groove,ridge,inset,outset" default="solid" />
      <attribute name="line-width" type="int" min="1" max="10" default="1" />
      <attribute name="line-color" type="string" default="gray" />
      <attribute name="auto-size" type="bool" default="true" />
      <attribute name="margin-start" type="int" min="0" max="50" default="0" />
      <attribute name="margin-end" type="int" min="0" max="50" default="0" />
    </attributes>
    <behavior>
      <event name="paint" />
    </behavior>
  </control>

  <control name="Image" type="display" category="basic" inherits="CommonControl">
    <description>Image display control for showing pictures and graphics</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,StatusBar,ToolBar,FormField,Button</allowed-parents>
      <allowed-children>none</allowed-children>
      <container>false</container>
    </constraints>
    <attributes>
      <attribute name="source" type="string" required="true" />
      <attribute name="source-type" type="enum" values="file,url,resource,base64,stream" default="file" />
      <attribute name="size-mode" type="enum" values="normal,stretch-image,auto-size,center-image,zoom" default="normal" />
      <attribute name="aspect-ratio" type="enum" values="ignore,keep,keep-by-expanding" default="keep" />
      <attribute name="interpolation-mode" type="enum" values="default,low,high,bilinear,bicubic,nearest-neighbor" default="default" />
      <attribute name="error-image" type="string" default="" />
      <attribute name="loading-image" type="string" default="" />
      <attribute name="border-style" type="enum" values="none,single,raised,sunken" default="none" />
      <attribute name="cursor-hand" type="bool" default="false" />
      <attribute name="allow-drop" type="bool" default="false" />
      <attribute name="cache-image" type="bool" default="true" />
      <attribute name="async-load" type="bool" default="false" />
      <attribute name="rotation" type="enum" values="none,rotate90,rotate180,rotate270" default="none" />
      <attribute name="flip" type="enum" values="none,horizontal,vertical,both" default="none" />
      <attribute name="opacity" type="double" min="0.0" max="1.0" default="1.0" />
      <attribute name="grayscale" type="bool" default="false" />
      <attribute name="alt-text" type="string" default="" />
    </attributes>
    <behavior>
      <event name="image-loaded" />
      <event name="image-load-error" />
      <event name="image-load-progress" />
      <event name="size-changed" />
    </behavior>
  </control>

  <!-- INPUT CONTROLS -->
  
  <control name="TextBox" type="input" category="basic" inherits="CommonControl">
    <description>Single-line text input control for user text entry</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,StatusBar,ToolBar,FormField</allowed-parents>
      <allowed-children>none</allowed-children>
      <container>false</container>
    </constraints>
    <attributes>
      <attribute name="max-length" type="int" min="0" max="32767" default="32767" />
      <attribute name="read-only" type="bool" default="false" />
      <attribute name="multiline" type="bool" default="false" />
      <attribute name="password-char" type="string" default="" />
      <attribute name="placeholder-text" type="string" default="" />
      <attribute name="text-align" type="enum" values="left,center,right" default="left" />
      <attribute name="accepts-return" type="bool" default="false" />
      <attribute name="accepts-tab" type="bool" default="false" />
      <attribute name="word-wrap" type="bool" default="true" />
      <attribute name="scroll-bars" type="enum" values="none,horizontal,vertical,both" default="none" />
      <attribute name="auto-complete-mode" type="enum" values="none,suggest,append,suggest-append" default="none" />
      <attribute name="auto-complete-source" type="string" default="" />
    </attributes>
    <behavior>
      <event name="text-changed" />
      <event name="enter-pressed" />
      <event name="selection-changed" />
      <event name="validated" />
      <event name="validating" />
    </behavior>
  </control>

  <control name="ComboBox" type="input" category="basic" inherits="CommonControl">
    <description>Dropdown selection control with editable or read-only options</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,StatusBar,ToolBar,FormField</allowed-parents>
      <allowed-children>ListBoxItem</allowed-children>
      <container>true</container>
      <requires-structure>dropdown-items</requires-structure>
    </constraints>
    <attributes>
      <attribute name="dropdown-style" type="enum" values="dropdown,simple,dropdown-list" default="dropdown" />
      <attribute name="max-dropdown-items" type="int" min="1" max="30" default="8" />
      <attribute name="selected-index" type="int" default="-1" />
      <attribute name="selected-value" type="string" default="" />
      <attribute name="auto-complete-mode" type="enum" values="none,suggest,append,suggest-append" default="none" />
      <attribute name="auto-complete-source" type="string" default="" />
      <attribute name="sorted" type="bool" default="false" />
    </attributes>
    <behavior>
      <event name="selection-changed" />
      <event name="dropdown-opened" />
      <event name="dropdown-closed" />
      <event name="text-changed" />
    </behavior>
    <structure>
      <dropdown-items max-count="unbounded" />
    </structure>
  </control>

  <!-- ACTION CONTROLS -->
  
  <control name="Button" type="action" category="basic" inherits="CommonControl">
    <description>Clickable button control for user actions</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,StatusBar,ToolBar,FormField,ButtonBar</allowed-parents>
      <allowed-children>none</allowed-children>
      <container>false</container>
    </constraints>
    <attributes>
      <attribute name="type" type="enum" values="text,image,text-image" default="text" />
      <attribute name="image" type="string" default="" />
      <attribute name="image-position" type="enum" values="left,right,top,bottom" default="left" />
      <attribute name="style" type="enum" values="normal,primary,secondary,danger,success,warning,info" default="normal" />
      <attribute name="size" type="enum" values="small,medium,large" default="medium" />
      <attribute name="auto-size" type="bool" default="false" />
      <attribute name="is-default" type="bool" default="false" />
      <attribute name="is-cancel" type="bool" default="false" />
      <attribute name="flat-style" type="bool" default="false" />
    </attributes>
    <behavior>
      <event name="click" required="true" />
      <event name="mouse-down" />
      <event name="mouse-up" />
    </behavior>
  </control>

  <!-- CONTAINER CONTROLS -->
  
  <control name="Panel" type="container" category="basic" inherits="CommonControl">
    <description>Generic container control for grouping other controls</description>
    <constraints>
      <allowed-parents>window,Panel,SplitPanel,PopupPanel,TabPage</allowed-parents>
      <allowed-children>any-control</allowed-children>
      <container>true</container>
    </constraints>
    <attributes>
      <attribute name="border-style" type="enum" values="none,single,raised,sunken,double" default="none" />
      <attribute name="border-width" type="int" min="0" max="10" default="0" />
      <attribute name="border-color" type="string" default="black" />
      <attribute name="auto-scroll" type="bool" default="false" />
      <attribute name="layout-type" type="enum" values="absolute,flow,stack,grid" default="absolute" />
      <attribute name="flow-direction" type="enum" values="left-to-right,right-to-left,top-to-bottom,bottom-to-top" default="left-to-right" />
    </attributes>
    <behavior>
      <event name="paint" />
      <event name="resize" />
      <event name="scroll" />
    </behavior>
  </control>

  <control name="PopupPanel" type="container" category="basic" inherits="Panel">
    <description>Popup container that displays above other controls</description>
    <constraints>
      <allowed-parents>window,Panel</allowed-parents>
      <allowed-children>any-control</allowed-children>
      <container>true</container>
    </constraints>
    <attributes>
      <attribute name="popup-mode" type="enum" values="modal,modeless,tooltip" default="modeless" />
      <attribute name="auto-close" type="bool" default="true" />
      <attribute name="close-on-escape" type="bool" default="true" />
      <attribute name="close-on-click-outside" type="bool" default="true" />
      <attribute name="show-close-button" type="bool" default="false" />
      <attribute name="resizable" type="bool" default="false" />
      <attribute name="movable" type="bool" default="false" />
      <attribute name="fade-in" type="bool" default="false" />
      <attribute name="fade-out" type="bool" default="false" />
      <attribute name="animation-duration" type="int" min="0" max="2000" default="200" />
    </attributes>
    <behavior>
      <event name="popup-opened" />
      <event name="popup-closed" />
      <event name="popup-opening" />
      <event name="popup-closing" />
    </behavior>
  </control>

  <!-- NAVIGATION CONTROLS -->
  
  <control name="Menu" type="navigation" category="basic" inherits="CommonControl">
    <description>Menu control for application navigation and commands</description>
    <constraints>
      <allowed-parents>window,Panel,ToolBar</allowed-parents>
      <allowed-children>MenuItem</allowed-children>
      <container>true</container>
      <requires-structure>menu-items</requires-structure>
    </constraints>
    <attributes>
      <attribute name="orientation" type="enum" values="horizontal,vertical" default="horizontal" />
      <attribute name="show-check-margin" type="bool" default="true" />
      <attribute name="show-image-margin" type="bool" default="true" />
      <attribute name="right-to-left" type="bool" default="false" />
    </attributes>
    <behavior>
      <event name="menu-activate" />
      <event name="menu-deactivate" />
      <event name="menu-collapse" />
    </behavior>
    <structure>
      <menu-items max-count="unbounded" />
    </structure>
  </control>

  <!-- LIST CONTROLS -->
  
  <control name="ListView" type="list" category="basic" inherits="CommonControl">
    <description>List view control for displaying data in various view modes</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,PopupPanel,TabPage</allowed-parents>
      <allowed-children>ListViewItem,ColumnItem</allowed-children>
      <container>true</container>
      <requires-structure>list-items,columns</requires-structure>
    </constraints>
    <attributes>
      <attribute name="view-mode" type="enum" values="details,list,large-icons,small-icons,tiles" default="details" />
      <attribute name="multi-select" type="bool" default="false" />
      <attribute name="full-row-select" type="bool" default="false" />
      <attribute name="grid-lines" type="bool" default="false" />
      <attribute name="header-style" type="enum" values="none,clickable,non-clickable" default="clickable" />
      <attribute name="sorting" type="enum" values="none,ascending,descending" default="none" />
      <attribute name="allow-column-reorder" type="bool" default="false" />
      <attribute name="hover-selection" type="bool" default="false" />
      <attribute name="hot-tracking" type="bool" default="false" />
      <attribute name="virtual-mode" type="bool" default="false" />
      <attribute name="virtual-list-size" type="int" min="0" default="0" />
    </attributes>
    <behavior>
      <event name="selected-index-changed" />
      <event name="item-activate" />
      <event name="column-click" />
      <event name="before-label-edit" />
      <event name="after-label-edit" />
      <event name="item-check" />
      <event name="virtual-items-selection-range-changed" />
    </behavior>
    <structure>
      <list-items max-count="unbounded" />
      <columns max-count="50" />
    </structure>
  </control>

  <control name="TreeView" type="list" category="basic" inherits="CommonControl">
    <description>Hierarchical tree view control for displaying nested data</description>
    <constraints>
      <allowed-parents>Panel,SplitPanel,PopupPanel,TabPage</allowed-parents>
      <allowed-children>TreeNode</allowed-children>
      <container>true</container>
      <requires-structure>tree-nodes</requires-structure>
    </constraints>
    <attributes>
      <attribute name="show-lines" type="bool" default="true" />
      <attribute name="show-plus-minus" type="bool" default="true" />
      <attribute name="show-root-lines" type="bool" default="true" />
      <attribute name="has-check-boxes" type="bool" default="false" />
      <attribute name="full-row-select" type="bool" default="false" />
      <attribute name="hot-tracking" type="bool" default="false" />
      <attribute name="hide-selection" type="bool" default="true" />
      <attribute name="label-edit" type="bool" default="false" />
      <attribute name="scrollable" type="bool" default="true" />
      <attribute name="sorted" type="bool" default="false" />
      <attribute name="path-separator" type="string" default="\" />
      <attribute name="indent" type="int" min="10" max="50" default="19" />
      <attribute name="item-height" type="int" min="10" max="50" default="16" />
    </attributes>
    <behavior>
      <event name="after-check" />
      <event name="after-collapse" />
      <event name="after-expand" />
      <event name="after-label-edit" />
      <event name="after-select" />
      <event name="before-check" />
      <event name="before-collapse" />
      <event name="before-expand" />
      <event name="before-label-edit" />
      <event name="before-select" />
      <event name="node-mouse-click" />
      <event name="node-mouse-double-click" />
    </behavior>
    <structure>
      <tree-nodes max-count="unbounded" />
    </structure>
  </control>

  <!-- STRUCTURAL DEFINITIONS -->
  
  <structure name="ListBoxItem" type="data-item" category="basic">
    <description>Individual item within list-based controls</description>
    <attributes>
      <attribute name="value" type="string" required="true" />
      <attribute name="text" type="string" required="true" />
      <attribute name="selected" type="bool" default="false" />
      <attribute name="enabled" type="bool" default="true" />
      <attribute name="image" type="string" default="" />
      <attribute name="tooltip" type="string" default="" />
      <attribute name="tag" type="object" default="null" />
    </attributes>
  </structure>

  <structure name="ListViewItem" type="data-item" category="basic">
    <description>Individual item within ListView control</description>
    <attributes>
      <attribute name="text" type="string" required="true" />
      <attribute name="value" type="string" default="" />
      <attribute name="selected" type="bool" default="false" />
      <attribute name="checked" type="bool" default="false" />
      <attribute name="focused" type="bool" default="false" />
      <attribute name="image-index" type="int" default="-1" />
      <attribute name="image-key" type="string" default="" />
      <attribute name="state-image-index" type="int" default="-1" />
      <attribute name="group" type="string" default="" />
      <attribute name="use-item-style-for-sub-items" type="bool" default="true" />
      <attribute name="tag" type="object" default="null" />
    </attributes>
    <structure>
      <sub-items max-count="unbounded" />
    </structure>
  </structure>

  <structure name="ColumnItem" type="data-item" category="basic">
    <description>Column definition for ListView control</description>
    <attributes>
      <attribute name="name" type="string" required="true" />
      <attribute name="text" type="string" required="true" />
      <attribute name="width" type="int" default="100" min="20" max="500" />
      <attribute name="sortable" type="bool" default="true" />
      <attribute name="visible" type="bool" default="true" />
      <attribute name="alignment" type="enum" values="left,center,right" default="left" />
      <attribute name="data-type" type="enum" values="text,number,date,boolean,image" default="text" />
      <attribute name="format-string" type="string" default="" />
      <attribute name="image-index" type="int" default="-1" />
      <attribute name="tag" type="object" default="null" />
    </attributes>
  </structure>

  <structure name="TreeNode" type="data-item" category="basic">
    <description>Individual node within TreeView control</description>
    <attributes>
      <attribute name="text" type="string" required="true" />
      <attribute name="value" type="string" default="" />
      <attribute name="expanded" type="bool" default="false" />
      <attribute name="selected" type="bool" default="false" />
      <attribute name="checked" type="bool" default="false" />
      <attribute name="image-index" type="int" default="-1" />
      <attribute name="image-key" type="string" default="" />
      <attribute name="selected-image-index" type="int" default="-1" />
      <attribute name="selected-image-key" type="string" default="" />
      <attribute name="state-image-index" type="int" default="-1" />
      <attribute name="state-image-key" type="string" default="" />
      <attribute name="tool-tip-text" type="string" default="" />
      <attribute name="context-menu" type="string" default="" />
      <attribute name="tag" type="object" default="null" />
    </attributes>
    <structure>
      <child-nodes max-count="unbounded" />
    </structure>
  </structure>

  <structure name="MenuItem" type="data-item" category="basic">
    <description>Individual menu item within Menu control</description>
    <attributes>
      <attribute name="text" type="string" required="true" />
      <attribute name="value" type="string" default="" />
      <attribute name="enabled" type="bool" default="true" />
      <attribute name="visible" type="bool" default="true" />
      <attribute name="checked" type="bool" default="false" />
      <attribute name="checkable" type="bool" default="false" />
      <attribute name="radio-check" type="bool" default="false" />
      <attribute name="image" type="string" default="" />
      <attribute name="shortcut-keys" type="string" default="" />
      <attribute name="show-shortcut" type="bool" default="true" />
      <attribute name="merge-type" type="enum" values="add,merge-items,remove,replace" default="add" />
      <attribute name="merge-order" type="int" default="0" />
      <attribute name="separator" type="bool" default="false" />
      <attribute name="tag" type="object" default="null" />
    </attributes>
    <structure>
      <sub-items max-count="unbounded" />
    </structure>
  </structure>

</patterns>