CoreTextEditContext Klasse

Definition

Namespace:

Windows.UI.Text.Core

Das primäre Objekt, das von Texteingabesteuerelementen für die Kommunikation mit dem Texteingabeserver verwendet wird.

public ref class CoreTextEditContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContext

Public NotInheritable Class CoreTextEditContext

Vererbung

Object Platform::Object IInspectable CoreTextEditContext

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Um ein Objekt dieses Typs abzurufen, rufen Sie CoreTextServicesManager.CreateEditContext auf.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1511	10586	NotifyFocusLeaveCompleted

Eigenschaften

InputPaneDisplayPolicy	Ruft einen Wert ab, der angibt, ob der Eingabebereich automatisch angezeigt werden soll, wenn der Fokus in das Texteingabesteuerelement eintritt, oder legt diesen fest. Der Standardwert ist Automatic, was angibt, dass der Eingabebereich automatisch angezeigt wird. Der Wert Manual gibt an, dass Ihre App für das Ein- und Ausblenden des Eingabebereichs mit InputPane.TryShow und TryHide verantwortlich ist.
InputScope	Ruft einen Wert ab, der den Eingabebereich des Texteingabesteuerelements angibt, oder legt diesen fest.
IsReadOnly	Ruft einen Wert ab, der angibt, ob das Bearbeitungssteuerelement bearbeitbar ist, oder legt diesen fest.
Name	Ruft einen beschreibenden Namen für das Texteingabesteuerelement ab oder legt einen fest. Ein Anwendungsframework verwendet in der Regel Eigenschaften wie "Name" oder "id", um ein Steuerelement zu identifizieren. Daher wird empfohlen, diese Eigenschaft auf dem Texteingabeserver entsprechend festzulegen, damit Eingabeprozessoren den Eingabekontext besser beibehalten und bessere Vorschläge bereitstellen können.

Methoden

NotifyFocusEnter()	Benachrichtigt den Texteingabeserver, dass der Fokus das Texteingabesteuerelement eingegeben hat.
NotifyFocusLeave()	Benachrichtigt den Texteingabeserver, dass der Fokus das Texteingabesteuerelement verlassen hat.
NotifyLayoutChanged()	Benachrichtigt den Texteingabeserver, dass sich das Textlayout innerhalb des Texteingabesteuerelements geändert hat.
NotifySelectionChanged(CoreTextRange)	Benachrichtigt den Texteingabeserver über änderungen, die das Texteingabesteuerelement am Auswahlbereich vornehmen muss. Dies ist wichtig, um den internen Zustand des Steuerelements und den internen Zustand des Servers synchronisiert zu halten.
NotifyTextChanged(CoreTextRange, Int32, CoreTextRange)	Benachrichtigt den Texteingabeserver über änderungen, die das Texteingabesteuerelement am Text vornehmen muss. Dies ist wichtig, um den internen Zustand des Steuerelements und den internen Zustand des Servers synchronisiert zu halten. Da sich eine Änderung am Text wahrscheinlich auch auf den Auswahlbereich auswirkt, verwendet die Methode den Auswahlbereich als Parameter.

Ereignisse

CompositionCompleted	Tritt auf, wenn die Komposition abgeschlossen ist.
CompositionStarted	Tritt auf, wenn die Komposition gestartet wurde.
FocusRemoved	Tritt auf, wenn der Fokus aus einem Texteingabesteuerelement erzwungen entfernt wurde. Die Anwendung sollte dieses Ereignis behandeln, um den Fokus für das Texteingabesteuerelement entsprechend zu entfernen.
FormatUpdating	Tritt auf, wenn der Texteingabeserver ein anderes Format auf einen bestimmten Textbereich anwenden muss. Dies geschieht in der Regel während der Komposition.
LayoutRequested	Tritt auf, wenn der Texteingabeserver das begrenzungsfeld eines Textbereichs und des Texteingabesteuerelements selbst abrufen muss. Die Anwendung sollte dieses Ereignis behandeln und die angeforderten Geometrieinformationen zurückgeben.
NotifyFocusLeaveCompleted	Tritt auf, nachdem der Fokus das Texteingabesteuerelement verlassen hat.
SelectionRequested	Tritt auf, wenn der Texteingabeserver den Textbereich abrufen muss, der den aktuell ausgewählten Text im Texteingabesteuerelement darstellt. Die Anwendung sollte dieses Ereignis behandeln und den angeforderten Bereich zurückgeben.
SelectionUpdating	Tritt auf, wenn der Texteingabeserver den Textbereich ändern muss, der derzeit im Texteingabesteuerelement ausgewählt ist. Dieses Ereignis kann das Ergebnis eines Eingabeprozessors sein, der Text auswählen oder das Caretzeichen verschieben muss. Das Texteingabesteuerelement sollte seinen Auswahlbereich entsprechend festlegen.
TextRequested	Tritt auf, wenn der Texteingabeserver einen Textbereich aus dem Texteingabesteuerelement abrufen muss. Die Anwendung sollte dieses Ereignis behandeln und den angeforderten Bereich zurückgeben.
TextUpdating	Tritt auf, wenn der Texteingabeserver Text innerhalb des Texteingabesteuerelements ändern muss. Dieses Ereignis kann das Ergebnis eines Schlüsselereignisses sein , z. B. das Einfügen eines einzelnen Zeichens, oder das Ergebnis einer Verarbeitung durch einen Eingabeprozessor, z. B. automatische Korrektur und Vorhersage. Bei der Behandlung des Ereignisses muss das Texteingabesteuerelement einen Bereich durch den neuen Text ersetzen, der vom Server bereitgestellt wird, und das Caret an das Ende des neuen Texts verschieben.

Weitere Informationen

• Beispiel für ein benutzerdefiniertes Bearbeitungssteuerelement