繁體中文
English 简体中文 繁體中文
Methodox 首頁

節點、引腳和連線

程式是由節點組成的圖。每個節點做一件事(將兩個數相加、載入一張影像、列印一行文字),它的引腳是它接收的內容(位於左側)和輸出的內容(位於右側)。連線將值從一個節點的輸出引腳傳遞到另一個節點的輸入引腳。

一個小型圖:兩個 Number 連線到 Add 的 Summand1 和 Summand2,Add 的結果連線到 Print Line 的 Message

每個節點都有一個標題;輸入引腳沿左側排列,未連線的輸入引腳旁有一個用於填寫值的框;輸出引腳沿右側排列;底部的頁尾顯示它上一次解釋執行的情況。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…,選擇一個節點來替代它:它的連線和值會盡可能轉移到新節點上,狀態列會說明哪些未能轉移。