VisualApplets 指令碼主控台

VisualApplets 提供指令碼主控台，您可在其中輸入 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 對話方塊。請參閱 管理 Python 版本。

Scripting Console 包含以下欄位：

1. 在輸入欄位中輸入您的指令，然後按下 Return 鍵。

2. 在上方可捲動的記錄視窗中，會顯示您輸入的所有指令，以及該指令是否成功執行的相關資訊，若否則會顯示對應的錯誤訊息。Scripting Console 會列出您為建立設計而輸入的所有指令（透過 GUI 選項、按鍵或在 Tcl/Python 中）。
   
   您輸入的指令會以前置的「>」標示。
   
   

   錯誤會以紅色反白顯示。
   
   

   

3. 使用 Scripting Console 來取得有關指令及其語法的資訊：只需使用 VisualApplets 的 GUI 選項（點擊、拖放、按鍵等）執行您要在指令碼中定義的動作，然後在 Scripting Console 的記錄視窗中讀取此動作在 Tcl 或 Python 中的定義方式。您可以使用複製與貼上將指令複製到您的指令碼中。

4. 使用 Scripting Console 來測試您要在指令碼中輸入的指令：只需在指令輸入欄位中輸入指令，並檢查 VisualApplets 是否執行了所需的動作。您可以使用複製與貼上將成功的指令複製到您的指令碼中。

資訊

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 Version Settings 對話方塊

若要開啟 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。

只有在按一下 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. 按一下 OK。
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。