====== 面板控件 ======

面板控件的标签为Panel，其实现类为XPanelCtrl。面板控件是一个带标题的组合容器控件，它提供了一个可以折叠可以激活的面板，使用面板时必须像一个独立的窗口一样定义布局（Layout），面板中的控件均在其中被组织布局。面板的表现形式是一个标题栏，激活勾选框被放置在标题栏的左边，折叠按钮放置在标题栏的右边，标题栏的下方是面板的控件所占据的空间。默认情况下，激活勾选框和折叠按钮均不可见。当面板可激活时，用户勾掉激活框面板下的所有控件均变灰，不再支持交互操作，如果勾选激活框，则所有子控件均恢复正常。当面板可折叠时，用户点击折叠按钮，所有子控件均将隐藏起来只显示标题栏，再次点击折叠按钮，所有子控件恢复显示。

面板控件提供了以下扩展槽：
  * void setCheck()，用于设置面板的激活状态；
  * void onCollapse()，用于折叠面板；

面板控件还提供了以下扩展信号：
  * void collapsed()，折叠面板时触发该信号；
  * void toggled()，点击折叠按钮时触发该信号；
  
===== 控件属性关键字 =====

==== name ====
控件名，其值类型为字符串，控件名只能以字母开头，可包含数字、下划线、点符号。参考示例：name="test.panel"。

==== enable ====
设置控件的初始状态是否可交互，其值类型为布尔型（true或者false），如设置为false，在该控件会变灰并且不可交互，用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例：enable="true"。

==== width ====
控件的宽度，其值类型整型, 单位为像素。参考示例：width="30"。

==== height ====
控件的高度，其值类型整型, 单位为像素。参考示例：height="30"。

==== connect ====
无。

==== title ====
当该控件为选项卡控件的子控件时，通过该属性定义它在选项卡控件中的选项卡的显示文本。	

==== strechable ====
设置面板是否可伸缩，默认可伸缩，如果面板可伸缩，当面板折叠时，面板的所占的空间不变，对话框其他的控件不改变位置；否则对话框其他的位置会自动调整以保持布局的紧凑。

==== collapsible ====
设置面板是否可折叠，默认不可折叠，取值为布尔类型（true或false）。参考示例：collapsible="true"。

==== collapse ====
设定面板的折叠状态，默认不折叠，取值为布尔类型（true或false）。参考示例：collapse="true"。	

==== checkable ====
设置面板是否支持切换激活状态，默认不可激活，取值为布尔类型（true或false）。参考示例：checkable="true"。

==== check ====
设定面板的激活状态，默认激活，取值为布尔类型（true或false）。参考示例：check="true"。		

===== 配置示例 =====
<code>
<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>
</code>

===== 相关API =====

  * [[class:ui:icommandwindow#setcontrolenable|setControlEnable]]
  * [[class:ui:icommandwindow#setcontrolvisible|setControlVisible]]
  * [[class:ui:icommandwindow#getpanelchecked|getPanelChecked]]
  * [[class:ui:icommandwindow#setpanelchecked|setPanelChecked]]