CoreInputView Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 CoreInputViewPublic NotInheritable Class CoreInputView- Héritage
- 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. |