訊息處理

RuntimeApi(API) 提供了多個方法來顯示和管理訊息。

Message

Message(API) 顯示一般訊息。

Note

指令格式

Message(<訊息字串>);

Tip

指令範例

Message("開始執行NC檔案");
PlayNcFile("NC/file1.nc");
Message("NC檔案執行完成");

ProgressMessage

ProgressMessage(API) 顯示進度訊息。

Note

指令格式

ProgressMessage(<訊息字串>);

Tip

指令範例

ProgressMessage("正在載入工件...");
ReadRuntimeGeom("Cache/workpiece.wct");
ProgressMessage("工件載入完成");

相關指令：程序幾何

WarningMessage

WarningMessage(API) 顯示警告訊息。

Note

指令格式

WarningMessage(<訊息字串>);

Tip

指令範例

if (StepCount == 0)
{
    WarningMessage("沒有執行任何步階");
}

ErrorMessage

ErrorMessage(API) 顯示錯誤訊息。

Note

指令格式

ErrorMessage(<訊息字串>);

Tip

指令範例

if (Workpiece == null)
{
    ErrorMessage("工件不存在");
    return;
}

AppendMessagesToFile

AppendMessagesToFile(API) 將訊息附加到檔案，可選擇性地依標籤過濾。

Note

指令格式

AppendMessagesToFile(<目標檔案路徑>, <標籤1>, <標籤2>, ...);

Tip

指令範例

PlayNcFile("NC/file1.nc");

// 將所有訊息寫入檔案
AppendMessagesToFile("Output/messages.txt");

// 只將帶有特定標籤的訊息寫入檔案
AppendMessagesToFile("Output/errors.txt", "Error", "Warning");

SessionMessageHost

SessionMessageHost(API) 取得會話訊息主機物件，用於進階訊息操作。

Note

指令格式

var messageHost = SessionMessageHost;

訊息類型

• Message: 一般資訊訊息
• ProgressMessage: 進度相關訊息（通常顯示在進度列）
• WarningMessage: 警告訊息（不會中斷執行）
• ErrorMessage: 錯誤訊息（可能影響執行）

Note

所有訊息都會記錄在會話訊息主機中，可以在介面中查看，也可以使用 AppendMessagesToFile 匯出到檔案。