CoreFrameworkInputView Klasse

Definition

Namespace:

Windows.UI.ViewManagement.Core

Stellt Benutzeroberflächenframeworks die Möglichkeit bereit, PrimaryViewAnimationStarting und OcclusionsChanged Ereignisse nach den entsprechenden CoreInputViewPrimaryViewAnimationStarting und OcclusionsChanged Ereignissen zu behandeln.

Auf diese Weise kann ein Framework die Anzeige eines angedockten, abgedockten, verschiebebaren oder transitorischen Eingabebereichs (und der zugeordneten Benutzeroberfläche) steuern, Benachrichtigungen empfangen, wenn der Bereich verschoben, angezeigt oder ausgeblendet wird, und um zu bestimmen, welcher Teil des App-Fensters vom Bereich verdeckt wird.

Anmerkung

Wird für HoloLens nicht unterstützt.

public ref class CoreFrameworkInputView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreFrameworkInputView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreFrameworkInputView

Public NotInheritable Class CoreFrameworkInputView

Vererbung

Object Platform::Object IInspectable CoreFrameworkInputView

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 11 (eingeführt in 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v14.0)

Hinweise

Wird nur von Frameworks (z. B. XAML) oder benutzerdefinierten Textsteuerelementen verwendet.

Das Framework kann die von diesem Objekt verfügbar gemachten Informationen verwenden, um die Ui anzupassen und umzubrechen, um alle Okklusionen zu berücksichtigen.

Die CoreFrameworkInputView-APIs unterstützen die folgenden Arten von Eingabebereichen.

• Angedockter Soft Input Panel (SIP) wie die Bildschirmtastatur und handschriftliche – in der Regel wird die Benutzeroberfläche der App umgebrochen.
• Unverankerte Symbolleiste oder SIP – in der Regel wird die App-UI nicht umgebrochen.
• Überlagerungspanels wie Inline-Freihand- oder IME-Kandidatenfenster – in der Regel wird die App-Benutzeroberfläche nicht für das Bearbeitungssteuerelement umgebrochen, sondern für text-/suchvorschläge umgebrochen.

Der Eingabebereich wird angezeigt, wenn der Benutzer eine Aktion ausführt, für die sie Informationen bereitstellen müssen, z. B. das Eingeben eines Textfelds.

Standardmäßig behandelt Windows Eingabebereichsereignisse und positioniert Inhalte so, dass Benutzer das Steuerelement mit Fokus sehen können.

Rufen Sie CoreFrameworkInputView.GetForCurrentView auf, um ein CoreFrameworkInputView-Objekt abzurufen.

Nachdem Sie sich registriert haben, um Eingabebereichsbenachrichtigungen zu erhalten, ruft das System Ihren Ereignisdelegat auf, wenn der Bereich für das Vordergrundfenster angezeigt oder ausgeblendet wird, wenn Sie die CoreFrameworkInputView.GetForCurrentView-Methode aufgerufen haben.

Anmerkung

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading und Marshaling (C++/CX).

Methoden

GetForCurrentView()	Ruft das CoreFrameworkInputView Objekt ab, das dem aktuellen Fenster zugeordnet ist.
GetForUIContext(UIContext)	Ruft ein CoreFrameworkInputView Objekt ab, das der Ansicht zugeordnet ist, die den angegebenen Kontextbezeichner aufweist.

Ereignisse

OcclusionsChanged	Tritt auf, wenn ein oder mehrere CoreInputViewOcclusion Objekte ihre Position oder den okkludierenden Bereich ändern, als Reaktion auf die Neupositionierung des Eingabebereichs, der dem CoreFrameworkInputView-zugeordnet ist.
PrimaryViewAnimationStarting	Animationen in der Anwendung, die als Reaktion auf das Ein- oder Ausblenden des Eingabebereichs auftreten, der dem CoreFrameworkInputView-zugeordnet ist.

Weitere Informationen

• CoreInputView