节点、引脚和连线

程序是由节点组成的图。每个节点做一件事（将两个数相加、加载一张图像、打印一行文本），它的引脚是它接收的内容（位于左侧）和输出的内容（位于右侧）。连线将值从一个节点的输出引脚传递到另一个节点的输入引脚。

每个节点都有一个标题；输入引脚沿左侧排列，未连线的输入引脚旁有一个用于填写值的框；输出引脚沿右侧排列；底部的页脚显示它上一次解释运行的情况。Appearance and settings ▸ Node previews 可以关闭节点下方的图片和值；Level of detail 可以减少每个节点的绘制内容（只绘制标题栏和引脚、只绘制标题，或者只绘制一个带引脚的空形状），设为 Auto 时则在缩小时逐渐简化。这些设置不会移动任何内容或改变其大小，每个节点仍然可以选中、拖动和连线。引脚的颜色表示它的类型：在这里，数字为青色，文本为粉色。

放置节点

• 工具箱托盘：按 Ctrl+Space，或双击画布的空白处，按名称查找节点。请参阅窗口。
• 节点库：按 Ctrl+Shift+Space，浏览所有工具箱。
• 快捷键可在指针处放置一个值：Ctrl+1 放置 Number，Ctrl+2 放置 Boolean，Ctrl+3 放置 Text Line，Ctrl+4 放置多行 Text，Ctrl+5 放置文件或文件夹 Path，Ctrl+6 放置 Preview，它会显示连入它的任何内容。
• Ctrl+R 再次放置你上一次放置的节点。

除语言自身的节点（值、循环、分支、Return）和文档自己的图之外，托盘和节点库还提供文档所引用的包中的节点。请参阅引用。

将鼠标悬停在节点上可查看它是什么：它调用的函数、它来自的工具箱和包，以及它的说明。选中节点后按 F1，即可在节点库中定位到该节点。

带有编辑器的节点

有些节点保存的是你手工制作的内容，而不是通过连线传入的内容，双击这类节点的任意位置即可打开其编辑器：Draw Shapes、Draw Shape 和 Draw Curve 打开绘图板，Create Image 和 Annotate Image 打开画板，九个 Create … Arrays 节点（例如 Create Boolean Arrays）打开一个用于输入值的列表，Record Audio 打开录音机。你制作的内容保存在节点中，也就是文档内部。即使文档没有引用某个节点所属的包，该节点仍然可以工作，其工具提示会显示 Not declared by this document。

值

没有连线连入的输入引脚旁边有一个框，用于填写它的值：数字、一段文本、复选框或选项列表。单击它，输入内容，然后按 Enter。选中节点时，Properties 面板中也会列出相同的值，在那里编辑长文本更方便。连线连入引脚后，该引脚的框会隐藏：以连线的值为准。

无论计算机的区域设置如何，数字和日期都按同一种方式输入：数字用点作小数点，不使用千位分隔符，例如 1.5、2500；日期和时间写作 2026-10-16 14:30:00。其他写法的值不会被接受；状态栏会给出提示（例如 '1,5' is not a Number），框中的内容也会恢复为节点原有的值。

连线

• 连接：从输出引脚拖动到输入引脚。连线只能落在值可以传入的位置；无法连接的连线在拖动过程中会变成红色，且不会创建。
• 连接到新节点：从引脚拖出一条连线，在空白处松开。工具箱托盘随即打开，只提供可以接受该连线的节点，你选择的节点会被放置并接好连线。在 Routine 或 Events 图上，从另一条语句的值放置的语句也会在执行流上与之相接，即它的 Previous 会连接到该语句的 Next。
• 替换：将一条新连线拖入已有连线的输入；一个输入只接受一条连线。
• 将多个值连入一个列表：接受值列表（数组）的输入，例如 Format 的 Text Values，可以从每个值各接受一条连线，节点按顺序接收它们。画布会将这些连线编号为 1、2、3，选中节点时，Properties 面板中该输入所在的行会列出它们，并提供将某一条前移或后移的按钮。传递整个列表的连线会替换它们。
• 断开连接：按住 Alt 并单击连线即可移除它，或按住 Alt 单击引脚，移除该引脚上的所有连线。
• 一次切断多条：按住 Alt，按住鼠标右键拖过要切断的连线。

每次编辑（包括连线）都是文档撤消历史中的一步：Ctrl+Z 撤消，Ctrl+Y 重做。每个标签页都有自己的历史记录。

选择和移动

要执行的操作	操作方法
选中一个节点	单击它
添加到选择中	Shift+单击
添加或移除一个节点	Ctrl+单击
选择一个区域	在画布的空白处拖出一个框
全选	Ctrl+A
移动	拖动节点的标题；所有选中的节点会随之移动
微调	方向键
沿某一边对齐	Alt+Shift 加方向键：对齐所选节点的左、右、上或下边缘
删除	Delete
复制和粘贴	Ctrl+C 和 Ctrl+V；被复制节点之间的连线也会一并复制

Routine 的 Begin 和最后一个 Return，以及 Function 的 Input 和 Output，在你删除时会保留下来，因为图需要它们。

整理

• 整理布局：按 Ctrl+L，或单击工具栏上的扫帚图标，将图排列成整齐的列。选中两个或更多节点时，只整理这些节点，其余节点保持原位。右键单击扫帚图标可设置它使用的间距和方向。
• 注释：Ctrl+0 在指针处放置一个注释；双击注释可编辑其文本。
• 分组：选中一些节点后按 Ctrl+G，即可用一个分组框住它们。双击分组标题栏可重命名分组；拖动分组会移动其中的所有内容。
• 标签：双击节点的标题，可以为它设置自定义标签。节点的功能不变，其工具提示仍会显示函数名称。提交原标题或空白内容即可去掉标签。
• 名称：节点 Properties 中的 Name 是程序对该节点所输出值的称呼。它必须是一个 C# 名称，例如 radius 或 my_radius：由字母、数字和下划线组成，不能以数字开头，不能是 C# 保留字，也不能与图中其他节点已有的名称相同。状态栏会显示 Set name；不合要求的名称不会被接受，框下方的一行文字会说明原因，例如 'class' is a C# keyword。
• 绘图：按 Ctrl+D，或单击工具栏上的笔图标，即可在画布上徒手绘图。绘图时，1 到 7 选择墨水颜色（白、红、橙、绿、蓝、紫和彩虹色），8 选择画笔（线条随手的移动速度变化），9 选择橡皮擦。按 Esc 或再次按 Ctrl+D 停止绘图。
• 图片和声音：Ctrl+Shift+I 放置参考图像，Ctrl+Shift+M 从文件放置语音注释，Ctrl+Shift+R 通过麦克风录制语音注释。它们保存在文档内部的资源库中（Ctrl+Shift+A）。

分步执行的图上的引脚

在 Routine 或 Events 图上，各步骤依次运行，执行操作的节点还带有执行引脚，以箭头形式绘制在其他引脚之前：输入为 Previous，输出为 Next；在 Branch 上则为 True 和 False，在循环上为 Completed。它们的连线是画布上最粗的线，表示各步骤的运行顺序。连线默认是曲线，除非在 Appearance and settings ▸ Wires 中选择了 Straight、Step 或 Circuit。没有执行引脚的节点（例如 Add）会在某一步需要其值时运行。请参阅图和成员。

找不到的节点

文档中可能包含当前环境无法提供的节点：例如，文档是为此发行版没有的包编写的，或者它引用的文档已被移动。这样的节点会作为未解析节点打开，并保留其连线和值。选中它，然后在 Properties 面板中单击 Resolve…，选择一个节点来替代它：它的连线和值会尽可能转移到新节点上，状态栏会说明哪些未能转移。