文本字符串

Parent page: 原理图对象

已放置的文本字符串。

概述

文本字符串（也称为注释）是一种非电气的绘图基本元素。它是一行可自由输入的文本，可放置在原理图图纸上。用途包括章节标题、修订历史、时序信息，或其他描述性/说明性文字。

可用性

文本字符串可在原理图编辑器和原理图库编辑器中放置：

• Schematic Editor - 从主菜单单击 Home | Graphical Elements | 。
• Schematic Library Editor - 从主菜单单击 Home | Place | 。

放置

启动命令后，光标将变为十字准星，并进入文本字符串放置模式。一个文本字符串会“悬浮”在光标处。

1. 定位对象后单击或按 Enter 以完成放置。
2. 继续放置更多文本字符串，或右键单击/按 Esc 退出放置模式。

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

• 按 Tab 键打开关联的属性 对话框，可在放置过程中即时更改文本字符串的属性。
• 按 Alt 键将移动方向约束为水平或垂直轴（取决于初始移动方向）。
• 按 Spacebar 使文本字符串逆时针旋转，或按 Shift+Spacebar 顺时针旋转。旋转以 90° 为增量。
• 按 X 或 Y 键分别沿 X 轴或 Y 轴镜像文本字符串。

图形化编辑

此编辑方式允许你在工作区中直接选择已放置的文本字符串对象，并以图形方式更改其位置。文本字符串的大小只能通过更改所用字体的大小来调整（通过 Annotation 对话框访问）。因此，当选中文本字符串对象时不会显示编辑手柄：

已选中的文本字符串

• 在虚线框内任意位置单击并拖动，以按需重新定位文本字符串。拖动时，可旋转（Spacebar/Shift+Spacebar）或镜像（按 X 或 Y 键分别沿 X 轴或 Y 轴镜像）文本字符串。
• 文本字符串对象的文本可通过 in-place 以下方式编辑：
  1. 单击一次文本字符串以选中。
  2. 再次单击一次（或按 Enter 键）进入就地编辑模式。两次单击之间需间隔足够时间，以确保软件不会将两次单击识别为一次双击（双击会打开文本字符串的属性对话框）。
  3. 完成就地文本编辑后，按 Enter 键，或用鼠标单击文本字符串以外区域。

非图形化编辑

提供以下非图形化编辑方法：

通过关联属性对话框

Dialog page: 注释

此编辑方式使用 Annotation 对话框来修改文本字符串对象的属性。

注释 对话框

在放置过程中可按 Tab 键打开该对话框。

放置后，可通过以下方式之一打开该对话框：

• 双击已放置的文本字符串对象。
• 将光标悬停在文本字符串对象上，右键单击，然后从快捷菜单中选择 Properties。

通过检查器面板

Panel pages: SCH Inspector、SCHLIB Inspector

Inspector 面板可用于查看并编辑活动文档中一个或多个设计对象的属性。

特殊字符串

虽然文本字符串对象可用于在原理图图纸上放置用户自定义文本，但可放置的并不只有 just 用户自定义文本。为便于生成文档，引入了“特殊字符串”的概念。它们充当设计或系统信息的占位符，在生成输出时显示在原理图上。

新建原理图文档提供了一组默认的预定义特殊字符串。你也可以通过在文档级（仅用于当前原理图）或项目级（可用于项目中的所有原理图图纸和 PCB 文档）定义附加参数，来添加自定义特殊字符串。

放置特殊字符串

要在原理图中使用特殊字符串，请先放置一个文本字符串对象，然后将其文本设置为某个特殊字符串名称。

在原理图图纸上，特殊字符串以前缀“=”为特征（例如 =CurrentTime、=CurrentDate 等）。可用特殊字符串列表（预定义与自定义）可通过在 Annotation 对话框中单击 Text 字段关联的下拉箭头查看。

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

原理图预定义特殊字符串

以下为可在原理图文档中使用的预定义特殊字符串。其中大多数链接到在 Document Options 对话框的 Parameters 选项卡中为活动文档定义的默认参数信息（Project | Content | Document Options）。

• =Address1 – 显示默认文档级参数 Address1 所指定的值。
• =Address2 – 显示默认文档级参数 Address2 所指定的值。
• =Address3 – 显示默认文档级参数 Address3 所指定的值。
• =Address4 – 显示默认文档级参数 Address4 所指定的值。
• =Application_BuildNumber – 显示当前 CircuitStudio 安装的版本与构建号
• =ApprovedBy – 显示默认文档级参数 ApprovedBy 所指定的值。
• =Author – 显示默认文档级参数 Author 所指定的值。
• =CheckedBy – 显示默认文档级参数 CheckedBy 所指定的值。
• =CompanyName – 显示默认文档级参数 CompanyName 所指定的值。
• =CurrentDate – 当前日期，根据用户系统设置自动计算，并以 dd/mm/yyyy 格式显示；在编辑原理图或刷新/重绘时更新。示例：10/12/2012。
• =CurrentTime – 当前时间，根据用户系统设置自动计算，并以 h:mm:ss AM/PM 格式显示；在编辑原理图或刷新/重绘时更新。示例：2:39:47 PM。
• =Date – 用于显示静态日期信息。显示默认文档级参数 Date 所指定的值。不同于会自动计算并以固定格式呈现的 =CurrentDate 特殊字符串，你可以用任意格式输入静态日期信息。
• =DocumentFullPathAndName – 用于显示放置该字符串的文档的完整路径与名称。示例：C:\MyTestDesign\PSU.SchDoc。
• =DocumentName – 仅用于显示原理图文件名（不含文件路径）。示例：PSU.SchDoc。
• =DocumentNumber – 显示默认文档级参数 DocumentNumber 所指定的值。使用 Tools | Annotation | Number Sheets 命令时，也可通过 Sheet Numbering For Project 对话框更新源参数。
• =DrawnBy – 显示默认文档级参数 DrawnBy 所指定的值。
• =Engineer – 显示默认文档级参数 Engineer 所指定的值。
• =ImagePath – 显示默认文档级参数 ImagePath 所指定的值。
• =ModifiedDate – 原理图的修改日期时间戳，自动填充。示例：10/12/2012。
• =Organization – 显示默认文档级参数 Organization 所指定的值。
• =ProjectName – 显示项目的实际名称（含扩展名）。例如，项目文件名为 MyPCB.PrjPcb 时，该特殊字符串将显示 MyPCB.PrjPcb。
• =Revision – 显示默认文档级参数 Revision 所指定的值。
• =Rule – 显示默认文档级参数 Rule 所指定的值。该参数的初始值为 Undefined Rule（在原理图上显示为 *）。双击参数值即可定义规则类型并编辑其约束条件。
• =SheetNumber – 当前原理图的图纸编号。该值在使用 Tools | Annotate | Number Sheets 命令时计算。Sheet Numbering For Project 对话框中分配的图纸编号将写入默认文档级参数 SheetNumber 的值中。当该特殊字符串用于原理图图纸的 Editor 选项卡视图时，将从此处获取信息。
• =SheetTotal – 项目的图纸总数。该值在使用 Tools | Annotate | Number Sheets 命令时计算。Sheet Numbering For Project 对话框中的图纸总数将写入默认文档级参数 SheetTotal 的值中。当该特殊字符串用于原理图图纸的 Editor 选项卡视图时，将从此处获取信息。
• =Time– 用于显示静态时间信息。显示为默认文档级参数 Time 所指定的值。不同于会自动计算并以固定格式呈现的 =CurrentTime 特殊字符串，你可以用任何你喜欢的格式输入静态时间信息。
• =Title – 显示为默认文档级参数 Title 所指定的值。
• =VariantName - 显示生成输出所使用的变体。该项会跟在当前变体（Project | Project Actions | Current Variant）的条目之后。如果使用基础设计生成输出，则该值为 [No Variations]。

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

在定义组件参数时，还可以使用若干额外的特殊字符串（或对现有特殊字符串的特殊解释）。在每种情况下，都是将特殊字符串作为参数的值来输入。

• =CurrentFootprint – 显示该组件当前分配的封装名称，该封装在关联的 Component Properties 对话框的 Models 区域中定义。
• =Comment – 显示组件的 Comment 字段中出现的值，该字段在关联的 Component Properties 对话框的 Properties 区域中定义。
• =Description – 显示组件的 Description 字段中出现的值，该字段在关联的 Component Properties 对话框的 Properties 区域中定义。
• =[ParameterName] – 显示为指定组件参数所定义的值。将组件参数的实际名称作为特殊字符串名称输入——因此，对于名为 PowerRating 的组件参数，应输入 =PowerRating。在为组件定义 Comment 属性时，关联的下拉字段会填充所有现有组件参数对应的特殊字符串——从而可以快速将任意已定义参数的值用于 Comment。