https://www.xt-solution.cn/xdoc/ 2026-10-23T18:27:17+00:00 https://www.xt-solution.cn/xdoc/ https://www.xt-solution.cn/xdoc/lib/tpl/dokuwiki/images/favicon.ico text/html 2024-04-26T11:57:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xactionctrl&rev=1714103823&do=diff 动作 动作控件的XML标签为Action，提供了一个抽象的用户界面操作，它可能包含图标、菜单文本、快捷方式、状态文本和工具提示， 动作可以作为独立对象创建，但也可以在构建菜单时创建。点击动作控件会触发triggered事件，开发者可以在命令的onControlEvent中编写响应代码。较常见的动态交互方式是将该控件关联另一个控件（通过value和ref_url属性），点击动作控件则在另外一个容器中（如堆栈控件）将关联控件按照ref_url构建并变为容器的当前控件。… text/html 2024-02-28T14:24:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xbuttonctrl&rev=1709101481&do=diff 按钮 按钮的XML标签为Button，点击它会触发Event_Clicked事件，开发者在命令的onControlEvent接口中处理该事件，在需要单击鼠标弹出对话框的场合，XCGS为按钮提供了ref_url的扩展以指定弹出对话框的配置文件路径以简化开发过程。 text/html 2024-04-26T11:57:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xcheckctrl&rev=1714103823&do=diff 复选框 复选框的XML标签为Check，数据交换宏为DX_Check，勾选或勾掉它会触发Event_Clicked事件，开发者在命令的onControlEvent接口中处理该事件。 控件属性关键字 name 控件名，其值类型为字符串，控件名只能以字母开头，可包含数字、下划线、点符号。参考示例：name= text/html 2024-02-28T14:24:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xchildctrl&rev=1709101481&do=diff 子部件 子部件的XML标签为Child，它是命令窗口的根，所有XCGS的配置都在子部件中实现，它可以包含其他子部件，它仅有name属性和ref_url属性，其中ref_url属性用于指定配置文件路径。它为XCGS提供了嵌套机制，允许通过组织多个xml文件配置复杂对话框，使得配置文件可以复用，其使用更结构化，文件更易读易修改易维护。需要注意的是子部件中定义的控件名须保证不得与上一级控件中的控件名冲突。… text/html 2024-02-27T11:12:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xcolorctrl&rev=1709003534&do=diff 下拉框 下拉框（Combo）可以包含option的子节点用于指定下拉选项。 * 控件属性 属性 描述 例子 备注 name 控件名，字符串 name=“mat_item_name_label” width 控件的宽度，整型, 单位为像素 text/html 2024-04-26T11:57:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xcomboctrl&rev=1714103823&do=diff 下拉框 下拉框的XML标签为Combo，其实现类为XComboCtrl，下拉框包含若干选项，每个选项可绑定一个值，数据交换宏为DX_Combo（交换变量类型为整型，对应当前选项绑定的整数值）或DX_ComboStr（交换变量为文本字符串，对应当前选项的显示文本）或DX_Combo_Default（与DX_Combo类似，区别是如果用户没有选择任何选项，会按照默认值交换到变量中），它支持若干扩展：过滤扩展，选项配置文件扩展，单位扩展。下拉框的下拉项可以与Tab控件或Stack控件的子控件项绑定对应，即Tab控件或Stack控件会根据下拉框的当前选项切换到对应的子控件上。一般Tab控件（或Stack控件）在加载时会把所有的子控件构建出来，在某些情况下，由于子控件所包含的内容较多，导致对话框加载较慢，为了解决这个问题，可以为下拉框的选项设定ref_url属性以指定和它关联的子控件的配置文件，这样子控件的构建只有在切换到下拉框对应的选项时才实时构建，有效提高第一次加载对话框的速度。… text/html 2024-02-27T11:12:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xcurvectrl&rev=1709003534&do=diff 下拉框 下拉框（Combo）可以包含option的子节点用于指定下拉选项。 * 控件属性 属性 描述 例子 备注 name 控件名，字符串 name=“mat_item_name_label” width 控件的宽度，整型, 单位为像素 text/html 2024-04-26T11:57:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xeditctrl&rev=1714103823&do=diff 编辑框 编辑框的标签为Edit，其实现类为XEditCtrl，数据交换宏为DX_Edit，它支持若干扩展：校验规则扩展，文件或目录扩展，浮点数变量场扩展，单位扩展。编辑框焦点状态时，回车会触发对话框的onControlEvent接口。如果编辑框定义了校验规则扩展，当编辑框的内容变化会触发校验事件。 text/html 2024-04-26T11:57:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xlabelctrl&rev=1714103823&do=diff 标签 标签的XML标签为Label，标签一般用于向用户提示后面的控件的意义和用途，在不参与用户交互的场景中，配置标签的时候可以不设置标签名，这时XCGS会自动赋予一个唯一的名字给它。需要注意的是，在表单布局中，标签不会被显示声明，它会在创建表单控件时自动生成，并且它的名字和控件名存在对应关系。标签还支持背景图片的扩展，允许在标签中显示图片。 text/html 2024-02-27T11:12:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xlayoutf&rev=1709003534&do=diff 表单布局 表单布局的标签为FLayout，它是一种为了方便用户使用的定制版栅格布局，该布局仅包含两列，第一列为标签栏，第二列为控件栏，定义该布局的时候仅需添加第二列控件栏的控件即可，与普通的控件定义相比，唯一的区别是需要添加label属性用以指定它所对应的标签的显示文本。表单布局中的控件按照行的顺序从下到下布置，XCGS会自动创建控件所对应的标签控件并赋予其唯一的控件名，标签的文本即为label属性值，所有行的标签的宽度一样，所有行的控件宽度也一样（除非特别指定控件的宽度），可以通过control_width和label_width分别定义这两列的宽度。表单布局极大的简化了用户定制表单对话框的工作。但是需要注意的是，表单布局不能嵌套包含其他子布局。… text/html 2024-02-27T11:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xlayoutg&rev=1709004576&do=diff 栅格布局 栅格布局的标签为GLayout，和表格控件类似，它是一个M行*N列的二维布局，它的下级结构是标签为Row的节点数组，每一个Row节点标识栅格布局中的一行，控件或其他子布局按顺序添加在Row节点中，Row还可以添加Space节点以占据栅格的格子，此时该格子会被空置跳过，所有Row节点所包含的子节点个数需相同。GLayout可以定义栅格布局包含多少列，此时需要注意的是所有的Row节点的子节点个数应不大于布局的列数。默认情况下不指定行数和列数，GLayout会根据子节点信息自动获得行数和列数。… text/html 2024-02-27T11:12:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xlayouth&rev=1709003534&do=diff 水平布局 布局用来布置控件在对话框中的位置。水平布局的标签为VLayout。水平布局中的控件按照从左到右的顺序放置，水平布局可嵌套包含任意其他子布局。 属性关键字 name 布局名，其值类型为字符串，不可与其他控件名或布局名重复冲突，布局名只能以字母开头，可包含数字、下划线、点符号。参考示例：name= text/html 2024-02-27T11:12:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xlayoutv&rev=1709003534&do=diff 垂直布局 布局用来布置控件在对话框中的位置。垂直布局的标签为VLayout。垂直布局中的控件按照从左到右的顺序放置，垂直布局可嵌套包含任意其他子布局。 属性关键字 name 布局名，其值类型为字符串，不可与其他控件名或布局名重复冲突，布局名只能以字母开头，可包含数字、下划线、点符号。参考示例：name= text/html 2024-02-27T11:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xlistctrl&rev=1709004576&do=diff 列表控件 列表控件的标签为List，其实现类为XListCtrl。列表控件包含若干列表项，列表项可绑定特征值（不同列表项的特征值不可重复，否则冲突），且列表项可设置前置勾选框使用户可以勾选某个列表项。列表控件可以直接设置各种关键字，也可以通过ref_url指定控件的参考配置文件对列表控件进行配置。 text/html 2024-02-27T11:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xpanelctrl&rev=1709004576&do=diff 面板控件 面板控件的标签为Panel，其实现类为XPanelCtrl。面板控件是一个带标题的组合容器控件，它提供了一个可以折叠可以激活的面板，使用面板时必须像一个独立的窗口一样定义布局（Layout），面板中的控件均在其中被组织布局。面板的表现形式是一个标题栏，激活勾选框被放置在标题栏的左边，折叠按钮放置在标题栏的右边，标题栏的下方是面板的控件所占据的空间。默认情况下，激活勾选框和折叠按钮均不可见。当面板可激活时，用户勾掉激活框面板下的所有控件均变灰，不再支持交互操作，如果勾选激活框，则所有子控件均恢复正常。当面板可折叠时，用户点击折叠按钮，所有子控件均将隐藏起来只显示标题栏，再次点击折叠按钮，所有子控件恢复显示。… text/html 2024-02-28T14:24:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xradioctrl&rev=1709101481&do=diff 单选框 单选框的XML标签为Radio，每个单选框都可以绑定一个整数值，可以使用命令窗口的exchangeRadioCheckData的接口函数获取或设置单选框的选中状态，数据交换宏为DX_RadioCheck，单选它会触发clicked事件，开发者在命令的onControlEvent接口中处理该事件。 text/html 2024-02-27T11:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xstackctrl&rev=1709004576&do=diff 堆栈控件 堆栈控件的标签为Stack。堆栈控件提供了可以切换的“页面区域”，堆栈控件可以包含多个页面，只有当前页面在页面区域中显示，其他所有页面都被隐藏。堆栈的页面一般为Child控件，但也可以是Panel、Tree、List或者Table。堆栈控件与选项卡控件的不同之处在于选项卡控件的页面有一个标签与之对应。堆栈页面切换时会自动调用命令的onDataExchange接口，并将页面的配置文件路径作为参数传入接口中，以便于开发者保存前一个页面界面的数据并初始化新的页面界面。… text/html 2024-02-27T11:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xtabctrl&rev=1709004576&do=diff 选项卡控件 选项卡控件的标签为Tab。选项卡控件提供了一个选项卡栏和对应的“页面区域”，用于显示与每个选项卡相关联的页面。默认情况下，选项卡栏显示在页面区域的上方。每个选项卡与不同的页面相关联。只有当前页面在页面区域中显示，其他所有页面都被隐藏。选项卡会保持prev_index的扩展属性以保存前一个选择页面的序号。选项卡的页面一般为Child控件，但也可以是Panel、Tree、List或者Table。选项卡页面切换时会自动调用命令的onDataExchange接口，并将页面的配置文件路径作为参数传入接口中，以便于开发者保存前一个页面界面的数据并初始化新的页面界面。… text/html 2024-02-27T11:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xtablectrl&rev=1709004576&do=diff 表格控件 表格控件的标签为Table，其实现类为XTableCtrl。表格控件是一个M列N行单元格的容器控件，每一个单元格包含一个控件，可以是编辑框，也可以是下拉框，也可以是勾选框。表格控件一般有一个列标题栏，显示每一列的标题，每一列可以指定它的宽度，列标题的设置在Header块中设定（参考【表格控件配置示例】）。表格控件的内容可以通过ref_url指定的参考配置文件进行配置。表格控件可以保存row_base, col_base的扩展属性用以设定其最小行数和列数，在定义了该扩展属性的情况下，用户动态修改表格控件的行数和列数时不得小于这些值。… text/html 2024-02-27T11:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://www.xt-solution.cn/xdoc/doku.php?id=reference:widgets:xtreectrl&rev=1709004576&do=diff 树控件 树控件的标签为Tree，其实现类为XTreeCtrl。树控件是一个将数据项组织为树形节点的控件，每一个节点对应一个Item，它可以包含多个列属性，树控件一般有一个列标题栏，显示每一列的标题，每一列可以指定它的宽度，列标题的设置在Header块中设定（参考【树控件配置示例】）。默认情况下每一个节点只有一列属性，如果超过一列属性，可在每个节点下面增加Column的子项，每一个Column对应一列属性。树控件的内容可以通过ref_url指定的参考配置文件进行配置。…