IUIAutomation3::AddTextEditTextChangedEventHandler メソッド (uiautomationclient.h)

[アーティクル]
03/13/2024

プログラムによるテキスト編集イベントを処理するメソッドを登録します。

メモイベントハンドラーを実装する前に、「スレッドの問題について」で説明されているスレッドの問題について理解しておく必要があります。

構文

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

パラメーター

[in] element

種類: IUIAutomationElement*

イベントハンドラーに関連付けられているUI オートメーション要素へのポインター。

[in] scope

種類: TreeScope

処理対象のイベントのスコープ (つまり、イベントが要素自体に関するものであるか、先祖および子孫に関するものであるか)。

[in] textEditChangeType

Type: TextEditChangeType

リッスンする特定の変更の種類。クライアントはテキスト編集の変更の種類ごとに個別に登録されるため、UI オートメーションシステムは実行時に登録されたリスナーに対してチェックし、リスナーがない場合に特定のテキスト編集変更のイベントを発生させないようにすることができます。

[in] cacheRequest

種類: IUIAutomationCacheRequest*

キャッシュ要求へのポインター。キャッシュが必要ない場合は NULL 。

[in] handler

種類: IUIAutomationTextEditTextChangedEventHandler*

プログラムによるテキスト編集イベントを処理するオブジェクトへのポインター。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

注釈

UI オートメーションクライアントでは、イベントハンドラーを追加または削除するために複数のスレッドを使用しないでください。同じクライアントプロセスで別のイベントハンドラーが追加または削除されている間に、1 つのイベントハンドラーが追加または削除されると、予期しない動作が発生する可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)