使用代码片段

snippets功能允许您将单个原理图页上的任意电路选择内容，或 PCB 设计中的电路内容（包括元件和布线）保存下来，并在任何设计中重复使用。Design Reuse面板可让您快速访问使用和管理代码片段集合所需的全部控件。

创建代码片段

可以基于原理图页或 PCB 文档中的现有电路创建新的原理图或 PCB 代码片段：

1. 在原理图编辑器或 PCB 编辑器中选择所需的电路。

2. 从主菜单中选择Tools » Convert » Create Snippet from selected objects命令（在 PCB 编辑器中，也可以右键单击所选内容，然后从上下文菜单中选择Snippets » Create Snippet from selected objects）。

3. 随后将出现New Schematic Snippet或New PCB Snippet对话框，您可以在其中定义Name、Description、保存目标（Save to——已连接的 Workspace 或本地文件夹）以及新代码片段要保存到的文件夹（Path）。

   

   单击对话框中Path字段右侧的按钮，可打开Choose Folder对话框（将代码片段保存到 Workspace 时）或Choose Snippet Folder对话框（将代码片段保存到本地文件夹时），以便选择一个现有文件夹来保存代码片段，或即时创建一个新文件夹。

   • 在Choose Snippet Folder对话框中，单击  按钮，并使用随即打开的Folder Properties对话框，在本地代码片段文件夹的整体结构中添加一个新的子文件夹（）。在该对话框中，您可以为新文件夹指定名称，并确定它应创建在哪个父文件夹下。

   • 有关如何将本地代码片段组织到文件夹中的信息，请参阅下方的组织本地代码片段部分。

4. 在对话框中单击 以保存代码片段。

搜索并放置代码片段

Workspace 和本地代码片段都可以通过Design Reuse面板进行放置。

• 当该面板设置为显示 Workspace 资源（）时，可用于访问存储在已连接 Workspace 中的代码片段。

• 当该面板设置为显示本地资源（）时，可访问存储在硬盘文件夹中的代码片段（这些文件夹按上述说明进行配置）。

您可以浏览 Workspace/本地文件夹来查找所需的代码片段。或者，也可以使用面板顶部的Search字段，按名称或描述搜索代码片段。

单击面板底部的Details控件可展开Details窗格，其中显示所选复用块的详细信息，包括：

• 代码片段名称。

• 生命周期状态图标和修订版（仅适用于 Workspace 代码片段；单击链接可打开 Reuse Block Item 的详细 History 视图，并选中最新修订版）。

• 代码片段描述。

• 代码片段常规信息。

• 代码片段的预览图像。

放置代码片段之前，请确保已打开正确的目标文档并将其设为活动文档。只有当代码片段能够正确放置到该文档中时，放置命令才会生效，也就是说，代码片段类型和文档类型必须一致。

要放置代码片段，将光标悬停在Design Reuse面板中的相应条目上，单击 按钮（或右键单击该条目），然后从菜单中选择Place（适用于原理图或 PCB 代码片段）或Place as Sheet Symbol（仅适用于原理图代码片段）命令。选择后者时，代码片段将作为图纸符号放置在当前活动原理图页上。放置后的图纸符号将包含与代码片段中端口相对应的图纸入口。代码片段的内容将放置到一个自动创建的子原理图页中，并由该图纸符号引用。

组织本地代码片段

本地代码片段可以组织到代码片段文件夹中，以便将相关代码片段归类在一起，从而更容易查找。这些代码片段文件夹是现有的 Windows 文件夹，不能在Design Reuse面板内部创建。相反，在浏览其中包含的本地代码片段时，这些文件夹会被“打开”或“关闭”。这些文件夹只能直接在硬盘或网络上、在 Altium Designer 之外创建。

当Design Reuse面板设置为显示本地资源时（单击面板顶部地址栏最左侧的图标并选择Local条目——此时图标将显示为），可通过Available Snippets Folders对话框打开和关闭代码片段文件夹；该对话框可通过单击面板右上角的按钮并从菜单中选择Snippet Folders命令来访问。

• 单击 以浏览到硬盘或网络上的所需文件夹。所选文件夹将被添加到对话框中的列表，并随后显示在Design Reuse面板中。

• 要从列表中移除某个代码片段文件夹（本质上相当于在浏览视角下将其关闭），请在Available Snippets Folders对话框的列表中选择该文件夹，然后单击。

编辑代码片段

要编辑 Workspace 代码片段，将光标悬停在Design Reuse面板中的相应条目上，单击 按钮（或右键单击该条目），然后从菜单中选择Edit命令。系统将打开一个临时编辑器，其中会打开该 Snippet Item 最新修订版中包含的文档代码片段以供编辑。按需进行更改，然后将代码片段保存为该 Item 的下一修订版（File » Save to Server）。

要编辑本地代码片段的内容，请从保存该代码片段的 Windows 文件夹中打开<SCHSnippetName>.SchDoc或<PCBSnippetName>.PcbDoc文档（使用 Altium Designer 主菜单中的File » Open命令或通过Windows Explorer），按需进行更改，然后保存文档（File » Save）。

本地代码片段的属性（名称、描述和路径）可以通过Snippet Properties对话框进行编辑。要访问此对话框， 请将光标悬停在Design Reuse面板中的相应条目上，单击 按钮（或右键单击该条目），然后从上下文菜单中选择Edit命令。使用该对话框进行所需更改。

其他代码片段操作

Design Reuse面板中代码片段条目的按钮菜单（以及右键菜单）还提供以下命令：

• Move （仅适用于 Workspace 代码片段）——用于更改 Snippet Item 在 Workspace 文件夹结构中的位置。启动该命令后，将打开Move Item 对话框，以选择该 Item 应放置到的目标文件夹。

• Share （仅适用于 Workspace 代码片段）——用于定义该代码片段的共享权限。选择此命令后，将打开Share For Item对话框，您可以按需要配置共享。进一步了解Item 级共享。

• Operations （仅适用于 Workspace 代码片段）——用于访问一个下拉菜单，其中包含下文所述的其他代码片段功能。

  • Make a Copy – 用于复制该代码片段。系统将打开该代码片段的临时编辑器，其内容与原始代码片段相同。完成所需修改后，将代码片段保存到 Workspace。 

  • Change Revision State – 用于更改该代码片段最新修订版本的修订状态。选择该命令后，将打开 批量状态更改对话框，您可在其中更改该代码片段的修订状态。

  • Download – 用于下载存储在该代码片段中的数据。 相关数据将下载到所选目录下的一个子文件夹中，该子文件夹以 Item Revision ID 命名。该文件可在其中的 Released 文件夹中找到。

• Delete – 用于删除该代码片段。

  • 对于 Workspace 代码片段，将显示 Delete Items 对话框，以确认删除操作。

    该操作实际上是“软删除”，代码片段将被移至 Workspace 的 Trash 区域。了解有关 软删除 的更多信息。

  • 对于本地代码片段，将显示 Confirm 对话框以确认删除。该操作将从硬盘中移除代码片段文件。

• History （仅适用于 Workspace 代码片段）– 用于访问该代码片段的 详细视图，该视图将在 Altium Designer 中作为新的选项卡视图打开。