演练：使用 Visual C# 创作复合控件(转自:microsoft.com)

Windows 窗体编程

演练：使用 Visual C# 创作复合控件

 

复合控件提供了一种创建和重用自定义图形界面的方法。复合控件本质上是具有可视化表示形式的组件。因此，它可能包含一个或多个 Windows 窗体控件、组件或代码块，它们能够通过验证用户输入、修改显示属性或执行作者所需的其他任务来扩展功能。可以按照与其他控件相同的方式将复合控件置于 Windows 窗体中。在本演练的第一部分，将创建一个名为

ctlClock

的简单复合控件。在本演练的第二部分，将通过继承扩展

ctlClock

的功能。

 

创建项目

创建新的项目时应指定其名称，以设置根命名空间、程序集名称和项目名称，并确保默认组件将位于正确的命名空间中。

 

创建 ctlClockLib 控件库和 ctlClock 控件

1. 在“文件”菜单上，指向“新建”，然后单击“项目”打开“新建项目”对话框。

2. 从 Visual C# 项目列表中选择“Windows 控件库”项目模板，在“名称”框中键入“ctlClockLib”，然后单击“确定”。

   默认情况下，项目名称

ctlClockLib

也被分配到根命名空间中。根命名空间用于限定程序集中的组件名。例如，如果两个程序集都提供名为

ctlClock

的组件，则可以使用

ctlClockLib.ctlClock.

指定

ctlClock

组件。

 

     3.在解决方案资源管理器中，右击“UserControl1.cs”，然后选择“重命名”。将文件名更改为 ctlClock.cs。当系统询问是否要重命名对代码元素“UserControl1”的所有引用时，单击“是”按钮。

 

说明：
默认情况下，复合控件从系统提供的 UserControl 类继承。UserControl 类提供了所有复合控件要求的功能，并实现了标准方法和属性。

     4.在“文件”菜单上，单击“全部保存”保存项目。

 

向复合控件添加 Windows 控件和组件

可视化界面是复合控件的基本部分。这种可视化界面是通过向设计器图面添加一个或多个 Windows 控件实现的。在下面的演示中，将向复合控件中加入 Windows 控件并编写代码实现功能。

向复合控件添加标签和计时器

1. 在解决方案资源管理器中，右击“ctlClock.cs”，然后单击“视图设计器”。

2. 在“工具箱”中，展开“公共控件”节点，然后双击“Label”。

   设计器图面上的控件中添加了一个名为

label1

的 Label 控件。

    3.在设计器中，单击“label1”。在“属性”窗口中，设置下列属性。

Name :      lblDisplay

text:          (空白)

TextAlign :MiddleCenter

Font.Size: 14

 

     4.在“工具箱”中，展开“组件”节点，然后双击“Timer”。

因为 Timer 是一个组件，所以它在运行时没有可视化的表示形式。因而它不会和控件一起出现在设计器图面，而是出现在“组件设计器”（设计器图面底部的一栏）中。

 

     5.在“组件设计器”中，单击“Timer1”，然后将 Interval 属性设置为 1000，将 Enabled 属性设置为 True。

Interval 属性控制 Timer 组件的计时频率。

 timer1

每走过一个刻度，它都会运行一次

timer1_Tick

事件中的代码。interval 属性表示前后两次计时之间的毫秒数。

 

      6.在“组件设计器”中，双击“Timer1”转到

ctlClock

的

Timer1_Tick

事件。

 

      7.将该代码修改为类似如下所示的代码示例。请确保将访问修饰符从 private 更改为 protected。

protected void timer1_Tick(object sender, System.EventArgs e) { // Causes the label to display the current time. lblDisplay.Text = DateTime.Now.ToLongTimeString(); }

这些代码将使得当前时间显示在

lblDisplay

中。因为

timer1

的间隔设置为 1000，所以该事件每 1000 毫秒发生一次，从而每一秒更新一次当前时间。

 

       8.用 virtual 关键字修改该方法使其可重写。有关更多信息，请参见下面的“从用户控件继承”一节。

protected virtual void timer1_Tick(object sender, System.EventArgs e)

 

       9.在“文件”菜单上，单击“全部保存”保存项目。

向复合控件添加属性

现在，clock 控件封装了 Label 控件和 Timer 组件，这两者各有一组继承属性。尽管您的控件的后续用户无法访问这些控件的个别属性，但可以通过编写适当的代码块来创建和公开自定义属性。在下面的过程中，将向控件添加属性，这些属性可使用户能够更改背景和文本的颜色。

向复合控件添加属性

    1.在解决方案资源管理器中，右击“ctlClock.cs”，然后单击“查看代码”。

        上述代码生成了两个自定义属性：

ClockForeColor

和

ClockBackColor

，该控件的后续用户可以使用这两个属性。get 和 set 语句提供了该属性值的存储和检索，还提供了实现适合于该属性的功能的代码。

       4.在“文件”菜单上，单击“全部保存”保存项目。

控件的“代码编辑器”打开。

       2.找到

public partial class ctlClock

语句。在左大括号

{                  

下键入下列代码。

private Color colFColor; private Color colBColor;

 

这些语句会创建私有变量，用来存储要创建的属性的值。

      3.在步骤 2 中的变量声明下方键入以下代码。

// Declares the name and type of the property. public Color ClockBackColor { // Retrieves the value of the private variable colBColor. get { return colBColor; } // Stores the selected value in the private variable colBColor, and // updates the background color of the label control lblDisplay. set { colBColor = value; lblDisplay.BackColor = colBColor; } } // Provides a similar set of instructions for the foreground color. public Color ClockForeColor { get { return colFColor; } set { colFColor = value; lblDisplay.ForeColor = colFColor; } }

上述代码生成了两个自定义属性：

ClockForeColor

和

ClockBackColor

，该控件的后续用户可以使用这两个属性。get 和 set 语句提供了该属性值的存储和检索，还提供了实现适合于该属性的功能的代码。

      4.在“文件”菜单上，单击“全部保存”保存项目。