Partager via


Méthode ITipAutocompleteClient::RequestShowUI

Détermine si le panneau d’entrée est prêt à afficher la liste de saisie semi-automatique.

Syntaxe

HRESULT RequestShowUI(
  [in]  HWND hWndACList,
  [out] BOOL *pfAllowShowing
);

Paramètres

hWndACList [in]

Handle de fenêtre de l’interface utilisateur de la liste de saisie semi-automatique.

pfAllowShowing [out]

FALSE si le client recommande de ne pas afficher l’interface utilisateur de la liste de saisie semi-automatique. TRUE si le fournisseur de saisie semi-automatique peut afficher l’interface utilisateur de la liste.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Opération réussie.
E_FAIL
Une erreur non spécifiée s'est produite.

Notes

Cette méthode est appelée par le fournisseur de saisie semi-automatique lorsqu’il est sur le point d’afficher l’interface utilisateur de saisie semi-automatique. Si l’état interne du client n’autorise pas le fournisseur à afficher l’interface utilisateur, pfAllowShowing est défini sur FALSE. Par exemple, lorsque le texte est envoyé au champ à partir de l’apparence de l’écriture manuscrite sur le panneau d’entrée du Tablet PC et que l’utilisateur démarre immédiatement l’entrée manuscrite, le client recommande de ne pas afficher l’interface utilisateur complète automatiquement, afin d’éviter de détruire l’entrée manuscrite de l’utilisateur, en définissant pfAllowShowing sur FALSE.

Appelez RequestShowUI pour définir le handle de la fenêtre de liste de saisie semi-automatique avant d’appeler la méthode ITipAutocompleteClient::P referredRects. Si vous ne le faites pas, une erreur de E_INVALIDARG est générée lors de l’appel de PreferredRects.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge
Aucun pris en charge
En-tête
TipAutoComplete.h (nécessite également Peninputpanel_i.c)
DLL
Tiptsf.dll

Voir aussi

ITipAutocompleteClient, interface

ITipAutocompleteClient::P referredRects, méthode

Informations de référence sur le panneau d’entrée de texte