Partager via


CoreInputView Classe

Définition

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)]
class CoreInputView final
/// [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)]
public sealed class CoreInputView
[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

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.

S’applique à

Voir aussi