VisualApplets 脚本控制台

VisualApplets 提供了一个脚本控制台（Scripting Console），您可以在其中输入 Python 或 Tcl 命令。

要在 VisualApplets 中打开 Scripting Console：

1. 从 Window 菜单中，选择 Dock Windows，然后选择 Scripting Console。

   

   Scripting Console 会立即在 VisualApplets 程序窗口的底部打开：

   

使用 Scripting Console

在 Scripting Console 中，您可以在 Script Interpreter 下拉列表中切换是要使用 Python 还是 Tcl 作为脚本语言：

Script Interpreter 下拉列表仅限 Tcl 和 Python。要选择 VisualApplets 加载的 Python 安装，请使用 Python Version Settings 对话框。请参见 Managing Python Versions。

Scripting Console 包含以下字段：

1. 在输入字段中输入您的命令并按下 Return 键。

2. 在上方可滚动的日志窗口中，将显示您输入的所有命令，以及该命令是否能够执行的信息，如果不能执行，则会显示相应的错误消息。Scripting Console 会列出您为创建设计而输入的所有命令（通过 GUI 选项、按键或使用 Tcl/Python）。
   
   您输入的命令前面会标有“>”。
   
   

   错误将以红色高亮显示。
   
   

   

3. 使用 Scripting Console 获取有关命令及其语法的信息：只需使用 VisualApplets 的 GUI 选项（点击、拖放、按键等）执行操作（您希望在脚本中定义的操纵），然后在 Scripting Console 的日志窗口中查看该操作在 Tcl 或 Python 中是如何定义的。您可以使用“复制和粘贴”(Copy&Paste) 将命令复制到您的脚本中。

4. 使用 Scripting Console 测试您要输入到脚本中的命令：只需在命令输入字段中输入命令，并检查 VisualApplets 是否执行了所需的操作。您可以使用“复制和粘贴”(Copy&Paste) 将成功的命令复制到您的脚本中。

信息

Scripting Console 列出了您为创建设计而输入的命令：不仅包括您在 Tcl/Python 中输入的命令，还包括您使用 VisualApplets GUI 选项下达的命令。当您开始将脚本用于 VA 设计时，这非常有用，因为您可以轻松获取有关正确命令及相应命令语法的相关信息。

有关所有 VisualApplets 专用 Tcl 和 Python 命令的完整列表，请参阅主题 Tcl Command Reference 和 Python Command Reference。

管理 Python 版本

当您在 Script Interpreter 下拉列表中选择 Python 时，VisualApplets 将加载一个 Python 脚本环境。在 Python Version Settings 对话框中，您可以管理 VisualApplets 可以使用的本地 Python 安装并选择要加载的版本。

VisualApplets 目前支持 64 位架构的 Python 3.10 至 3.14 版本。随 VisualApplets 一起打包安装的版本通常显示为 VisualAppletsPython。您无法重命名或删除该安装。

打开 Python 版本设置对话框

要打开 Python Version Settings 对话框：

1. 打开 Scripting Console。

2. 单击 Script Interpreter 下拉列表旁边的 Python Version Settings 按钮。

   

   Python Version Settings 对话框打开：

   

Available Python Versions 列表显示了已注册的安装。您在添加安装时指定 Path。随后您无法更改 Path。Version ID 和 Version String 是从该路径下的 python.exe 文件中读取的，并且是只读的。

如果有另一个 VisualApplets 实例打开了 Python Version Settings 对话框，则在关闭该对话框之前您无法打开它。

选择活动的 Python 版本

若要选择 VisualApplets 在加载 Python 脚本环境时使用的 Python 版本：

1. 打开 Python Version Settings 对话框。
2. 在 Available Python Versions 中选择该安装。
3. 勾选 Active Version 复选框。
4. 单击确定。

只有在单击 OK 时才会保存更改。如果您单击 Cancel，现有设置将保持不变。

信息

如果在同一 VisualApplets 实例中运行 Python 时更改了活动 Python 版本，VisualApplets 将询问是否继续。如果继续，VisualApplets 将重新启动 Python 环境并丢弃当前的 Python 状态。

如果另一个 VisualApplets 实例更改了 Python 版本设置，当前实例将检测到此更改。新设置将在下次加载 Python 时生效。

添加 Python 安装

若要注册另外的本地 Python 安装：

1. 打开 Python Version Settings 对话框。

2. 单击 Add。

   Add Python Version 对话框打开：

   

3. 在 Name 中输入该安装的名称。

4. 在 Path to Python executable 中输入 python.exe 或 Python 安装目录的路径。或者，单击 … 并选择 python.exe。
5. 单击确定。
6. 在 Python Version Settings 对话框中单击 OK 以保存新条目。

添加安装时，VisualApplets 会检查解释器类型、版本、架构和所需的运行时库。只能添加受支持的 Python 安装。

从 Scripting Console 启动脚本

您有三种选项可从 Scripting Console 启动脚本。

信息

在导入脚本之前，请确保在 Script Interpreter 下拉列表框中选择了正确的脚本语言。

通过工具栏启动脚本

您可以通过工具栏按钮 Open Script 启动脚本：

导航至脚本所在的目录并将其选中。

信息

在导入脚本之前，请确保在 Script Interpreter 下拉列表框中选择了正确的脚本语言。

手动启动脚本

您也可以手动键入 Source 命令：

Tcl 语法：

1. 在命令输入栏中输入命令 Source 。
2. 空出一个空格，并在命令后面直接输入脚本文件的路径和脚本文件名 Source。如果路径或文件名包含空格，请将路径和文件名放在双引号中。
3. 按 Return 键即可在 VisualApplets 中开始执行脚本。

Python 语法：

1. 在命令输入栏中输入命令 Source 。

2. 打开圆括号和引号，并在圆括号和引号后面直接输入脚本文件的路径和脚本文件名。如果路径或文件名包含空格，请将路径和文件名放在双引号中。关闭引号和圆括号。

   示例： Source("C:/Basler/MyPythonScript.py")

3. 按 Return 键即可在 VisualApplets 中开始执行脚本。

   

将脚本代码复制到 Console 中

您也可以直接将剪贴板中的 Tcl 或 Python 代码复制到命令输入栏中：

1. 在脚本中标记要执行的代码并将其复制到剪贴板。
2. 将剪贴板中的代码粘贴到命令输入栏中。
3. 按 Return 键即可在 VisualApplets 中开始执行代码。

快速命令语法信息

若要快速获取有关命令语法的信息：

1. 在命令输入栏中输入命令名称，然后输入：
   • 对于 Tcl： <CommandName> 后跟一个空格和一个问号
   • 对于 Python： help(<CommandName>)
2. 按 Enter。

参数的语法将显示在 Scripting Console 窗口中。

Tcl 示例：

输入 GetModules ? 以获取命令的语法信息 GetModules.

Scripting Console 窗口显示了所需的信息：

Python 示例：

输入 help(GetModules) 以获取命令的语法信息 GetModules.

Scripting Console 窗口显示了所需的信息：

有关各个参数和允许值的详细信息，请参考 TCL Command Reference 和 Python Command Reference 主题。