参数

Parent page: 原理图对象

参数用于元件（如图所示）、文档和工程，以便为设计添加更详细的信息。

概述

参数是通用的文本字符串，作为父对象的子对象存在，用于向该父对象添加详细信息。例如，原理图元件大量使用参数。它们用于定义位号（Designator）和注释（Comment），以及可添加的通用参数字符串，以便对元件进行完整定义。通用元件参数可用于多种用途，包括元件细节（如功率 Wattage、电压 Voltage 等）、供应商信息（包括供应商名称和料号）、库元件设计细节（如符号的修订版本号），以及文档信息（例如链接到元件数据手册的 URL）。

参数也可以在原理图页（文档）级别和工程级别定义。文档级参数非常适合定义字段，例如文档标题和编号；工程级参数非常适合定义字段，例如设计者或工程名称。

可用性

参数是作为父对象的属性添加的；它们不像文本字符串那样可以独立放置。参数可以添加到以下任意设计对象中：

• Component - 在 Parameters 区域的 Component Properties 对话框中添加用户自定义参数；如果是在原理图库编辑器中定义元件时添加，则在 Library Component Properties 对话框中添加。对于元件对象，Designator 和 Comment 参数始终存在。要打开该对话框，在原理图编辑器中双击元件，或在原理图库编辑器的 Sch Library 面板中双击元件名称。
• Pin - 在 Pin Properties 对话框的 Parameters 选项卡中。
• Port - 在 Port Properties 对话框的 Parameters 选项卡中。
• Sheet Symbol - 在 Sheet Symbol 对话框的 Parameters 选项卡中。
• Document - 在 Document Options 对话框（Project | Content | ）中。参数列在该对话框的 Parameters 选项卡中；新建原理图页时会自动包含若干默认参数。
• Project - 在 Options for Project 对话框（Project | Content | ）中。参数列在该对话框的 Parameters 选项卡中。

图形化编辑

可见字符串可以通过所谓的 in-place 编辑进行图形化编辑。要就地编辑字符串，单击一次进行选择，停顿一秒，然后再次单击以进入编辑模式。

 单击一次以选择该字符串。

 停顿一下， 然后再次单击以进入就地编辑模式。

位号字符串的值可以就地编辑。

 此处字符串已被选中，准备输入替换字符串。

编辑完成后，按 Enter 或单击字符串以外区域以退出就地编辑模式。

通过检查器面板编辑

Panel pages: SCH Inspector、SCHLIB Inspector

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

元件参数

元件参数包括位号和注释，以及任何用户自定义参数。

在原理图库编辑器中编辑元件参数

默认情况下，位号、注释和用户自定义参数在原理图库编辑器中不可见。它们在 Library Component Properties 对话框中编辑。在 SCH Library 面板中双击元件名称，或单击 Edit 按钮打开该对话框，如下图所示。

在库编辑器中双击元件名称或单击 Edit 按钮打开对话框并编辑元件参数。

可在 Library Component Properties 对话框中勾选其 Visible 复选框来显示用户自定义参数。启用后将显示该参数 Value.。要显示参数名称，单击 Edit 按钮打开 Parameter Properties 对话框，在其中可为 Name 字段启用 Visible 复选框。

或者，也可以在原理图库编辑器中显示位号和注释字符串，然后双击它们以编辑其属性。要显示这些字符串，单击 Tools | Options |

打开 Library Editor Workspace 对话框，然后按下图所示启用 Always Show Comment/Designator 选项。该设置是原理图库的属性。

启用 Always Show Comment/Designator 选项，以在原理图库编辑器中显示这些字符串。

在原理图编辑器中编辑元件参数

元件参数可以在原理图编辑器中于放置元件时定义，也可以在元件放置到原理图页之后定义。

• 要在放置元件过程中定义位号/注释/用户参数，当元件随光标悬浮时按 Tab 键。将打开 Properties for Schematic Component 对话框。输入所需的位号/注释/用户自定义参数字符串，然后单击 OK 关闭对话框并完成元件放置。继续放置元件，或按 Esc 结束放置。
• 要在放置后定义位号/注释/用户参数，双击已放置的元件以打开 Properties for Schematic Component 对话框，在其中可编辑位号/注释/用户参数。单击 OK 关闭对话框并提交更改。

编辑元件参数的显示属性

位号/注释/用户参数字符串的外观（包括字体类型、大小和颜色）可通过以下方式定义：

1. 作为符号的属性：在原理图库编辑器的 Parameter Properties 对话框中设置位号/注释/用户参数的属性。这需要先将位号字符串设为可见，如前所述。
2. 通过编辑已放置的原理图元件的位号/注释/用户参数字符串：双击元件以编辑不同的参数属性。

两种方式都会打开 Parameter Properties 对话框，如下所示。注意：该对话框中可以编辑参数的所有属性。

Designator 字符串的值和外观可在 Parameter Properties 对话框中编辑。

固定参数字符串的位置

元件参数字符串的默认行为是在放置过程中元件旋转时自动重新定位（autoposition）。如果不需要此行为，可在 Parameter Properties 对话框中关闭 Autoposition 选项（参见上一张图），可在创建符号时设置，也可在元件放置到原理图页后设置。注意：这样会使该参数被归类为 manual parameter（即手动定位参数）。手动参数在其选择框左下角会以一个点标识。

特殊用途的元件参数

为定义元件与相关文档之间的链接，创建了特殊用途的元件参数，包括 HelpURL 和 ComponentLink 参数对。

HelpURL 参数

HelpURL 参数允许你定义从元件到外部文档（如 PDF 或网页）的链接。当你在原理图页上将光标悬停在元件上并按 F1，或当该元件在 Libraries 面板中被选中时，链接会被激活。使用该参数可以引用 PDF、文本文件或 HTML 页面。要使用此功能，将 HelpURL 参数添加到所需元件，并将参数值设置为你希望打开的文档。

在指定参数值时，你可以包含绝对路径，也可以仅输入文档名。以下示例都是该参数值的有效输入：

• C:\Design_Projects\Schematics\Modifications.txt
• From Idea to Manufacture - Driving a PCB Design through CircuitStudio.pdf
• www.circuitstudio.com

当光标悬停在已放置对象上并按下 F1 时，将按如下方式搜索文档：

• 如果指定了路径，则优先搜索该位置，
• 如果在该位置找不到文档，或未指定路径，则搜索 CircuitStudio 安装目录下的 \Help 文件夹，
• 如果仍找不到文档，则显示该对象的默认帮助主题。

ComponentLink 参数对

该功能允许你定义并呈现指向任意数量参考文档的具名链接。可以定义多个 ComponentLink 参数对。要使用此功能，请为每个 ComponentLink 对添加并配置两个参数，如下所示：

第一个参数——用于定义目标文档：

• Parameter Name = ComponentLinknURL（其中 n 为任意整数）
• Parameter Value = target document path\name

第二个参数——用于定义菜单中显示的条目：

• Name = ComponentLinknDescription （其中 n 与第一个参数中使用的整数相同）
• Value = Entry to appear in the menu

可以定义任意数量的 ComponentLink 参数对；每一对通过共享相同的 n 值进行关联。

要访问元件链接，在工作区中右键单击已放置的器件。该链接条目将出现在 References 子菜单中。

用参数值替换字符串的值

元件参数可以通过其Visible 复选框轻松显示。但文档参数或工程参数则不同，它们无法直接显示在原理图页上。要显示这些参数，需要使用一种称为String Indirection的技术。字符串间接引用（String Indirection）是一种机制：在原理图页上放置一个标准文本字符串，但不输入具体字符串值，而是输入一个以等号开头的文档参数或工程参数名称，例如=Title。软件会自动检测此类字符串，并且不会显示文本字符串本身的内容（例如=Title），而是去检查文档与工程参数；如果找到名为Title的参数，就会显示 Title 参数的值。

被间接引用的字符串称为Special Strings。系统预定义了大量特殊字符串，列表如下。任何用户自定义的文档参数或工程参数也可以视为一种特殊字符串，并可被间接引用到原理图页上的文本字符串中。

原理图预定义特殊字符串

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

• =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]。

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

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

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