在项目中创建新用户控件

项目
10/11/2017

您可以设计自己的自定义控件，以便能够在项目中多次重复使用。这些控件从“UserControl”类继承，因此，它们不使用模板。但是，您可以从头设计用户控件以控制其外观。

创建空的用户控件

打开项目。
在“文件”菜单上，单击“新建项”(Crtl+N)。
在“新建项”对话框中，选择“UserControl”。
在“名称”旁边，键入用户控件的描述性名称。
如果要生成该用户控件的代码隐藏文件，请选择“包括代码文件”。

提示：

如果您希望用户控件对用户交互做出响应，或者如果开发人员将为用户控件创建自定义行为，将需要用到代码隐藏文件。
单击“确定”，以关闭对话框并打开该用户控件以供编辑。

此时，便可设计用户控件的外观了。

提示：
如果您希望用户控件对用户交互做出响应，或者如果开发人员将为用户控件创建自定义行为，将需要用到代码隐藏文件。

从现有对象创建用户控件

选择要用来生成新用户控件的现有对象。

提示：

若要选择多个对象，请按住 Ctrl 键的同时单击各个对象。
在“工具”菜单上，单击“构成 UserControl”(F8)。
在“构成 UserControl”对话框中，键入用户控件的描述性名称。
如果希望所选对象保持原样并在用户控件中创建重复内容，请选择“将原始内容保持原样并根据需要创建重复内容”。
单击“确定”以创建用户控件文件，并在美工板上打开 XAML 文件以供编辑。

提示：
若要选择多个对象，请按住 Ctrl 键的同时单击各个对象。

在项目文档中绘制用户控件的新实例

保存所有文件 (Crtl+Shift+S)。
生成项目（按 Ctrl+Shift+B），以使用户控件显示在“资产”面板中。
在“工具”面板中，单击“资产”。
在“资产”面板的“项目”选项卡中，选择用户控件。
使用鼠标在美工板上绘制用户控件。

提示：
使用“构成控件”命令从所选对象生成控件模板。您可以在美工板上选择对象，并将其组合到版式面板（如 Grid）中，然后单击“工具”菜单上的“构成控件”。“构成控件”命令不能用于创建用户控件。但是，它可用于创建控件样式，其中包含由所选对象组成的模板。若要绘制同种类型的其他控件，请在“资产”面板的“样式”类别中选择所需的样式，然后在美工板上进行绘制。

使用“构成控件”命令从所选对象生成控件模板。您可以在美工板上选择对象，并将其组合到版式面板（如 Grid）中，然后单击“工具”菜单上的“构成控件”。“构成控件”命令不能用于创建用户控件。但是，它可用于创建控件样式，其中包含由所选对象组成的模板。若要绘制同种类型的其他控件，请在“资产”面板的“样式”类别中选择所需的样式，然后在美工板上进行绘制。

疑难解答

使用“构成 UserControl”命令时，如果所选的对象包括已构成的内容（如事件处理程序或触发器），则可能需要在新建的用户控件中还原这些事件处理程序方法和触发器。

后续步骤

您可以向用户控件添加多个对象。有关详细信息，请参阅下列主题：
您可以定义用户控件所处的自定义状态，并更改用户控件在每种状态下的外观。有关详细信息，请参阅定义用户控件的可视状态和过渡时间。
通过更改用户控件的外观，可使该控件对鼠标单击做出响应。有关详细信息，请参阅更改用户交互的响应状态。
您可以使用户控件在受到单击时以更具体的方式改变其外观。有关详细信息，请参阅添加状态改变后显示的动画。
您可以在运行时显示用户控件，以响应按钮单击或其他用户交互。有关详细信息，请参阅动手试验：在 Silverlight 应用程序中动态加载新网页。

另请参见

任务

从现有对象创建控件

通过