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

  • [アーティクル]

プログラムによるテキスト編集イベント ハンドラーを削除します。

構文

HRESULT RemoveTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

パラメーター

[in] element

種類: IUIAutomationElement*

ハンドラーを削除する UI オートメーション要素へのポインター。

[in] handler

種類: IUIAutomationTextEditTextChangedEventHandler*

IUIAutomation3::AddTextEditTextChangedEventHandler に渡されたインターフェイスへのポインター。

戻り値

種類: HRESULT

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

解説

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

イベントをサブスクライブ解除する要求と同時にイベントを受信した場合、ハンドラーの登録を解除した後にイベントをイベント ハンドラーに配信できます。 ベスト プラクティスは、コンポーネント オブジェクト モデル (COM) 標準に従い、参照カウントが 0 になるまでイベント ハンドラー オブジェクトを破棄しないようにすることです。 イベントのサブスクライブを解除した直後にイベント ハンドラーを破棄すると、イベントが遅れて配信された場合にアクセス違反が発生する可能性があります。

要件

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

関連項目

IUIAutomation3

RemoveAllEventHandlers