创建形状

Qt Quick Designer 是一款 UI 设计工具，而非通用绘图工具，因此其重点在于提供现成的 UI 控件，您可以根据需要对其进行修改。控件的某些属性值是通过样式设置指定的，因此无法直接更改。

不过，您可以使用“组件”（Components）中的某些组件来绘制基本形状，例如矩形。此外，您还可以在“xml-ph-0000@deepl.internal”视图中安装 Qt Quick Shapes Design Helpers 模块，在“2D ”视图中创建更复杂的形状，例如椭圆、多边形和星形。

Components 中的大多数可视化组件都基于 `Item ` 组件。尽管该组件本身没有视觉外观（例如，类似于鼠标区域），但它定义了所有可视化组件共有的属性，例如位置、大小和可见性。有关更多信息，请参阅“设置基本组件属性”。

此外，每个组件都有一组属性，用于指定其视觉外观和行为。您可以修改属性值来设置填充色、边框色、描边宽度以及形状的其他特征。

以下各节将更详细地介绍可用的形状及其属性。您可以在“Properties ”视图中修改这些属性的值。

矩形

Rectangle 的基本组件用于绘制具有四条边和四个角以及实线边框的图形。

矩形可以使用纯色填充，也可以使用您在“Fill color ”字段中设置的线性渐变填充。您还可以使用颜色选择器选择颜色，并使用渐变选择器从预定义的WebGradients 集合中选择渐变。

通过设置“Border color ”和“Border width ”字段的值，可以为矩形添加可选的实心边框，并自定义其颜色和粗细。若要创建无填充色的边框，请点击“ ”按钮，该按钮将颜色设置为透明。

通过设置“Radius ”字段的值，您可以创建圆角形状。通过合理组合矩形宽度、高度和半径属性的值，您可以创建椭圆形和圆形。例如，要绘制一个完整的圆，首先绘制一个四边等长的矩形，然后将其半径设置为边长的一半。

绘制弯曲边角时，建议在“Advanced ”部分启用“Antialiasing ”选项，以改善图形的外观。

矩形形状

若需独立调整矩形的每个角，或使用虚线边框，请在“Components ”中创建RectangleShape 组件的实例， Qt Quick Shapes Design Helpers 中的Rectangle 组件的实例，而不是使用Default Components >Basic 中提供的基本 组件。

通过设置“Corner Radiuses ”部分中的属性值，您可以独立绘制每个角。通过将半径值与“Corner Bevel ”部分中的值结合使用，您可以创建带有切角的形状。

除了线性渐变外，您还可以在“Fill color ”字段中指定锥形和径向渐变。

在“Stroke Details ”部分，您可以指定边框模式、线条样式以及虚线和点划线的破折号图案。

椭圆形状

EllipseShape 要添加完整的椭圆、弧线或带填充的扇形，请创建“Components ”> Qt Quick Shapes Design Helpers中可用的Start angle 组件的实例。设置 和Sweep angle 以控制图形的外观。

默认情况下，该类型会渲染一个完整的椭圆。内部填充为Fill color ，轮廓则根据Stroke color 、Stroke width 和Stroke style 进行绘制。

要创建弧线或扇形，请将Start angle 和Sweep angle 设置为0-360度，以定义要绘制的椭圆段。

要创建简单的弧（仅轮廓），请将Fill color 设置为Transparent 。弧的线条样式可通过Dash pattern 和Dash offset 进行自定义。

要创建带填充的扇形（与中心相连的扇形），请将Fill color 设置为0.0。扇形的轮廓线也会被描边。

要创建环形图（中空椭圆），请将Inner arc ratio 设置为0.0到1.0之间的值。这定义了内椭圆半径与外椭圆半径的比率。

描边内部的区域将使用Fill color 中设置的纯色填充，或使用Shape gradient 类型之一定义并在Fill gradient 中设置的渐变色进行填充。如果同时设置了纯色和渐变色，则使用渐变色。

若要添加具有独立颜色和粗细的可选边框，请设置Stroke color 和Stroke width 。将颜色设为透明可创建无填充色的边框。

要绘制圆角椭圆，请设置 `Corner radius`。

RegularPolygonShape

正多边形可以是单纯的 2D 多边形轮廓、填充区域，或是带填充的轮廓。设置 `Stroke Details ` 可更改轮廓的外观。

描边内部的区域可使用纯色填充或渐变填充。如果同时设置了颜色和渐变，则使用渐变。

要创建带有描边的多边形，请将Side count 设置为3到100之间的数值，并将Stroke width 设置为大于0。

要绘制圆角多边形，请将Corner radius 设置为。

星形

星形可以是星形的描边、填充或带填充的描边。设置Stroke Details 可更改轮廓的外观。

将Point count 设置在3到60之间，以指定星形的点数。将比率设置在0.1到1之间，以指定星形内部各点到中心的距离。

描边内部的区域可使用纯色填充或渐变填充。如果同时设置了颜色和渐变，则使用渐变。

要创建带有描边的星形，请将“Side count ”设置为3到100之间的数值，并将“Stroke width ”设置为大于0的数值。

要绘制圆角星形，请将“Corner radius ”设置为 。

形状组件概览

下表列出了可用于绘制图形的组件。位置列指明了该组件在Components 中的位置。MCU支持列指明了哪些组件在MCU上受支持。

图标	名称	位置	MCU支持	用途
	椭圆形状	一个可渲染椭圆、弧线或扇形片段的形状组件。	否
	矩形	默认组件 - 基础	是	一个矩形，可使用纯色填充或线性渐变进行绘制，并可选边框。您可以使用 radius 属性绘制圆形。
	矩形形状	Qt Quick 形状设计辅助工具	否	一种扩展的矩形，可填充纯色或线性、锥形或径向渐变色，且各个角可独立调整形状。
	RegularPolygonShape	Qt Quick 形状设计辅助工具	否	一个带填充的正多边形，可选边框。
	StarShape	Qt Quick 形状设计辅助工具	否	一个填充的星形多边形，可选边框。