UiaRaiseTextEditTextChangedEvent-Funktion (uiautomationcoreapi.h)
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