IUIAutomationTextEditTextChangedEventHandler::HandleTextEditTextChangedEvent メソッド (uiautomationclient.h)

  • [アーティクル]

テキスト編集コントロールの Microsoft UI オートメーション プロバイダーがプログラムによるテキスト変更を報告したときに発生するイベントを処理します。

構文

HRESULT HandleTextEditTextChangedEvent(
  [in] IUIAutomationElement *sender,
  [in] TextEditChangeType   textEditChangeType,
  [in] SAFEARRAY            *eventStrings
);

パラメーター

[in] sender

種類: IUIAutomationElement*

イベントを発生させた要素へのポインター。

[in] textEditChangeType

型: TextEditChangeType

発生したテキスト編集の変更の種類。

[in] eventStrings

種類: SAFEARRAY*

イベントによって渡されるイベント データ。

戻り値

型: HRESULT

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

注釈

このメソッドは、 AddTextEditTextChangedEventHandler を使用してサブスクライブしたイベントを処理するために、アプリケーションによって実装されます。

イベント データには、テキスト編集の変更の種類ごとに異なるペイロードが含まれています。

  • TextEditChangeType_AutoCorrect: データは、新しい修正された文字列 です。
  • TextEditChangeType_Composition: データは、コンポジション内の更新された文字列です (変更された部分のみ)。
  • TextEditChangeType_CompositionFinalized: Data は、完成したコンポジションの最終文字列です (コンポジションが取り消されたか削除された場合は空である可能性があります)。

要件

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

こちらもご覧ください

安全な配列を使用するためのベスト プラクティス

IUIAutomationTextEditTextChangedEventHandler