创建自定义组件

您可以使用项目向导模板创建自定义组件和控制，或者将组件实例移入独立文件中，将其转换为可创建实例的新组件。然后，您可以在其他组件中使用这些新组件的实例。

自定义组件存储在 组件 > 我的组件 中。您可以通过将它们从 组件 拖放到 2D、3D 或 导航器 视图中来创建自定义组件的实例。

从头创建组件

要使用向导模板创建自定义组件

1. 选择 文件 > 新建文件 > Qt Quick 文件 > Qt Quick UI 文件 > 选择 以创建新的 .ui.qml 文件。

   注意：组件只有在文件名以大写字母开头时才列在 组件 > 我的组件 中。

2. 点击 设计 在 2D 视图中打开文件。
3. 将组件从 组件 拖放到 导航器 或 2D 视图中。
4. 在 属性 视图中编辑组件属性。可用的属性取决于组件类型。您可以在 连接 视图的 属性 标签页中 为组件添加属性。
5. 要更改组件实例的默认外观和行为，无法使用 Qt 设计工作室支持的，您可以在 连接 视图的 属性 标签页中定义自定义属性。

以下部分包含有关如何使用 2D 视图编辑 2D 内容，以及如何使用 3D 视图编辑 3D 场景的更多信息，以及如何使用基本组件的实例创建 UI 控件的示例

• 2D 视图
• 3D 视图
• 创建按钮
• 创建可扩展的按钮和边框

命名约定

建立命名约定以保持您的UI组件有序。准确命名组件并为他们赋予合适的ID。特别是，检查并修改从设计工具导出的组件的默认名称，以创建符合您已建立的命名约定的可靠且解释充分的名称。

例如，一个按钮符号可能有IDmyButton_symbol，而不同的层可能以此作为前缀，加上状态，从而产生ID，如myButton_symbol_default。为了为项目后期 planned additional mouse areas，您可以使用类似的ID，例如myButton_symbol_hotspot。当您在屏幕中使用按钮作为实例时，您会给这些实例赋予一个与该屏幕相关的独特ID。例如，myButton_myMenu_home、myButton_myMenu_profile和myButton_myMenu_settings

创建自定义控件

您可以使用项目向导模板来创建基于Qt Quick Controls模块组件的可样式化UI控件。

按钮	复选框	转盘
滑动条	旋转框	开关

您可以在所有预设的状态中编辑控件属性，以将您自己的样式应用到它们上。

要创建可样式化的UI控件

1. 选择文件 > 新建文件 > 文件和类 > Qt Quick Controls。
2. 选择要创建的控件，然后选择选择。

   注意：组件仅列在组件 > 我的组件中，如果文件名以大写字母开头。

3. 在属性视图中编辑组件属性。

   可用的属性取决于组件类型。您可以在连接视图中“属性”选项卡中为组件添加属性。

有关使用按钮模板创建按钮并对其进行样式的示例，请参阅创建一个按钮，有关登录UI - 组件教程。

除此之外，您可以为不同类型的屏幕创建起点

• 面板
• 堆叠布局
• 滑动视图

将组件实例转换为自定义组件

创建可重用组件的另一种方法是通过对组件实例进行操作，将它们移动到单独的组件文件（.ui.qml）中，以将它们转换为自定义组件。在导航器中或2D视图中右键单击组件实例，在上下文菜单中选择创建组件。

为新组件命名，并选择是否为新组件或原始组件设置属性。

选择OK后，将创建一个新的组件文件，并在当前组件文件中添加组件的一个实例。您的UI在2D视图中的外观不会改变。

要打开新组件文件并编辑您想要更改所有组件实例的属性，右键单击组件，然后在下拉菜单中选择进入组件。有关打开基础组件的其他方法的更多信息，请参阅组件内移动。

例如，创建可重用自定义组件的示例，请参阅 进度条。

自定义组件列在 组件 > 我的组件 下，您可以使用这些组件的实例来构建更多组件。

使用模版合并文件

您可以使用类似使用 CSS 样式表的方式，将当前组件文件与一个现有的第二个组件文件合并。

要使用此实验性功能，在 导航器 或 2D 视图中右键单击组件，并从上下文中选择 与模板合并文件。

在 模板 字段中，选择用作模板的文件。