Partager via


IPenInputPanel ::Refresh, méthode (peninputpanel.h)

[L’actualisation n’est plus disponible à partir de Windows XP Édition Tablet PC. Utilisez plutôt le panneau d’entrée de texte (TIP).]

Mises à jour et restaure les propriétés PenInputPanel en fonction des paramètres du panneau d’entrée tablet PC, positionne automatiquement le panneau d’entrée du stylet et définit l’interface utilisateur sur le panneau par défaut.

Syntaxe

HRESULT Refresh();

Valeur de retour

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

Code de retour Description
S_OK
Réussite.
E_UNEXPECTED
Type de paramètre ou de propriété inattendu.
E_FAIL
Une erreur non spécifiée s'est produite.

Remarques

La méthode Refresh restaure le panneau par défaut. Par exemple, si la propriété DefaultPanel a la valeur Clavier et que la propriété CurrentPanel a la valeur Écriture manuscrite, la méthode Refresh définit le panneau d’entrée du stylet sur Clavier. Si la propriété DefaultPanel a la valeur Default, la méthode Refresh ne modifie pas le panneau d’entrée du stylet.

La méthode Refresh positionne automatiquement le panneau d’entrée du stylet par rapport au contrôle auquel il est attaché.

La méthode Refresh met à jour le panneau d’entrée du stylet à l’aide des paramètres du panneau d’entrée. Par instance, vous pouvez apporter des modifications à l’objet PenInputPanel, puis appeler Actualiser pour restaurer les paramètres de ceux copiés à partir du panneau d’entrée.

L’objet PenInputPanel est mis à jour automatiquement chaque fois que les paramètres du panneau d’entrée changent.

L’appel de l’actualisation alors que le panneau d’entrée du stylet n’a pas le focus génère une erreur.

Note Normalement, vous n’aurez pas besoin d’appeler Actualiser , car tout ce qui précède est exécuté pendant l’activation du panneau d’entrée du stylet. Toutefois, si la propriété AutoShow a la valeur FALSE, vous pouvez désactiver l’activation du panneau d’entrée du stylet. Par conséquent, la méthode Refresh est nécessaire.
 

Configuration requise

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
Plateforme cible Windows
En-tête peninputpanel.h
Bibliothèque InkObj.dll

Voir aussi

IPenInputPanel

PenInputPanel