| 注意 | 必需的应用程序 |
|---|---|
只有安装了必需的应用程序后，本主题中的功能才可用。 有关更多信息，请参见 产品组合可用的功能。 |
|
此示例演示操作窗格上的自定义用户控件，并包含有助于在操作窗格上组织控件的可折叠容器控件（子窗格控件）。此示例还演示如何响应寄宿在子窗格控件上的控件生成的事件。
此示例解决方案中存在一个项目：包含示例控件的 Microsoft Office Word 2003 应用程序项目。
.gif) 安全注意 |
|---|
提供该代码示例是为了阐释一个概念，并不代表着最安全的编码实践，因此不应在应用程序或网站中使用该代码示例。对于因将该代码示例用于其他用途而出现的偶然或必然的损害，Microsoft 不承担任何责任。 |
有关在计算机上安装示例项目的信息，请参见 如何：下载帮助主题中的示例文件。
运行此示例
- 按 F5。
演示
子窗格控件是一个可承载其他控件（如列表框和文本框）的可折叠容器。向项目中添加一个用户控件，然后将一个或多个子窗格控件拖放到用户控件设计图面上。必要时，可以使用多个子窗格控件并使用项目所需的控件来填充这些子窗格控件。然后编写代码将子窗格控件与文档的操作窗格关联，之后就可以针对任何子窗格上的控件进行编程了。
该控件具有以下属性、方法和事件：
属性：
Text。给定子窗格标题栏中显示的文本。
HighlightColor。用户选中此控件时，标题栏的颜色。
GradientBeginColor。标题栏左侧的起始颜色。
GradientEndColor。标题栏右侧的结束颜色。
IsExpanded。指示子窗格是否展开，即是否显示其项的列表。
IsAnimated。指示当子窗格展开或折叠时是否向上滚动或向下滚动。
方法：
Expand。展开控件。如果控件已展开，则此方法没有任何效果。
Collapse。折叠控件。如果控件已折叠，则此方法没有任何效果。
事件：
BeforeExpanding。展开控件之前执行的事件。
BeforeCollapsing。折叠控件之前执行的事件。
AfterExpand。展开控件之后执行的事件。
AfterCollapse。折叠控件之后执行的事件。