复合控件提供了一种创建和重用自定义图形界面的方法。 复合控件本质上是具有可视化表示形式的组件。 因此,它可能包含一个或多个 Windows 窗体控件、组件或代码块,它们能够通过验证用户输入、修改显示属性或执行作者所需的其他任务来扩展功能。 可以按照与其他控件相同的方式将复合控件置于 Windows 窗体中。 在本演练的第一部分,将创建一个名为 ctlClock 的简单复合控件。 在本演练的第二部分,将通过继承扩展 ctlClock 的功能。
Note: 显示的对话框和菜单命令可能会与“帮助”中的描述不同,具体取决于你现用的设置或版本。 若要更改设置,请在 “工具” 菜单上选择 “导入和导出设置” 。 有关详细信息,请参阅个性化设置 Visual Studio IDE。
创建项目
创建新的项目时应指定其名称,以设置根命名空间、程序集名称和项目名称,并确保默认组件将位于正确的命名空间中。
创建 ctlClockLib 控件库和 ctlClock 控件
-
在“文件”菜单上指向“新建”,然后单击“项目”打开“新建项目”对话框。
-
从C#可视化项目列表中, 选择 " Windows 窗体控件库" 项目模板, 在
ctlClockLib"名称" 框中键入, 然后单击 "确定" 。默认情况下,项目名称
ctlClockLib也会分配到根命名空间中。 根命名空间用于限定程序集中的组件名。 例如,如果两个程序集都提供名为ctlClock的组件,则可以使用ctlClockLib.ctlClock.指定ctlClock组件 -
在解决方案资源管理器中,右键单击“UserControl1.cs”,然后单击“重命名”。 将文件名更改为
ctlClock.cs。 当系统询问是否重命名对代码元素“UserControl1”的所有引用时,单击“是”按钮。NOTE 默认情况下, 复合控件继承自系统xref:System.Windows.Forms.UserControl提供的类。 xref:System.Windows.Forms.UserControl类提供所有复合控件所需的功能, 并实现标准方法和属性。
-
在“文件”菜单上,单击“全部保存”保存项目。
将 Windows 控件和组件添加到复合控件
可视化界面是复合控件的基本部分。 这种可视化界面通过向设计器图面添加一个或多个 Windows 控件实现。 在下面的演示中,将向复合控件中加入 Windows 控件并编写代码实现功能。
将标签和计时器添加到复合控件
-
在解决方案资源管理器中,右键单击“ctlClock.cs”,然后单击“视图设计器”。
-
在“工具箱”中,展开“公共控件”节点,然后双击“标签”。
xref:System.Windows.Forms.Label 名
label1为的控件将添加到设计器图面上的控件中。 -
在设计器中,单击“label1”。 在“属性”窗口中,设置下列属性。
属性 更改为 名称 lblDisplay文本 (blank space)TextAlign MiddleCenterFont.Size 14 -
在“工具箱”中,展开“组件”节点,然后双击“计时器”。
xref:System.Windows.Forms.Timer由于是一个组件, 因此它在运行时不具有可视表示形式。 因而它不会和控件一起出现在设计器图面上,而是出现在“组件设计器”(设计器图面底部的一栏)中。
-
在 "组件设计器" 中, 单击 " timer1" xref:System.Windows.Forms.Timer.Interval* , 然后
1000将属性设置为true, 并xref:System.Windows.Forms.Timer.Enabled*将属性设置为。属性控制xref:System.Windows.Forms.Timer组件的计时频率。 xref:System.Windows.Forms.Timer.Interval*
timer1每走过一个刻度,它都会运行一次timer1_Tick事件中的代码。 间隔表示计时之间的毫秒数。 -
在“组件设计器”中,双击“timer1”转到
ctlClock的timer1_Tick事件。 -
将代码修改为类似如下所示的代码示例。 确保将访问修饰符从
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 毫秒发生一次,从而每一秒更新一次当前时间。 -
修改该方法使其可通过
virtual关键字重写。 有关详细信息,请参阅下面的“从用户控件继承”一节。protected virtual void timer1_Tick(object sender, System.EventArgs e) -
在“文件”菜单上,单击“全部保存”保存项目。
将属性添加到复合控件
时钟控件现在封装一个xref:System.Windows.Forms.Label控件和一个xref:System.Windows.Forms.Timer组件, 每个组件都有其自己的固有属性集。 尽管控件的后续用户无法访问这些控件的单个属性,但可以通过编写适当的代码块来创建和公开自定义属性。 在下面的过程中,将向控件添加属性,这些属性可使用户能够更改背景和文本的颜色。
将属性添加到复合控件
-
在解决方案资源管理器中,右键单击“ctlClock.cs”,然后单击“查看代码”。
控件的“代码编辑器”随即打开。
-
找到
public partial class ctlClock语句。 在左大括号 ({)下键入下以下代码。private Color colFColor; private Color colBColor;这些语句会创建私有变量,用来存储要创建的属性的值。
-
在步骤 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语句提供了该属性值的存储和检索,还提供了实现适合于该属性的功能的代码。 -
在“文件”菜单上,单击“全部保存”保存项目。
测试控件
控件不是独立应用程序,它们必须托管在容器中。 测试控件的运行时行为,并使用“UserControl 测试容器”运用其属性。 有关详细信息,请参阅如何:测试 UserControl的运行时行为。
测试控件
-
按 F5 生成项目并在“UserControl 测试容器”中运行该控件。
-
在测试容器的属性网格中,找到
ClockBackColor属性,然后选择该属性以显示调色板。 -
通过单击选择颜色。
控件的背景颜色更改为你选择的颜色。
-
使用类似的事件序列来验证
ClockForeColor属性的功能是否与预期的相符。本节和前面的几节演示了如何将组件和 Windows 控件与代码和打包相结合,以复合控件的形式提供自定义功能。 你现已了解如何在复合控件中公开属性,以及如何在完成后对控件进行测试。 下一节将介绍如何以
ctlClock为基础构造继承的复合控件。
从复合控件继承
前面的章节中介绍了如何将 Windows 控件、组件和代码组合成可重用的复合控件。 现在即可将复合控件用作生成其他控件的基础。 从基类派生类的过程称为继承。 在本节中,将创建一个称为 ctlAlarmClock 的复合控件。 此控件将从其父控件 ctlClock 派生。 将介绍如何通过重写父级方法并添加新的方法和属性来扩展 ctlClock 的功能。
创建继承控件的第一步是从它的父控件派生。 该操作创建一个新控件,它具有父控件的所有属性、方法和图形特征,但也可以用作添加新功能或修改过的功能的基础。
创建继承的控件
-
在解决方案资源管理器中,右键单击“ctlClockLib”,指向“添加”,然后单击“用户控件”。
此时将打开“添加新项”对话框。
-
选择“继承的用户控件”模板。
-
在“名称”框中,键入
ctlAlarmClock.cs,然后单击“添加”。“继承选择器”对话框将出现。
-
在“组件名称”下,双击“ctlClock”。
-
在解决方案资源管理器中,浏览当前项目。
NOTE 当前项目中添加了一个名为“ctlAlarmClock.cs”的文件。
添加警报属性
将属性添加到继承的控件的方法与将其添加到复合控件的方法相同。 现在将使用属性声明语法向控件中添加两个属性:AlarmTime 和 AlarmSet,前者将存储发出警报的日期和时间值,后者指示是否设置了警报。
将属性添加到复合控件
-
在解决方案资源管理器中,右键单击“ctlAlarmClock”,然后单击“查看代码”。
-
找到
public class语句。 请注意,控件继承自ctlClockLib.ctlClock。 在左大括号 ({)语句下键入下以下代码。private DateTime dteAlarmTime; private bool blnAlarmSet; // These properties will be declared as public to allow future // developers to access them. public DateTime AlarmTime { get { return dteAlarmTime; } set { dteAlarmTime = value; } } public bool AlarmSet { get { return blnAlarmSet; } set { blnAlarmSet = value; } }
添加到控件的图形界面
继承的控件具有可视化界面,该界面与它从中继承的控件的界面完全相同。 它与其父控件拥有相同的构成控件,但除非将构成控件的属性特别公开,否则它们将不可用。 可以向继承的复合控件的图形界面进行添加,方法与向任意复合控件进行添加相同。 若要继续向警报时钟的可视化界面进行添加,请添加一个标签控件,它将在警报响起时闪烁。
添加标签控件
-
在解决方案资源管理器中,右键单击“ctlAlarmClock”,然后单击“视图设计器”。
`ctlAlarmClock` 的设计器将在主窗口中打开。 -
单击该控件的显示部分,然后查看“属性”窗口。
NOTE 当显示所有属性时,属性是浅灰色的。 这表示这些属性是
lblDisplay所固有的,不能在“属性”窗口中修改或访问。 默认情况下,复合控件中所包含的控件为private,通过任何途径都无法访问其属性。NOTE 如果希望复合控件的后续用户可以访问其内部控件,则可将其声明为
public或protected。 如此即可使用适当的代码设置和修改复合控件内所包含控件的属性。 -
向复合控件添加控件。xref:System.Windows.Forms.Label
-
使用鼠标将xref:System.Windows.Forms.Label控件拖到显示框的正下方。 在“属性”窗口中,设置下列属性。
属性 设置 名称 lblAlarm文本 Alarm! TextAlign MiddleCenter可见 false
添加警报功能
在前面的章节中,已经添加了一些属性和一个控件,它们将启用复合控件中的警报功能。 在本过程中,将添加代码以比较当前时间和警报时间,如果两者相同,则警报闪烁。 通过重写 ctlClock 的 timer1_Tick 方法并向其中添加其他代码,可扩展 ctlAlarmClock 的功能,同时会保留 ctlClock 的所有固有功能。
重写 ctlClock 的 timer1_Tick 方法
-
在“代码编辑器”中,找到
private bool blnAlarmSet;语句。 在其紧下方添加下列语句。private bool blnColorTicker; -
在“代码编辑器”中,在类的结尾找到右大括号 (
})。 在大括号的前面添加以下代码。protected override void timer1_Tick(object sender, System.EventArgs e) { // Calls the Timer1_Tick method of ctlClock. base.timer1_Tick(sender, e); // Checks to see if the alarm is set. if (AlarmSet == false) return; else // If the date, hour, and minute of the alarm time are the same as // the current time, flash an alarm. { if (AlarmTime.Date == DateTime.Now.Date && AlarmTime.Hour == DateTime.Now.Hour && AlarmTime.Minute == DateTime.Now.Minute) { // Sets lblAlarmVisible to true, and changes the background color based on // the value of blnColorTicker. The background color of the label // will flash once per tick of the clock. lblAlarm.Visible = true; if (blnColorTicker == false) { lblAlarm.BackColor = Color.Red; blnColorTicker = true; } else { lblAlarm.BackColor = Color.Blue; blnColorTicker = false; } } else { // Once the alarm has sounded for a minute, the label is made // invisible again. lblAlarm.Visible = false; } } }添加此代码将完成多项任务。
override语句指示控件使用此方法替换从基控件继承的方法。 调用此方法时,它通过调用base.timer1_Tick语句来调用它重写的方法,从而确保在该控件中重现原始控件包含的所有功能。 然后,运行附加代码以合并警报功能。 警报触发时,将会出现闪烁的标签控件。警报时钟控件已基本完成。 剩下的唯一事情是实现关闭它的方法。 为此,将向
lblAlarm_Click方法添加代码。
实现关闭方法
-
在解决方案资源管理器中,右键单击“ctlAlarmClock.cs”,然后单击“视图设计器”。
设计器随即打开。
-
将按钮添加到控件。 按如下方式设置该按钮的属性。
属性 值 名称 btnAlarmOff文本 禁用警报 -
在设计器中,双击“btnAlarmOff”控件。
“代码编辑器”随即打开并显示
private void btnAlarmOff_Click行。 -
将此方法修改为类似如下所示的代码。
private void btnAlarmOff_Click(object sender, System.EventArgs e) { // Turns off the alarm. AlarmSet = false; // Hides the flashing label. lblAlarm.Visible = false; } -
在“文件”菜单上,单击“全部保存”保存项目。
在窗体上使用继承的控件
您可以通过与测试基类控件ctlClock相同的方式来测试您的继承控件:按 F5 生成项目并在“UserControl 测试容器”中运行该控件。 有关详细信息,请参阅如何:测试 UserControl的运行时行为。
若要使用控件,还需要将其放入窗体中。 与标准复合控件一样,继承的复合控件不能独立存在,而必须承载在窗体或其他容器中。 由于 ctlAlarmClock 的功能更加深入,因此需要附加代码以对其进行测试。 在本过程中,将编写一个简单的程序来测试 ctlAlarmClock 的功能。 将编写代码来设置和显示 ctlAlarmClock 的 AlarmTime 属性,并测试其固有功能。
生成测试窗体并将控件添加到该窗体
-
在解决方案资源管理器中,右键单击“ctlClockLib”,然后单击“生成”。
-
将一个新的“Windows 应用程序”项目添加到解决方案,并将其命名为
Test。 -
在解决方案资源管理器中,右键单击测试项目的“引用”节点。 单击“添加引用”,显示“添加引用”对话框。 单击标记为“项目”的选项卡。 “项目名称”下将列出
ctlClockLib项目。 双击该项目将引用添加到测试项目。 -
在解决方案资源管理器中,右键单击“测试”,然后单击“生成”。
-
在“工具箱”中,展开“ctlClockLib 组件”节点。
-
双击“ctlAlarmClock”向窗体添加
ctlAlarmClock的副本。 -
在 "工具箱" 中, 找到并双击 " DateTimePicker " 将xref:System.Windows.Forms.DateTimePicker控件添加到xref:System.Windows.Forms.Label窗体, 然后双击 "标签" 添加控件。
-
使用鼠标将这些控件放置在窗体上合适的位置。
-
按下述方法设置这些控件的属性。
控件 属性 “值” label1文本 (blank space)名称 lblTestdateTimePicker1名称 dtpTest格式 xref:System.Windows.Forms.DateTimePickerFormat.Time -
在设计器中,双击“dtpTest”。
“代码编辑器”随即打开并显示
private void dtpTest_ValueChanged。 -
像如下所示修改代码。
private void dtpTest_ValueChanged(object sender, System.EventArgs e) { ctlAlarmClock1.AlarmTime = dtpTest.Value; ctlAlarmClock1.AlarmSet = true; lblTest.Text = "Alarm Time is " + ctlAlarmClock1.AlarmTime.ToShortTimeString(); } -
在解决方案资源管理器中,右键单击“测试”,然后单击“设为启动项目”。
-
在“调试”菜单上,单击“启动调试”。
测试程序随即启动。 请注意,
ctlAlarmClock控件中的当前时间已更新, 并且开始时间显示xref:System.Windows.Forms.DateTimePicker在控件中。 -
单击 "小时" 的显示位置。xref:System.Windows.Forms.DateTimePicker
-
使用键盘设置一个分钟值,使它比
ctlAlarmClock显示的当前时间快一分钟。警报设置的时间在
lblTest中显示。 等候显示的时间到达警报设置时间。 显示时间到达警报设置的时间时,lblAlarm会闪烁。 -
单击
btnAlarmOff关闭警报。 现在可以重置警报。本演练涵盖了多个关键概念。 现已应了解如何通过将控件和组件组合到复合控件容器中来创建复合控件。 还应了解图和将属性添加到控件,以及如何编写代码以实现自定义功能。 在最后一节中,应了解到如何通过继承来扩展给定复合控件的功能,以及如何通过重写承载方法来改变这些方法的功能。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
