IUIAutomationTextEditTextChangedEventHandler::HandleTextEditTextChangedEvent-Methode (uiautomationclient.h)

  • Artikel

Behandelt ein Ereignis, das ausgelöst wird, wenn ein Microsoft Benutzeroberflächenautomatisierung-Anbieter für ein Textbearbeitungssteuerelement eine programmgesteuerte Textänderung meldet.

Syntax

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

Parameter

[in] sender

Typ: IUIAutomationElement*

Ein Zeiger auf das Element, das das Ereignis ausgelöst hat.

[in] textEditChangeType

Typ: TextEditChangeType

Der Typ der Textbearbeitungsänderung, die aufgetreten ist.

[in] eventStrings

Typ: SAFEARRAY*

Vom Ereignis übergebene Ereignisdaten.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode wird von der Anwendung implementiert, um Ereignisse zu behandeln, die sie mit AddTextEditTextChangedEventHandler abonniert hat.

Die Ereignisdaten enthalten unterschiedliche Nutzlasten für jeden Änderungstyp der Textbearbeitung:

  • TextEditChangeType_AutoCorrect: Daten sind die neue korrigierte Zeichenfolge .
  • TextEditChangeType_Composition: Daten sind die aktualisierte Zeichenfolge in der Komposition (nur der Teil, der geändert wurde).
  • TextEditChangeType_CompositionFinalized: Daten sind die abgeschlossene Zeichenfolge der abgeschlossenen Komposition (diese kann leer sein, wenn die Komposition abgebrochen oder gelöscht wurde).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

Bewährte Methoden für die Verwendung sicherer Arrays

IUIAutomationTextEditTextChangedEventHandler