InputPane 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 recevoir des notifications lorsque le clavier tactile ancré ou le panneau d’entrée réversible (SIP) est sur le point d’être affiché ou masqué, et de déterminer quelle partie de la fenêtre de l’application est masquée par le volet d’entrée.
Notes
Les API InputPane fournissent des informations d’occlusion précises pour un panneau ancré uniquement. Pour Windows 10 Creators Fall Update et versions ultérieures, nous vous recommandons d’utiliser les API suivantes pour gérer l’occlusion par des volets d’entrée ancrés, non ancrés, déplaçables et transitoires, tels que les panneaux d’entrée souples (SIP), les fenêtres candidates de l’éditeur de méthode d’entrée (IME), les barres d’outils flottantes, etc.
public ref class InputPane sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class InputPane final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class InputPanePublic NotInheritable Class InputPane- Héritage
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Remarques
Le volet d’entrée s’affiche lorsque l’utilisateur effectue une action qui l’oblige à entrer des informations, comme la sélection d’un champ de saisie 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 où ils tapent. Si vous définissez CoreTextEditContext.InputPaneDisplayPolicy sur Manuel dans votre application, il vous incombe d’afficher et de masquer le volet d’entrée à l’aide de TryShow et TryHide. Utilisez cette classe pour remplacer le comportement par défaut et personnaliser le volet d’entrée.
Dans certains cas, l’interface utilisateur de superposition telle qu’un InputPane n’est pas entièrement prise en charge. notamment :
- applications en mode plein écran, comme les jeux.
- Applications Holographiques Windows en mode holographique.
Appelez GetForCurrentView pour obtenir un objet InputPane.
Une fois que vous vous êtes 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 d’entrée 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 |
|---|---|---|
| 1903 | 18362 | GetForUIContext |
Propriétés
| OccludedRect |
Obtient la région de la fenêtre d’application masquée par le volet d’entrée. |
| Visible |
Obtient ou définit une valeur qui indique si le volet d’entrée est affiché. Important Valide pour la famille d’appareils Xbox uniquement. Pour les applications universelles, la propriété OccludedRect indique la région de la fenêtre d’application bloquée par le volet d’entrée. |
Méthodes
| GetForCurrentView() |
Obtient l’objet InputPane associé à la fenêtre d’application actuellement visible. |
| GetForUIContext(UIContext) |
Obtient l’objet InputPane associé à la vue avec l’identificateur de contexte spécifié. |
| TryHide() |
Tente de masquer l’élément InputPane, s’il est visible. |
| TryShow() |
Tente d’afficher l’élément InputPane, s’il est masqué. Cette méthode est un « effort optimal » et garantit uniquement que l’utilisateur a un moyen d’entrer du texte dans le contrôle prioritaire. Le clavier tactile, ou panneau d’entrée souple (SIP), s’affiche uniquement si un clavier matériel n’est pas disponible. |
Événements
| Hiding |
Se produit lorsque le volet d’entrée commence à glisser hors de l’affichage. |
| Showing |
Se produit lorsque le volet d’entrée commence à glisser dans l’affichage. |