UI 自動化動作
重要
若要防止未經授權的存取，Power Automate 必須以與其自動化應用程式相同或更高的權限執行。 若要使用 UI 自動化動作 (使用桌面動作除外) 來與以較高權限執行的應用程式互動，請以管理員執行 Power Automate。 如需有關以管理員身分執行 Power Automate 的詳細資訊，請移至以提升的權限執行 Power Automate。
Power Automate 能提供各種 UI 自動化動作，讓使用者能夠與 Windows 和桌面應用程式進行互動。 部分 UI 自動化動作需要您在其屬性中設定 UI 元素，才能指示您要處理的元素。
若要新增 UI 元素，請透過已部署的 UI 自動化動作或流程設計工具的 UI 元素窗格，選取新增 UI 元素。
所有 UI 元素都是由精確鎖定元件階層結構的選擇器所組成。 選取器會使用 > 標記法，表示每個元素都包含在其左側的元素中。
建立應用程式視窗的 UI 元素時，其選取器一定會有名為 :desktop 的根元素。
如果您建立 UI 元素來精確鎖定應用程式視窗中的元件，將會自動建立兩個 UI 元素。 上層 UI 元素會精確鎖定應用程式視窗，而下層 UI 元素則會顯示視窗中特定元件的階層結構。
儘管在新增 UI 元素時會自動建立選取器，但某些特定情況仍需要手動建立選取器。 需要自訂選取器時，您可以編輯現有的選取器，或從頭開始組建選取器。
若要開發更動態的流程，請將等於運算子替換為其他運算子或規則運算式。 此外，如果選取器的屬性值依先前動作的結果而定，請用變數而不是硬式編碼值。
有兩種模式可執行各種 UI 自動化動作：實體模式和模擬模式。 在實體模式下，工具會控制電腦的滑鼠和鍵盤以實體方式執行動作。 在模擬模式下，此動作會以程式設計方式執行，無需控制滑鼠和鍵盤，也無需將 UI 元素的畫面置於最上層。 請務必注意，模擬選項可能不適用於每個 UI 元素。 若要透過模擬執行動作，請在某些動作中啟用模擬動作參數或在其他動作中停用置於最上層參數。
取得視窗的詳細資料
取得視窗的屬性，像是其標題或來源文字。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 視窗 | 否 | UI 元素 | 要從中取得詳細資料的視窗 | |
| 視窗屬性 | 無法使用 | 取得視窗標題、取得視窗文字、取得視窗位置和大小、取得程序名稱 | 取得視窗標題 | 選擇要擷取的視窗屬性 |
| 帶往前方 | 無法使用 | 布林值 | 確判為真 | 指定包含 UI 元素的視窗在執行期間是否將置於最上層。 如果停用此選項，則該動作將在背景執行。 請注意，並非所有 UI 元素都可停用該選項。 此外，如果執行動作需要捲動，則停用此選項可能不會提取所有元素。 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| WindowProperty | 一般值 | 擷取的視窗資訊 |
例外狀況
| 例外 | 描述 |
|---|---|
| 無法擷取視窗的屬性 | 指出擷取視窗屬性時發生問題 |
取得視窗中 UI 元素的詳細資料
取得視窗中 UI 元素的屬性值。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 要從中取得詳細資料的 UI 元素 | |
| 屬性名稱 | 是 | 文字值 | 自己的文字 | 將擷取其值的屬性 |
| 帶往前方 | 無法使用 | 布林值 | 確判為真 | 指定包含 UI 元素的視窗在執行期間是否將置於最上層。 如果停用此選項，則該動作將在背景執行。 請注意，並非所有 UI 元素都可停用該選項。 此外，如果執行動作需要捲動，則停用此選項可能不會提取所有元素。 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| AttributeValue | 文字值 | UI 元素的文字值 |
例外狀況
| 例外 | 描述 |
|---|---|
| 無法擷取 UI 元素的屬性 | 指出擷取 UI 元素的屬性時發生問題 |
取得視窗中選取的核取方塊
擷取核取方塊群組中所選取核取方塊的名稱，或特定核取方塊的狀態。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 核取方塊或核取方塊群組 | |
| 選用 | 無法使用 | 取得群組中所選取核取方塊的名稱、取得核取方塊的狀態 | 取得群組中所選取核取方塊的名稱 | 指定要擷取選取的多個核取方塊的狀態，或只擷取一個 |
| 帶往前方 | 無法使用 | 布林值 | 確判為真 | 指定在執行期間是否應將包含 UI 元素的視窗置於最上層。 如果停用此選項，則該動作將在背景執行。 請注意，並非所有 UI 元素都可停用該選項。 此外，如果執行動作需要捲動，則停用此選項可能不會提取所有元素。 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| IsChecked | 布林值 | 所選取核取方塊的狀態 |
| SelectedCheckboxes | 文字值清單 | 指定的核取方塊群組內所選取核取方塊的名稱 |
例外狀況
| 例外 | 描述 |
|---|---|
| 無法擷取核取方塊狀態 | 指出擷取指定的核取方塊狀態時發生問題 |
取得視窗中選取的選項按鈕
擷取選項按鈕群組中所選取選項按鈕的名稱，或特定選項按鈕的狀態。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 選項按鈕或選項按鈕群組 | |
| 選用 | 無法使用 | 取得群組中所選取選項按鈕的名稱、取得選項按鈕的狀態 | 取得群組中所選取選項按鈕的名稱 | 指定要擷取選項按鈕群組內所選取選項按鈕的名稱，或只擷取單一選項按鈕的狀態 |
| 帶往前方 | 無法使用 | 布林值 | 確判為真 | 指定包含 UI 元素的視窗在執行期間是否將置於最上層。 如果停用此選項，則該動作將在背景執行。 請注意，並非所有 UI 元素都可停用該選項。 此外，如果執行動作需要捲動，則停用此選項可能不會提取所有元素。 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| IsSelected | 布林值 | 所選取選項按鈕的狀態 |
| SelectedRadiobutton | 文字值 | 指定的選項按鈕群組內選取的選項按鈕 |
例外狀況
| 例外 | 描述 |
|---|---|
| 無法擷取選項按鈕狀態 | 指出擷取指定的選項按鈕狀態時發生問題 |
從視窗擷取資料
從視窗的特定部分擷取單一值、清單或資料表形式的資料。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 視窗 | 否 | UI 元素 | 要從中擷取資料的視窗 | |
| 將擷取的資料儲存在 | 無法使用 | Excel 試算表、變數 | Excel 試算表 | 指定要儲存擷取資料的位置 |
| 帶往前方 | 無法使用 | 布林值 | 確判為真 | 指定包含 UI 元素的視窗在執行期間是否將置於最上層。 如果停用此選項，則該動作將在背景執行。 請注意，並非所有 UI 元素都可停用該選項。 此外，如果執行動作需要捲動，則停用此選項可能不會提取所有元素。 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| ExcelInstance | Excel 執行個體 | 包含所擷取資料的 Excel 執行個體。 使用這個執行個體可透過 Excel 專屬動作操縱試算表 (或儲存後將其關閉)。 |
| DataFromWindow | 一般值 | 資料表形式的擷取資料 |
例外狀況
| 例外 | 描述 |
|---|---|
| 擷取失敗 | 指出從指定的視窗擷取資料時發生問題 |
取得 UI 元素的螢幕擷取畫面
取得視窗中 UI 元素的螢幕截圖。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 視窗中要擷取為螢幕擷取畫面的 UI 元素 | |
| 儲存模型 | 無法使用 | 剪貼簿、檔案 | 剪貼簿 | 指定是要將影像儲存到檔案中，還是將其儲存到剪貼簿中 |
| Image file path | 否 | 檔案 | 設定要儲存檔案的完整路徑 | |
| File format | 無法使用 | BMP、EMF、EXIF、GIF、JPG、PNG、TIFF、WMF | BMP | 影像檔的檔案格式 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| ImageFile | 檔案 | 產生螢幕擷取畫面影像檔的檔案路徑 |
例外狀況
| 例外 | 描述 |
|---|---|
| 無法擷取 UI 元素 | 表示擷取 UI 元素時發生問題 |
| 無法儲存影像 | 表示儲存螢幕擷取畫面時發生問題 |
| 無法取得 UI 元素的螢幕擷取畫面 | 表示擷取 UI 元素的螢幕擷取畫面發生問題 |
將焦點放在視窗中的文字欄位
將焦點設定於視窗的文字方塊並捲動使其進入檢視範圍。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 文字欄位 | 否 | UI 元素 | 要設定焦點的文字方塊 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法在視窗文字方塊中設定輸入焦點 | 指出在指定的網頁文字欄位上設定焦點時發生問題 |
填入視窗中的文字欄位
用指定文字填入視窗中的文字方塊。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Text box | 否 | UI 元素 | 要在其中填入的文字方塊 | |
| 要填入的文字 | 否 | 直接加密文字輸入或文字值 | 要填入文字欄位的文字 | |
| 模擬動作 | 無法使用 | 布林值 | 誤判為真 | 將文字填入 UI 文字欄位元素時，以程式設計方式模擬按鍵輸入。 此選項不需要 UI 項目的畫面具有焦點，因此不會自動將其顯示在前景。 請注意，此選項只能套用於點擊左鍵動作，並且可能不適用於每個 UI 項目。 |
| 如果欄位不是空白 | 是 | 取代文字，附加文字 | 取代文字 | 指定是要取代現有內容還是附加。 |
| Click before populating | 是 | 按滑鼠左鍵、按兩下、否 | 按滑鼠左鍵 | 指定在填入文字欄位之前是否要按滑鼠左鍵。 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法寫入文字方塊 | 指出填入指定的文字欄位時發生問題 |
按視窗中的按鈕
按下視窗按鈕。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 要按下的按鈕 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法按下按鈕 | 指出按下指定的按鈕時發生問題 |
選取視窗中的選項按鈕
選取視窗上的選項按鈕。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Radio button | 否 | UI 元素 | 要選取的選項按鈕 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法選取選項按鈕 UI 元素 | 指出選取指定的選項按鈕 UI 元素時發生問題 |
設定視窗中的核取方塊狀態
勾選或取消勾選視窗表單中的核取方塊。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 核取方塊 | 否 | UI 元素 | 要設定狀態的核取方塊 | |
| 將核取方塊狀態設定為 | 無法使用 | 已核取、已取消核取 | 已勾選 | 指定核取方塊為勾選或未勾選 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法設定核取方塊狀態 | 指出設定指定的核取方塊狀態時發生問題 |
設定視窗中的下拉式清單值
設定或清除視窗表單中下拉式清單的已選選項。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 下拉式清單 | 否 | UI 元素 | 要設定其值的下拉式清單 | |
| 選用 | 無法使用 | 清除已選選項、依名稱選取選項、依索引選取選項 | 清除選取的選項 | 指定要依名稱或序數位置 (1 2 3 ...) 選取值，或清除下拉式清單中選取的值 |
| 選項名稱 | 否 | 文字值清單 | 在下拉式清單中，輸入要選取的選項或選項清單。 只有在使用複選清單時，多個選項才有意義。 如果清單是單選，則只會使用指定清單的第一個選項。 | |
| 使用規則運算式 | 無法使用 | 布林值 | 誤判為真 | 指定是否要將選項名稱值解譯為規則運算式 |
| 選項索引 | 否 | 數值清單 | 在下拉式清單中，輸入要選取的索引或索引清單。 只有在使用複選清單時，多個選項才有意義。 如果清單是單選，則只會使用指定清單的第一個選項。 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法選取下拉式清單中指定的選項 | 指出選取下拉式清單中指定的選項時發生問題 |
取得視窗
取得執行中視窗，用於自動化桌面應用程式。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Get window | 無法使用 | 特定視窗、前景視窗 | 特定視窗 | 指定要使用選取器或前景視窗來尋找 |
| UI 元素 | 否 | UI 元素 | 要取得的視窗選取器 | |
| 將視窗置於前方 | 無法使用 | 布林值 | 否 | 指定是否要在取得視窗時自動將它移至前景 |
| Fail if window isn't found | 無法使用 | 布林值 | 是 | 指定要不限時間等待視窗顯示，或是視窗未在設定的時段內顯示時使作業失敗。 |
| Timeout | 否 | 數值 | 等待的逾時秒數 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| WindowTitle | 文字值 | 前景視窗的標題 |
| AutomationWindow | 視窗執行個體 | 搭配較新版本使用者介面自動化動作使用的特定視窗執行個體 |
例外狀況
| 例外 | 描述 |
|---|---|
| 無法取得視窗 | 指出取得視窗時發生問題 |
焦點視窗
啟用特定視窗並移至前景。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Find window mode | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗標題 | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| Window instance | 否 | 數值 | 要設定焦點之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，輸入要使用的視窗類別。 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 找不到視窗 | 指出找不到指定的視窗 |
| 無法將焦點設於視窗 | 指出將焦點設於指定的視窗時發生問題 |
| 無法在非互動模式中執行視窗相關動作 | 指出在非互動模式中執行視窗相關動作時發生問題 |
設定視窗狀態
還原、最大化或最小化特定視窗。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Find window mode | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗標題 | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| Window instance | 否 | 數值 | 要設定狀態之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，輸入要使用的視窗類別。 | |
| Window state | 無法使用 | 已還原、已最大化、最小化 | 已還原 | 選擇要顯示視窗的狀態 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 找不到視窗 | 指出找不到指定的視窗 |
| 無法設定視窗狀態 | 指出設定所指定視窗的視窗狀態時發生問題 |
| 無法在非互動模式中執行視窗相關動作 | 指出在非互動模式中執行視窗相關動作時發生問題 |
設定視窗顯示性
顯示隱藏的視窗或隱藏可見的視窗。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Find window mode | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗標題 | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| Window instance | 否 | 數值 | 要設定可見度之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，輸入要使用的視窗類別。 | |
| Visibility | 無法使用 | 可見、已隱藏 | 已隱藏 | 選擇要設定的視窗可見度狀態 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 找不到視窗 | 指出找不到指定的視窗 |
| 無法設定視窗可見度 | 指出設定所指定視窗的可見度時發生問題 |
| 無法在非互動模式中執行視窗相關動作 | 指出在非互動模式中執行視窗相關動作時發生問題 |
移動視窗
設定特定視窗的位置。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Find window mode | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗標題 | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| Window instance | 否 | 數值 | 要移動之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果您有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，輸入要使用的視窗類別。 | |
| Position X | 否 | 數值 | 視窗的 X 位置 | |
| Position Y | 否 | 數值 | 視窗的 Y 位置 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 找不到視窗 | 指出找不到指定的視窗 |
| 無法移動視窗 | 指出移動指定的視窗時發生問題 |
| 無法在非互動模式中執行視窗相關動作 | 指出在非互動模式中執行視窗相關動作時發生問題 |
調整視窗大小
設定特定視窗的大小。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Find window mode | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗標題 | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| Window instance | 否 | 數值 | 要調整大小之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，輸入要使用的視窗類別 | |
| Width | 否 | 數值 | 新寬度 (像素) | |
| 高 | 否 | 數值 | 新高度 (像素) |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 找不到視窗 | 指出找不到指定的視窗 |
| 無法調整視窗大小 | 指出調整指定視窗的大小時發生問題 |
| 無法在非互動模式中執行視窗相關動作 | 指出在非互動模式中執行視窗相關動作時發生問題 |
關閉視窗
關閉特定視窗。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Find window mode | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗標題 | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| Window instance | 否 | 數值 | 要關閉之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，輸入要使用的視窗類別。 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 找不到視窗 | 指出找不到指定的視窗 |
| 無法關閉視窗 | 指出關閉指定的視窗時發生問題 |
| 無法在非互動模式中執行視窗相關動作 | 指出在非互動模式中執行視窗相關動作時發生問題 |
如果視窗包含
根據視窗中是否存在一段特定文字或 UI 元素，標記條件動作區塊的開頭。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Check if window | 無法使用 | 包含 UI 元素、不包含 UI 元素、包含文字、不包含文字 | 包含 UI 元素 | 檢查視窗中是否有特定文字或 UI 元素存在 |
| Check UI element state | 無法使用 | 布林值 | 否 | 檢查特定 UI 元素是否已啟用或已停用 |
| 文字 | 否 | 文字值 | 要檢查的文字 | |
| UI 元素 | 否 | UI 元素 | 要檢查的 UI 元素 | |
| 視窗 | 否 | UI 元素 | 要檢查是否有文字存在的視窗 | |
| 狀態 | 無法使用 | 已啟用、已停用 | 已啟用 | 要檢查的 UI 元素狀態 |
變數已產生
此動作不會產生任何變數。
例外狀況
此動作不包括任何例外狀況。
等待視窗內容
暫停執行自動化，直到特定文字片段或 UI 元素出現或從視窗中消失。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Wait until window | 無法使用 | 包含 UI 元素、不包含 UI 元素、包含文字、不包含文字 | 包含 UI 元素 | 是否要等待特定文字或 UI 元素出現在視窗中 |
| Check UI element state | 無法使用 | 布林值 | 否 | 檢查特定 UI 元素是否已啟用或已停用 |
| 文字 | 否 | 文字值 | 要檢查的文字 | |
| UI 元素 | 否 | UI 元素 | 要檢查的 UI 元素 | |
| 視窗 | 否 | UI 元素 | 要檢查是否有文字存在的視窗 | |
| 狀態 | 無法使用 | 已啟用、已停用 | 已啟用 | 要檢查的 UI 元素狀態 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 等待視窗內容失敗 | 指出等待作業失敗 |
如果影像
此動作會根據畫面上是否能找到所選圖像，標記條件動作區塊的開頭。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| If image | 無法使用 | 存在、不存在 | 存在 | 是否要檢查選取的影像存在與否 |
| 影像 | 否 | 影像清單 | 動作將會檢查的影像 (若存在) | |
| 搜尋影像 | 無法使用 | 整個畫面、僅前景視窗 | 整個畫面 | 只在最前面的視窗中尋找指定的影像，還是在整個可見的畫面中尋找。 如果畫面上的影像並非清楚可見，則兩個選項都找不到該影像 |
| Search mode | 無法使用 | 搜尋整個畫面或前景視窗、在指定的畫面或前景視窗子區域搜尋 | 搜尋整個畫面或前景視窗 | 掃描整個畫面 (或視窗) 尋找提供的文字，或是只掃描縮小的子區域 |
| Find all images in the list | 無法使用 | 布林值 | 否 | 檢查清單中的所有影像是否存在 |
| X1 | 是 | 數值 | 用於掃描特定文字之子區域起始點的 X 座標 | |
| X2 | 是 | 數值 | 用於掃描特定文字之子區域結束點的 X 座標 | |
| Y1 | 是 | 數值 | 用於掃描特定文字之子區域起始點的 Y 座標 | |
| Y2 | 是 | 數值 | 用於掃描特定文字之子區域結束點的 Y 座標 | |
| Tolerance | 是 | 數值 | 10 | 指定容許搜尋到的影像與最初選取的影像有多少差異 |
| 影像比對演算法 | N/A | 基本，進階 | 基本 | 搜尋影像時要使用哪種影像演算法 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 非互動模式中無法檢查影像 | 指出非互動模式中無法識別影像 |
| 子區域座標無效 | 指出所指子區域座標無效 |
使用桌面
執行桌面和工作列相關作業。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 執行按一下的 UI 元素 | |
| Click type | 無法使用 | 按滑鼠左鍵、按滑鼠右鍵、按兩下 | 按滑鼠左鍵 | 要執行的按一下類型 |
| Launch new application when left-clicking on the taskbar | 無法使用 | 布林值 | 是 | 當此參數設為 'true' 時，可確保在快速啟動列 (也就是 Windows 7 或更新版本的工作列) 中用滑鼠左鍵按一下應用程式的圖示時，會建立其新視窗。 取消勾選此選項則會將已在執行的應用程式執行個體移至前景。 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 工作列作業失敗 | 指出工作列作業失敗 |
選取視窗中的索引標籤
從索引標籤群組中選取索引標籤。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 索引標籤 | 否 | UI 元素 | 要選取的索引標籤 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 選取索引標籤失敗 | 指示選取指定的索引標籤時發生問題 |
等待影像
這個動作會一直等待，直到特定影像出現在畫面上或前景視窗中。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Wait for image to | 無法使用 | 顯示、消失 | 出現 | 檢查是否要等待影像出現或消失 |
| 要等待的影像 | 否 | 影像清單 | 動作將會檢查的影像 (若存在) | |
| 搜尋影像 | 無法使用 | 整個畫面、僅前景視窗 | 整個畫面 | 只在最前面的視窗中尋找指定的影像，還是在整個可見的畫面中尋找。 如果畫面上的影像並非清楚可見，則兩個選項都找不到該影像 |
| Search mode | 無法使用 | 搜尋整個畫面或前景視窗、在指定的畫面或前景視窗子區域搜尋 | 搜尋整個畫面或前景視窗 | 掃描整個畫面 (或視窗) 尋找提供的文字，或是只掃描縮小的子區域 |
| Wait for all images | 無法使用 | 布林值 | 否 | 要等待清單上的所有影像或只等待其中一個影像出現 (消失) |
| X1 | 是 | 數值 | 用於掃描特定文字之子區域起始點的 X 座標 | |
| X2 | 是 | 數值 | 用於掃描特定文字之子區域結束點的 X 座標 | |
| Y1 | 是 | 數值 | 用於掃描特定文字之子區域起始點的 Y 座標 | |
| Y2 | 是 | 數值 | 用於掃描特定文字之子區域結束點的 Y 座標 | |
| Tolerance | 是 | 數值 | 10 | 指定容許搜尋到的影像與最初選取的影像有多少差異 |
| 影像比對演算法 | N/A | 基本，進階 | 基本 | 搜尋影像時要使用哪種影像演算法 |
| 失敗，發生逾時錯誤 | N/A | 布林值 | False | 指定是否讓動作無限期等待，還是在經過設定的時段後失敗 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| X | 數值 | 在畫面上找到文字位置的 X 座標。 如果已在前景視窗中搜尋過文字，則此值會相對於視窗的左上角。 |
| Y | 數值 | 在畫面上找到文字位置的 Y 座標。 如果已在前景視窗中搜尋過文字，則此值會相對於視窗的左上角。 |
例外狀況
| 例外 | 描述 |
|---|---|
| 等待影像失敗 | 指出等待作業失敗 |
| 非互動模式中無法檢查影像 | 指出非互動模式中無法識別影像 |
| 子區域座標無效 | 指出所指子區域座標無效 |
將滑鼠游標暫留在視窗的 UI 元素上方
將滑鼠游標懸停在視窗的任何 UI 元素上方。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 選取視窗中要暫留的 UI 元素 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法暫留在元素上方 | 指示懸停在該元素上失敗 |
按一下視窗中的 UI 元素
按一下視窗的任何 UI 元素。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 要按一下的 UI 元素 | |
| Click type | 無法使用 | 按滑鼠左鍵、按滑鼠右鍵、按兩下、按中間鍵、左鍵向下、左鍵向上、右鍵向下、右鍵向上 | 按滑鼠左鍵 | 要執行的按一下類型 |
| 模擬動作 | 無法使用 | 布林值 | 誤判為真 | 指定點選之前是否要模擬滑鼠游標移至項目上。 此選項不需要 UI 項目的畫面具有焦點，因此不會自動將其顯示在前景。 請注意，此選項只能套用於點擊左鍵動作，並且可能不適用於每個 UI 項目。 |
| Mouse position relative to UI element | 無法使用 | 左上、中上、右上、左中、正中、右中、左下、中下、右下 | 正中 | 指定要在按一下之前先將滑鼠移至哪一個 UI 元素區段 |
| Offset X | 是 | 文字值 | 0 | 依此像素數將滑鼠從位置向右位移 |
| Offset Y | 是 | 文字值 | 0 | 依此像素數將滑鼠從位置向下位移 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 按一下失敗 | 指出按一下失敗 |
選取視窗中的功能表選項
選取視窗的功能表中的選項。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 要選取的功能表選項 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法選取選項 | 指出選取指定的功能表選項時發生問題 |
拖放視窗中的 UI 元素
拖放視窗的 UI 元素。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 要拖曳的 UI 元素 | 否 | UI 元素 | 要拖曳的 UI 元素 | |
| 要放置的 UI 元素 | 否 | UI 元素 | 要放置的 UI 元素 | |
| Click type | 無法使用 | 按滑鼠左鍵、按滑鼠右鍵 | 按滑鼠左鍵 | 指定要用於按住，同時將 UI 元素拖至其目的地的滑鼠按鍵 |
| Mouse down offset X | 是 | 文字值 | 0 | 按住滑鼠向右位移的像素數目，將用於抓取 UI 元素並拖曳 |
| Mouse down offset Y | 是 | 文字值 | 0 | 按住滑鼠向下位移的像素數目，將用於抓取 UI 元素並拖曳 |
| Mouse down position relative to drag-target UI element | 無法使用 | 左上、中上、右上、左中、正中、右中、左下、中下、右下 | 正中 | 指定要在按一下之前先將滑鼠移至 UI 元素的哪個區段 |
| Mouse up offset X | 是 | 文字值 | 0 | 放開滑鼠向右位移的像素數目，將用於抓取 UI 元素並拖曳 |
| Mouse up offset Y | 是 | 文字值 | 0 | 放開滑鼠向下位移的像素數目，將用於抓取 UI 元素並拖曳 |
| Mouse up position relative to drop-target UI element | 無法使用 | 左上、中上、右上、左中、正中、右中、左下、中下、右下 | 正中 | 指定要在按一下之後將滑鼠移至 UI 元素的哪個區段 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 找不到要拖曳的 UI 元素 | 指出找不到要拖曳的 UI 元素 |
| 找不到放置目標 UI 元素 | 指出找不到放置目標 UI 元素 |
| 拖放失敗 | 指出拖放指定 UI 元素期間發生問題 |
展開/摺疊視窗中的樹狀節點
展開或摺疊位於視窗中的樹狀檢視節點。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| UI 元素 | 否 | UI 元素 | 要展開/摺疊的樹狀節點 | |
| 資料夾路徑 | 是 | 文字值 | 由資料夾名稱組成的正斜線分隔路徑，會引導至要展開或摺疊的樹狀節點 | |
| Use regular expressions | 無法使用 | 布林值 | 否 | 指定是否要將路徑中的每個資料夾名稱解譯為規則運算式 |
| Operation | 無法使用 | 展開、摺疊 | 展開 | 指定要展開或摺疊樹狀節點 |
注意
Power Automate 的標準運算式引擎是 .NET。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法將樹狀節點設為指定的狀態 | 指出將樹狀節點設定為指定的狀態時發生問題 |
如果視窗
此動作會根據視窗是否已開啟，或視窗是否為焦點 (前景) 視窗所在，標記條件動作區塊的開頭。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Get window | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| Window title | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗執行個體 | 否 | 數值 | 要檢查之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，請輸入要使用的視窗類別。 | |
| Check if window | 無法使用 | 已開啟、未開啟、擁有焦點、沒有焦點 | 已開啟 | 要檢查之視窗的狀態 |
變數已產生
此動作不會產生任何變數。
例外狀況
此動作不包括任何例外狀況。
等待視窗
暫停執行或處理序，直到特定視窗開啟、關閉、獲得或失去焦點。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Find window | 無法使用 | 依據視窗 UI 元素、依據視窗執行個體/控點、依據標題和/或類別 | 依據視窗 UI 元素 | 指定要使用 UI 元素或視窗標題/類別組合尋找視窗 |
| Window title | 是 | 文字值 | 視窗標題。 可使用萬用字元，如 '?' 或 '*'。 | |
| 視窗 | 否 | UI 元素 | 視窗 UI 元素 | |
| 視窗執行個體 | 否 | 數值 | 要檢查之視窗的執行個體或控點 | |
| Window class | 是 | 文字值 | 如果有兩個標題相同的視窗，則視窗類別有助於區分兩者。 在這種情況下，請輸入要使用的視窗類別 | |
| Wait for window to | 無法使用 | 開啟、關閉、成為焦點、失去焦點 | 開啟 | 要等待特定視窗開啟、關閉、成為焦點 (也就是成為前景視窗) 或失去焦點 (也就是不再是前景視窗)。 |
| Focus window after it opens | 無法使用 | 布林值 | 否 | 視窗開啟後將它移至前景，後續動作就會指向此視窗 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 無法將焦點設於視窗 | 指出將焦點設於指定的視窗時發生問題 |
| 等待視窗失敗 | 指出等待作業失敗 |
| 無法在非互動模式中執行視窗相關動作 | 指出在非互動模式中執行視窗相關動作時發生問題 |