关于标签格式函数
要查看标签格式所用函数的列表,请单击“创建标签”(Create Label)“编辑标签”(Edit Label) 对话框中的 “选择函数”(Select a function) 对话框打开。下表介绍了标签格式字符串的函数:
“选择函数”(Select a function) 对话框中的条目
在格式字符串中插入的函数
说明
交叉引用 (列字符{-}, 位置设置字符{/}) (Cross reference (column character{-}, location set character{/}))
[dg_xref(-,/)]
缺省
为形状间的交叉引用显示同一制件的其他形状位置。所生成的标签可以显示各种结果。
如果存在多个形状,将返回每个形状的位置,各位置间用逗号分开。
以下示例是该函数可返回的内容:
* - 如果没有其他要参考的形状。
4 - 参考形状在该页面位置设置的第 4 列中。
Sheet_1-4 - 另一个形状在 Sheet1 上,它所在的位置设置与当前页面的相同,并且位置设置的顺序页面编号设置为假。
Default/Sheet1-4 - 另一个形状在 Sheet1 上,它在另一个名为 Default 的位置设置中。
Default/4 - 另一个形状在另一个名为 Default 的位置设置的第 4 列中。位置设置的顺序列编号设置为真时,就会出现这种情况。
* 
如果将位置设置为使用行和列编号,所返回的交叉引用的格式将为 [column, row]。例如,[2,8]。
参数有:
column character{-}-:要调用的第一个参数 (缺省值为 -) 用于分隔页面名称与列编号。例如,Sheet1-4。
location set character{/}-/:要调用的第二个参数 (缺省值为 /) 用于分隔位置设置名称与页面名称。例如,Default/Sheet1-4。
主成员交叉引用 (列字符{-},位置设置字符{/}) (Master cross reference (column character{-}, location set character{/})
[dg_xref_master(-,/)]
使用与交叉引用 (dg_xref) 相同的输出格式,显示组中主成员的形状位置。
子项名称 ({逻辑名称}) (Name of child ({logical name}))
[dg_child_name(1)]
以指定的逻辑名称显示子元件的名称。缺省逻辑名称为 1。如果元件是可变组,则以逗号分隔的数字对形式指定逻辑名称。
子项属性 ({属性名称}, {逻辑名称}) (Property of child ({property name}, {logical name}))
[dg_child_property(name,1)]
以指定的逻辑名称显示元件指定参数的值。缺省参数名称为 name。缺省逻辑名称为 1。如果元件是可变组,则以逗号分隔的数字对形式指定逻辑名称。
制件的全称 (分隔符{/}) (Full name of artifact (separator character{/}))
[dg_full_name(/)]
用分隔符字符分隔的形式显示制件的全称。缺省分隔符字符是 /。例如,名称可以是 Conn1/Motor/1
容器的名称 (如果存在) (Name of container if present)
[dg_container_name_if_present()]
显示父项的名称 (如果制件有父项)。
页面序列号 (Sequence number for sheet)
[dg_get_sheet_info(seq_num)]
显示页面在位置设置中的位置。
位置设置中的页面数 (Number of sheets in location set)
[dg_get_sheet_info(num_sheets)]
返回位置设置中的页面数。
* 
由于位置设置序列中可能存在间隔,因而页面数不必与位置设置中的最高序列号相同。
位置设置中的最高序列号 (Highest sequence number in location set)
[dg_get_sheet_info(end_seq_num)]
显示位置设置中的最高页面序列号。
布线图类型的名称 (Name of diagram type)
[get_diagram_type_info(name)]
显示布线图类型的名称。(由系统设置)
布线图类型的说明 (Description of diagram type)
[get_diagram_type_info(description)]
显示布线图类型的说明。(由系统设置)
制件的逻辑名称 (Logical name of artifact)
[dg_get_logical_name()]
以整数形式显示制件的逻辑名称。
* 
如果制件是可变组成员,则返回成对的逻辑名称。例如,[1,1]
原型数 (Number of ancestors)
[dg_get_num_ancestors()]
显示制件的原型数。例如,如果端口是块成员,而块又是组成员,则端口具有两个原型。
获取“至”元件({至},{属性名},{两者|端口|元件}) (Get 'to' component({to},{propname}, {both|port|component}))
获取“自”元件({自},{属性名},{两者|端口|元件}) (Get 'from' component({from},{propname}, {both|port|component}))
[report_from_to(from,name,both)]
显示连接到接线的对象的详细信息。该函数可以返回已连接端口、已连接端口父项的详细信息,或二者的详细信息。
* 
该函数仅适用于接线。
参数有:
{From|To} - 指示是获取电线的第一个 (自) 端口还是第二个 (至) 端口。
{propname} - 指示要从已连接对象获取的参数名。
{both|port|component} - 指示是返回已连接端口、其父项还是二者的信息。如果指定 both,则两个值用空格分开。
例如,电线的一端与名为 B1 的块连接,而另一端未进行连接。如果该函数需要参数 name,则 fromB1toNC (适用于未连接情况)。