Freigeben über

CoreFrameworkInputView Klasse

  • Referenz

Definition

Namespace:
Windows.UI.ViewManagement.Core
Bearbeiten

Stellt Ui-Frameworks mit der Möglichkeit bereit, PrimaryViewAnimationStarting - und OcclusionsChanged-Ereignisse nach den entsprechenden Ereignissen CoreInputViewPrimaryViewAnimationStarting und OcclusionsChanged zu verarbeiten.

Dadurch kann ein Framework die Anzeige eines angedockten, nicht angedockten, beweglichen oder vorübergehenden Eingabebereichs (und der zugehörigen Benutzeroberfläche) steuern, Benachrichtigungen empfangen, wenn der Bereich verschoben, angezeigt oder ausgeblendet wird, und bestimmen, welcher Teil des App-Fensters durch den Bereich verdeckt wird.

Hinweis

Wird auf 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 Benutzeroberfläche anzupassen und umzufließen, um jede Okklusion zu berücksichtigen.

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

  • Angedockter Soft Input Panel (SIP) wie die Bildschirmtastatur und der Schreibbereich – in der Regel wird die App-Benutzeroberfläche umfließen.
  • Unverankerte Symbolleiste oder SIP: In der Regel wird die App-Benutzeroberfläche nicht umfließen.
  • Überlagern von Bereichen wie Inline-Freihand- oder IME-Kandidatenfenstern. In der Regel wird die App-Benutzeroberfläche für das Bearbeitungssteuerelement nicht umfließen, sondern die Text-/Suchvorschläge umfließen.

Der Eingabebereich wird angezeigt, wenn der Benutzer eine Aktion ausführt, bei der er Informationen bereitstellen muss, z. B. das Eingeben eines Textfelds.

Standardmäßig verarbeitet Windows Eingabebereichsereignisse und positioniert Inhalte neu, sodass Benutzer das Steuerelement mit fokussiert 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 Ereignisdelegaten auf, wenn der Bereich für das Vordergrundfenster angezeigt oder ausgeblendet wird, wenn Sie die CoreFrameworkInputView.GetForCurrentView-Methode aufgerufen haben.

Hinweis

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 Marshalling (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 mit dem angegebenen Kontextbezeichner zugeordnet ist.

Ereignisse

OcclusionsChanged

Tritt auf, wenn mindestens ein CoreInputViewOcclusion-Objekt seine Position oder den verschließenden Bereich als Reaktion auf die Neupositionierung des Eingabebereichs ändert, 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.

Gilt für:

Weitere Informationen