Partage via


InputPane Classe

Définition

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 InputPane
Public NotInheritable Class InputPane
Héritage
Object Platform::Object IInspectable InputPane
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 :

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.

S’applique à

Voir aussi