CoreFrameworkInputView Classe

  • Référence

Définition

Espace de noms:
Windows.UI.ViewManagement.Core
Modifier

Fournit aux infrastructures d’interface utilisateur la possibilité de gérer les événements PrimaryViewAnimationStarting et OcclusionsChanged après les événements CoreInputViewPrimaryViewAnimationStarting et Événements OcclusionsChanged correspondants.

Cela permet à une infrastructure de contrôler l’affichage d’un volet d’entrée ancré, non suspendu, déplacé ou transitaire (et de l’interface utilisateur associée), de recevoir des notifications lorsque le volet est déplacé, affiché ou masqué et de déterminer quelle partie de la fenêtre de l’application est masquée par le volet.

Note

Non pris en charge sur HoloLens.

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
Héritage
Object Platform::Object IInspectable CoreFrameworkInputView
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 11 (introduit dans 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v14.0)

Remarques

Utilisé par les frameworks (tels que XAML) ou les contrôles de texte personnalisés uniquement.

L’infrastructure peut utiliser les informations exposées par cet objet pour ajuster et reflower l’interface utilisateur afin de prendre en compte n’importe quelle occlusion.

Les API CoreFrameworkInputView prennent en charge les types suivants de volets d’entrée.

  • Panneau d’entrée réversible ancré (SIP) tel que le clavier tactile et le panneau d’écriture manuscrite , généralement, l’interface utilisateur de votre application reflowe.
  • Barre d’outils flottante ou SIP : généralement, l’interface utilisateur de votre application ne reflowe pas.
  • Les panneaux de superposition tels que les fenêtres manuscrites inline ou candidate IME , généralement, l’interface utilisateur de votre application ne reflowe pas pour le contrôle d’édition, mais reflowe les suggestions de texte/recherche.

Le volet d’entrée s’affiche lorsque l’utilisateur effectue une action qui les oblige à fournir des informations, telles que l’entrée d’un champ de texte.

Par défaut, Windows gère les événements du volet d’entrée et repositionne le contenu afin que les utilisateurs puissent voir le contrôle avec focus.

Appelez CoreFrameworkInputView.GetForCurrentView pour obtenir un objet CoreFrameworkInputView.

Après vous être inscrit pour recevoir des notifications du volet d’entrée, le système appelle votre délégué d’événement chaque fois que le volet est affiché ou masqué pour la fenêtre de premier plan lorsque vous avez appelé la méthode CoreFrameworkInputView.GetForCurrentView.

Note

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez threading et marshaling (C++/CX).

Méthodes

GetForCurrentView()

Récupère l’objet CoreFrameworkInputView associé à la fenêtre active.
GetForUIContext(UIContext)

Obtient un objet CoreFrameworkInputView associé à la vue ayant l’identificateur de contexte spécifié.

Événements

OcclusionsChanged

Se produit lorsqu’une ou plusieurs CoreInputViewOcclusion objets changent leur position ou zone d’ocluding en réponse au repositionnement du volet d’entrée associé au CoreFrameworkInputView.
PrimaryViewAnimationStarting

Animations dans l’application qui se produisent en réponse à l’affichage ou au masquage du volet d’entrée associé au CoreFrameworkInputView.

S’applique à

Voir aussi