Vcl.Forms.TApplication.Hint

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Hint: string read FHint write SetHint;

C++

__property System::UnicodeString Hint = {read=FHint, write=SetHint};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Vcl.Forms.pas
Vcl.Forms.hpp
Vcl.Forms TApplication

Description

Spécifie la chaîne de texte apparaissant dans la boîte de conseil.

La propriété Hint stocke la valeur du conseil du contrôle ou de l'élément de menu, qui apparaît si l'utilisateur maintient momentanément le pointeur de la souris au-dessus du contrôle. Vous pouvez également lui affecter une valeur chaîne donnant à l'utilisateur certaines informations sur une action, une erreur ou autre chose. Utilisez donc la propriété Hint pour :

  • Afficher les conseils des contrôles dans une autre zone de l'affichage, par exemple une barre d'état, en utilisant le gestionnaire d'événements OnHint. La propriété Hint est utilisée ici en lecture.
  • Indiquer l'état de l'application pendant qu'un traitement a lieu. Ceci définit la propriété Hint.

Les conseils apparaissent quand se produit l'événement OnHint. Si la valeur de la propriété Hint de TApplication est affectée (par exemple, comme libellé de la barre d'état), le libellé du contrôle barre d'état affiche la valeur chaîne en cours de la propriété Hint pendant un événement OnHint.

La chaîne Hint est constituée de deux parties (abrégée et longue), séparées par le caractère |. Les conseils abrégés sont affichés dans des boîtes de conseil surgissantes. Les conseils longs sont utilisés par une barre d'état. Utilisez les fonctions globales GetShortHint et GetLongHint, de l'unité Controls, pour extraire la partie abrégée et la partie longue de la chaîne de conseil.

Remarque :  Lorsque vous affectez à la propriété Hint un message informant l'utilisateur d'un événement se produisant dans l'application, n'oubliez pas que par défaut la chaîne Hint est redéfinie avec la propriété Hint d'un contrôle quand le curseur de la souris passe au-dessus du contrôle.

Voir aussi

Exemples de code