UiaRaiseTextEditTextChangedEvent-Funktion (uiautomationcoreapi.h)

  • Artikel

Wird von einem Anbieter aufgerufen, um den Microsoft Benutzeroberflächenautomatisierung Kern zu benachrichtigen, dass ein Textsteuerelement text programmgesteuert geändert hat.

Syntax

HRESULT UiaRaiseTextEditTextChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] TextEditChangeType        textEditChangeType,
  [in] SAFEARRAY                 *pChangedData
);

Parameter

[in] pProvider

Typ: IRawElementProviderSimple*

Der Anbieterknoten, auf dem die Textänderung aufgetreten ist.

[in] textEditChangeType

Typ: TextEditChangeType

Der Typ der Textbearbeitungsänderung, die aufgetreten ist.

[in] pChangedData

Typ: SAFEARRAY*

Die Ereignisdaten. Sollte als VAR vom Typ VT_BSTR zugewiesen werden können.

Rückgabewert

Typ: HRESULT

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

Hinweise

Dies ist eine Hilfsfunktion für Anbieter, die ITextEditProvider implementieren und die erforderlichen Ereignisse des Musters auslösen. Befolgen Sie die Anleitung unter TextEdit-Steuerelementmuster, in der beschrieben wird, wann die Ereignisse ausgelöst werden und welche Nutzlast die Ereignisse an Benutzeroberflächenautomatisierung übergeben sollen.

Wenn keine Clients auf einen bestimmten Änderungstyp lauschen, wird kein Ereignis ausgelöst.

Die Ereignisdaten sollten unterschiedliche Nutzlasten für jeden Änderungstyp (pro TextEditChangeType) enthalten:

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcoreapi.h
Bibliothek Uiautomationcore.lib
DLL Uiautomationcore.dll

Weitere Informationen

HandleTextEditTextChangedEvent

ITextEditProvider

IUIAutomation3::AddTextEditTextChangedEventHandler

TextEdit-Steuerelementmuster