面板控件的标签为Panel,其实现类为XPanelCtrl。面板控件是一个带标题的组合容器控件,它提供了一个可以折叠可以激活的面板,使用面板时必须像一个独立的窗口一样定义布局(Layout),面板中的控件均在其中被组织布局。面板的表现形式是一个标题栏,激活勾选框被放置在标题栏的左边,折叠按钮放置在标题栏的右边,标题栏的下方是面板的控件所占据的空间。默认情况下,激活勾选框和折叠按钮均不可见。当面板可激活时,用户勾掉激活框面板下的所有控件均变灰,不再支持交互操作,如果勾选激活框,则所有子控件均恢复正常。当面板可折叠时,用户点击折叠按钮,所有子控件均将隐藏起来只显示标题栏,再次点击折叠按钮,所有子控件恢复显示。
面板控件提供了以下扩展槽:
面板控件还提供了以下扩展信号:
控件名,其值类型为字符串,控件名只能以字母开头,可包含数字、下划线、点符号。参考示例:name=“test.panel”。
设置控件的初始状态是否可交互,其值类型为布尔型(true或者false),如设置为false,在该控件会变灰并且不可交互,用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例:enable=“true”。
控件的宽度,其值类型整型, 单位为像素。参考示例:width=“30”。
控件的高度,其值类型整型, 单位为像素。参考示例:height=“30”。
无。
当该控件为选项卡控件的子控件时,通过该属性定义它在选项卡控件中的选项卡的显示文本。
设置面板是否可伸缩,默认可伸缩,如果面板可伸缩,当面板折叠时,面板的所占的空间不变,对话框其他的控件不改变位置;否则对话框其他的位置会自动调整以保持布局的紧凑。
设置面板是否可折叠,默认不可折叠,取值为布尔类型(true或false)。参考示例:collapsible=“true”。
设定面板的折叠状态,默认不折叠,取值为布尔类型(true或false)。参考示例:collapse=“true”。
设置面板是否支持切换激活状态,默认不可激活,取值为布尔类型(true或false)。参考示例:checkable=“true”。
设定面板的激活状态,默认激活,取值为布尔类型(true或false)。参考示例:check=“true”。
<Panel name="color.panel" title="Color Setting" collapse="true"> <VLayout> <HLayout> <Label name="bgtopcolor.label" width="240" text="Background Top Color" /> <Color name="bgtopcolor.color" text="" /> </HLayout> <HLayout> <Label name="bgbottomcolor.label" width="240" text="Background Bottom Color" /> <Color name="bgbottomcolor.color" text="" /> </HLayout> </VLayout> </Panel>