CoreInputView.TryShow Méthode
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.
Surcharges
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. |
TryShow()
Tente d’afficher (s’il est masqué) le volet d’entrée associé à CoreInputView.
public:
virtual bool TryShow() = TryShow;
/// [Windows.Foundation.Metadata.Overload("TryShow")]
bool TryShow();
[Windows.Foundation.Metadata.Overload("TryShow")]
public bool TryShow();
function tryShow()
Public Function TryShow () As Boolean
Retours
bool
True si la demande d’affichage du volet d’entrée a été acceptée. Sinon, False.
Si cette méthode est appelée à partir d’une application qui n’est pas au premier plan, la demande est rejetée et la valeur false est retournée.
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10, version 1809 (introduit dans 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v7.0)
|
Remarques
Cette méthode est un « effort optimal » et garantit uniquement que l’utilisateur dispose d’un moyen d’interagir avec le contrôle ciblé. Pour un panneau sip (Soft Input Panel) ancré comme le clavier tactile et le panneau d’écriture manuscrite, le volet s’affiche uniquement si aucun clavier matériel n’est disponible.
Si vous définissez CoreTextEditContext.InputPaneDisplayPolicy sur Manual
, utilisez TryShow ou TryShowPrimaryView pour afficher le volet d’entrée, et TryHide ou TryHidePrimaryView pour masquer le volet d’entrée.
Voir aussi
S’applique à
TryShow(CoreInputViewKind)
Tente d’afficher (s’il est masqué) le type spécifié de volet d’entrée associé au CoreInputView.
public:
virtual bool TryShow(CoreInputViewKind type) = TryShow;
/// [Windows.Foundation.Metadata.Overload("TryShowWithKind")]
bool TryShow(CoreInputViewKind const& type);
[Windows.Foundation.Metadata.Overload("TryShowWithKind")]
public bool TryShow(CoreInputViewKind type);
function tryShow(type)
Public Function TryShow (type As CoreInputViewKind) As Boolean
Paramètres
Retours
bool
True, si la demande d’affichage du volet d’entrée a été acceptée ; sinon, false.
Si cette méthode est appelée à partir d’une application qui n’est pas au premier plan, la demande est rejetée et la valeur false est retournée.
- Attributs
Configuration requise pour Windows
Famille d’appareils |
Windows 10, version 1809 (introduit dans 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v7.0)
|
Remarques
Si type est défini sur Par défaut, un « meilleur effort » est fait pour afficher le volet d’entrée tout en veillant à ce que l’utilisateur puisse toujours interagir avec le contrôle prioritaire. Par exemple, un panneau SIP (Soft Input Panel) ancré, tel que le clavier tactile et le panneau d’écriture manuscrite, s’affiche uniquement si un clavier matériel n’est pas disponible.
Utilisez cette méthode si vous souhaitez fournir une expérience utilisateur spécifique basée sur un volet d’entrée spécifique, tel que le volet Emoji Windows.
La vue principale fait référence aux vues CoreInputViewKind.Keyboard ou CoreInputViewKind.Handwriting , tandis que CoreInputView peut être l’une des valeurs de CoreInputViewKind.
Si vous définissez CoreTextEditContext.InputPaneDisplayPolicy sur « Manual », utilisez TryShow ou TryShowPrimaryView pour afficher le volet d’entrée, et TryHide ou TryHidePrimaryView pour masquer le volet d’entrée.