Search In: Doc:Documentation: Altium Designer
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany Dashboard
Close
搜索 Search on Documentation

使用文本对象

Created: 一月 03, 2025 | Updated: 四月 29, 2025

Text（文本）对象用于在所选层上放置单行字符串或多行文本框，并支持多种显示样式与格式，包括常见的条码标准和二维码。它既可以是用户自定义文本，也可以是一种特殊类型的字符串（称为“特殊字符串”），用于显示板级或系统信息，或显示板上用户参数的值。文本框是可调整大小的矩形区域，可包含多行文本，并可自动换行与裁剪文本，使其保持在文本框边界内。

已放置的 Text 对象
已放置的 Text 对象

在 PCB 编辑器和 PCB 封装编辑器中，都可以通过主菜单中的 Place » String 或 Place » Text Frame 命令来放置 Text 对象。启动字符串放置命令后，光标会变为十字准星，并进入文本放置模式。此时会有一个 Text 对象跟随光标悬浮显示：

  1. 定位光标后单击，或按 Enter 放置一个 Text 对象。
  2. 继续放置更多 Text 对象，或右键单击/按 Esc 退出放置模式。
根据所选的放置命令（Place » String 或 Place » Text Frame），正在放置的 Text 对象将处于 String 或 Frame 模式；该模式可在放置过程中或放置后，通过 Properties 面板 进行更改。

放置过程中还可执行以下附加操作：

  • 按 Spacebar 使文本对象逆时针旋转，或按 Shift+Spacebar 顺时针旋转。旋转步进遵循 Rotation Step 的设置，该设置定义在 PCB Editor – General 页面（位于 Preferences 对话框中）。
  • 按 X 或 Y 键，使文本对象沿 X 轴或 Y 轴镜像。
  • 按 L 键，将文本对象翻转到电路板的另一面。
  • 按数字键盘上的 + 和 - 键，在设计中所有可见层之间向前/向后循环，以快速更改放置层。

图形化编辑方式允许你在设计空间中直接选中已放置的文本对象，并更改其位置、旋转、方向和尺寸。

当选中文本对象时，可使用以下编辑手柄：

选中的 Text
选中的 Text

  • 单击并拖动 B，以其参考点 A （由小 x 标记）为中心旋转文本对象。
  • 单击并拖动 C，同时在垂直与水平方向调整文本对象边界框大小。
  • 单击并拖动 D，分别在垂直与水平方向调整文本对象边界框大小。
  • 在远离编辑手柄的文本对象区域单击并拖动以重新定位。拖动过程中，可对注释进行旋转或镜像：
    • 按 Spacebar 使文本对象逆时针旋转，或按 Shift+Spacebar 顺时针旋转。旋转步进遵循 Rotation Step 的设置，该设置定义在 PCB Editor – General 页面（位于 Preferences 对话框中）。
    • 按 X 或 Y 键，使文本对象沿 X 轴或 Y 轴镜像。
  • 新放置的字符串对象的默认文本为 String。放置后（除非在放置前或放置过程中已更改），可在通过 Properties 面板查看该字符串属性时，使用文本输入窗口按需修改此文本。
  • 软件支持将 Text 对象直接作为条码符号放置到 PCB 的任意层上，从而可在制造过程中将条码方便地印制到 PCB 上。要了解如何将 Text 对象用作条码，请参阅 Including Barcodes & Logos 页面中的 Adding a Barcode 小节。
  • 软件支持将 Text 对象直接作为二维码放置到 PCB 的任意层上，从而可在制造过程中将二维码方便地印制到 PCB 上。要了解如何将 Text 对象用作二维码，请参阅 Including Barcodes & Logos 页面中的 Adding a QR Code 小节。

特殊字符串

虽然 Text 对象可用于在当前 PCB 层上放置用户自定义文本，但可放置的并不只有 only 用户自定义文本。为便于生成文档，引入了 special strings 的概念。它们充当占位符，用于表示设计、系统或项目信息，并在生成输出时显示在 PCB 上。

设计、系统以及设计参数类特殊字符串示例：第一张图为源字符串，第二张图为转换后的显示。 
设计、系统以及设计参数类特殊字符串示例：第一张图为源字符串，第二张图为转换后的显示。

PCB 文档中可用的特殊字符串来自多个来源：

使用特殊字符串的注意事项

  • 特殊字符串以 “.”（点号）开头来标识（例如 .Layer_Name、 .Net_Count 等）。 如果字符串以 “.” 开头，则整个字符串都会被视为“特殊”字符串。引用用户参数时也使用该语法：参数名之前加上 “.”（点号）。
  • 若要在同一个 PCB 文本中包含多个特殊字符串，请将每个特殊字符串用撇号（ ' ）括起来；例如：'.Pcb_File_Name_No_Path' '.Print_Date'。
  • 在拼接的特殊字符串之间也可以加入文本、空格和特殊字符，例如：FileName= '.Pcb_File_Name_No_Path' : PrintDate = '.Print_Date'。
  • 项目参数名与变体参数名中也可以包含空格和特殊字符。

  • 某些特殊字符串的值只能在生成相关输出时查看，包括 .Legend、.Plot_File_Name 和 .Printout_Name。大多数特殊字符串可在屏幕上直接查看。

    为 PCB 项目生成文档并发布到 Workspace 时，需要有一种方式来指明文档对应的 Item 与 Revision，以及发布所用设计项目的配置和任何适用的驱动变体。为此提供了一组特殊字符串用于管理这些信息，包括 .PCBConfigurationName、.ItemAndRevision 和 .VariantName。这些特殊字符串在生成输出之前不会被解释（除非以 3D 方式查看 PCB，因为 3D 查看本身也被视为一种输出）。使用这些字符串提供的信息可在生成的输出中看到，包括 Gerber/ODB++ 文件、Final Artwork 打印、PCB 打印、PCB 3D 打印、PCB 3D Video 以及装配图。
  • 特殊字符串会自动转换以便在屏幕上显示。如果字符串无法转换，则会显示所输入字符串的值或一条提示信息。例如，如果项目未处于版本控制之下，而在 PCB 上放置了特殊字符串 .VersionControl_RevNumber，则会显示消息 Not in Version Control。

  • 为便于识别 特殊字符串，View Configuration 面板 包含一个 Special Strings 选项。启用该选项后，任何由已转换特殊字符串形成的已放置文本对象，都会叠加显示（标注）未转换的特殊字符串名称。

放置特殊字符串

要在 PCB 上使用特殊字符串，请先放置一个 Text 对象，然后在 Properties 面板中，从 Text 字段下拉列表（String 模式）或  下拉列表（Frame 模式）中选择一个特殊字符串名称。

为已放置的字符串对象访问特殊字符串。
为已放置的字符串对象访问特殊字符串。

以下为 PCB 文档中可用的、预定义的系统类特殊字符串：

  • .Application_BuildNumber – 当前加载该 PCB 的软件版本。生成 Gerber 输出时，可用此字符串记录创建该设计所用的软件构建版本。
  • .Arc_Count – PCB 上圆弧的数量。
  • .BlindVia_Count – PCB 上盲孔过孔的数量。
  • .Board_Height – PCB 板的垂直尺寸。
  • .Board_Width – PCB 板的水平尺寸。 
  • .BuriedVia_Count – PCB 上埋孔过孔的数量。
  • .Comment – 元件的注释字符串（在库编辑器中作为元件封装的一部分，可放置在任意层）。
  • .Component_Count – PCB 上元件的数量。
  • .ComponentMixed_Count – PCB 上具有混合焊盘的元件数量。
  • .ComponentSMD_Count – PCB 上具有 SMD 焊盘的元件数量。
  • .ComponentThru_Count – PCB 上具有通孔焊盘的元件数量。
  • .ComputerName– 安装并运行该软件的计算机名称。
  • .CopperInner_Weight_Max – 内层的最大铜厚（铜重）。
  • .CopperOuter_Weight_Max – 外层的最大铜厚（铜重）。
  • .Designator – 元件的标号字符串（在库编辑器中作为元件封装的一部分，可放置在任意层）。
  • .Fill_Count – PCB 上的填充（fill）数量。
  • .Hole_Count – PCB 上的钻孔数量。
  • .Hole_Size_Min – PCB 上的最小孔径。
  • .Hole_Size_Num – PCB 上不同孔径（唯一孔径）的数量。
  • .Item – 生成数据所关联的 Item（例如： D-810-2000）。这些数据将用于构建该 Item。
  • .ItemAndRevision – 生成数据所关联的 Item 及其特定修订版，格式为 <Item ID>-<Revision ID>（例如： D-810-2000-01.A.1）。这些数据将用于构建该特定 Item 的该特定修订版。
  • .ItemRevision – 生成数据所关联的 Item 的特定修订版（例如： 01.A.1）。数据会存储在目标服务器中的该 Item Revision 内。
  • .ItemRevisionBase – Item Revision 命名方案中的 Base Level 部分（例如： 1）。
  • .ItemRevisionLevel1 – Item Revision 命名方案中的 Level 1 部分（例如： A）。
  • .ItemRevisionLevel1AndBase – Item Revision 命名方案中的 Level 1 与 Base Level 部分（例如： A.1）。
  • .ItemRevisionLevel2 – Item Revision 命名方案中的 Level 2 部分（例如： 01）。
  • .ItemRevisionLevel2AndLevel1 – Item Revision 命名方案中的 Level 2 与 Level 1 部分（例如： 01.A）。
  • .Layer_Count – PCB 上的铜层数量。
  • .Layer_Name – 放置该字符串所在层的名称。
  • .Legend – 机械钻孔图（drill plots）的符号图例。该字符串仅在放置于 Drill Drawing 层时有效。注意：这是一个遗留功能；如需更详细的钻孔信息，请放置 Drill Table 对象。
  • .MicroVia_Count – PCB 上的微孔（microvia）数量。
  • .ModifiedDate – PCB 的修改日期时间戳；会自动填充。示例： 23/09/2015。
  • .ModifiedTime – PCB 的修改时间时间戳；会自动填充。
  • .Net_Count – PCB 上不同网络（net）的总数量。
  • .Net_Names_On_Layer – 特定层上所有网络的名称。该字符串仅在放置于内部电源层（internal plane layer）时有效。
  • .Pad_Count – PCB 上焊盘（pad）的数量。
  • .PadSMD_Count – PCB 上 SMD 焊盘的数量。
  • .PadThru_Count – PCB 上通孔焊盘（thru-hole pad）的数量。
  • .Pattern – PCB 上使用的元件封装名称。
  • .Pcb_File_Name – PCB 文档的路径和文件名。
  • .Pcb_File_Name_No_Path – PCB 文档的文件名。
  • .PCBConfigurationName – 显示生成输出所使用的数据集名称，该名称在 Project Releaser 中定义。请注意，默认的 Source、Fabrication 和 Assembly 配置名称不可编辑（例如，Fabrication 输出会为 .PCBConfigurationName 显示 Fabrication）。当使用该特殊字符串时，用户自定义的 Custom 配置将显示用户定义的名称（show image）。
  • .Plot_File_Name – 对于生成的 Gerber 输出，该字符串标识 Gerber 绘图文件的文件名。对于打印输出，它标识输出中所描绘的层。对于 ODB++ 输出，它标识存放文件的父文件夹名称。
  • .Poly_Count – PCB 上多边形（polygon）数量（包括 polygon pours、internal planes 和 split planes）。
  • .Print_Date – 打印/绘图日期。
  • .Print_Scale – 打印/绘图比例因子。
  • .Print_Time – 打印/绘图时间。
  • .Printout_Name – 打印输出的名称。
  • .SlotHole_Count – PCB 上长槽孔（slotted holes）的数量。
  • .SolderMask_Bottom – 底层阻焊（bottom solder mask）的可用性。如果没有底层阻焊层，该参数将为 No mask 值。如果存在底层阻焊层但未定义颜色，该参数将为 No color 值。如果存在底层阻焊层且已定义颜色，该参数将显示颜色：可以是名称（Green、Black、Blue、Red 等），也可以是 RGBA 代码（例如 #FF0065FF）。
  • .SolderMask_Top – 顶层阻焊（top solder mask）的可用性。如果没有顶层阻焊层，该参数将为 No mask 值。如果存在顶层阻焊层但未定义颜色，该参数将为 No color 值。如果存在顶层阻焊层且已定义颜色，该参数将显示颜色：可以是名称（Green、Black、Blue、Red 等），也可以是 RGBA 代码（例如 #FF0065FF）。
  • .SquareHole_Count – PCB 上方孔（square holes）的数量。
  • .StackedVia_Count – PCB 上叠孔（stacked vias）的数量。
  • .String_Count – PCB 上字符串（strings）的数量。
  • .Thru_Via_Count – PCB 上通孔过孔（thru-hole vias）的数量。
  • .Total_Thickness – 板厚。
  • .Total_Thickness(Board Layer Stack) – 板层叠厚度。
  • .Track_Count – PCB 上走线（tracks）的数量。
  • .VariantName – 生成该输出所基于的设计变体（variant）。
  • .VersionControl_PrjFolderRevNumber – 项目的当前修订号；每当对项目执行一次完整提交（即包含项目文件）时都会递增。必须使用版本控制，该字符串才会包含任何信息。
  • .VersionControl_ProjFolderRevNumber – 项目的当前修订号；每当对项目执行一次完整提交（即包含项目文件）时都会递增。必须使用版本控制，该字符串才会包含任何信息。
  • .VersionControl_ProjFolderRevNumberShort – 项目的短 Git 哈希格式（前 8 个字符）。必须使用版本控制，该字符串才会包含任何信息。
  • .VersionControl_RevNumber – 文档的当前修订号。必须使用版本控制，该字符串才会包含任何信息。
  • .VersionControl_RevNumberShort – 文档当前修订号的短 Git 哈希格式（前 8 个字符）。必须使用版本控制，该字符串才会包含任何信息。
  • .Via_Count – PCB 上过孔（vias）的数量。
可用的特殊字符串完整列表还将包括任何由用户定义的项目级参数派生的字符串。
AI-LocalizedAI 翻译
如您发现任何问题，请选中相关文本/图片，并按 Ctrl + Enter 键向我们提交反馈。
功能可用性

您可使用的功能取决于您所选择的 Altium 解决方案 —— Altium Develop、Altium Agile（Agile Teams 或 Agile Enterprise 版本），或仍在有效订阅期内的 Altium Designer。

如果您在软件中未找到文中提及的功能，请联系 Altium 销售团队了解更多信息。

旧版文档

Altium Designer 文档不再提供版本区分。如果您需要访问 Altium Designer 旧版本的文档，请前往其他安装程序页面的旧版文档部分。

Content