图幅字段
显示图纸信息的函数：在图框的文字中（以及其条形码和变量中），显示图幅上放置该图框的图纸所包含的内容；在其他任何地方，显示图纸自身包含的内容。
语法
HOST("name") HOST("name",sample)
HOSTNOTE("key") HOSTNOTE("key",sample)
HOSTCLASS("field") HOSTCLASS("field",sample)
DRAWINGTITLE() DRAWINGNAME() DRAWINGFILE() DRAWINGUNITS()
PAGENAME() VIEWPAGE() VIEWPAGE(n) VIEWPAGE("name")
SHEETNO() SHEETCOUNT() SHEETSCALE() SHEETSCALE(n)
TODAY() TODAY("format")
| 函数 | 结果 |
|---|---|
HOST("L") |
图纸变量 L 的值。 |
HOSTNOTE("Customer") |
图纸中该名称的备注（文件 › 图纸属性），不区分大小写。 |
HOSTCLASS("category") |
图纸分类的一个字段：category、style、product、tags、description 或您自己的字段。 |
DRAWINGTITLE() |
图纸的 Title 备注；没有时为其文件名。 |
DRAWINGNAME(), DRAWINGFILE() |
图纸的文件名，前者不含文件夹和扩展名，后者含扩展名。 |
DRAWINGUNITS() |
"mm" 或 "in"。 |
PAGENAME() |
图幅所在页面的名称（在图幅之外，为当前处理的页面的名称）。 |
VIEWPAGE() |
图幅第一个视口显示的页面；VIEWPAGE(2) 为第二个视口的，VIEWPAGE("Detail") 为该名称视口的。 |
SHEETNO(), SHEETCOUNT() |
这是第几张图幅（从 1 开始）以及共有多少张：按带有图幅的页面计算；在没有图幅的图纸中，按其页面计算（不含 3D 页面）。 |
SHEETSCALE() |
图幅第一个视口的比例，形如 "1:2"；适合大小显示的视图会计算出其比例（"1:2.37"）。带数字或名称时，用法同 VIEWPAGE。 |
TODAY() |
今天的日期，形如 2026-11-03（ISO 8601）；给出格式时按该格式：TODAY("dd.MM.yyyy")。 |
sample 是图纸没有该项内容时显示的内容：HOSTNOTE("Drawing number",DRAWINGNAME()) 在图纸获得 Drawing number 备注之前显示图纸名称。
结果
文字；HOST 为变量的值；SHEETNO() 和 SHEETCOUNT() 为数字。
示例
在示例图纸中（该图纸没有备注且未保存）：
| 表达式 | 结果 |
|---|---|
HOST("W") |
300 |
HOST("FLAP",25) |
25 |
HOSTNOTE("Customer") |
"<Customer>" |
HOSTNOTE("Revision","-") |
"-" |
HOSTCLASS("style") |
"<style>" |
DRAWINGNAME() |
"<Drawing name>" |
DRAWINGUNITS() |
"mm" |
PAGENAME() |
"Page 1" |
CONCAT("Sheet ",SHEETNO()," of ",SHEETCOUNT()) |
"Sheet 1 of 1" |
SHEETSCALE() |
"1:1" |
说明
占位符。 在单独的图纸中（例如您正在编辑的图框），图纸没有的字段会显示尖括号中的占位符（如上所示），以便您看清各项内容的位置。在图幅上，如果给出了 sample，则显示 sample，否则不显示任何内容。
在图幅上，每当字段所显示的内容发生变化，字段都会重新计算：为图纸添加备注、重命名页面、添加图幅、更改比例或变量，图幅都会随之更新。
如果图纸自己有同名的 FUNCTION，则使用该函数而不是这里的函数。