滑鼠和鍵盤動作

  • 發行項

使用傳送按鍵動作來模擬鍵盤活動。 若要插入特殊按鍵 (如方向鍵和 Caps Lock)，和進行修改 (例如 Shift 和 Control)，請選取插入特殊按鍵。

以下範例會將簽名新增至電子郵件訊息中 (以兩個分行符號開頭)。 然後，該動作會傳送 Ctrl + A 和 Ctrl + C 以選取文字，並將其複製到剪貼簿中。

注意

若要使用某個按鍵做為輔助按鍵，請對這兩個按鍵使用大括弧標記法。

[傳送按鍵] 動作的螢幕擷取畫面。

若要模擬滑鼠移動，請使用移動滑鼠動作。 以下範例以正常速度手動將滑鼠移動到特定坐標。

[移動滑鼠] 動作的螢幕擷取畫面。

使用將滑鼠移至影像動作，將滑鼠移至畫面上的特定影像。 以下示例將游標移動到第一次出現的搜尋圖示，然後用滑鼠左鍵按一下該圖示。

[將滑鼠移至影像] 動作的螢幕擷取畫面。

在動作的進階區段中，您可以看到該動作等待 30 秒，讓影像出現在前景視窗中，滑鼠將指向影像的中心。

[將滑鼠移至影像] 動作的進階屬性螢幕擷取畫面。

封鎖輸入

封鎖使用者滑鼠和鍵盤輸入，讓流程能夠執行滑鼠和鍵盤動作，而不受使用者干擾。

重要

因為其重要功能，所以封鎖輸入動作需要較高的權限才能執行。 因此，使用動作之前，請務必以管理員權限執行 Power Automate。 如需有關以管理員身分執行 Power Automate 的詳細資訊，請移至以提升的權限執行 Power Automate。

輸入參數

引數 選用 接受 預設值 描述
Block it 無法使用 布林值 是 指定要封鎖或解除封鎖滑鼠和鍵盤輸入

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況 描述
無法在非互動模式下封鎖/解除封鎖使用者輸入 指出在非互動模式下封鎖/解除封鎖輸入時發生問題
無法封鎖/解除封鎖輸入 指出封鎖/解除封鎖輸入時發生問題

取得滑鼠位置

擷取畫面上目前滑鼠游標的位置 (單位像素座標)。

輸入參數

引數 選用 接受 預設值 描述
Relative to 無法使用 畫面、前景視窗 畫面 指定要以畫面座標擷取滑鼠位置，或是相對於使用中視窗左上角的位置

變數已產生

引數 類型​ 描述
MousePosX 數值 滑鼠位置的水平 (X) 值
MousePosY 數值 滑鼠位置的垂直 (Y) 值

例外狀況

例外 描述
非互動模式中無法擷取滑鼠位置 指出在非互動模式中擷取滑鼠游標位置時發生問題

移動滑鼠

將滑鼠移至特定位置。

輸入參數

引數 選用 接受 預設值 描述
Position X 否 數值 要移動滑鼠的目標位置的水平 (X) 值
Position Y 否 數值 要移動滑鼠的目標位置的垂直 (Y) 值
Relative to 無法使用 畫面、使用中視窗、目前滑鼠位置 畫面 指定新的滑鼠位置將會相對於畫面左上角、最前面的視窗，或是目前的滑鼠位置
Move mouse from previous position 無法使用 即時、採用動畫、採用動畫 (常速)、採用動畫 (高速) 即時 指定如何移動滑鼠

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況 描述
非互動模式中無法移動滑鼠 指出在非互動模式下移動滑鼠時發生問題
無法移動滑鼠 指出移動滑鼠時發生問題

移動滑鼠至影像

將滑鼠移至畫面上或前景視窗中找到的影像上方。

輸入參數

引數 選用 接受 預設值 描述
要將滑鼠移動到的影像 否 影像的清單 要移動滑鼠的目標影像清單
滑鼠移動方式 無法使用 即時、採用動畫、採用動畫 (常速)、採用動畫 (高速) 立即 指定移動樣式，滑鼠將依此樣式從上一個位置移至所記錄路由的開頭 (或其最終位置)
發生事項 是 數值 1 所找到要將滑鼠移至該處的影像出現次數
移動滑鼠後傳送按一下 N/A 布林值 False 指定是否在滑鼠定位在影像上方之後傳送按一下
Click type 無法使用 左鍵按一下、右鍵按一下、按兩下、按中間鍵、左鍵向下、左鍵向上、右鍵向下、右鍵向上 按滑鼠左鍵 要傳送至影像的滑鼠按一下
等待影像出現 N/A 布林值 True 選擇如果在畫面或前景視窗中找不到影像時，是否要讓動作等候
失敗逾時 是 數值 0 失敗逾時秒數
按一下前幾秒數 是 數值 0 傳送按一下之前等待的秒數
影像比對演算法 N/A 基本，進階 基本 搜尋影像時要使用哪種影像演算法
相對於影像的滑鼠位置 N/A 左上角、中上、右上角、左中部分、中央、右中部分、左下角、中下、右下角 置中 滑鼠將移至該處的影像區段
位移 X 否 文字值 0 將滑鼠從位置向右位移的像素數
位移 Y 否 文字值 0 將滑鼠從位置向下位移的像素數
Tolerance 是 數值 10 指定容許指定的影像與最初選擇的影像有多少差異
搜尋圖像 N/A 整個畫面、僅前景視窗 整個畫面 指定只在最前面的視窗中搜尋指定的影像，或是在整個可見的畫面中搜尋。 如果畫面上的影像並非清楚可見，則兩個選項都找不到該影像
Search mode 無法使用 搜尋整個畫面或前景視窗、在指定的畫面或前景視窗子區域搜尋 搜尋整個畫面或前景視窗 指定要掃描整個畫面 (或視窗) 尋找提供的影像，或是只掃描其子區域
X1 是 數值 要進行搜尋的子區域起始點 X
Y1 是 數值 要進行搜尋的子區域起始點 Y
X2 是 數值 要進行搜尋的子區域結束點 X
Y2 是 數值 要進行搜尋的子區域結束點 Y

變數已產生

引數 類型​ 描述
X 數值 在畫面上找到影像所在位置的 X 座標。 如果是在前景視窗中搜尋影像，傳回的座標會是相對於視窗左上角的位置
Y 數值 在畫面上找到影像所在位置的 Y 座標。 如果是在前景視窗中搜尋影像，傳回的座標會是相對於視窗左上角的位置

例外狀況

例外 名描述
畫面上找不到影像 指出畫面上找不到指定的影像
非互動模式中無法移動滑鼠 指出在非互動模式下移動滑鼠時發生問題
無法移動滑鼠 指出移動滑鼠時發生問題
子區域座標無效 指出所指子區域座標無效
畫面上未找到足夠的影像 指出畫面上未找到足夠的指定影像

將滑鼠移至畫面上的文字 (OCR)

使用 OCR 將滑鼠移至畫面上或前景視窗中找到的文字上方。

輸入參數

引數 選用 接受 預設值 描述
OCR engine type 否 OCR 引擎變數，Tesseract 引擎 OCR 引擎變數 要使用的 OCR 引擎類型。 選取預先設定的 OCR 引擎或定一個新的 OCR 引擎。
OCR engine variable 否 OCREngineObject 搜尋文字的 OCR 引擎
Text to find 否 文字值 要移動滑鼠的目標文字
Is regular expression 無法使用 布林值 否 是否使用規則運算式在畫面上尋找文字
發生事項 是 數值 1 將做為畫面上輸入文字出現次數的正數
Search for text on 無法使用 整個畫面、僅前景視窗 整個畫面 只在最前面的視窗中尋找指定的文字，還是在整個可見的畫面中尋找。 如果畫面上的文字並非清楚可見，則兩個選項都找不到該文字
Search mode 無法使用 整個指定來源、僅限特定子區域、與影像相關的子區域 整個指定來源 掃描整個畫面 (或視窗) 尋找提供的文字，或是只掃描縮小的子區域
影像 否 影像的清單 用於指定要掃描特定文字之子區域 (相對於影像左上角) 的影像
X1 是 數值 用於掃描特定文字之子區域起始點的 X 座標
Tolerance 是 數值 10 指定容許搜尋到的影像與最初選取的影像有多少差異
Y1 是 數值 用於掃描特定文字之子區域起始點的 Y 座標
X1 是 數值 相對於要掃描特定文字之指定影像的子區域起始點的 X 座標
X2 是 數值 用於掃描特定文字之子區域結束點的 X 座標
Y1 是 數值 相對於要掃描特定文字之指定影像的子區域起始點的 Y 座標
Y2 是 數值 用於掃描特定文字之子區域結束點的 Y 座標
X2 是 數值 相對於要掃描特定文字之指定影像的子區域結束點的 X 座標
Y2 是 數值 相對於要掃描特定文字之指定影像的子區域結束點的 Y 座標
Move mouse from previous position 無法使用 即時、採用動畫、採用動畫 (常速)、採用動畫 (高速) 立即 移動樣是，滑鼠將依此樣是從上一個位置移至最終位置
Windows OCR 語言 N/A 中文 (簡體)，中文 (繁體)、捷克文、丹麥文、荷蘭文、英文、芬蘭文、法文、德文、希臘文、匈牙利文、意大利文、日文、韓文、挪威文、波蘭文、葡萄牙文、羅馬尼亞文、俄文、塞爾維亞文 (西里爾文)、塞爾維亞文 (拉丁文)、斯洛伐克文、西班牙文、瑞典文、土耳其文 英文 Windows OCR 引擎偵測到的文字語言
使用其他語言 N/A 布林值 誤判 指定是否使用「Tesseract 語言」欄位中未提供的語言
Tesseract 語言 N/A 英文、德文、西班牙文、法文、義大利文 英文 Tesseract 引擎偵測的文字語言
語言縮寫 否 文字值 要使用之語言的 Tesseract 縮寫。 例如，如果資料為「eng.traineddata」，請將此參數設定為「eng」
語言資料路徑 否 文字值 儲存指定語言 Tesseract 資料的資料夾路徑
影像寬度乘數 否 數值 1 影像的寬度乘數
影像高度乘數 否 數值 1 影像的高度乘數
等待文字出現 N/A 布林值 誤判 指定在畫面上或前景視窗中找不到文字時，是否要等待
Fail if text doesn't appear within 是 數值 10 等待提供的文字出現的秒數
Send a click after moving mouse 無法使用 布林值 否 指定是否在滑鼠定位在文字上方之後傳送按一下
Click type 無法使用 左鍵按一下、右鍵按一下、按兩下、按中間鍵、左鍵向下、左鍵向上、右鍵向下、右鍵向上 按滑鼠左鍵 要傳送至文字的滑鼠按一下類型
Wait before clicking for 是 數值 1 按一下之前等待的秒數
Mouse position relative to text 無法使用 左上、中上、右上、左中、正中、右中、左下、中下、右下 正中 指定滑鼠將移至文字的哪個區段
位移 X 否 文字值 0 依此像素數將滑鼠從位置向右位移
位移 Y 否 文字值 0 依此像素數將滑鼠從位置向下位移
影像比對演算法 N/A 基本，進階 基本 搜尋影像時要使用哪種影像演算法

注意

Power Automate 的標準運算式引擎是 .NET。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。

變數已產生

引數 類型​ 描述
LocationOfTextFoundX 數值 在畫面上找到文字所在位置的 X 座標。 如果是在前景視窗中搜尋文字，這坐標會是相對於視窗左上角的位置
LocationOfTextFoundY 數值 在畫面上找到文字所在位置的 Y 座標。 如果是在前景視窗中搜尋文字，這坐標會是相對於視窗左上角的位置
WidthOfTextFound 數值 找到文字所在區域的寬度
HeightOfTextFound 數值 找到文字所在區域的寬度

例外狀況

例外 描述
畫面上找不到文字 指出畫面上找不到指定的文字
非互動模式中無法移動滑鼠 指出在非互動模式下移動滑鼠時發生問題
無法移動滑鼠 指出移動滑鼠時發生問題
子區域座標無效 指出所指子區域座標無效
無法建立 OCR 引擎 表示嘗試建立 OCR 引擎時發生錯誤
資料路徑資料夾不存在 指示為語言資料指定的資料夾不存在
電腦上未安裝所選取的 Windows 語言套件 指示電腦上未安裝所選取的 Windows 語言套件
OCR 引擎未連線 表示 OCR 引擎未連線

傳送滑鼠按一下

傳送滑鼠按一下事件。

重要

若要防止未經授權的存取，Power Automate 必須以與其自動化應用程式相同或更高的權限執行。 若要使用傳送滑鼠按一下動作來與以較高權限執行的應用程式互動，請以管理員執行 Power Automate。 您可以在以提升的權限執行 Power Automate 中找到有關以管理員身分執行 Power Automate 的更多資訊

輸入參數

引數 選用 接受 預設值 描述
Mouse event to send 無法使用 左鍵按一下、右鍵按一下、按兩下、按中間鍵、左鍵向下、左鍵向上、右鍵向下、右鍵向上 按滑鼠左鍵 指定要傳送何種形式的滑鼠事件
Wait 是 數值 0 傳送滑鼠事件之前的延遲時間 (單位 1/1000 秒)
Move mouse 無法使用 布林值 否 移動滑鼠
X 否 數值 以像素座標表示的滑鼠水平 (X) 位置
Y 否 數值 以像素座標表示的滑鼠垂直 (Y) 位置
Relative to 無法使用 畫面、使用中視窗、目前滑鼠位置 畫面 指定新的滑鼠位置將會相對於畫面左上角、最前面的視窗，或是目前的滑鼠位置
Mouse movement style 無法使用 即時、採用動畫、採用動畫 (常速)、採用動畫 (高速) 立即 移動樣式，滑鼠將依此樣式從上一個位置移至所記錄路由的開頭 (或其最終位置)

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況 描述
非互動模式中無法傳送滑鼠按一下 指出在非互動模式下傳送滑鼠按一下時發生問題
滑鼠按一下超出畫面範圍 指出滑鼠按一下超出畫面範圍
無法傳送滑鼠按一下 指出傳送滑鼠按一下時發生問題

傳送按鍵

將按鍵傳送至目前使用中的應用程式。

重要

若要防止未經授權的存取，Power Automate 必須以與其自動化應用程式相同或更高的權限執行。 若要使用傳送金鑰動作來與以較高權限執行的應用程式互動，請以管理員執行 Power Automate。 如需有關以管理員身分執行 Power Automate 的詳細資訊，請移至以提升的權限執行 Power Automate。

輸入參數

引數 選用 接受 預設值 描述
傳送索引鍵給 N/A 前景視窗, 依 UI 元素, 依視窗執行個體/控制碼, 依標題和/或類別 前景視窗 指定是否要將金鑰傳送至前景視窗或至 UI 元素，或至視窗執行個體，或視窗標題/類別的組合
要傳送的文字 否 直接加密文字輸入或文字值 要傳送至應用程式的文字
按鍵輸入間的延遲 是 數值 10 指定兩次傳送按鍵輸入之間的延遲毫秒數，以避免輸入錯誤
Send Text as hardware keys 無法使用 布林值 否 傳送整段文字時模擬鍵盤上的實際按鍵輸入

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況 描述
非互動模式中無法傳送按鍵輸入 指出在非互動模式下傳送按鍵輸入時發生問題
要傳送的文字不代表有效的按鍵輸入 指出所指文字不代表有效的按鍵輸入
沒有可做為傳送按鍵輸入目標的使用中應用程式 指出沒有可做為傳送按鍵輸入目標的使用中應用程式
無法傳送按鍵輸入 指出傳送按鍵輸入時發生問題

注意

若要在傳送按鍵動作中模擬按下實體按鍵，請使用大括弧 {} 標記法。 若要使用某個按鍵做為輔助按鍵，請對這兩個按鍵使用大括弧 {} 標記法。 傳送按鍵動作接受虛擬按鍵碼。

有效按鍵

目錄 金鑰
按鈕 LButton、RButton、Cancel、MButton、XButton1、XButton2
鍵盤控制 Back、Tab、LineFeed、Clear、Enter、Return、ShiftKey、ControlKey、Menu、Pause、CapsLock、Capital、Escape、Space、Prior、PageUp、PageDown、Next、End、Home、Left、Up、Right、Down、Select、Print、Execute、Snapshot、PrintScreen、Insert、Delete、Help
按鈕 HangulMode、HanguelMode、KanaMode、JunjaMode、FinalMode、KanjiMode、HanjaMode
IME 金鑰 IMEConvert、IMENonconvert、IMEAccept、IMEAceept、IMEModeChange
瀏覽器按鍵 BrowserSearch、BrowserFavorites、BrowserHome
音量鍵 VolumeMute、VolumeDown、VolumeUp
媒體鍵 MediaNextTrack、MediaPreviousTrack、MediaStop、MediaPlayPause
按鈕 LaunchMail、SelectMedia、LaunchApplication1、LaunchApplication2
OEM 金鑰 OemSemicolon、Oem1、Oemplus、Oemcomma、OemMinus、OemPeriod、Oem2、OemQuestion、Oem3、Oemtilde、Oem4、OemOpenBrackets、OemPipe、Oem5、OemCloseBrackets、Oem6、OemQuotes、Oem7、Oem8、Oem102、OemBackslash、OemClear
按鈕 ProcessKey、Packet、Attn、Crsel、Exsel、EraseEof、Play、Zoom、NoName、Pa1
按鈕 KeyCodem、Shift、Control、Alt、Modifiers
D 按鍵 D0、D1、D2、D3、D4、D5、D6、D7、D8、D9
字母 A、B、C、D、E、F、G、H、I、J、K、L、M、N、O、P、Q、R、S、T、U、V、W、X、Y、Z
Windows 鍵 LWin、RWin、Apps、Sleep
數字鍵台按鍵 NumPad0、NumPad1、NumPad2、NumPad3、NumPad4、NumPad5、NumPad6、NumPad7、NumPad8、NumPad9
計算鍵 Multiply、Add、Separator、Subtract、Decimal、Divide
功能鍵 F1、F2、F3、F4、F5、F6、F7、F8、F9、F10、F11、F12、F13、F14、F15、F16、F17、F18、F19、F20、F21、F22、F23、F24
按鈕 NumLock、Scroll、LShiftKey、RShiftKey、LControlKey、RControlKey、LMenu、RMenu、BrowserBack、BrowserForward、BrowserRefresh、BrowserStop

按下/放開按鍵

按下 (並按住) 或放開一個或多個輔助按鍵 (Alt、Ctrl 或 Shift)。

輸入參數

引數 選用 接受 預設值 描述
Action to perform 無法使用 按下、放開 按下 指定是否要使用此動作按下或放開按鍵
Ctrl 無法使用 布林值 否 指定是否將按下/放開 Ctrl 鍵
Alt 無法使用 布林值 否 指定是否將按下/放開 Alt 鍵
Shift 無法使用 布林值 否 指定是否將按下/放開 Shift 鍵
Win 無法使用 布林值 否 指定是否將按下/放開 Windows 鍵

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況 描述
在非互動模式中無法按下或放開按鍵 指出在非互動模式中按下或放開按鍵時發生問題

設定按鍵狀態

設定 Caps Lock、Num Lock 或 Scroll Lock 這些按鍵的狀態 (開或關)

輸入參數

引數 選用 接受 預設值 描述
Key 無法使用 Caps Lock、Num Lock、Scroll Lock Caps Lock 指定要設定的按鍵
State 無法使用 關、開 開 要將按鍵狀態設定為開或關

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況 描述
非互動模式中無法設定按鍵狀態 指出在非互動模式下設定按鍵狀態時發生問題

等待滑鼠

暫停執行流程，直到滑鼠指標變更 (通常變更前後會是「等待游標」或沙漏)。

輸入參數

引數 選用 接受 預設值 描述
Wait for mouse pointer to 無法使用 變成是、變成不是 變成是 選擇要等待的滑鼠游標動作。
Mouse pointer 無法使用 箭頭、應用程式啟動中、十字形、手形、說明、I 字形、等待游標 箭頭 指定滑鼠指標狀態。

變數已產生

此動作不會產生任何變數。

例外狀況

此動作不包括任何例外狀況。

取得鍵盤識別碼

從機器的登錄中擷取使用中的鍵盤識別碼。

輸入參數

此動作不需要任何輸入。

變數已產生

引數 類型​ 描述
KeyboardLayoutId 數值 使用中鍵盤識別碼的登錄機碼

例外狀況

例外 描述
找不到鍵盤識別碼 表示擷取鍵盤識別碼時發生錯誤

等待快速鍵

暫停流程執行，直到按下特定快速鍵。 快速鍵必須至少包含一個按鍵，或按鍵與 (ctrl、alt、shift) 其中一鍵的組合。 可以定義多個快速鍵。

輸入參數

引數 選用 接受 預設值 描述
快速鍵 N/A 按鍵組合 Ctrl + A 指定要等待的快速鍵。 快速鍵必須包含剛好一個鍵，或一個鍵與 (ctrl、alt、shift) 其中之一的組合。 若要新增多個快速鍵，請選取「新增快速鍵」
逾時後繼續流程執行 N/A 布林值 誤判 指定在設定的快速鍵等待期間經過後，是否仍要繼續流程執行
Continue after 是 數值 10 繼續執行流程前等待的時間 (秒)

變數已產生

引數 類型​ 描述
IndexOfShortcutKeyPressed 數值 快速鍵的索引 (如果快速鍵為清單格式)。

例外狀況

例外 描述
無法註冊快速鍵 指出無法註冊快速鍵。