Méthode ITipAutocompleteClient::P referredRects

Article
06/13/2023

Permet au client de suggérer où positionner la liste de saisie semi-automatique afin d’éviter le chevauchement du panneau d’entrée.

Syntaxe

HRESULT PreferredRects(
  [in]      RECT *prcACList,
  [in]      RECT *prcField,
  [out]     RECT *prcModified,
  [in, out] BOOL *pfShownAboveTip
);

Paramètres

prcACList [in]: Rectangle, dans les coordonnées de l’écran, indiquant l’emplacement préféré du fournisseur et la taille de l’interface utilisateur de la liste de saisie semi-automatique.
prcField [in]: Rectangle, en coordonnées d’écran, indiquant l’emplacement et la taille du champ ciblé.
prcModified [out]: Rectangle basé sur l’état actuel du TIP et l’emplacement et la taille de la liste de saisie automatique par défaut spécifiés par prcACList.
pfShownAboveTip [in, out]: TRUE si le rectangle modifié doit être affiché au-dessus de la zone cible du panneau d’entrée de texte ; sinon, FALSE. Cette valeur doit être initialisée à l’orientation préférée du fournisseur avant que la méthode soit appelée.

Valeur retournée

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

Code de retour	Description
S_OK	Opération réussie.
E_INVALIDARG	Appelez la méthode ITipAutocompleteClient::RequestShowUI pour définir la fenêtre de liste contextuelle de saisie semi-automatique avant d’appeler la méthode ITipAutocompleteClient::P referredRects.
E_FAIL	Une erreur non spécifiée s'est produite.

Notes

Il s’agit de la méthode que le fournisseur de saisie semi-automatique appelle lorsqu’il est sur le point d’afficher l’interface utilisateur complète automatique. Le client modifie le rectangle préféré du fournisseur spécifié par prcACList via l’argument prcModified .

Appelez la méthode ITipAutocompleteClient::RequestShowUI pour définir le handle de fenêtre de saisie de la liste contextuelle automatique avant d’appeler PreferredRects. Si vous ne le faites pas, une erreur 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 Tablet 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::RequestShowUI, méthode
Informations de référence sur le panneau d’entrée de texte

Partager via