Freigeben über

TextEdit-Steuerelementmuster

  • Artikel

Enthält Richtlinien und Konventionen für die Implementierung ITextEditProvider-, einschließlich Informationen zu Eigenschaften und Methoden. Das TextEdit Steuerelementmusters wird für den programmgesteuerten Zugriff auf ein Steuerelement verwendet, das Text ändert, z. B. ein Steuerelement, das die automatische Korrektur durchführt oder die Eingabekomposition ermöglicht.

Anmerkung

Implementierungshinweise in diesem Thema beziehen sich auf APIs, die aus Text Services Framework (TSF) stammen. Weitere Informationen zu TSF und der API-Referenz finden Sie unter Text Services Framework.

Erforderliche Elemente für ITextEditProvider-

Diese Eigenschaften und Methoden sind für die Implementierung der ITextEditProvider Schnittstelle erforderlich.

Erforderliche Mitglieder Elementtyp Notizen
GetActiveComposition- Methode Gibt den Bereich der aktuellen Konvertierung zurück (keine, wenn keine Konvertierung vorhanden ist). Gibt die aktive Komposition zurück (in TSF ist dies der bereich, der durch GUID_PROP_COMPOSINGgekennzeichnet ist). Dies wäre beispielsweise mit dem Microsoft Japanese Input Method Editor (IME) der vollständige unterstrichene Text.
GetConversionTarget- Methode Gibt den aktuellen Konvertierungszielbereich zurück (keine Konvertierung). In TSF ist dies der Als TF_ATTR_TARGET_NOTCONVERTED oder TF_ATTR_TARGET_CONVERTED aus der TF_DISPLAYATTRIBUTE Struktur markierte Zeichenbereich.

Die TextEditTextChanged- und ConversionTargetChanged- Ereignisse müssen von Microsoft-Benutzeroberflächenautomatisierungselementen ausgelöst werden, die das TextEdit- Muster unterstützen.

TextEditTextChanged-

TextEditChangeType Ereignisnutzlast Notizen
AutoKorrektur- Neue korrigierte Zeichenfolge Wird ausgelöst, wenn vom Steuerelement eine automatische Korrektur vorgenommen wird. Oder wenn ein Ersatz über TSF erfolgt und der Bereich einen GUID_PROP_TKB_ALTERNATES Wert von TKB_ALTERNATES_AUTOCORRECTION_APPLIEDhat.
Kompositions- Die aktualisierte Zeichenfolge Die Nutzlast darf nur die geänderten Zeichen enthalten (nicht die gesamte Kompositionszeichenfolge senden). Wird immer ausgelöst, wenn eine Komposition ersetzt wird. In TSF wird eine Kompositionsersetzung als Ersatz definiert, der die GUID_PROP_COMPOSING Flag festgelegt hat. Edit controls implementing TSF can monitor for these changes via the OnEndEdit notification.
CompositionFinalized Die endgültige Kompositionszeichenfolge (siehe Hinweise) In TSF wird die fertige Konvertierungszeichenfolge durch das GUID_PROP_COMPOSING Flag definiert, das aus einer Komposition entfernt wird. Edit controls implementing TSF should determine the finalized string from EndComposition and raise the event when OnEndEdit is called.
Die endgültige Kompositionszeichenfolge kann leer sein, wenn die Komposition abgebrochen oder gelöscht wurde.

ConversionTargetChanged-

  • ConversionTargetChanged tritt auf, wenn sich das Konvertierungsziel von einem Ziel in ein anderes ändert.
  • Verwenden Sie die funktion UiaRaiseAutomationEvent, um das ConversionTargetChanged-Ereignis auszulösen (übergeben Sie den UIA_TextEdit_ConversionTargetChangedEventId Ereignisbezeichner).
  • ConversionTargetChanged sollte nicht ausgelöst werden, wenn sich der Inhalt des Ziels ändert. Wenn die Zieländerung gleichzeitig mit einer Kompositionsänderung auftritt, muss das Zieländerungsereignis ausgelöst werden, nachdem bereits Kompositionsereignisse ausgelöst wurden.
  • In TSF wird das Konvertierungsziel durch den Wert definiert, TF_ATTR_TARGET_CONVERTED aus der TF_DISPLAYATTRIBUTE-Struktur festgelegt wird. Änderungen können mithilfe OnEndEdit-überwacht werden.

Konzeptionelle

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung

übersicht über Benutzeroberflächenautomatisierungsstruktur