5.3.3. 关于控制标记

控制标记通常应用于紧接注释节的下一项。 使用索引可以修改代码的特定项,也可以忽略不需要通过 GUI 组件修改的其他项。

项可以是向函数提供的参数,也可以是变量或 #define。 项可以划分为几个表示特定位位置的组件。 此外,在使用 # 修饰符标记将组件值合并回相关项之前,可对组件值应用简单计算。 有关详细信息,请参阅Table 5.4

Note

如果项是大于 2^64 的数字,则行为是未定义的。 这同样适用于在修饰符标记中指定的参数。

控制标记表示单个组件或一组组件。 若要将组件作为一组,请使用开始标记和结束标记。 若要创建 GUI 组件,请使用选项标记。 有关详细信息,请参阅Table 5.3Table 5.4

控制标记可以包含用于定义以下内容的其他修饰符标记:

控制标记或修饰符标记之后可以有说明,例如:

<h> External Bus Interface (EBI)

后面没有修饰符标记的数字控制标记使用 <0x0-0xFFFFFFFF> 作为缺省格式。 如果指定了修饰符标记,则格式由下限值确定。

Table 5.3. 控制标记 

控制说明
<h>
一组组件的开始标记。 仅用于标题。
<e>

一组组件的开始标记。 标题中包含复选框选项,用于启用或禁用后面的组。 例如:

<e>

代码的下一项包含启用/禁用值。 索引 0 为缺省值。

<e.4>

代码的下一项的位 4 包含启用/禁用值。

<e1.4>

索引 1 指定代码的第二项的位 4 包含启用/禁用值。

</h></e>一组组件的结束标记。
<q>

复选框选项。 例如:

<q>

代码的下一项包含启用/禁用值。 索引 0 为缺省值。

<q.4>

代码的下一项的位 4 包含启用/禁用值。

<q1.4>

索引 1 指定代码的第二项的位 4 包含启用/禁用值。

<o>

组合框或数字显示框选项。 例如:

<o>

代码的下一项包含值。 索引 0 为缺省值。

<o.4>

代码的下一项的位 4 包含值。

<o1.4..6>

索引 1 指定代码的第二项的位 4 至 6 包含值。

<s>

文本框选项。 大小限制是可选的。 例如:

<s>

代码的下一项包含字符串。

<s.10>

代码的下一项包含大小限制为 10 个字符的字符串。


Table 5.4. 修饰符标记 

修饰符说明
<i>
工具提示,用于提供有关上一个组件的帮助。 用于开始标记或选项标记。
<0-31>
生成一个包含一组十进制值的数字显示框。 例如,0 - 31 的值。
<0-100:10>
生成一个数字显示框,其中包含一组十进制值,其增量由步长值定义。 例如,0 - 100 的值,其步长为 10。
<0x40-0x1000:0x10>

生成一个数字显示框,其中包含一组十六进制值,其增量由步长值定义。 例如,0x40 - 0x1000 的值,其步长为 0x10。

Note

如果未指定任何修饰符标记,则 <0x0-0xFFFFFFFF> 为缺省值。

<0=>  First_Description
生成一个包含文本说明的组合框。 本示例生成 First_Description 作为组合框中的第一项。 值 0 合并回代码中。
<#+1> <#-1>
<#*8> <#/3>
在合并回代码之前应用计算,可用计算为: 加法、减法、乘法和除法。

Copyright © 2006-2008 ARM Limited. All rights reserved。ARM DUI 0330EC
Non-Confidential