Controls.TControl.Hint

Informations Delphi

De Controls.pas

	property Hint: string read FHint write FHint;

Unité : Controls

Type : propriété

Visibilité : published

Membre de : TControl

Informations C++

De Controls.hpp

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

Unité : Controls

Type : propriété

Visibilité : public

Membre de : TControl

Description

Contient la chaîne de texte apparaissant lorsque l'utilisateur déplace la souris au-dessus du contrôle.

Utilisez la propriété Hint pour spécifier une chaîne de texte d'aide comme texte de conseil ou comme texte d'aide affiché à un endroit spécifique, par exemple sur la barre d'état.

Un conseil est une boîte affichant un texte d'aide à propos d'un contrôle, qui apparaît si l'utilisateur maintient momentanément le pointeur de la souris au-dessus du contrôle. Pour mettre en place les conseils :

Spécifiez la propriété Hint de chaque contrôle pour lequel un conseil d'aide doit apparaître.

Affectez true à la propriété ShowHint de chaque contrôle approprié, ou affectez true à la propriété ParentShowHint de tous les contrôles et définissez la propriété ShowHint de la fiche à true.

A l'exécution, affectez true à la valeur à la propriété ShowHint.

Pour afficher le conseil dans une barre d'état ou à un autre emplacement, utilisez le gestionnaire d'événement OnHint de l'application. L'événement OnHint de l'application est déclenché quand le pointeur de la souris passe au-dessus du contrôle.

Spécifiez un conseil à utiliser pour la boîte d'aide de la propriété Hint et un autre pour le gestionnaire OnHint en indiquant deux valeurs séparées par un caractère | (le symbole barre verticale "ou"). Par exemple :

Edit1.Hint := 'Name|Entrez le nom dans la boîte de saisie';

Edit1->Hint = "Name|Entrez le nom dans la boîte de saisie";

La chaîne "Nom" apparaît dans la boîte de conseil et la chaîne "Entrez le nom dans la boîte de saisie" peut être extraite en utilisant la fonction GetLongHint pour l'utiliser dans un gestionnaire d'événement OnHint.

Si Hint ne contient qu'une valeur, la chaîne entière est utilisée comme conseil d'aide et est renvoyée par la fonction GetLongHint. Si un contrôle n'a pas de valeur Hint spécifiée, mais que son contrôle parent l'ait, le contrôle utilise la valeur Hint du contrôle parent (tant que la propriété ShowHint du contrôle a la valeur true).

Remarque : Si la propriété ShowHint de l'application a la valeur false, le conseil d'aide n'apparaît pas, mais le gestionnaire d'événement OnHint est toujours appelé.