在原理图上操作文本对象

以下是可在原理图文档中使用的预定义特殊字符串。其中大多数关联到活动文档的默认参数信息，这些信息在 Properties 面板处于 Document Options 模式（未选中任何对象）时的 Parameters 选项卡中定义。

• =Address1 – 显示为默认文档级参数 Address1 指定的值。
• =Address2 – 显示为默认文档级参数 Address2 指定的值。
• =Address3 – 显示为默认文档级参数 Address3 指定的值。
• =Address4 – 显示为默认文档级参数 Address4 指定的值。
• =Application_BuildNumber – 显示当前安装的 Altium Designer 的版本号和内部版本号。
• =ApprovedBy – 显示为默认文档级参数 ApprovedBy 指定的值。
• =Author – 显示为默认文档级参数 Author 指定的值。
• =CheckedBy – 显示为默认文档级参数 CheckedBy 指定的值。
• =CompanyName – 显示为默认文档级参数 CompanyName 指定的值。
• =CurrentDate – 当前日期，以当前 Windows 区域设置中的短日期格式显示，在编辑原理图或刷新/重绘时更新。例如：22/09/2015。
• =CurrentTime – 当前时间，以当前 Windows 区域设置中的长时间格式显示，在编辑原理图或刷新/重绘时更新。例如：2:39:47 PM。
• =Date – 用于显示用户定义的静态日期信息。显示为默认文档级参数 Date 指定的值。与自动计算并以固定格式显示的 =CurrentDate 特殊字符串不同，您可以按自己喜欢的任何格式输入静态日期信息。
• =DocumentFullPathAndName – 用于显示放置该字符串的文档的完整路径和名称。例如：C:\MyTestDesign\PSU.SchDoc。
• =DocumentName – 用于仅显示原理图的文件名（不含文件路径）。例如：PSU.SchDoc。
• =DocumentNumber – 显示为默认文档级参数 DocumentNumber 指定的值。使用 Tools » Annotation » Number Schematic Sheets 命令时，也可以通过 项目图纸编号 对话框 更新源参数。
• =DrawnBy – 显示为默认文档级参数 DrawnBy 指定的值。
• =Engineer – 显示为默认文档级参数 Engineer 指定的值。
• =ImagePath – 显示为默认文档级参数 ImagePath 指定的值。
• =Item – 生成的数据所关联的条目（例如， D-810-2000）。这些数据将用于构建该条目。
• =ItemAndRevision – 生成的数据所关联的条目及其特定修订版， 格式为 <Item ID>-<Revision ID>（例如 D-810-2000-01.A.1）。这些数据将用于构建该条目的特定修订版。
• =ItemRevision – 生成的数据所关联的条目的特定修订版（例如， 01.A.1）。数据存储在目标工作区中该条目的相应修订版内。
• =ItemRevisionBase – 条目修订版命名方案中的基础级别部分（例如， 1）。
• =ItemRevisionLevel1 – 条目修订版命名方案中的第 1 级部分（例如， A）。
• =ItemRevisionLevel1AndBase – 条目修订版命名方案中的第 1 级和基础级别部分（例如， A.1）。
• =ItemRevisionLevel2 – 条目修订版命名方案中的第 2 级部分（例如， 01）。
• =ItemRevisionLevel2AndLevel1 – 条目修订版命名方案中的第 2 级和第 1 级部分（例如， 01.A）。
• =ModifiedDate – 原理图的修改日期戳；此值会自动填充。例如：23/09/2015。
• =Organization – 显示为默认文档级参数 Organization 指定的值。
• =PCBConfigurationName – 用于生成输出的数据集的名称， 该名称在 Release 视图（项目发布器）中定义。
• =ProjectName – 显示项目的实际名称（包括扩展名）。 例如，对于文件名为 MyPCB.PrjPcb 的项目，此特殊字符串将显示 MyPCB.PrjPcb。
• =Revision – 显示为默认文档级参数 Revision 指定的值。
• =SheetNumber – 当前原理图的图纸编号。使用 Tools 菜单中的以下命令时会计算此值：
  • Number Schematic Sheets – 项目图纸编号 对话框中分配的图纸编号 将被填入默认文档级参数 SheetNumber 的值中。在原理图图纸的编辑器选项卡视图中使用此特殊字符串时， 将从此处获取信息。
  • Annotate Compiled Sheets – 在原理图的 Compiled 选项卡视图中查看该字符串时，将显示 编译后图纸标注 对话框中分配的编译后图纸编号。必须在 Preferences 对话框的 原理图 – 编译器 页面上的 Compiled Names Expansion 区域中，启用显示 Sheet Number 对象展开后的编译名称的选项。
• =SheetSymbolDesignator – 放置在父级原理图图纸上的关联 图纸符号对象 的标号。此特殊字符串 也可用于多通道设计。选择子原理图图纸的某个编译后选项卡，即可显示此特殊字符串转换后的值。
• =SheetTotal – 项目的图纸总数。使用 Tools 菜单中的以下命令时会计算此值：
  • Number Schematic Sheets – 项目图纸编号 对话框中的图纸总数 将被填入默认文档级参数 SheetTotal 的值中。在原理图图纸的编辑器选项卡视图中使用此特殊字符串时， 将从此处获取信息。
  • Annotate Compiled Sheets – 在原理图的 Compiled 选项卡视图中查看该字符串时，将显示图纸总数，其值取自 编译后图纸标注 对话框中列出的图纸数量。必须在 Preferences 对话框的 原理图 – 编译器 页面上的 Compiled Names Expansion 区域中， 启用显示 Sheet Number 对象展开后的编译名称的选项。
• =Time – 用于显示用户定义的静态时间信息。显示为默认文档级参数 Time 指定的值。与自动计算并以固定格式显示的 =CurrentTime 特殊字符串不同，您可以按自己喜欢的任何格式输入静态时间信息。
• =Title – 显示为默认文档级参数 Title 指定的值。
• =VariantName - 显示用于生成输出的变体。此值与当前变体的条目一致（通过 Variants 工具栏显示和更改）。如果使用基础设计生成输出，则该值为 [No Variations]。
• =VersionControl_ProjFolderRevNumber – 工程的当前修订号，每次对工程执行完整提交（即 包括工程文件）时都会递增。必须使用版本控制，此字符串才会包含信息。
• =VersionControl_ProjFolderRevNumberShort – 工程的简短 Git 哈希值（前八个字符）。 必须使用版本控制，此字符串才会包含信息。
• =VersionControl_RevNumber – 文档的当前修订号。必须使用版本控制，此字符串才会包含信息。
• =VersionControl_RevNumberShort – 文档当前修订版本的简短 Git 哈希值（前八个字符）。必须使用版本控制，此字符串才会包含信息。

用于元件参数的特殊字符串

使用文本字符串定义元件参数时，还可以使用其他一些特殊字符串（或对现有特殊字符串作特殊解释）。在每种情况下，均将特殊字符串输入为参数值。

• =CurrentFootprint – 显示当前为元件指定的封装名称。
• =Comment – 显示元件的 Comment 字段中的值。
• =Description – 显示元件的 Description 字段中的值。
• =<ParameterName> – 显示为指定元件参数定义的值。将元件参数的实际名称输入为特殊字符串名称。例如， 对于名为 PowerRating 的元件参数，输入 =PowerRating。定义元件的 Comment 属性时，使用此类特殊字符串可快速将任意已定义参数的值用于 Comment。