用进度条

当显示在图表上时，您可以将进度条添加到任何可以显示隔间并可以显示范围内任何数值的元素。

进度条可用于显示以下内容：

任务或项目的当前进度
使用了多少项目预算

默认情况下，进度条将显示 0 到 100（含）之间的值；但是，可以同时调整最小值和最大值以设置所需的任何值范围。

此图显示了默认进度条的示例：

Class diagram with the Progress Bar feature in Sparx Systems Enterprise Architect.

使用新的标记值创建进度条

使用此过程使用您立即从头开始创建的简单标记值创建进度条。

节	行动	也见
1	在图表上，创建一个可以显示隔间的元素（例如需求或特征）并向其添加简单的标记值。	快速开始- 将标记值添加到元素
2	从属性窗口的“标签”选项卡中打开标签的注记并添加“Type=ProgressBar;” （包括分号），然后点击确定按钮。（您可以在标记值中添加更多选项，如附加进度条选项表中所述。）
3	单击元素并按 Ctrl+Shift+Y 或右键单击并选择“分隔可见性”选项。将显示“隔间可见性”对话框。
4	选中“显示元素分隔”面板中的“标签”复选框，然后单击确定按钮。进度条现在将显示在图表上的元素上，进度条上方显示标记值名称。
5	在属性窗口的“标签”选项卡中，通过在标签的“值”字段中键入一个介于1和 100 之间的数字来指示进度。在图表上，进度条的适当长度以绿色填充。

从“ UML类型”对话框创建进度条

您还可以从“ UML类型”对话框中定义一个进度条，然后可以将其应用于任何元素，而不必每次都设置标记值标记值注记。

节	行动	也见
1	选择“设置 >参考> UML类型”功能区选项以显示“ UML类型”对话框，然后单击“标记值类型”选项卡。	标记值类型
2	在“标签名称”和“描述”字段中，输入标签标记值的名称和描述。在“详细信息”字段中输入标记值。单击保存按钮和关闭按钮。（选项参数在附加进度条选项表中描述。）
3	选择“开始>应用程序>设计>属性”功能区选项以打开属性窗口（如果尚未打开）并选择“标签”选项卡。在图表上选择一个元素，然后在“标签”选项卡上单击新标签（新标签标记值）按钮。在标记值对话框的“标签”栏，点击下拉箭头，选择您在步骤2中创建的标记值，然后点击确定按钮。
4	在图表上，右键单击元素并选择“Compartment Visibility”选项以显示“Compartment Visibility”对话框。
5	选择“标签”复选框，然后单击确定按钮。
6	在“标签”选项卡上，多次更改值字段中的数字，每次都单击该字段。注意这对进度条的影响。

其他进度条选项

默认进度条A显示标记值名称并反映 0-100 范围内的值。如果需要，您可以更改范围值，如果必须提供更多信息，则可以在栏的右侧显示文本。默认情况下，进度条的背景、边框和填充颜色由当前应用的内置图表主题确定。但是，您可以将自己的颜色应用于这些属性中的一个或多个。

使用这些参数来增强进度条。

参数	描述	也见
最小值	使用选项设置在进度条上显示的最低允许值。语法：MinVal=<数字>；设置 MinVal=10 A进度条；将从 10 开始。低于 10 的值将不会显示在其上。如果已定义最大值（MaxVal），进度条将显示 MinVal 和 MaxVal（含）之间的任何值；否则，最大值将默认为 MinVal + 100。因此，如果 MinVal=10，进度条可以显示 10 到 110（含）之间的值。
最大值	使用选项设置进度条上允许的最高值。语法：MaxVal=<数字>；设置 MaxVal=300 A进度条；将显示不超过 300 的值（包括 300）。高于 300 的值将不会显示。如果设置了最小值（MinVal），进度条将显示 MinVal 和 MaxVal（包括）之间的任何值；否则最小值将默认为 0。因此，如果 MaxVal=300，进度条可以显示 0 到 300（含）之间的值。
文本	使用文本选项来定义要在进度条右侧显示的附加文本。该文本可能是资源名称或当前占用的项目总预算。语法：文本=<文本>； - 显示定义的文本string ，例如“David Brown's Tasks” 语法：文本=#Value#; - 显示进度条标记值的值，例如“462”（其中标记值名称本身可能表示值的类型或单位）语法：Text=<text> #Value# <text>; - 显示进度条标记值的前后有文字，如'$<value> of $100,000' 此图显示了使用文本选项的一些示例。
隔间	默认情况下，元素中的进度条与其他类型的标记值一起显示在一个单独的隔间中（前提是图表和/或元素设置为显示标签隔间）。当一个元素上有多个进度条时，每个进度条都与项目的不同因素有关，区分它们会变得更加困难。在这些情况下，可以将进度条设置为在特定隔间中显示，以提高清晰度。这也提供了额外的标签级别。因此，您可能有一个与成本相关的元素，以及两个或多个指示不同部门成本的隔间，其中部门名称反映在隔间名称中。或者每个包含两个或多个进度条的隔间，例如，指示每个部门任务的成本和完成百分比。语法：隔间=<名称>；要将多个进度条添加到同一个隔间，只需为进度条指定相同的隔间名称。此示例显示了来自文本参数示例的元素，但使用了隔间来帮助提高可读性。
返回Clr	使用选项覆盖用于进度条未填充部分的颜色。语法：BackClr=<颜色>; <color> 可以是多种值之一，例如用于浅灰色的 RGB 值rgb(198,198,198) 。有关设置颜色时可用值的完整列表，请参阅进度条颜色选项表。
填充清除器	使用选项来覆盖用于进度条填充部分的颜色。语法：FillClr=<颜色>； <color> 可以是多种选项之一，例如十六进制值#0000ff表示鲜红色。有关设置颜色时可用值的完整列表，请参阅进度条颜色选项表。
边界清除	使用选项覆盖在进度条边缘绘制的颜色。语法：BorderClr=<颜色>； <color> 可以是多种选项之一，例如关键字elementtext选择与当前元素的文本颜色相同的颜色。有关设置颜色时可用值的完整列表，请参阅进度条颜色选项表。

示例

需求元素'进程-Credit Card Payment'的标记值值为'Completion'，值为'66'。

在标记值注记中，我们指定'Type=ProgressBar;'以及显示文本和颜色设置。

结果是这里看到的进度条：

进度条颜色选项

此表列出了在为进度条设置自定义颜色时可以与选项 BackClr、FillClr 和 BorderClr 一起使用的不同类型的值。

价值	描述	也见
RGB（红、绿、蓝）	使用 rgb 值，您可以设置红色、绿色和蓝色分量来创建您需要的颜色。示例：示例=rgb(46, 139, 87); //将进度条的未填充部分设置为海绿色。红色、绿色和蓝色值的范围分别为 0 到 255 此选项可以与“布局”选项卡中的颜色选择器结合使用，因为它们为当前选择的颜色提供 RGB 值。
hsl（色相，饱和度，亮度）	使用 hsl 与使用 rgb 非常相似。然而，与 rgb 不同的是，通过简单地调整亮度，或者通过调整饱和度来增加或减少颜色的强度，更容易创建相同颜色的更亮或更暗版本。示例：FillClr=hsl(197, 71, 73); //将进度条的填充部分设置为天蓝色。色调值的范围是 0 到 360 饱和度和亮度值的范围分别为 0 到 100
十六进制值	颜色也可以使用十六进制值定义。例如： BorderClr:#000000; //设置进度条的边框颜色为黑色。十六进制值范围从 #000000 到 #ffffff
HTML 颜色名称	在为进度条定义颜色时，也可以使用标准的 Web 颜色名称。例如： fillclr=aliceblue； //将进度条的填充部分设置为标准颜色'aliceblue' Enterprise Architect支持 140 种标准 HTML 颜色名称。
元素颜色	使用 ElementFill、ElementLine 或 ElementText 会将颜色值设置为当前选定元素的填充、线条或文本颜色（即 ElementFill 将应用元素的当前填充颜色）。以这种方式设置的颜色可以通过使用修饰符s:=<value>和l:=<value>来修改颜色的饱和度和亮度来进一步细化，使分配给进度条的颜色成为当前选定元素的略微更改版本颜色。如果希望元素改变颜色（例如使用图表图例）以保持进度条与元素正确主题化，这些设置会很有用。例如： backclr=elementfill:s=-10:l=20:; //将进度条的未填充部分设置为与元素的填充颜色相同，但颜色饱和度降低10%，亮度增加20%。 s和l可以是任意值；但是，结果可能会因当前选择的颜色而异（例如，与较暗的颜色相比，非常浅的颜色增加 20% 的亮度可能不会那么明显）	图表图例
没有任何	none 关键字用于指示不应将颜色应用于所选字段。例如： borderClr=none； //移除进度条的边框。

进度条与MDG 技术

进度条也可以在MDG 技术中创建，以定义一组一致的进度条以用于多个项目。