Les principaux composants

10. Les principaux composants

Chaque classe et composant de la bibliothèque VCL a une utilité particulière. Toutefois

il est possible de les classer en différentes catégories de manière à mieux comprendre leurs
points communs et leurs différences.

Globalement on distingue :
- Les classes et composants de haut niveau qui représentent l'application et ses
différentes fenêtres.
- Les composants qui permettent de créer une interface évoluée ( panneau, labels,
cadres, blocs notes, menus, etc. ).
- Les composants chargés de réaliser des entrées et des sorties ( zone de saisie et
d'affichage ) ou offrant des possibilités de choix à l'utilisateur ( case à cocher, liste,
etc.).
- Les composants permettant d'accéder au système.

 Dans cette description, qui ne peut qu'être succincte, on laissera de coté

les composants plus particulièrement conçus pour la manipulation des données
et ceux destinés à la gestion du graphisme.
Il est du ressort de tout utilisateur de C++ Builder de chercher à manipuler les
différents composants à l'aide d'exercices qu'il s'impose ou en étudiant les,
nombreux, exemples fournis. Mais attention, dans ce dernier cas les exemples
sont parfois difficiles à appréhender.

10.1 : Composant du niveau application

Une application C++ Builder est composée d'un nombre variable de fenêtres dont une
est la fenêtre principale. Chaque fenêtre est, du point de vue de la programmation, une classe
particulière dérivée de la classe TForm.

Mais il existe aussi une classe spéciale, appelé TApplication, "caché" qui permet de
référencer directement l'application dans son ensemble. Il n'est pas nécessaire de manipuler
directement le composant, non visuel, instancié à ce type dans tous les cas mais il est bon de
savoir qu'il existe, sachant qu'il a une importance capitale, et que l'on peut, par son
intermédiaire, réaliser des traitements puissants.

Page X.1
 Les principaux composants

La structure générale d'une application est alors :

TApplication

TScreen TForm1
TForm2
TForm1

TPanel1 Contrôle
TPanel
TPanel Contrôle

Contrôle
Contrôle

Contrôle
Contrôle

Contrôle

L'objet Application est l'objet "parent" de tous les composants. Il est en particulier
parent de tous les objets de type TForm et d'un objet spécifique, appelé TScreen, dont on
explicitera le rôle.
Chaque objet TForm est parent de tous les composants qu'il contient. Certains de ces
composants ( comme le composant TPanel ) peuvent contenir eux même des composants dont
ils sont les parents.

10.11 : La classe TForm

 Ce composant ne figure pas dans les palettes de composant. Il faut l'appeler
explicitement par le menu 'Fichier | Nouvelle Fiche'.
Le fait de créer une nouvelle fiche implique la création automatique d'une unité.

10.111 / Description :
Une fiche est constituée à partir du composant TForm. Ce composant peut contenir
d'autres composants. Il est au centre des applications C++ Builder : on conçoit une
application en plaçant des composants sur une ou plusieurs fiches.
Les fiches peuvent être utilisées en tant que fenêtres ou en tant que boîtes de dialogue.

 Une fiche représente, à l'exécution, une fenêtre distincte : en particulier, les

dimensions et la position écran données à la fiche lors de la phase de
conception sont, par défaut, celles de la fenêtre à l'exécution.

Page X.2
 Les principaux composants

10.112 / Principales propriétés :

Un composant de type TForm possède un grand nombre de propriétés. En plus de
celles, générales, décrites dans le chapitre précédent, il faut connaître la signification
d'un certain nombre d'entre elles, spécifiques à ce composant, pour personnaliser la
feuille.

Propriétés Type Description

ActiveControl TWinControl Désigne le composant de la fiche qui sera actif
lors de l'affichage de celle-ci.
AutoScroll Bool Détermine si les barres de défilement doivent
apparaître dans la fiche lorsque la taille de
celle-ci est insuffisante pour afficher tous ses
contrôles.
BordersIcons TBorderIcons Définissent la présence ou l'absence du menu
système et des boutons d'agrandissement et de
réduction de part et d'autre de la barre de titre.
BorderStyle TFormBorderStyle Définit l'apparence et le comportement de la
bordure ( redimensionnable ou non, style "boite
de dialogue", etc. ).
FormStyle TFormStyle Indique si la feuille sera normale ou de type
MDI ou si elle pourra rester toujours au-dessus
des autres feuilles.
KeyPreview Bool Permet de gérer les événements clavier.
Menu TMainMenu Désigne la barre des menus de la fiche.
Position TPosition Permet de définir la taille et le positionnement
de la fiche au démarrage.
WindowsState TWindowState Permet de déterminer l'état de la fenêtre
au démarrage.

Lors de la phase de conception on peut initialiser la plupart des valeurs de ces

propriétés.

 D'autres propriétés permettent de déterminer précisément la taille et la

position de la fenêtre à l'écran.
Si l'on veut que la fenêtre ait la taille de l'écran il faudra que ses
propriétés Height et Width correspondent à la taille de l'écran ( en tenant
compte de la résolution de l'écran ). Il faut ensuite initialiser, à
l'exécution, les propriétés Left et Top à 0 ( ou alors initialiser la
propriété Position = poScreenCenter ).

 Une fenêtre de type "boite de dialogue " ( BorderStyle = bsDialog ) ne

peut afficher de menu ( même si celui-ci a été défini lors de la phase de
conception).

 Par défaut, la propriété Visible est initialisée à False pour toute autre
fiche que celle de la fenêtre principale.

 Comme le composant fiche est le parent de tous les composants qu'il

contient, il n'est pas nécessaire de citer son nom logique pour accéder à
ses différentes propriétés ou méthodes à partir des différents
gestionnaires d'événements créés.

Form1->Caption = "Fenêtre principale" ;

est équivalent à :
Caption = "Fenêtre principale" ;

Page X.3
 Les principaux composants

Par contre, il sera nécessaire d'utiliser le nom de la fiche si on souhaite

invoquer une de ses propriétés ou de ses méthodes à partir d'une autre
fiche.

10.113 / Principales méthodes :

Le composant TForm possède aussi un nombre impressionnant de méthodes. Parmi
celles-ci on peut citer :

Méthode Action
Close ( void ) Ferme la fiche.
La méthode Close appelle d'abord la méthode CloseQuery
pour déterminer si la fiche peut être fermée. Si CloseQuery
renvoie False, l'opération de fermeture est interrompue.
CloseQuery ( void ) La méthode CloseQuery est appelée pendant le processus de
fermeture déclenché par la méthode Close d'une fiche afin de
savoir si cette dernière peut être effectivement fermée.
CloseQuery exécute le code rattaché à l'événement
OnCloseQuery.
Print Imprime une image de la fiche
Show ( void ) Rend visible une fiche en mettant sa propriété Visible à True
et en la faisant fonctionner en mode amodal.
ShowModal ( void ) Rend visible une fiche en mettant sa propriété Visible à True
et en la faisant fonctionner en mode modal.

10.114 / Événements associés :

Les principaux événements gérés par le composant de type TForm sont :

Événement Déclenchement
OnActivate Se produit lorsque la fiche devient active.
OnClick Se produit lorsque l'utilisateur clique sur le composant.
OnClose Se produit lors de la fermeture d'une fiche
OnCloseQuery Se produit lors d'une action fermant la fiche ( lorsque la méthode
Close est appelée ou lorsque l'utilisateur choisit Fermeture dans
le menu système de la fiche).
Il est possible d'utiliser un gestionnaire d'événement
OnCloseQuery afin de demander à l'utilisateur une confirmation
de la fermeture.
OnCreate Permet de créer une fonction associée servant à initialiser la fiche
( valeurs initiales des propriétés et exécution de traitements
spécifiques ).
OnExit Se produit lorsque la focalisation passe à une autre feuille.

Une fiche ne peut être fermée que si la variable globale OnClose, de type booléen, est
positionnée à True. Il est donc possible de créer un gestionnaire d'événement afin
d'initialiser cette variable.
Quelle que soit la manière dont la fenêtre sera fermée ( par un bouton approprié, par le
menu système ou par un raccourci clavier ) le gestionnaire d'événement associé à
OnCloseQuery est exécuté. Il est alors possible d'y inclure certains contrôles
préalables à la fermeture en bloquant celle-ci le cas échéant.

 Il est intéressant d'utiliser les possibilités offertes par les différents événements
amenant à la création et à l'affichage de la feuille. Certains sont systématiquement appelés
lors de la procédure de création. Il s'agit, dans l'ordre, des événements :

Page X.4
 Les principaux composants

- OnCreate : Événement appelé lors de la création de la fiche. Les

différents composants de la fiche existent déjà ( on peut donc les
invoquer et les initialiser ). Par contre la variable fiche elle-même
n'existe pas encore. On ne peut donc pas réaliser des initialisations
en l'invoquant ( mais on peut le faire en invoquant directement
certaines propriétés ou méthodes ).
- OnShow : Événement appelé juste avant que la fiche ne devienne
visible.
- OnResize :
- OnActivate : Événement se produisant lorsque la fiche devient
active.
- OnPaint : Événement se produisant lorsque Windows demande à la
fiche de se peindre quand elle reçoit la focalisation et devient visible
alors qu'elle ne l'était pas avant.

Tant que la fiche n'est pas visible, on ne peut donner le focus à un de

ses composants ( il faut utiliser pour cela la propriété ActiveControl qui
donnera le focus au composant souhaité quand cela sera possible ou
alors utiliser un événement à partir de OnShow ).

On ne peut réaliser des opérations d'affichage graphique que dans

l'événement OnPaint et pas avant.

10.115 / Création, appel et destruction à l'exécution d'une fiche :

Une fiche est créée simplement, en phase de conception, par utilisation du menu
'Fichier/ Nouvelle fiche '.

On peut ensuite composer l'interface graphique en déposant différents composants sur

la fiche et en les initialisant. Le code correspondant est généré automatiquement par C+
+ Builder dans le source associé.
Une fois le projet sauvegardé, la fiche et le fichier possèdent des noms qui leurs
permettent d'être manipulés par programmation.

Une application étant, normalement, constituée de plusieurs fenêtres, il faut maintenant

mettre en place les mécanismes permettant d'appeler une fiche à partir d'une autre fiche
( ou à partir de la fiche principale ) :

Pour réaliser cette manipulation on prend pour exemple deux fenêtres :

- Une première, nommée FMere, comporte un bouton nommé BOuvrir avec comme
légende "Ouvrir Fenêtre fille" ;
- Une seconde, nommée FFille, comporte un bouton nommé BFermer avec, comme
légende "Fermer".
Sauvegarder les deux fiches et donner un nom au projet.

1° / Créer un gestionnaire d'événement associé au bouton BOuvrir.

[ La plupart du temps il s'agit d'un gestionnaire associé à l'événement OnClick

d'un bouton ou d'une rubrique d'un menu, mais ce n'est pas une obligation et
tous les composants peuvent permettre l'apparition d'une fenêtre fille ].
Au sein du gestionnaire, insérer le code permettant l'apparition de la fiche
désirée.

A ce niveau, il y a plusieurs possibilités :

Page X.5
 Les principaux composants

- Soit la fenêtre apparaît en mode amodal et on doit alors utiliser la méthode

Show.
- Soit elle apparaît en mode modal et on doit utiliser la méthode ShowModal.
C'est cette dernière possibilité que l'on choisit car la plus efficace.

void __fastcall TFMere::BOuvrirClick(TObject *Sender)

{
FFille->ShowModal ( ) ;
}

2° / Créer un gestionnaire d'événement associé au bouton BFermer.

void __fastcall TFFille::BFermerClick(TObject *Sender)

{
Close ( ) ;
}

3° / Faire "reconnaître la fenêtre FFille par la fenêtre FMere en incluant le fichier

'.h' de la fenêtre mère après le dernier #include du fichier '.cpp' de la fenêtre
mère :

#include "Unit1.h"
#include "Unit2.h"
Inclusion du fichier en-tête
//-------------------------------------------------------

#pragma package(smart_init)
#pragma resource "*.dfm"
TFMere *FMere;
//-------------------------------------------------------
__fastcall TFMere::TFMere(TComponent* Owner)
: TForm(Owner)
{

Le code du fichier '.cpp' du projet est alors le suivant :

WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)

{
try
{
Application->Initialize();
Application->CreateForm
(__classid(TFMere), &FMere);
Application->CreateForm
(__classid(TFFille), &FFille);
Application->Run();
}

catch (Exception &exception)

{
Application->ShowException(&exception);
}
return 0;
}
/* On note les deux appels à la méthode CreateForm ( )
réalisé par l'objet Application. */

A l'exécution on peut basculer d'une fenêtre à l'autre en cliquant sur les boutons
correspondant.

Page X.6
 Les principaux composants

Cependant ce mode de création de fiche, qui est le mode par défaut, n'est pas
satisfaisant. En effet il implique que toutes les fiches constituant l'application soient
créées au démarrage, par l'objet Application. Elles ne sont affichées qu'à la demande. Si
l'application est composée de quelques dizaines de feuilles les ressources mémoires et
systèmes nécessaires risquent d'être insuffisantes.

Par ailleurs certaines fiches peuvent avoir besoin de certaines valeurs d'initialisation qui
ne seront valides que par action de l'utilisateur dans d'autres fiches ( ce sera souvent le
cas dans les applications gérant des données ). L'application risque alors de "planter"
au démarrage.

Il est donc préférable, et de loin, de réaliser une création dynamique des feuilles : les
zones mémoires nécessaires aux différentes fiches ne sont alors réservées qu'en cas de
besoin.

Pour pouvoir réaliser cette création dynamique il faut explicitement créer la feuille dans
le gestionnaire d'événement chargé de l'afficher. Il faudra aussi prendre soin de libérer
la mémoire lorsque la fenêtre est fermée.

En reprenant l'exemple précédent, on a alors, dans le gestionnaire d'événement du

bouton BOuvrir, le code suivant :

void __fastcall TFMere::BOuvrirClick(TObject *Sender)

{
FFille = new TFFille ( this );
FFille->ShowModal ( ) ;
delete FFille ;
}

/* La première instruction crée dynamiquement le fenêtre

fille;
La deuxième instruction l'affiche ;
La troisième détruit dynamiquement la fiche. */

 L'opérateur new appelle le constructeur de la classe qui réalise la

"construction" de la fiche ( avec les composants qui y sont inclus ).
La méthode ShowModal affiche la fenêtre. Comme celle-ci est modale
toutes les actions de l'utilisateur se déroulent au sein de cette fenêtre. On
ne sort de cette ligne de code que lorsque la fenêtre est fermée.
L'opérateur delete libère les ressources allouées.

Pour que cette méthode d'allocation dynamique soit réellement prise en compte, il faut
que l'option "auto-création" des fiches soit annulée dans le projet. Il faut pour cela se
rendre dans le menu ' Projet / Options', pour faire passer les différentes fiches
secondaires dans la catégorie " fiches disponibles ".

Page X.7
 Les principaux composants

 Si on affiche alors le source du fichier '.cpp' du projet, on constate que la ligne

provoquant la création de la fiche secondaire FFille a disparue.

WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)

{
try
{
Application->Initialize();
Application->CreateForm (__classid(TFMere),
&FMere);
Application->Run();
}
catch (Exception &exception)
{
Application->ShowException(&exception);
}
return 0;
}

Appel de fiche "protégé" :

Il est possible que Windows ne soit pas en mesure d'afficher la fenêtre ( lors de
l'exécution de la méthode ShowModal ( ou Show ) car il ne dispose plus de
suffisamment de ressources.

Page X.8
 Les principaux composants

Il faut donc protéger l'appel à cette méthode en gérant l'exception qui est susceptible
d'être déclenchée ( et qui se traduit par un message système à l'écran bien peu
esthétique).
Un chapitre est consacré ultérieurement à la gestion des exceptions. Néanmoins il est
intéressant de voir quel est le code complet et sécurisé de l'appel d'une fiche :

void __fastcall TFMere::BOuvrirClick(TObject *Sender)

{

try
{
FFille = new TFFille ( this );
FFille->ShowModal ( ) ;
}
catch ( ... )
{
ShowMessage ( "Ouverture impossible" ) ;
}
delete FFille ;
}
/* En fait il y a deux sources d'exception possible :
- L'appel à new qui ne peut allouer la mémoire
nécessaire ;
- L'appel à ShowModal qui ne peut disposer des
ressources systèmes nécessaires pour réaliser
l'affichage.
Il faut donc être plus précis dans sa gestion des
exceptions */

10.12 : La classe TApplication

Un composant Application, invisible, est automatiquement instancié à partir de la classe
TApplication et intégré au projet par C++ Builder. Il sert à définir l'application dans son
ensemble.
Il est principalement utilisé pour créer la fiche principale et lancer l'application.

 C'est ce composant qui est invoqué dans le fichier projet '.cpp' et qui permet
de lancer l'application par l'instruction :

Application->Run ( ) ;

On n'utilise pas fréquemment les propriétés et méthodes de ce composant. Néanmoins

quelques unes sont intéressantes et permettent d'avoir accès à des renseignements très
intéressants.

Page X.9
 Les principaux composants

10.121 / Principales propriétés :

ExeName Nom de l'application exécutable ( chemin complet ).

HelpFile Nom du fichier d'aide associé ( chemin complet ).
Hint Texte apparaissant sous forme de bulle d'aide. Lorsque
la propriété ShowHint du composant est à True ainsi que
celle des différents composants, on peut utiliser la
propriété Hint de l'application pour afficher les messages
correspondants directement à chaque fois que l'on
passe le curseur sur un composant.
HintColor Couleur des bulles d'aide de l'application.
HintPause Délai, en millisecondes, de déclenchement des bulles
d'aide.
Icon Icône du programme lorsque celui-ci est intégré au
Gestionnaire de programme.
Title Texte associé à l'icône dans le gestionnaire de
programme.

 On peut par exemple utiliser le renseignement fourni par la propriété

Exename pour se positionner dans le répertoire de l'exécutable ( en utilisant
la fonction ExtractFilePath( ) ) :

ChDir( ExtractFilePath (Application->Exename ));

10.122 / Principales méthodes :

MessageBox ( ) Appelle la fonction correspondante de l'API Windows

Run ( ) Lance l'exécution de l'application.

10.123 / Principaux événements :

OnActivate Se produit lorsque l'application devient active

( lorsqu'elle est créée ou lorsqu'elle reçoit le focus ).
OnException Se produit lorsqu'une exception non gérée survient dans
l'application.
OnHint Se produit lorsque le curseur de la souris passe au-
dessus d'un composant dont la propriété Hint n'est pas
vide.

10.13 : La classe TScreen

Comme la classe TApplication, TScreen est une classe spécifique qui instancie
automatiquement un composant invisible qui est automatiquement intégré au projet. Son nom
est Screen.

De même ses propriétés et méthodes ne sont pas très connues ( il faut dire que la
documentation à son sujet est très réduite et qu'il faut presque un hasard pour savoir qu'il
existe). Néanmoins certaines de ses caractéristiques sont très intéressantes et, pour tout dire,
incontournables.

Page X.10
 Les principaux composants

Le composant Screen représente l'état de l'écran au fur et à mesure de l'exécution de

l'application.
On peut connaître la résolution courante du moniteur en invoquant les propriétés
Height et Width. La propriété PixelsPerInch indique le nombre de pixels par pouce tel qu'il
est défini dans le pilote du périphérique d'affichage courant.

10.131 / Principales propriétés :

ActiveControl Indique le contrôle actif dans la feuille active

ActiveForm Indique la fenêtre active
Cursor Permet de gérer le curseur d'une manière globale
Cursors Tableau des curseurs disponibles
Fonts Liste des fontes supportées par l'écran

 La propriété Cursor de chaque composant permet de modifier l'aspect

du curseur lorsque celui-ci "passe" au-dessus du composant concerné
( croix, sablier, etc. ).
Par contre, lorsque l'on souhaite modifier le curseur en cours d'exécution
( par exemple pour qu'il prenne la forme d'un sablier indiquant qu'un
traitement est en cours), il faut utiliser la propriété Cursor de TScreen
qui permet de modifier de manière globale son apparence.

void __fastcall TFMere::Button1Click(TObject *Sender)

{
double i = 0 ;

Screen->Cursor = crHourGlass ;
while ( i++ < 100000000 )
;
Screen->Cursor = crDefault ;

}
/* Le curseur prend la forme d'un sablier lorsque l'on
clique sur un bouton puis reprend son aspect habituel
*/

10.2 : Composants permettant la réalisation

d'une interface

Quelques composants sont essentiellement destinés à la constitution d'interfaces

évoluées. Il est important de connaître leurs caractéristiques pour pouvoir les utiliser de
manière optimale.

10.21 : La classe TPanel

Le composant de type TPanel ( en français : volet ou panneau ) est un composant que
l'on utilise souvent pour réaliser des interfaces complexes. Sa caractéristique principale est
qu'il peut servir de "container" à d'autres composants. Ceci permet d'agir directement sur ce
composant lorsque l'on souhaite agir sur l'ensemble des composants.

Page X.11
 Les principaux composants

Un composant de type TPanel peut servir à créer des "cadres" dans lesquels d'autres
contrôles peuvent ensuite être placés. Il peut aussi être utilisé comme base pour créer une
palette d'outils, une barre d'icônes ou une barre d'état.

 Le contrôle TPanel doit être placé sur la fiche avant les contrôles qu'il
contiendra. Cela étant réalisé :
- Si le cadre est déplacé, tous les composants qu'il contient sont déplacés en
même temps.
- Il est possible ensuite d'aligner ces différents contrôles par rapport au cadre
TPanel en utilisant la palette d'alignement.

 Outre le fait que le composant sert de container aux composants qu'il contient,
il y a "propagation" de certaines de ses propriétés :
- Lorsque l'on déplace ce composant, tous les composants inclus sont
déplacés.
- La palette d'alignement agit sur les composants inclus par rapport aux
dimensions du container.
- Les modifications des propriétés Visible et Enabled s'appliquent d'un seul
coup au container et à tous les composants inclus.
- Les propriétés Color, Font, CTL3D sont elles aussi propagées.

La palette d'alignement :

Lorsque plusieurs composants sont placés sur une feuille, ou à l'intérieur d'un
composant TPanel, il est possible de les aligner rapidement grâce à la palette
d'alignement ( on peut aussi les positionner un par un mais c'est beaucoup plus
fastidieux ).

Pour ce faire, il faut d'abord sélectionner les composants que l'on souhaite aligner.
Pour cela ils doivent être sélectionnés à la souris un par un en maintenant la touche
'Shift' enfoncée.

Page X.12
 Les principaux composants

10.211 / Principales propriétés :

Align Positionne le composant à l'intérieur de la fenêtre

Alignment Positionne le texte ( Caption ) du composant.
BevelInner Permet de spécifier l'aspect des biseaux des bordures du
BevelOuter composant. En jouant sur l'ensemble des possibilités
proposées on peut créer des interfaces soignées.
BevelWidth
BorderStyle Propriétés permettant de jouer sur l'aspect des bordures.
BorderWidth

 La propriété Align permet de définir l'alignement d'un cadre par rapport à

la fiche. Il est possible d'aligner les volets pour que leur position relative
dans la fiche soit toujours identique, même si l'utilisateur redimensionne la
fiche.

On peut alors concevoir une fiche constituée de 3 composants TPanel :

- Un sera positionné tout en haut avec la propriété Align = alTop ( ce
qui aura pour effet de lui faire occuper toute la partie supérieure de la
fiche, quel que soit les redimentionnements ultérieurs de la fenêtre ).
- Un sera positionné en bas de la fiche avec la propriété Align =
alBottom ( il occupe donc tout le bas de la fiche ).
- Un sera positionné entre les deux précédents avec la propriété Align
= alClient. Il est alors redimentionné automatiquement pour occuper
tout l'espace disponible entre les deux cadres précédents.

Il n'y a plus qu'à redimentionner éventuellement l'épaisseur des divers

cadres puis de donner un aspect "3D" aux différentes bordures ( avec
les propriétés Bevel... et Border .... ) pour disposer d'une application
avec barre d'icônes et barre d'état en bas.

Pour construire une barre d'outils ou une palette d'outils, il suffit d'ajouter
des turbo-boutons ( TSpeedButton ) au cadre du haut ainsi que tout
autre contrôle utile.

 Outre le composant TForm, il existe d'autres composants qui comme

TPanel peuvent servir de containers à d'autres composants
(TGroupBox, TRadioGroup, TNotebook, TTabbedNotebook ). Ces
composants reprennent les caractéristiques propres aux containers.

 L'utilisation conjointe de plusieurs TPanel, rendus actifs et visibles à

tour de rôle, peut être un moyen efficace pour éviter la multiplication
excessive des fenêtres. Néanmoins dans ce cas l'utilisation du
composant TNotebook est encore plus efficace.

10.22 : La classe TBevel

Comme le composant de type TPanel, un composant de type TBevel permet de réaliser

des cadres au sein de l'interface. Mais ce n'est pas un container pouvant regrouper d'autres
composants.

Page X.13
 Les principaux composants

TBevel est surtout utilisé pour créer des lignes de séparations et des cadres sur
l'interface. Les différents possibilités de configurations sont accessibles à l'aide des propriétés
Shape et Style.

 Le fait de placer un composant TBevel en tant que cadre au tour d'un ou

plusieurs composants risque d'empêcher l'accès à ces derniers si on n'a
pas positionné le TBevel " en-dessous" ( utiliser l'option "Mettre en arrière
plan" dans le menu Edition de C++ Builder ).

10.23 : La classe TLabel

Un composant de ce type permet l'affichage de texte à l'écran. En règle générale, ce

texte ( qui correspond à la propriété Caption ) sert de titre à un autre composant. Il ne peut pas
être modifié par l'utilisateur lors de l'exécution (mais il peut l'être par programmation ).

10.231 / Principales propriétés :

Alignment Aligne le texte à l'intérieur de la surface du composant.

AutoSize Réajuste automatiquement la taille du composant en fonction
de celle du texte qu'il contient.
Si Autosize = False, le texte risque d'être tronqué.
FocusControl Lie le contrôle TLabel à un autre contrôle de la fiche
Transparent Permet de rendre le fond du contrôle transparent ou non.
Intéressant pour placer TLabel au dessus d'un objet image.
Worwrap Lorsque cette propriété est à True, permet de réaliser du texte
sur plusieurs lignes.

TLabel est un composant dérivé de TGraphicControl : il ne peut donc pas avoir le

focus. Par contre, il peut être associé à un composant susceptible de recevoir le focus
de manière à pouvoir utiliser les raccourcis clavier pour rendre actif le composant
"focusable".

Exemple :

Déposer un composant TLabel avec la propriété Caption = "&Nom : ".

Déposer à coté un composant TEdit avec la propriété Text = "" ( vide ).

Initialiser la propriété FocusControl du TLabel avec le nom de la zone d'édition .

A l'exécution, le fait d'utiliser le raccourci clavier 'Alt + N' rend la zone
d'édition active.

10.24 : Les blocs-notes

C++ Builder propose d'emblée la possibilité de réaliser des interfaces utilisant des
"blocs-notes" à onglets.
Un bloc-notes est constitué de plusieurs surfaces superposées. Chaque surface est un
container à composants. Une seule surface est active et visible à un moment donné. On peut
choisir la surface à activer :
- Par programmation ;
- Par action de l'utilisateur sur un ensemble d'onglets.

Page X.14
 Les principaux composants

C++ Builder propose deux méthodes pour constituer des blocs notes à onglets :

- L'utilisation d'un composant de type TTabbedNotebbok permet de constituer

simplement ce type d'objet. Néanmoins cela se traduit par des possibilités
d'utilisation limitées.
- L'utilisation conjointe de composants de types TNotebook et TTabset permet
de réaliser des blocs notes plus puissants mais plus complexes à programmer.

10.3 : Les menus

Les menus font partie des éléments standards de l'environnement Windows. Ils sont en
fait constitués de deux parties distinctes :
- Un menu principal affiché en haut de la fenêtre de l'application ( juste en dessous de
la barre de titre ) ;
- Des menus déroulants qui s'affichent lorsque l'on clique sur une des rubriques du
menu principal et qui contiennent un nombre variable de rubriques ( dits items ).

 Chaque rubrique d'un menu déroulant peut ouvrir un sous-menu particulier.

 Il existe aussi des menus flottants qui peuvent apparaître à des emplacements
divers de la fenêtre et, souvent, être déplacés.

C++ Builder propose deux composants permettant la création aisée de menus

complexes. Ces deux composants font partie du premier onglet de la barre de composants. Ce
sont des composants "non-visuels", c'est à dire que l'on peut les poser n'importe où sur la

Page X.15
 Les principaux composants

feuille de conception, ils n'apparaîtront pas à l'exécution : les menus seront alors attachés à la
barre de titre.

10.31 : Le concepteur de menu

L'utilisation du composant 'Main Menu' permet d'accéder, en cliquant sur le bouton
droit de la souris après l'avoir déposé sur la fiche ( ou en passant par la propriété Items du
composant ), à un utilitaire très pratique permettant de réaliser la totalité du menu : le
concepteur de menu.

 Une des premières choses à faire est de donner un nom au menu ( propriété
Name ).

A l'ouverture, le concepteur présente un menu vierge dont la première case ( la 1°

rubrique du menu principal ) est sélectionnée. Il suffit alors de remplir la propriété Caption
(soit directement en sélectionnant la zone concernée du menu, soit dans l'inspecteur d'objet )
par le nom de la rubrique choisi, pour que la rubrique soit créée.

 Le fait d'utiliser la touche ' flèche droite ' valide l'entrée et prépare une
nouvelle rubrique dans le menu principal.
De même la touche ' flèche bas ' valide l'entrée et prépare une nouvelle
rubrique dans le menu déroulant associé.

 Si l'on entre le caractère ' - ' en tant que 'Caption', une barre de séparation est
générée directement dans le menu concerné.

 Les rubriques qui ouvriront une boîte de dialogue doivent être terminées par
trois points ' ...' .

 A la conception il y a toujours une case de vide en fin de chaque menu

déroulant ainsi qu'au bout du menu principal. Ces cases vides n'apparaissent
pas à l'exécution.

Aspect du concepteur de menu

Page X.16
 Les principaux composants

10.311 / Modifications d'un menu existant :

- Pour insérer une rubrique il faut se positionner sur la rubrique qui suivra la rubrique
à insérer et appuyer sur la touche ' Inser '. Une rubrique vierge s'insère devant cette
rubrique.
- De même, si l'on souhaite effacer une rubrique il faut se positionner dessus et
appuyer sur la touche ' Suppr '.
- On peut déplacer les différentes rubriques en réalisant un "glisser- déplacer" avec la
souris.

10.312 / Utilisation de "raccourcis clavier" :

- Il est possible d'utiliser le caractère ' & ' pour définir les accélérateurs qui seront
reconnus par le système.
- Certaines rubriques peuvent être associées à des combinaisons de touches. Il faut
alors renseigner la propriété 'ShortCut' de la rubrique concernée par la combinaison
de touche à prendre en compte ...... ce qui rajoute automatiquement cette
combinaison de touche en regard du titre de la rubrique.

10.313 / Création de sous-menu :

Pour créer un sous-menu à partir d'une rubrique d'un menu déroulant il faut :
- Sélectionner l'élément du menu concerné.
- Appuyer sur la combinaison de touches ' Ctrl + Flèche Droite' pour créer la
première marque du sous-menu à l'aplomb de la rubrique.
Une flèche est créée dans le menu déroulant pour indiquer qu'il existe un sous-menu
pour cette rubrique.
- Renouveler les opérations habituelles pour composer le sous-menu.

 Le Turbo-menu, accessible à l'aide du bouton droit de la souris, propose

l'utilisation de modèles de menus prédéfinis.

 Une fois un menu constitué il est toujours possible de la sauvegarder en

tant que modèle, en vue d'une utilisation ultérieure. Pour cela il faut
ouvrir le menu contextuel attaché au composant TMenu en cliquant sur
celui-ci avec le bouton droit de la souris.

10.32 : Le composant de type TMenuItem

On constate que chaque élément du menu créé par le concepteur de menu est un objet
particulier, de type TMenuItem qu'il est possible de manipuler individuellement.

 Principales propriétés :

Checked Affiche ou non une coche à coté du libellé de la rubrique

Count Nombre d'élément d'un menu principal ( uniquement pour
les TMenuItems du menu principal ).

Page X.17
 Les principaux composants

Items [ i ] Permet d'accéder en programmation à un élément d'un sous

menu rattaché.
ShortCut Raccourci clavier rattaché à l'élément du menu

 Événement associé à un élément du menu :

Les différents éléments TMenuItem d'un menu ne réagissent qu'à un seul type
d'événement : l'événement OnClick qui correspond à un click sur le bouton gauche
de la souris.

Pour chaque élément il n'y a donc qu'à créer un gestionnaire d'événement associé
pour réaliser les fonctionnalités souhaitées.

10.33 : Manipulation des menus par programmation

Par programmation il est possible de modifier l'aspect des différents menus en jouant
principalement sur les valeurs des propriétés Enabled, Checked et Visible des différents
objets TMenuItem :
- La propriété Enabled rend actif ou non, selon sa valeur booléenne, l'élément de
menu concerné. Lorsque l'élément est inactif, il apparaît grisé et ne réagit plus aux
clicks souris.
- La propriété Visible cache ou non un élément du menu.
- La propriété Checked, lorsqu'elle est à True, permet d'ajouter une coche à gauche
de la rubrique pour indiquer qu'elle est sélectionnée.

Option->Checked = ! Option->Checked ;
/* Cette ligne insérée dans le gestionnaire d'événement
permet d'afficher ou de supprimer la 'coche' à chaque clic
sur la rubrique Option */

- La propriété Items permet d'accéder à un élément du menu :

Par exemple, le code suivant rend indisponible un sous-élément du menu :

Fichier->Items [ 2 ]->Enabled = False ;
/* Rend inactif le 3° élément du menu Fichier */

On peut par ailleurs insérer ou supprimer des éléments de menu, à l'exécution, en

utilisant les méthodes Insert( ) et Remove( ).
La méthode Add( ) ajoute un élément de menu en fin de menu.

10.34 : Les menus "Pop-up"

Le deuxième composant de la palette permet de concevoir des menus surgissants "Pop-
Up". La création de tels menus se fait selon les mêmes principes que ceux utilisés pour créer
un menu principal.

Un menu "Pop-Up" s'affiche lorsque l'on appuie avec le bouton droit de la souris sur
un composant ou sur le fond de la fenêtre.
Il faut pour cela que le menu ait été assigné au composant ou à la fiche en initialisant
la propriété PopupMenu du composant concerné avec le nom du menu surgissant.

Page X.18
 Les principaux composants

Par défaut ( propriété AutoPopup = True ) le menu s'affiche lorsque l'on clique avec
le bouton droit de la souris. Mais l'on peut aussi l'activer en invoquant la méthode PopUp ( )
qui en plus permet de spécifier l'endroit où le menu va s'afficher.

10.4 : Les boutons

Les boutons sont les composants privilégiés mis à la disposition des utilisateurs pour
spécifier leurs choix et influencer le déroulement de l'application.

C++ Builder propose trois types de composants différents pour créer des boutons : les
classes TButton, TBitBtn et TSpeedButton. Chacun, outre des caractéristiques communes,
propose des spécificités.

Sous une apparente similitude il faut noter une grosse différence entre les TButtons et
les TBitBtns, d'une part, et les TSpeedButtons, d'autre part : les premiers sont des
composants dérivés de la classe TWinControl ( ils peuvent donc acquérir le focus et sont
gérés par un handle ) alors que les TSpeedButtons dérivent de TGraphicControl ( pas de
focus possible, pas de handle ).

 Lorsque l'on hésite à choisir entre un TBitBtn et un TSpeedButton il faut se

rappeler qu'un TSpeedButton est plus économe en ressources. Par contre
le fait qu'il ne puisse pas obtenir le focus peut être un handicap ( en
particulier dans la création de boites de dialogue ).

 Le fait d'utiliser un '&' dans la propriété Caption d'un TButton ou d'un

TBitBtn fait que le gestionnaire d'événement associé à son événement
OnClick peut être activé par le raccourci clavier ainsi constitué.

10.41 : Principales propriétés :

Propriété Button BitBtn SpBtn

AllowAllUp X Spécifie si tous les boutons d'un
groupement de SpeedButton peuvent
être déselectionnés.
Cancel X X Indique si le bouton est un bouton
d'annulation. Si Cancel = True,
l'utilisation de la touche Echap appelle
le gestionnaire d'événement associé à
l'événement OnClick du bouton.
Default X X Indique si le bouton est le bouton par
défaut. Si Default = True, l'utilisation
de la touche Enter appelle le
gestionnaire d'événement associé à
l'événement OnClick du bouton.
Down X Indique si le composant s'affiche
enfoncé ou non
Glyph X X Image affichée sur le bouton
GroupIndex X Permet de définir des groupes de
SpeedButton
Kind X Indique le type de BitButton
Layout X X Positionne l'image sur le bouton
Margin X X Distance entre l'image et la limite du
bouton
ModalResult X X Utilisée si le choix du bouton doit
fermer une fiche modale.

Page X.19
 Les principaux composants

Spacing X X Distance entre l'image et le texte du

bouton
Style X X Détermine l'aspect du bouton

10.42 : Spécificités des composants de type TBitBtn

Le composant de type TBitBtn est un composant directement dérivé du composant de

type TButton dont il reprend les principales caractéristiques. Il ajoute une petite image bitmap
à coté de la légende du bouton. Cette image sert à repérer facilement l'action de chaque bouton.

Les propriétés spécifiques à ce type de bouton, Kind et Glyph permettent de définir

quelle image sera affichée. Ces deux propriétés fonctionnent ensemble :

¤ La propriété Kind permet de décider si l'image affichée sera :

- D'un type prédéfini par C++ Builder, ce qui permet d'afficher des images
standards : les types prédéfinis dépendent de la valeur de la propriété Kind :

 Bien prendre en compte que le fait de choisir un type de bouton

particulier fait que certaines actions sont réalisées automatiquement
selon la valeur choisie ( en particulier fermeture de la fenêtre ou de la
boite de dialogue ). Cela du fait que la valeur de la propriété
ModalResult est initialisée à une autre valeur que mrNone, et que les
propriété Cancel et Default sont, le cas échéant, positionnées.

- Dans le cas où la propriété Kind = bkCustom ( c'est à dire que l'on utilise un
bouton qui n'est pas prédéfini, et qui n'a donc pas de comportement par défaut )
il faut charger - grâce aux '...' qui apparaissent dans la propriété Glyph -
l'image désirée. L'invocation de cette propriété entraîne le lancement de l'éditeur
d'image.

10.421 / Boutons prédéfinis :

bkAbort

bkAll : Prend le focus ( bouton par défaut ) lorsqu'il existe.

bkCancel : Utilisé dans les boites de dialogue. Ferme la boite

quand il est utilisé.
bkClose : Utilisé au niveau d'une fiche. Ferme la fenêtre quand il
est utilisé.
bkHelp

bkIgnore : Son utilisation permet à l'utilisateur de poursuivre après

l'apparition d'une erreur.
bkNo : Utilisé dans les boites de dialogue. Ferme la boite quand il
est utilisé.
bkOK : Utilisé dans les fiches et les boites de dialogue. Prend le
focus et ferme la boite ou la fenêtre quand il est utilisé.

bkRetry

bkYes : Utilisé dans les boites de dialogue. Prend le focusPage

et ferme
X.20
la boite quand il est utilisé.
 Les principaux composants

 Les images bitmap des boutons prédéfinis ne font pas partie de la

bibliothèque d'images fournie avec C++ Builder. Si l'on souhaite
néanmoins utiliser ces images il faut :
- Utiliser un TBitBtn que l'on initialise, avec Kind, de manière à ce qu'il
ait l'aspect du bouton prédéfini contenant l'image désirée.
- Appeler l'éditeur de composant. L'image apparaît alors.
- Enregistrer l'image sous un nom distinct.
On peut alors effacer le composant utiliser puis en déposer un autre
avec lequel on pourra charger l'image nouvellement créée.

10.422 / Utilisation de la propriété ModalResult :

La propriété ModalResult ( contenue dans les TButton et les TBitBtn ) permet de

spécifier des comportements par défaut des boutons.
Par défaut cette propriété est initialisée à mrNone ( = pas de comportement par défaut ).

Si, par exemple, une fenêtre a été créée - en mode modal - avec deux boutons,
'OK' et 'Annuler', il faut initialiser la propriété ModalResult à mrOK pour le bouton
'OK' et à mrCancel pour le bouton 'Annuler'.
Lorsque l'utilisateur choisit l'un ou l'autre de ces boutons, l'état modal de la boîte de
dialogue s'achève car la valeur de ModalResult est supérieure à mrNone et la
fenêtre disparaît. En utilisant ModalResult, il n'est pas nécessaire d'écrire un
gestionnaire d'événement uniquement pour fermer la boîte de dialogue.

La valeur de ModalResult initialise la valeur de retour de la fonction ShowModal

utilisée pour afficher la fenêtre. On peut donc tester cette valeur dans la fenêtre
mère pour savoir quel bouton a été utilisé.

 Lorsqu'on utilise un TBitbtn et que sa propriété Kind n'est pas bkCustom,

la propriété ModalResult prend souvent une valeur différente de
mrNone. Si l'on ne veut pas que le bouton ait le comportement prédéfini
habituel, il faut repositionner la propriété à ModalResult = mrNone.

 Il est toujours possible d'affecter une valeur quelconque à ModalResult

(la valeur doit être assez grande de manière à ce qu'elle ne corresponde
pas à une valeur prédéfinie ). On peut alors tester cette valeur au retour
dans la feuille mère.

10.43 : Les TSpeedButton et les barres d'icônes

Les composants TSpeedButton sont surtout utilisés pour réaliser des barres d'icônes,
permettant un accès rapide aux principales fonctionnalités proposées par un menu.

Grâce à ce composant, C++ Builder permet de réaliser facilement des barres d'icônes.
Dans un premier temps elles peuvent être fixes mais il est possible d'imaginer des barres
configurables et flottantes.

Page X.21
 Les principaux composants

10.5 : Composants permettant la saisie de texte

C++ Builder propose deux composants permettant la saisie de texte : le composant de
type TEdit et le composant de type TMemo.

Il existe d'autres composants aux possibilités plus étendues mais plus complexes à
manipuler.

10.51 : Class TEdit

La classe TEdit permet de disposer de composants permettant la saisie ou l'affichage de
texte ( jusqu'à 255 caractères ) dans une zone de saisie qu'il est possible de configurer ( taille,
position, fonte, couleur ). Sa propriété principale est la propriété Text qui contient le texte
affiché ou saisi.

Principales propriétés :

CharCase Permet de forcer les affichage en minuscules ou en

majuscules
MaxLength Indique le nombre maximal de caractères que l'on peut
saisir. Si MaxLength = 0 il n'y a pas de contrôle de
longueur.
Modified Indique si le texte a été modifié ou non
PasswordChar Permet de définir un caractère qui sera affiché en lieu et
place des autres caractères lorsque l'on souhaite
réaliser une saisie sécurisée.
ReadOnly Permet de placer le composant en lecture seule
( affichage sans possibilité de saisie ).
Text Texte affiché ou saisi.

 Une zone de saisie peut avoir le focus mais ne peut être activée par une touche
spécifique. Pour cela il faut la lier avec un composant TLabel.

 Lorsque l'on réalise un formulaire, contenant plusieurs zones de saisie, penser

à vérifier l'ordre d'activation afin que l'utilisateur puisse passer de l'une à l'autre
en appuyant sur la touche Tab.

 Conformément aux standards Windows, la validation d'une saisie ne se fait pas

à l'aide de la touche Enter.

La méthode Clear ( ) permet d'effacer le texte contenu dans le composant.

10.52 : Le composant TMemo

Ce composant permet de réaliser des saisies ou des affichages multilignes. La taille du
texte géré ne peut dépasser 32 Ko.
TMemo est surtout utilisé pour réaliser des éditeurs de texte simples.

Page X.22
 Les principaux composants

10.521 / Principales propriétés :

Alignment Aligne le texte au sein du composant

BorderStyle Type de bordure
Lines Permet de gérer les lignes du texte individuellement
MaxLenght Longueur maximale du texte
Modified Indique si le texte a été modifié ou non
ReadOnly Place le composant en mode "lecture seule"
ScrollBars Affiche ou non le ou les ascenseurs.
WantReturn Détermine si les retours chariot sont acceptés
WordWrap Autorise ou non le retour à la ligne automatique en fin de
ligne

10.522 / Principales méthodes :

Clear ( ) Efface le contenu du mémo

LoadFromFile Charge un fichier dans le mémo
SaveToFile Sauvegarde le contenu du mémo dans un fichier
CopyToClipBoard Envoi ou réception de texte vers ou en provenance du
CutToClipBoard presse papiers.
PasteFromClipBoard

Chaque ligne du composant est gérée ( via la propriété Lines ) comme un objet
particulier ayant ses propres propriétés et méthodes.

On peut, en particulier charger un fichier texte :

void __fastcall TForm1::Button1Click(TObject *Sender)

{
if ( OpenDialog1->Execute ( ))
Memo1->Lines->LoadFromFile ( OpenDialog1->FileName );
}

/* Le fichier sélectionné grâce à la boite de dialogue

OpenDialog1 est chargé ( s'il contient du texte ) en une
seule opération. */

10.6 : Les composants permettant de réaliser des

choix
Les normes actuelles de programmation privilégient le fait que l'utilisateur doit pouvoir
choisir dans une liste de choix les données qu'il souhaite utiliser au lieu de les lui faire saisir.
C++ Builder propose un ensemble de composants permettant de réaliser des choix
selon différentes méthodes.

Page X.23
 Les principaux composants

10.61 : Classes TList et TComboBox

C++ Builder propose d'abord deux composants distincts pour réaliser des listes
d'éléments, contenues dans des boites, parmi lesquelles l'utilisateur peut faire – à la souris - son
choix :
- Le composant de type TListBox qui affiche l'ensemble des éléments d'une liste
prédéfinie ;
- Le composant de type TComboBox qui ne présente, au repos, qu'une zone de saisie
mais qui se déploie et affiche l'ensemble des choix prédéfinis lorsqu'on clique sur la
flèche située à sa droite.

La propriété principale de ces deux composants est la propriété Items, c'est à dire
l'ensemble des éléments, de type Strings, composant les "lignes" de la liste.
Items [ i ] permet d'accéder au ième –1 élément de la liste.
C'est grâce à cette propriété que l'on peut gérer la liste ( méthodes Add( ), Delete,( )
Insert( ), etc.).

10.611 : Principales propriétés

BorderStyle Style de la bordure.

Canvas Permet d'afficher des graphiques dans la liste.
ItemIndex Indique la ligne actuellement sélectionnée ( surbrillance ).
Items [ i ] Permet de gérer chaque entrée de la liste de manière
particulière.
MultiSelect Autorise les multiples sélections.
Selected [ i ] Indique si l'entrée est sélectionnée.
SelectedCount Nombre d'entrées sélectionnées.
Sorted Affiche la liste triée ou non.

La propriété Count permet de connaître le nombre d'éléments de la liste.

La propriété ItemIndex permet de connaître la position de l'élément sélectionné ( = -1
si aucun élément est sélectionné, 0 correspond au premier élément ).

 Pour une ComboBox la propriété Text permet, en plus, d'accéder à l'élément

placé dans la zone de saisie ( après sélection d'un élément de la liste ou par
initialisation interne ).

10.612 : Principales manipulations

¤ Lors de la phase de conception il est possible d'initialiser un composant de type
TListBox ou TComboBox en accédant à un éditeur de liste de chaînes qui
apparaît lorsque l'on active la propriété Items dans l'inspecteur d'objet.

On utilise cette possibilité lorsque l'on souhaite proposer à l'utilisateur une liste
finie de choix.

Page X.24
 Les principaux composants

¤ On peut charger directement un fichier texte ( puis le sauvegarder ) en utilisant les

méthodes LoadFromFile( ) / SaveToFile( ) de la propriété Items. Les différents
retours chariot contenus dans le fichier texte tiennent lieu de délimiteurs d'items.

¤ On ajoute ou on supprime des entrées dans les listes en utilisant les méthodes
Add( ) ou Delete( ) de la propriété Items.

ListBox->Items->Add ( Edit1->Text ) ;
/*Ajout du contenu de la zone d'édition Edit1 dans la
liste */
ListBox->Items->Delete ( ListBox->ItemIndex ) ;
// Suppression de la ligne qui est sélectionnée

¤ Il est possible d'empêcher l'insertion de lignes déjà existantes.

¤ On peut utiliser la méthode IndexOf de l'objet Items. Cette fonction renvoie l'indice
de l'item correspondant à la chaîne passée en paramètre si celle-ci existe déjà dans la
liste et -1 dans le cas contraire.

If ( ListBox->Items->IndexOf ( Edit->Text ) = -1 )
ListBox->Items->Add ( Edit->Text )
else
MessageDlg ( "L'élément existe déjà !!!", mtWarning,
TMsgDlgButtons() << mbCancel,0 ) ;

10.62 : Présentation d'options

C++ Builder propose quatre composants permettant de proposer des choix divers à
l'utilisateur : Deux sont des composants "simples" : les "cases à cocher" ( TCheckBox ) et
les "boutons radio" ( TRadioButton ). Les deux autres permettent de grouper des composants
de ces types de base : TGroupBox permet de regrouper toutes sortes de composants et
TRadioGroup ne regroupe que des boutons radios afin de faciliter leur gestion.

10.621 / Les cases à cocher :

Une case à cocher ( classe TCheckBox ) permet de présenter une option à l'utilisateur.
Ce dernier peut la cocher pour sélectionner l'option ou supprimer la coche pour la
desélectionner.
Les différentes cases à cocher affichées ont un comportement indépendant ( il peut y
avoir plusieurs cases cochées ).

C'est la propriété Checked ( ou la propriété State ) qui indique si la case est cochée
ou non : lorsque l'utilisateur coche ou décoche une case à cocher, la valeur de la
propriété Checked change et l'événement OnClick se produit.

Il est possible de désactiver une case à cocher en mettant la propriété Enabled à False.

 Checked vaut False si la case est desélectionnée ou désactivée.

10.622 / Les boutons radio :

Page X.25
 Les principaux composants

Comme les cases à cocher, les boutons radios ( classe TRadioButton ) permettent de
présenter un ensemble d'options. Mais cette fois-ci, les options s'excluent mutuellement
( ce qui veut dire qu'un seul bouton radio peut être validé en même temps ).

C'est la propriété Checked ( ou la propriété State ) qui permet de modifier l'apparence

d'un bouton radio ( sélectionné ou non ). Un bouton radio peut être désactivé via la
propriété Enabled.

10.623 / Le composant "groupe radio" :

Le composant de type TRadioGroup simplifie la synchronisation entre les différents
boutons radio.

A l'exécution, lorsque l'utilisateur sélectionne un bouton radio dans la boîte groupe,

le bouton qui l'était précédemment est automatiquement desélectionné.

A la conception, les boutons radio sont ajoutés à la boîte via la propriété Items qui
appelle l'éditeur de chaînes de caractères ( le même que celui utilisé dans TMemo,
TListBox ou TComboBox ) : chaque chaîne de la propriété Items provoque l'affichage
d'un bouton radio dans la boîte groupe, avec la chaîne entrée comme intitulé du bouton
correspondant.
On peut ajouter ou supprimer dynamiquement des boutons radios en utilisant les
possibilités offertes par la propriété Items.

La propriété ItemIndex détermine le bouton radio actuellement sélectionné.

Il est possible d'afficher les boutons radio sur une ou plusieurs colonnes en définissant
la valeur de la propriété Columns.

On accède à un élément particulier de la boite par la ligne :

RadioGroup->Items [ i ]

L'élément sélectionné est accessible via l'expression :

RadioGroup->Items [ RadioGroup->ItemIndex ]

 TRadioGroup ( comme TGroupBox ) est un composant "container" : il en

possède toutes les caractéristiques ( diffusions de certaines de ses propriétés ).

10.7 : Les boites de messages

Il est toujours possible de créer une fenêtre spécifique pour afficher un message ou
poser une question à l'utilisateur.
Mais cette solution est lourde et consommatrice en ressources. Il est préférable, dans de
nombreux cas, d'utiliser directement des possibilités proposées par Windows permettant la
création rapide de boîtes de messages.

Les boîtes de messages fonctionnent toutes en mode modal. Elles sont très pratiques
pour afficher diverses informations, avertissements et messages d'erreur ou pour demander à
l'utilisateur la conduite à tenir face à une alternative.

Page X.26
 Les principaux composants

Pour accéder à une boîte de message il suffit d'invoquer des fonctions particulières qui
réalisent la totalité des opérations d'affichage.

10.71 : Fonction ShowMessage ( const AnsiString Msg )

Il s'agit de la boîte de message la plus simple. Elle affiche une boite centrée dans la
fenêtre comportant le texte passé en paramètre ( limité à 255 caractères ) et un bouton 'OK'
pour fermer la fenêtre.

 Son défaut majeur c'est qu'elle affiche le nom du programme dans sa barre
de titre au lieu d'un titre plus "informatif".

 La fenêtre est automatiquement dimensionnée à la taille de la chaîne à

afficher ( avec éventuellement affichage sur plusieurs lignes ).

 On peut invoquer aussi directement la procédure d'affichage de Windows

en appelant la méthode MessageBox de l'objet TApplication. Les
possibilités de configuration de cette méthode sont plus importantes que
celles de ShowMessage.

10.72 : Fonction MessageDlg ( )

Cette boîte de message est plus complexe car :
- Elle affiche un message d'avertissement avec éventuellement une icône prédéfinie ;
- Elle affiche un nombre variable de boutons proposant un choix à l'utilisateur.
La valeur renvoyée par la fonction indique le choix réalisé par l'utilisateur.

Le prototype de la fonction est :

extern PACKAGE int __fastcall MessageDlg ( const AnsiString Msg,

TMsgDlgType DlgType, TMsgDlgButtons Buttons, int HelpCtx );

Les différents paramètres de la fonction permettent de configurer son apparition à l'écran :

¤ Msg : Message à afficher .

¤ DlgType : Détermine l'icône qui apparaîtra à coté du message. Les différentes valeurs
possibles sont :

mtWarning Une boîte de message contenant une icône point d'exclamation

jaune.
mtError Une boîte de message contenant une icône de stop rouge.
mtInformation Une boîte de message contenant une icône "i" bleu.
mtConfirmation Une boîte de message contenant une icône point d'interrogation
vert.
mtCustom Une boîte de message ne contenant pas d'image. Le titre de la
boîte de dialogue est le nom du fichier exécutable de
l'application.

¤ Buttons : Détermine le ou les boutons qui apparaîtront dans la boîte de message.

Page X.27
 Les principaux composants

L'initialisation de ce paramètre se fait grâce à l'opérateur <<, redéfini pour l'occasion, en

utilisant la syntaxe ( tordue !!! ) suivante :

TMsgDlgButtons() << mbYes << mbNo // boutons Yes et No

Les différentes valeurs possibles sont :

mbYes Un bouton avec une marque verte et le texte 'Oui'.

mbNo Un bouton avec un cercle rouge barré et le texte 'Non'.
mbOK Un bouton avec une marque verte et le texte 'OK'.
mbCancel Un bouton avec un X rouge et le texte 'Annuler'.
mbHelp Un bouton avec un point d'interrogation cyan et le texte 'Aide'
mbAbort Un bouton avec une marque rouge et le texte 'Abandonner'.
mbRetry Un bouton avec deux flèches circulaires vertes et le texte
'Réessayer'.
mbIgnore Un bouton avec un bonhomme vert marchant et le texte 'Ignorer'.
mbAll Un bouton avec une double marque verte et le texte 'Tous'.

Outre les valeurs individuelles de l'ensemble, il existe aussi trois ensembles constants
prédéfinis correspondant aux combinaisons les plus courantes :

mbYesNoCancel Un ensemble plaçant les boutons Oui, Non et Annuler.

mbOkCancel Un ensemble plaçant les boutons OK et Annuler.
mbAbortRetryIgnore
Un ensemble plaçant les boutons Abandonner, Réessayer et
Ignorer.

¤ HlpCtx : Permet de lier la boîte avec une aide en ligne.

Paramètre facultatif ( initialisé à 0 ).

 La valeur renvoyée peut prendre les valeurs suivantes : mrNone, mrOk,

mrCancel, mrAbort, mrRetry, mrIgnore, mrYes, mrNo, mrAbort, mrRetry,
mrIgnore, mrAll.

 La fonction MessageDlgPos ( ) est pratiquement identique mais permet de

positionner la boite de dialogue à l'écran.

Exemple d'utilisation :

void __fastcall TForm1::Button3Click(TObject *Sender)

{
if ( MessageDlg ( "Voulez vous sortir de cette boîte
évoluée ? ", mtInformation, TMsgDlgButtons() << mbYes <<
mbNo , 0 ) == mrYes )
{
MessageDlg ( "Au revoir", mtInformation,
TMsgDlgButtons() << mbOK, 0);
Close ( );
}
}

Provoque l'apparition de la boîte de dialogue :

Page X.28
 Les principaux composants

10.73 : Boites de saisie

C++ Builder propose aussi deux boites permettant la saisie d'une chaîne de caractères par
l'utilisateur.

10.731 / Fonction InputBox ( ) :

Cette fonction permet d'entrer une chaîne de caractères. Son prototype est le suivant :

extern PACKAGE AnsiString __fastcall InputBox( const AnsiString

ACaption, const AnsiString APrompt, const AnsiString ADefault );

Le paramètre ACaption indique le titre de la boîte de dialogue.

Le paramètre APrompt est le message situé au-dessus de la zone de saisie.
Le paramètre ADefault est la chaîne apparaissant dans la zone de saisie à l'ouverture de
la boîte de dialogue ( fréquemment : "" , chaîne vide ).

Si l'utilisateur choisit le bouton 'Annuler', la chaîne par défaut est renvoyée. Si

l'utilisateur choisit le bouton 'OK', la valeur de la chaîne entrée dans la zone de saisie
est renvoyée.

Exemple :

void __fastcall TForm1::Button4Click(TObject *Sender)

{
AnsiString InputString = InputBox( "Boîte de saisie",
"Invite", "Chaîne par défaut");

Affiche la boite de saisie suivante :

10.732 / Fonction InputQuery ( )

Prototype :

Page X.29
 Les principaux composants

extern PACKAGE bool __fastcall InputQuery( const AnsiString

ACaption, const AnsiString APrompt, AnsiString &Value);

Même si Value remplace Adefault le rôle des trois paramètres est identique à celui
qu'ils ont dans la fonction InputBox ( ).

Par contre, lorsque l'utilisateur entre une chaîne dans la zone de saisie puis choisit 'OK',
le paramètre Value prend la nouvelle valeur ( d'où le passage de paramètre par
variable).
La fonction InputQuery renvoie True si l'utilisateur a choisi 'OK' et False si
l'utilisateur a choisi 'Annuler' ou a appuyé sur la touche Echap.

10.8 : Accès aux boites de dialogue de Windows

10.81 : Principe d'utilisation
Il est possible d'utiliser directement, au sein d'une application C++ Builder les boites de
dialogues standards de Windows ( contenues dans COMMDLG.DLL ).
Cette possibilité évite d'avoir à recréer ce genre de dialogue. Les informations validées
par l'utilisateur sont ensuite directement utilisables dans l'application.

Les différentes boîtes sont accessibles via des composants regroupés dans l'onglet
''Dialogues' de la palette de composants. Il s'agit de :

- TOpenDialog : permet d'ouvrir un fichier, après avoir éventuellement modifié le

lecteur, le répertoire, les sous-répertoires, etc ....
- TSaveDialog : permet de sauvegarder un fichier.
- TFontDialog : permet de modifier un texte ( polices, tailles, couleurs et styles ).
- TColorDialog : permet de modifier les couleurs.
- TPrintDialog : permet d'imprimer un document après configuration de l'impression.
- TPrinterSetupdialog : permet de configurer une imprimante.
- TFindDialog : permet de rechercher un texte.
- TReplaceDialog : permet de remplacer un texte.

Toutes ces boites de dialogues sont accessibles en :

- Déposant le composant concerné (non visuel ) sur la fiche.
- En l'exécutant à partir d'un gestionnaire d'événement ( click sur un bouton ou à
partir d'un menu la plupart du temps ).

Par exemple le gestionnaire d'événement :

void __fastcall TForm1::Button5Click(TObject *Sender)

{
PrintDialog1 -> Execute ( ) ;
}

Page X.30
 Les principaux composants

Affichera la boite de dialogue suivante :

 La fonction Execute ( ) renvoie un booléen. Il est donc possible de vérifier la

bonne exécution de l'appel de la boite de dialogue :

If ( OpenDialog->Execute ( ) )
< actions ...>

10.82 : La boite de dialogue "OpenDialog "

Cette boite de dialogue est la plus utilisée et c'est celle qui demande le plus d'attention
lors de sa configuration. Elle permet à l'utilisateur de sélectionner un fichier situé dans
n'importe quel répertoire ( y compris sur un autre disque ).

On peut configurer cette boîte de dialogue dès la conception, pour qu'elle affiche
certains renseignements, grâce aux propriétés suivantes :

- DefaultExt permet d'indiquer l'extension qui sera attribuée par défaut aux fichiers
si celle-ci n'est pas explicitée.
- Filename contient le nom du fichier qui apparaît dans la zone de saisie après
sélection.

Page X.31
 Les principaux composants

- Files, accessible uniquement à l'exécution, contient la liste de tous les fichiers

affichés dans la boite de liste, après éventuellement un filtrage.
- Filter indique, grâce à une boite de dialogue spécifique, les différents masques
d'extension pouvant être proposés à l'utilisateur.
- InitialDir indique le répertoire par défaut à l'ouverture de la boite de dialogue.

 C'est la valeur de la propriété FileName qui doit être utilisée dans le reste
du programme pour réaliser les opérations d'ouverture du fichier.

10.9 : Composants divers

10.91 : Le composant TTimer

Le composant de type TTimer est très utile quand on veut réaliser certaines opérations à
des intervalles précis, en tâche de fond.

- Ces opérations sont exécutées selon la périodicité indiquée dans la propriété

Interval ( en milliseconde ).
- Elles ne sont exécutées que lorsque le composant est actif ( Enabled = True ).

Par exemple on peut vouloir indiquer dans un composant de type TPanel, utilisé en tant
que barre d'état l'action réalisée par un bouton.

Le code résultant est alors :

void __fastcall TForm1::Button1Click(TObject *Sender)

{
Panel1->Caption = "J'ai appuyé sur le bouton" ;
}

/* Mais une fois l'affichage réalisé il reste affiché tant

qu'une action sur un autre bouton au comportement similaire
ne vient pas modifier la légende */

On peut alors utiliser un composant de type TTimer initialisé à Enabled = False ( de

manière à ce qu'il ne se déclenche pas systématiquement dès le lancement de
l'application ). Le gestionnaire d'événement associé au bouton est alors :

void __fastcall TForm1::Button1Click(TObject *Sender)

{
Panel1->Caption = "J'ai appuyé sur le bouton" ;
Timer1-> Enabled = True ;
}

Le gestionnaire d'événement associé à l'événement OnTimer du timer est :

void __fastcall TForm1::Timer1Timer(TObject *Sender)

{
Panel1->Caption = "" ;
Timer1->Enabled = False ;
}
/* Désactivation du timer pour éviter qu'il ne continue à
fonctionner indéfiniment */

Page X.32
 Les principaux composants

 Même si l'utilisation des timers s'avère pratique, il ne faut pas en abuser car un
timer consomme beaucoup de ressources. En règle générale il ne faut pas
avoir plus de trois ou quatre timers dans une application.

10.92 : Jauges
Les jauges, comme les barres d'icônes et les barres d'état sont à la mode. C++ Builder
ne pouvait pas ne pas proposer des composants permettant de réaliser certaines initialisations
de variables par l'utilisation de ce type de gadget.

Deux composants de C++ Builder peuvent être utilisés : un ne réalise que des
affichages d'informations alors que l'autre est manipulable par l'utilisateur et permet réellement
la modification de valeurs.

10.921 / Le composant TScrollBar :

Ce composant est en fait l'ascenseur traditionnel du monde Windows. Mais il peut être
aisément détourné de sa fonction première pour être utilisé en tant que jauge interactive.

Principales propriétés :

Kind Permet de déterminer si l'on souhaite que la jauge soit verticale

ou horizontale.
LargeChange Détermine le pas du déplacement lorsque l'on clique sur la barre
de défilement
Max Valeurs maximale et minimale du curseur

Min
Position Position courante du curseur

SmallChange Détermine le pas du déplacement lorsque l'on clique sur les

flèches situées aux extrémités de l'ascenseur.

10.922 / Le composant CGauge :

C++ Builder propose, dans la palette 'Exemple', le composant de type CGauge
permettant de réaliser une jauge affichant des informations à l'écran.

Par rapport à la jauge précédente celle-ci n'est pas interactive ( lecture seule ) mais elle
permet d'afficher des valeurs en pourcentage et est surtout utilisée pour afficher la
progression d'une action ( chargement d'un fichier par exemple ).

 Elle n'est pas documentée dans l'aide mais son fonctionnement est facile à
comprendre.

Comme dans le cas précédent on dispose des propriétés Max et Min pour déterminer les
valeurs maximale et minimale possibles. Par contre, c'est la propriété Progress qui
permet de connaître la valeur courante ( cette valeur est affichée, en pourcentage au
milieu de la jauge ).

Page X.33
 Les principaux composants

Kind permet de définir son orientation. BackColor indique sa couleur lorsque la

progression est à 0 %, ForeColor la couleur qui occupe petit à petit la surface de la
jauge au fur et à mesure de la progression.

Page X.34