共用方式為

IUIAutomation6：：RemoveActiveTextPositionChangedEventHandler 方法 (uiautomationclient.h)

  • 發行項

拿掉作用中文字位置已變更事件處理程式。

重要

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

語法

HRESULT RemoveActiveTextPositionChangedEventHandler(
  [in] IUIAutomationElement                               *element,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

參數

[in] element

與事件處理程式相關聯之 使用者介面自動化 專案的指標。

[in] handler

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

傳回值

這個方法不會傳回值。

備註

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

使用中文字位置是由網頁瀏覽器、可攜式檔格式 (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 事件。

如果事件與取消訂閱事件的要求同時收到，則事件可以在未訂閱處理程式之後傳遞至事件處理程式。 最佳做法是遵循元件物件模型 (COM) 標準，並避免終結事件處理程序物件，直到其參考計數達到零為止。 取消訂閱事件之後立即終結事件處理程式，可能會導致延遲傳遞事件時發生存取違規。

規格需求

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

另請參閱

IUIAutomation6：：AddActiveTextPositionChangedEventHandler、 IUIAutomation6 介面