Vcl.Controls.TControl.Caption

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Caption: TCaption read GetText write SetText stored IsCaptionStored;

C++

__property TCaption Caption = {read=GetText, write=SetText, stored=IsCaptionStored};

Propriétés

Type Visibilité  Source Unité  Parent
property protected
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TControl


Description

Spécifie une chaîne de texte permettant à l'utilisateur d'identifier le contrôle.

Utilisez Caption pour spécifier la chaîne de texte qui définit le libellé du contrôle.

Pour souligner un caractère dans un Caption qui définit le libellé d'un composant, incluez une esperluète (&) devant le caractère. Ce type de caractère est appelé caractère accélérateur. L'utilisateur peut alors sélectionner le composant en appuyant sur la touche ALT tout en tapant le caractère souligné. Pour afficher un caractère esperluète dans le libellé, utilisez deux esperluètes (&&).

Remarques : 

  • Les contrôles qui affichent du texte utilisent soit la propriété Caption, soit la propriété Text pour spécifier la valeur texte. La propriété utilisée dépend du type de contrôle. En général, la propriété Caption est utilisée pour le texte qui apparaît en tant que titre ou libellé d'une fenêtre, alors que la propriété Text est utilisée pour le texte qui apparaît en tant que contenu d'un contrôle.
  • Pour certains contrôles, tels que TButton, il n'est pas possible de changer la couleur du Caption. Si vous voulez changer la couleur d'un libellé de bouton, vous devez utiliser un autre type de bouton tel que TSpeedButton ou TBitBtn au lieu de TButton. Avec TSpeedButton ou TBitBtn, vous pouvez changer la couleur de la propriété Caption en utilisant la propriété Font.
  • Pour TLinkLabel, une balise HTML est déclarée dans la propriété Caption à l'exécution ou à la conception.

Voir aussi

Exemples de code