配置 BitLabels.xml 和 aaBitLabelsSchema.xsd 文件
- Last UpdatedSep 24, 2024
- 1 minute read
BitLabels.xml 文件用于定义位标签信息,而 aaBitLabelsSchema.xsd 文件用于验证位标签信息。缺省条件下,这些文件不可用。
BitLabels.xml
BitLabels.xml 文件用于定义每个受支持位标签的标签。例如,Standard 位标签。

要定义位标签,需要使用 Name 和 Type。例如:<Labels Name="Standard" Type="Default">。
-
Name:此处指定的名称会显示在“位标签”下拉列表组合框中。
位标签名必须至少包含一个字母。有效字符为字母数字和特殊字符($、#、_)。位标签名的最大长度为 32。 -
Type:标签的“Default”或“Name”。
每个 XML 可以包含多个 <Labels>。每个 <Labels> 包含一个或多个 <Label>。每个标签都包含 Name 和 Range 信息。例如:
<Labels Name="Standard" Type="Default">
<Label Name="B31" Range="0X80000000"/>
<Label Name="B30" Range="0X40000000"/>
<Label Name="B29" Range="0X20000000"/>
每个 <Label> 都将包含两个字段:
-
Name:标签名和位标签名不区分大小写,标签名的最大长度为 4。在“位模式选择器”对话框中,选择“Standard”位标签时,将在第一个左上角显示标签名“B31”。
-
Range:一个十六进制格式的整数,用于指定将哪个位应用于 Name。Range 包含 32 个位,其中只能有一个位设置为“1”。其它所有位都应该为“0”。但“ALMSTA”标签的“CRIT”标签和“PRI”标签除外。
例如:
在“Standard”标签中,将位“B31”指定给“0x80000000”。将十六进制数转换为二进制数后,将为“1000 0000 0000 0000 0000 0000 0000 0000”。这意味着,“B31”标签是最高位。
<Label Name="B31" Range="0x80000000"/>
在“Standard”标签中,将位“B5”指定给“0x20”。将十六进制数转换为二进制数后,将为“0000 0000 0000 0000 0000 0000 0010 0000”。由于前导 26 位都是 0,我们可以在 Range 值中忽略这些 0。
<Label Name="B5" Range="0x20"/>
验证位标签 XML 并显示“位模式选择器”对话框时,会应用以下规则:
-
标签名和位标签名必须至少包含一个字母。有效字符为字母数字和特殊字符($、#、_)。
<Label Name="B31" Range="0x80000000"/> -
每种标签类型的标签名必须是唯一的。一个标签名不能用于一个标签类型中的多个地方。
-
位标签名可以“,”开头,以节省标签空间。例如:<Label Name=",PNT2" Range="0x4000"/>。
-
两个不同的标签名不能指向相同的位,但一个位可以有多个标签。这些标签可以在 Name 中指定,以逗号“,”分隔。最多可包含 4 组逗号分隔值。例如,标签“ALMSTA”中的位“0x2000000”。BitLabels.xml 中的条目将为 <Label Name="HHA,TARG" Range="0x2000000"/>。“位模式选择器”对话框将显示如下内容:

-
位模式选择器支持标签名别名。例如,如果在 xml 中定义了以下标签类型,选择器将针对所选标签名“INHSTA”,应用类型为“ALMOPT”的所有标签:
<Labels Name="ALMOPT" Type="ALMOPT" SameAs="INHSTA"/> -
如果没有定义位的标签名,相应的位配置在选择器对话框中会被禁用。Standard 位标签中的标签将与该位关联。
-
每个标签名只能在范围中指定一个位,但“CRIT”和“PRI”除外。如需详细信息,请参阅 ALMSTA 标签中的 CRIT 和 PRI。
aaBitLabelsSchema.xsd
aaBitLabelsSchema.xsd 包含用于验证 BitLabels.xml 文件的架构。在以下条件下,将禁用“位标签”下拉列表:
-
XML 和 XSD 文件不在 <installpath>\ArchestrA\Bin 位置中。
-
XML 格式不正确
-
加载 BitLabels.xml 时检测到无效标签;在此情况下,将记录警告消息,并且将使用缺省 Standard 标签类型。
如果位标签被禁用,则会在“位模式选择器”对话框中将“Standard”位标签应用于每个位。
未指定的位
如果没有将位指定给标签,该位在“位模式选择器”对话框中将显示为灰色。
例如,“B15”到“B8”在“ALMSTA”标签中显示为灰色。
显示为灰色的位无法更改,并且位值将显示为“X”(忽略)。