共用方式為

IUIAutomationEventHandlerGroup：：AddActiveTextPositionChangedEventHandler 方法 (uiautomationclient.h)

  • 發行項

在事件處理程式群組中註冊方法 (，) 處理作用中文字位置變更時處理的方法。

重要Microsoft 使用者介面自動化 客戶端應該使用處理程式群組方法來註冊事件接聽程式，而不是各種 IUIAutomation 命名空間中定義的個別事件註冊方法。

 

語法

HRESULT AddActiveTextPositionChangedEventHandler(
  [in] TreeScope                                          scope,
  [in] IUIAutomationCacheRequest                          *cacheRequest,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

參數

[in] scope

要處理的事件範圍，意即，事件是項目本身或其項目的祖系及子系。

[in] cacheRequest

快取要求的指標，如果沒有快取， 則為 NULL 。

[in] handler

處理作用中文字位置已變更事件的 對象指標。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

實作事件處理程式之前，您應該先熟悉 了解線程問題中所述的線程問題。

使用中文字位置是由網頁瀏覽器、可攜式檔格式 (PDF) 檔，或 EPUB 檔) 使用書籤 (或片段標識符來參考資源) 內位置等只讀文字元素 (來表示使用書籤 (或片段標識符。 範例包括：

  • 流覽至相同網頁內的書籤
  • 流覽至不同網頁上的書籤
  • 啟用相同 PDF 內不同位置的連結
  • 啟用相同EPUB內不同位置的連結
使用此事件處理程式可將書籤/目標的視覺位置與只讀文字專案中的焦點位置同步處理，在使用書籤或片段標識符時可能會分叉。

例如，當叫用相同的頁面錨點 () <a href=”#C4”>Jump to Chapter 4</a> ... <h1><a name="C4">Chapter 4</a></h1> 時，視覺效果位置會更新，但 使用者介面自動化 用戶端會保留在原始位置。 這會導致文字讀取或移動下一個專案命令等動作，從原始位置開始，而不是新位置。

同樣地，使用片段標識符啟動新的頁面 URI (： (<a href=”www.blah.com#C4”>Jump to Chapter 4</a>) ) 載入新頁面並跳至指定的書籤，但會將 使用者介面自動化 用戶端保留在頁面頂端。

對於可編輯的文字元素，例如 Edit 和 Rich Edit 控件，您可以接聽 SelectionChanged 事件。

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1809 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 版本 1709 [僅限傳統型應用程式]
目標平台 Windows
標頭 uiautomationclient.h (包含 UIAutomation.h)

另請參閱

IUIAutomationEventHandlerGroup