CoreInputView Classe

Définition

Espace de noms:

Windows.UI.ViewManagement.Core

Permet à une application de contrôler l’affichage d’un volet d’entrée ancré, non chaussé, déplaçable ou temporaire (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.

Notes

Non pris en charge sur HoloLens.

public ref class CoreInputView sealed

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

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

Public NotInheritable Class CoreInputView

Héritage

Object Platform::Object IInspectable CoreInputView

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v5.0)

Remarques

L’affichage principal fait référence à l’une des vues CoreInputViewKind.Keyboard ou CoreInputViewKind.Handwriting , tandis que CoreInputView peut être l’une des valeurs de CoreInputViewKind.Handwriting.

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

Votre application peut utiliser les informations exposées par cet objet pour ajuster et redistribuer son interface utilisateur afin de prendre en compte toute occlusion.

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

• Panneau d’entrée souple (SIP) ancré, comme le clavier tactile et le panneau d’écriture manuscrite , en général, l’interface utilisateur de votre application est redistribuée.
• Barre d’outils flottante ou SIP : en règle générale, l’interface utilisateur de votre application ne reflowe pas.
• Les panneaux de superposition tels que les fenêtres manuscrites inline ou candidates IME : en règle générale, l’interface utilisateur de votre application ne reflowe pas pour le contrôle d’édition, mais elle effectue un nouveau flux pour les suggestions de texte/recherche.

Le volet d’entrée s’affiche lorsque l’utilisateur effectue une action qui l’oblige à fournir des informations, comme la saisie 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 le focus. Si vous définissez CoreTextEditContext.InputPaneDisplayPolicy sur Manual dans votre application, il vous incombe d’afficher et de masquer le volet d’entrée à l’aide de TryShowPrimaryView et TryHidePrimaryView. Utilisez cette classe pour remplacer le comportement par défaut et personnaliser le volet d’entrée.

Appelez GetForCurrentView pour obtenir un objet CoreInputView.

Une fois que vous vous êtes inscrit pour recevoir des notifications de 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 qui était visible lorsque vous avez appelé la méthode GetForCurrentView .

Notes

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 and Marshaling (C++/CX).

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1803	17134	TryTransferXYFocusToPrimaryView
1803	17134	XYFocusTransferredToPrimaryView
1803	17134	XYFocusTransferringFromPrimaryView
1809	17763	TryHide
1809	17763	TryShow
1809	17763	TryShow(CoreInputViewKind)
1903	18362	GetForUIContext
2004	19041	PrimaryViewHiding
2004	19041	PrimaryViewShowing

Méthodes

GetCoreInputViewOcclusions()	Récupère une référence à chaque volet d’entrée qui oblude actuellement l’application.
GetForCurrentView()	Récupère l’objet CoreInputView associé à la fenêtre active.
GetForUIContext(UIContext)	Obtient un objet CoreInputView associé à la vue ayant l’identificateur de contexte spécifié.
IsKindSupported(CoreInputViewKind)	Obtient si le type de CoreInputView spécifié est pris en charge.
TryHide()	Tente de masquer (s’il est visible) le volet d’entrée associé au volet CoreInputView .
TryHidePrimaryView()	Tente de masquer (s’il est visible) le volet d’entrée associé à CoreInputView.
TryShow()	Tente d’afficher (s’il est masqué) le volet d’entrée associé à CoreInputView.
TryShow(CoreInputViewKind)	Tente d’afficher (s’il est masqué) le type spécifié de volet d’entrée associé au CoreInputView.
TryShowPrimaryView()	Tente d’afficher (s’il est masqué) le volet CoreInputView . Cette méthode est un « meilleur effort » et garantit uniquement que l’utilisateur dispose d’un moyen d’interagir avec le contrôle ciblé. Pour un panneau d’entrée souple (SIP) ancré comme le clavier tactile et le panneau d’écriture manuscrite, le volet s’affiche uniquement si un clavier matériel n’est pas disponible.
TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)	Tente de déplacer le focus de l’interface utilisateur de l’application vers le volet d’entrée.

Événements

OcclusionsChanged	Se produit lorsqu’un ou plusieurs objets CoreInputViewOcclusion modifient leur position ou leur zone d’occlusion en réponse au repositionnement du volet d’entrée associé au CoreInputView.
PrimaryViewAnimationStarting	Animations dans l’application qui se produisent en réponse à l’affichage ou au masquage de l’affichage principal CoreInputView .
PrimaryViewHiding	Se produit avant que le volet d’entrée associé à CoreInputView ne soit masqué (s’il est visible).
PrimaryViewShowing	Se produit avant l’affichage du volet d’entrée associé à CoreInputView (s’il est masqué).
SupportedKindsChanged	Se produit lorsque la collection de vues CoreInputViewKind prises en charge pour CoreInputView change.
XYFocusTransferredToPrimaryView	Se produit lorsque le focus est déplacé vers le volet d’entrée à partir de l’interface utilisateur de l’application.
XYFocusTransferringFromPrimaryView	Se produit avant que le volet d’entrée ne perde le focus et avant qu’un élément d’interface utilisateur obtienne le focus.

Voir aussi

• CoreFrameworkInputView