Vous êtes sur la page 1sur 106

Prise en main

Borland
C++Builder 6

pour Windows
Reportez-vous au fichier DEPLOY.TXT situ dans le rpertoire racine de votre produit C++Builder 6 pour obtenir
la liste complte des fichiers que vous pouvez distribuer en accord avec les termes du contrat de licence
de C++Builder.
Les applications mentionnes dans ce manuel sont brevetes ou en attente de brevet. Ce document ne donne
aucun droit sur ces brevets. Reportez-vous au CD du produit ou la bote de dialogue A propos.
COPYRIGHT 1983, 2002 Borland Software Corporation. Tous droits rservs. Tous les produits Borland sont
des marques commerciales ou des marques dposes de Borland Software Corporation aux Etats-Unis ou dans
les autres pays. Toutes les autres marques sont la proprit de leurs fabricants respectifs.

CPE1360WW21000 6E2R0102
0203040506-9 8 7 6 5 4 3 2 1
PDF
Table des matires
Chapitre 1 Types de projets. . . . . . . . . . . . . . . . . . . 3-9
Applications CLX . . . . . . . . . . . . . . . 3-10
Introduction 1-1 Applications serveur Web . . . . . . . . . . 3-10
Quest-ce que C++Builder ? . . . . . . . . . . . 1-1
Applications de bases de donnes . . . . . 3-11
Enregistrement de C++Builder. . . . . . . . . . 1-2
Administrateur BDE. . . . . . . . . . . . 3-12
O trouver des informations ? . . . . . . . . . . 1-3
Explorateur SQL
Aide en ligne . . . . . . . . . . . . . . . . . . 1-4
(explorateur de base de donnes) . . . 3-12
Aide F1 . . . . . . . . . . . . . . . . . . . . . 1-4
Module base de donnes . . . . . . . . . 3-12
Documentation imprime . . . . . . . . . . . . 1-6
Dictionnaire de donnes . . . . . . . . . 3-13
Services de support dveloppeur . . . . . . . . 1-6
Composants personnaliss . . . . . . . . . . 3-13
Conventions typographiques. . . . . . . . . . . 1-6
DLL . . . . . . . . . . . . . . . . . . . . . . . 3-13
Chapitre 2 COM et ActiveX. . . . . . . . . . . . . . . . 3-14
Bibliothques de types . . . . . . . . . . 3-14
Parcours rapide
de lenvironnement 2-1 Chapitre 4
Dmarrage de C++Builder . . . . . . . . . . . . 2-1 Tutoriel : cration
LEDI . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Menus et barres doutils . . . . . . . . . . . . . 2-2
dun diteur de texte 4-1
Dmarrage dune nouvelle application . . . . . 4-1
Le concepteur de fiche, la palette de composants
Dfinition des valeurs dune proprit . . . . . 4-2
et linspecteur dobjets . . . . . . . . . . . . . 2-3
Ajout de composants la fiche . . . . . . . . . . 4-3
Larborescence dobjets . . . . . . . . . . . . . . 2-4
Ajout du support pour un menu
Le rfrentiel dobjets . . . . . . . . . . . . . . . 2-5
et une barre doutils . . . . . . . . . . . . . . . 4-6
Lditeur de code . . . . . . . . . . . . . . . . . 2-6
Diffrences entre lditeur du gestionnaire
Audit de code . . . . . . . . . . . . . . . . 2-6
dactions et lditeur de liste dactions . . . 4-7
Navigation dans le code . . . . . . . . . . 2-7
Ajout dimages aux menus et la barre
La page Diagramme . . . . . . . . . . . . . . 2-8
doutils (Entreprise et Professionnel) . . . . 4-7
Visualisation du code des fiches . . . . . . . 2-9
Ajout dactions au gestionnaire dactions
Lexplorateur de classe . . . . . . . . . . . . . . 2-9
(Entreprise et Professionnel) . . . . . . . . . 4-9
Le gestionnaire de projet . . . . . . . . . . . . . 2-9
Ajout dactions standard
Liste A faire . . . . . . . . . . . . . . . . . . . . 2-10
(Entreprise et Professionnel) . . . . . . . . 4-11
Chapitre 3 Ajout dun menu
(Entreprise et Professionnel) . . . . . . . . 4-13
Programmation avec C++Builder 3-1 Ajout dune barre doutils
Cration dun projet . . . . . . . . . . . . . . . . 3-1 (Entreprise et Professionnel) . . . . . . . . 4-14
Ajout de modules de donnes . . . . . . . . 3-2 Ajout dune liste dimages et dimages
Construction de linterface utilisateur . . . . . 3-2 (dition Personnelle) . . . . . . . . . . . . 4-15
Positionnement des composants Ajout dactions la liste dactions
sur une fiche . . . . . . . . . . . . . . . . . 3-2 (dition Personnelle) . . . . . . . . . . . . 4-16
Dfinition des proprits des composants . 3-4 Ajout dactions standard la liste dactions
Ecriture du code . . . . . . . . . . . . . . . . . . 3-5 (dition Personnelle) . . . . . . . . . . . . 4-18
Ecriture des gestionnaires dvnements . . 3-5 Ajout dun menu (dition Personnelle) . . 4-20
Utilisation des bibliothques VCL et CLX . 3-6 Ajout dune barre doutils
Compilation et dbogage des projets . . . . . . 3-7 (dition Personnelle) . . . . . . . . . . . . 4-23
Dploiement des applications . . . . . . . . . . 3-8 Effacement de la zone de texte
Internationalisation dapplications . . . . . . . 3-9 (toutes ditions) . . . . . . . . . . . . . . . . . 4-24

i
Ecriture de gestionnaires dvnements . . . . 4-25 Ajout du support pour un menu . . . . . . . 5-8
Cration dun gestionnaire dvnement Ajout dun menu . . . . . . . . . . . . . . . 5-10
pour la commande Nouveau . . . . . . . . 4-25 Ajout dun bouton . . . . . . . . . . . . . . 5-12
Cration dun gestionnaire dvnement Affichage dun titre et dune image . . . . . . 5-12
pour la commande Ouvrir . . . . . . . . . 4-28 Ecriture dun gestionnaire dvnements . . . 5-14
Cration dun gestionnaire dvnement Ecriture dun gestionnaire dvnement pour
pour la commande Enregistrer . . . . . . . 4-29 la commande Mise jour immdiate ! . . 5-14
Cration dun gestionnaire dvnement Ecriture dun gestionnaire dvnement
pour la commande Enregistrer sous . . . . 4-30 pour la commande Quitter. . . . . . . . . 5-15
Cration dun fichier daide . . . . . . . . . . . 4-32 Ecriture dun gestionnaire dvnement
Cration dun gestionnaire dvnement pour fermer la fiche . . . . . . . . . . . . . 5-15
pour la commande Rubriques daide . . . 4-32
Cration dun gestionnaire dvnement Chapitre 6
pour la commande Index de laide . . . . 4-33 Personnalisation du bureau 6-1
Cration dune bote de dialogue A propos . . 4-34 Organisation de votre espace de travail . . . . . 6-1
Achvement de lapplication . . . . . . . . . . . 4-36 Agencement des menus
et des barres doutils . . . . . . . . . . . . . 6-1
Chapitre 5 Ancrage des fentres doutils . . . . . . . . . 6-2
Tutoriel : cration dune application Enregistrement des dispositions du bureau . 6-4
de base de donnes CLX 5-1 Personnalisation de la palette de composants . 6-5
Prsentation de larchitecture Organisation de la palette de composants . . 6-5
des bases de donnes . . . . . . . . . . . . . . 5-1 Cration de modles de composants . . . . . 6-5
Cration dune nouvelle application CLX . . . 5-2 Installation de paquets de composants. . . . 6-6
Installation des composants Utilisation des cadres . . . . . . . . . . . . 6-7
daccs aux donnes . . . . . . . . . . . . . . . 5-3 Ajout de contrles ActiveX. . . . . . . . . 6-8
Installation de la connexion Dfinition des options des projets . . . . . . . . 6-8
la base de donnes . . . . . . . . . . . . . 5-3 Dfinition des options de projet par dfaut . 6-8
Installation de lensemble de donnes Spcification des modles de projet
unidirectionnel . . . . . . . . . . . . . . . . 5-5 et de fiches par dfaut . . . . . . . . . . . . . . 6-8
Installation du fournisseur, Ajout de modles au rfrentiel dobjets. . . 6-9
de lensemble de donnes client Dfinition des prfrences pour les outils . . . 6-10
et de la source de donnes . . . . . . . . . 5-5 Personnalisation du concepteur de fiche. . 6-10
Conception de linterface utilisateur . . . . . . 5-6 Personnalisation de lditeur de code . . . 6-11
Cration de la grille
et de la barre de navigation. . . . . . . . . 5-7 Index I-1

ii
Chapitre

1
Introduction
Chapitre 1

Ce manuel, Prise en main, prsente lenvironnement de dveloppement


de C++Builder pour vous permettre dutiliser immdiatement le produit.
Il indique aussi o rechercher des renseignements sur lutilisation des outils
et des fonctionnalits disponibles dans C++Builder.
Le chapitre 2, Parcours rapide de lenvironnement, dcrit les principaux outils
disponibles sur le bureau C++Builder, cest--dire lenvironnement de
dveloppement intgr (EDI). Le chapitre 3, Programmation avec C++Builder,
explique lutilisation de certains de ces outils pour crer une application.
Le chapitre 4, Tutoriel : cration dun diteur de texte, vous guide, tape
par tape, dans lcriture dun programme dditeur de texte. Le chapitre 5,
Tutoriel : cration dune application de base de donnes CLX, vous guide
pas pas dans la cration dune application de base de donnes. Le chapitre 6,
Personnalisation du bureau, dcrit comment personnaliser lEDI de C++Builder
pour quil rponde vos besoins de dveloppement.

Quest-ce que C++Builder ?


C++Builder est un environnement de programmation visuel orient objet pour
le dveloppement rapide dapplications (RAD). En utilisant C++Builder, vous
pouvez, avec un minimum de codage manuel, crer de performantes applications
pour Microsoft Windows XP, Microsoft Windows 2000 et Microsoft Windows 98.
C++Builder fournit tous les outils ncessaires pour dvelopper, tester et dployer
vos applications, notamment une importante bibliothque de composants
rutilisables, une suite doutils de conception, des modles dapplications
et de fiches, ainsi que des experts de programmation.

Introduction 1-1
Enregistrement de C++Builder

Enregistrement de C++Builder
C++Builder peut tre enregistr de plusieurs faons. La premire fois que vous
lancez C++Builder aprs son installation, vous tes invit entrer un numro
de srie et une cl dautorisation. Aprs cela, la bote de dialogue
denregistrement vous propose trois possibilits :
En ligne (enregistrement et activation du logiciel).
Utilisez cette option pour effectuer lenregistrement en ligne via votre
connexion internet en cours.
Par tlphone ou navigateur Web (enregistrement et activation du logiciel).
Utilisez cette option pour effectuer lenregistrement par tlphone ou via votre
navigateur web. Si vous avez reu une cl dactivation par e-mail, entrez-la en
utilisant cette option.
Je menregistrerai ultrieurement.
Lenregistrement en ligne est le moyen le plus simple denregistrer C++Builder,
mais il ncessite quune connexion internet soit active. Si vous tes dj membre
de la Communaut Borland ou si vous avez un compte denregistrement de
logiciel, entrez simplement les informations concernant ce compte. Cela
enregistrera automatiquement C++Builder. Sinon, le processus denregistrement
vous propose le moyen de crer un compte.

1-2 Prise en main


O trouver des informations ?

La deuxime option (enregistrement et activation par tlphone ou navigateur)


est utile si la machine sur laquelle vous effectuez linstallation nest pas
connecte internet, si un pare-feu bloque les enregistrements en ligne ou si
vous avez dj reu une cl dactivation.

Remarque Sauf si vous avez une raison particulire de ne pas le faire, prfrez loption
denregistrement en ligne.

O trouver des informations ?


Vous pouvez trouver des informations sur C++Builder de diffrentes faons
(les sections qui suivent dcrivent ces sources dinformation) :
dans laide en ligne,
dans la documentation imprime,
sur le site Web de Borland et de ses services de support aux dveloppeurs.
Pour des informations sur les nouveauts de cette version, reportez-vous la
rubrique Nouveauts de laide en ligne.

Introduction 1-3
O trouver des informations ?

Aide en ligne
Le systme daide en ligne fournit des informations dtailles sur les
fonctionnalits de linterface utilisateur, limplmentation du langage, les tches
de programmation et les composants de la bibliothque de composants visuels
Borland (VCL) et de la bibliothque de composants Borland multiplate-forme
(CLX). Il contient toutes les informations se trouvant dans le Guide du dveloppeur
ainsi que de nombreux fichiers daide pour dautres lments fournis
avec C++Builder.
Pour afficher la table des matires, choisissez Aide|Aide C++Builder et Aide|
Outils C++Builder et choisissez longlet Sommaire. Pour rechercher des
informations sur les objets VCL, CLX ou dautres sujets, choisissez les onglets
Index ou Rechercher et saisissez votre requte.

Aide F1
Pour obtenir de laide sur la VCL, CLX ou tout lment de lenvironnement
de dveloppement (y compris les lments de menu, les botes de dialogue,
les barres doutils et les composants) slectionnez llment et appuyez sur F1.
Appuyez sur F1 au niveau
dun nom de proprit ou
dvnement dans
linspecteur dobjets afin
dafficher laide VCL.

1-4 Prise en main


O trouver des informations ?

Appuyez sur F1 au niveau dun mot cl ou


dun lment de la VCL dans lditeur de code.

Appuyez sur F1 au
niveau dun objet dans
le concepteur de fiche.

Appuyez sur F1 au niveau


de nimporte quelle
commande de menu, bote
de dialogue ou fentre pour
afficher laide correspondant
cet lment.

Introduction 1-5
Documentation imprime

Lappui sur le bouton Aide dans toute bote de dialogue affiche galement
une aide contextuelle.
Les messages derreur issus du compilateur et du lieur apparaissent dans une
fentre spciale situe sous lditeur de code. Pour avoir de laide sur les erreurs
de compilation, slectionnez un message dans la liste et appuyez sur F1.

Documentation imprime
Ce manuel, Prise en main, est une introduction C++Builder. Outre ce manuel,
vous disposez du manuel suivant selon la version de C++Builder que vous avez
acquise : Guide du dveloppeur.

Services de support dveloppeur


Borland offre aussi de nombreuses possibilits de support si vous avez besoin
dinformations supplmentaires. Pour des informations sur les services
de support dveloppeur de Borland, visitez le site Web ladresse
http://www.borland.fr/support.
A partir de ce site, vous pouvez accder divers groupes de discussion o les
dveloppeurs C++Builder changent informations, astuces et techniques. Ce site
propose galement une liste de livres traitant de C++Builder, dautres documents
techniques C++Builder et des foires aux questions (FAQ).

Conventions typographiques
Ce manuel utilise les types de caractres dcrits dans le tableau ci-dessous.

Types de
caractres Signification
Espacement fixe Les caractres despacement fixe reprsentent du texte qui apparat sur
lcran ou du code. Ils reprsentent aussi tout texte que vous tapez.
Gras Les mots en gras dans le texte ou les programmes reprsentent des mots
rservs ou des options du compilateur.
Italique Les mots en italique dans le texte reprsentent des identificateurs
C++Builder tels que des noms de variables ou de types. Les italiques sont
aussi utiliss pour mettre en valeur certains mots tels que les nouveaux
termes.
Touches Ce type de caractres indique une touche de votre clavier. Par exemple,
Appuyez sur Echap pour fermer un menu.

1-6 Prise en main


Chapitre

Parcours rapide de lenvironnement


Chapitre 2
2
Ce chapitre explique comment dmarrer C++Builder et donne un aperu rapide
des principales parties et des outils de lenvironnement de dveloppement
intgr (EDI).

Dmarrage de C++Builder
Vous pouvez dmarrer C++Builder de plusieurs faons :
Double-cliquer sur licne C++Builder (si vous avez cr un raccourci).
Choisir Programmes|Borland C++Builder dans le menu Dmarrer
de Windows.
Choisir Excuter dans le menu Dmarrer de Windows, puis entrer Bcb.
Double-cliquer sur Bcb.exe dans le rpertoire CBuilder6\Bin.

LEDI
Lorsque vous dmarrez C++Builder pour la premire fois, vous voyez apparatre
quelques-uns des principaux outils proposs dans lEDI. Dans C++Builder, lEDI
comprend des barres doutils, des menus, la palette de composants, linspecteur
dobjets, larborescence dobjets, lditeur de code, lexplorateur de classes,
le gestionnaire de projet et bien dautres outils. Selon ldition de C++Builder,
les caractristiques et les composants disponibles varient.

Parcours rapide de lenvironnement 2-1


Menus et barres doutils

La vue arborescente de lobjet affiche une reprsentation


hirarchique des relations parent-enfant des composants.

Palette de composants
prts tre utiliss dans
votre application.

Editeur de code
permettant de visualiser
et de modifier le code.

Concepteur de fiche contenant


une fiche vierge pour dmarrer la
conception de linterface
utilisateur de votre application.
Une application peut inclure
plusieurs fiches.

Linspecteur dobjets est utilis pour changer Lexplorateur de code montre les classes, variables
les proprits des objets et slectionner les et routines de votre unit et vous permet de naviguer
gestionnaires dvnements. rapidement.

Le modle de dveloppement C++Builder repose sur des outils bidirectionnels.


Cela signifie que vous pouvez passer alternativement des outils de conception
visuelle aux modifications du code sous forme de texte. Par exemple, aprs avoir
utilis le concepteur de fiche pour agencer les boutons et les autres lments
dune interface graphique, vous pouvez voir immdiatement le fichier fiche
contenant la description textuelle de votre fiche. De mme, vous pouvez modifier
manuellement tout code gnr par C++Builder sans perdre laccs
lenvironnement de programmation visuelle.
Dans lEDI, tous les outils de programmation sont facilement accessibles.
Vous pouvez concevoir des interfaces graphiques, parcourir les bibliothques
de classes, crire du code, compiler, tester, dboguer et grer des projets sans
quitter lEDI.
Pour apprendre organiser et configurer lEDI, reportez-vous au chapitre 6,
Personnalisation du bureau.

Menus et barres doutils


La fentre principale, qui occupe la partie suprieure de lcran, contient le menu
principal, les barres doutils et la palette de composants.

Fentre principale dans son agencement par dfaut.

2-2 Prise en main


Le concepteur de fiche, la palette de composants et linspecteur dobjets

Les barres doutils de C++Builder permettent un accs rapide aux oprations


et aux commandes les plus utilises. La plupart des oprations accessibles dans
les barres doutils se retrouvent dans les menus droulants.
Barre doutils Standard Barre doutils Voir Barre doutils Bureaux
Retirer
Ouvrir un fichier Voir une Basculer Nom de la disposition Enregistrer
Nouveau Enregistrer un projet du projet unit fiche/unit du bureau enregistr le bureau

Ouvrir Tout Ajouter un Voir une Nouvelle Dfinir le bureau


enregistrer fichier au projet fiche fiche de dbogage
Barre doutils Dboguer Barre doutils Internet Pour connatre la fonction dun bouton,
pointez dessus pendant un court
Liste des projets Pas pas Nouvelle application Nouveau module de moment pour quun message saffiche
excutables approfondi WebSnap donnes WebSnap
Vous pouvez aussi utiliser le menu
contextuel pour cacher les barres
doutils. Pour afficher une barre
doutils cache, choisissez Voir|
Excuter Pas pas Nouveau module de Editeur Barres doutils et cochez la barre
Suspendre page WebSnap externe doutils voulue.

De nombreuses oprations possdent des quivalents clavier ainsi que des


boutons dans la barre doutils. Lorsquun raccourci clavier est disponible, il est
toujours inscrit ct de la commande dans le menu droulant.
Vous pouvez cliquer avec le bouton droit de la souris sur la plupart des outils
et des icnes pour afficher un menu de commandes appropries lobjet que
vous manipulez. Il sagit des menus contextuels.
Vous pouvez galement personnaliser les barres doutils en leur ajoutant
des commandes ou en les dplaant. Pour plus dinformations, voir Agencement
des menus et des barres doutils la page 6-1 et Enregistrement des
dispositions du bureau la page 6-4.

Pour plus dinformations...


Si vous voulez des informations sur une option de menu, pointez-la et appuyez
sur F1.

Le concepteur de fiche, la palette de composants et linspecteur


dobjets
La palette des composants, le concepteur de fiche, linspecteur dobjets et
larborescence dobjets vous permettent de concevoir linterface utilisateur dune
application.
La palette de composants est compose de pages onglets o des groupes
dicnes reprsentent les composants VCL et CLX visuels ou non visuels que
vous pouvez utiliser pour la conception de linterface de vos applications.

Parcours rapide de lenvironnement 2-3


Larborescence dobjets

Les pages regroupent les composants selon leurs diverses fonctionnalits. Ainsi
les pages Supplment et Win32 contiennent des contrles fentrs comme
les botes de saisie ou les cases cocher ; la page Dialogues contient les botes
de dialogue standard utilises dans les oprations de fichier comme louverture
ou lenregistrement de fichiers.
Cliquez ici pour visualiser
Pages de la palette de composants, regroupes par fonctions les autres pages.

Composants

Chaque composant possde des attributs spcifiques (proprits, vnements


et mthodes) vous permettant de contrler votre application.
Utilisez le concepteur de fiche pour arranger les composants votre convenance
dans linterface utilisateur. Pour chaque composant que vous placez sur une
fiche, utilisez linspecteur dobjets pour dfinir des proprits de conception,
crer des gestionnaires dvnements, filtrer la visibilit des proprits et des
vnements, ce qui tablira le lien entre lapparence visuelle de votre application
et le code qui la fait sexcuter. Voir Positionnement des composants sur une
fiche la page 3-2.

Pour plus dinformations...


Voir palette de composants dans lindex de laide.

Larborescence dobjets
Larborescence dobjets affiche les relations parent-enfant et entre enfants
des composants dans une vue hirarchique arborescente. Cette arborescence est
synchronise avec linspecteur dobjets et le concepteur de fiche : si vous
dplacez la slection dans larborescence dobjets, elle est dplace en
consquence dans linspecteur dobjets et dans la fiche.
Larborescence dobjets vous permet de changer la relation tablie entre des
composants. Si par exemple, vous ajoutez des composants volet et case cocher
votre fiche, ces deux composants sont frres. Mais, si vous utilisez
larborescence dobjets pour dplacer la case cocher sur licne du volet, la case
cocher devient un enfant du volet.
Si les proprits dun objet nont pas t renseignes, larborescence dobjets
affiche un point dinterrogation rouge ct. Vous pouvez galement double-
cliquer sur un objet dans larborescence pour ouvrir lditeur de code afin
dcrire un gestionnaire dvnement.
Si larborescence dobjets napparat pas, slectionnez Voir|Arborescence dobjets.
Larborescence dobjets est particulirement utile pour afficher les relations entre
objets de base de donnes.

2-4 Prise en main


Le rfrentiel dobjets

Pour plus dinformations...


Voir arborescence dobjets dans lindex de laide.

Le rfrentiel dobjets
Le rfrentiel dobjets contient des fiches, botes de dialogue, modules de
donnes, experts, exemples dapplications DLL ainsi que dautres lments
pouvant simplifier le dveloppement. Choisissez Fichier|Nouveau|Autre pour
afficher la bote de dialogue Nouveaux lments par laquelle dbute un projet.
Cette bote de dialogue est galement appele le rfrentiel dobjets. Recherchez
dans le rfrentiel un objet qui ressemble celui que vous voulez crer.
Les pages onglet du rfrentiel dobjets
contiennent des objets tels des fiches, des
cadres, des units, ainsi que des experts
pour crer des lments spcialiss.
Lorsque vous crez un lment partir
dun objet du rfrentiel, vous pouvez
choisir de copier llment, dhriter de lui
ou de lutiliser :
Copier (par dfaut) cre une copie de
llment dans votre projet. Hriter signifie
que les modifications apportes lobjet du
rfrentiel sont hrites par lobjet de votre
projet. Utiliser signifie que les modifications
apportes lobjet de votre projet sont
hrites par lobjet du rfrentiel.

Pour modifier ou supprimer des objets dans le rfrentiel dobjets, choisissez


Outils|Rfrentiel ou cliquez avec le bouton droit dans la bote de dialogue
Nouveaux lments et choisissez Proprits.

Vous pouvez ajouter,


supprimer ou renommer
un onglet dans le rfrentiel
dobjets.

Cliquez sur les flches pour


modifier lordre dans lequel
apparaissent les onglets
de la bote de dialogue
Nouveaux lments.

Pour ajouter des modles de projet ou de fiche au rfrentiel dobjets, voir


Ajout de modles au rfrentiel dobjets la page 6-9.

Pour plus dinformations...


Voir rfrentiel dobjets dans lindex de laide en ligne. Les objets disponibles
dpendent de votre dition C++Builder.

Parcours rapide de lenvironnement 2-5


Lditeur de code

Lditeur de code
A mesure que vous construisez linterface utilisateur de votre application,
C++Builder gnre le code sous-jacent. Lorsque vous slectionnez et modifiez les
proprits des fiches et des composants, ces modifications sont automatiquement
rpercutes dans les fichiers source. Vous pouvez ajouter directement du code
vos fichiers source en utilisant lditeur de code intgr, un diteur ASCII
complet. C++Builder propose diverses aides lcriture de code, dont les outils
daudit de code (Code Insight), lachvement de classe et la navigation dans
le code.
Lajout de composants
la fiche est rpercut
dans le code.

Code
gnr.

Audit de code
Les outils daudit de code (Code Insight) affichent des fentres surgissantes
contextuelles.

Tableau 2.1 Les outils daudit de code


Outil Fonctionnement de loutil
Achvement du code Entrez le nom dune variable qui reprsente un pointeur sur
un objet suivi dune flche (->) ou qui reprsente un objet
non VCL suivi par un point. Tapez le dbut dune instruction
daffectation puis appuyez sur Ctrl+espace pour afficher une
liste darguments valides pour la variable. Tapez un nom de
procdure, de fonction ou de mthode pour faire apparatre
une liste darguments.
Paramtres du code Tapez un nom de mthode et une parenthse ouvrante pour
afficher la syntaxe des arguments de la mthode.
Modles de code Appuyez sur Ctrl+J pour lister les instructions de
programmation courantes que vous pouvez insrer dans votre
code. Vous pouvez crer vos propres modles qui viendront
sajouter ceux qui sont fournis par C++Builder.

2-6 Prise en main


Lditeur de code

Tableau 2.1 Les outils daudit de code (suite)


Outil Fonctionnement de loutil
Evaluation dexpression Lors dun arrt pendant le dbogage, pointez sur une variable
dans conseil pour afficher sa valeur courante.
Audit de symbole Pendant ldition du code, pointez sur un identificateur
dans conseil quelconque pour afficher sa dclaration.

Pour activer ou dsactiver ces outils, choisissez Outils|Options de lditeur


et slectionnez longlet Audit de code. Cochez ou non les outils dans la zone
Fonctionnalits automatiques.

Pour plus dinformations...


Voir Audit de code dans lindex de laide en ligne.

Navigation dans le code


Quand vous faites passer la souris au-dessus dun nom de classe, de variable,
de proprit de mthode ou de tout autre identificateur, le menu surgissant
appel Audit de symbole dans conseil indique o lidentificateur est dclar.
Appuyez sur Ctrl : le curseur prend la forme dune main, lidentificateur devient
bleu et vous pouvez cliquer dessus pour atteindre sa dfinition.
Lditeur de code dispose de boutons Suivant et Prcdent similaires ceux
dun navigateur Web. Quand vous atteignez une dfinition, lditeur de code
se souvient de vos dplacements dans le code. Vous pouvez cliquer sur les
flches places ct des boutons Parcourir vers lavant et Parcourir vers
larrire pour parcourir lhistorique de ces rfrences.

Utilisez lditeur comme


un navigateur Web.

Appuyez sur Ctrl et pointez sur


nimporte quel identificateur.
Le curseur prend la forme dune
main et lidentificateur devient bleu
et soulign.
Cliquez pour aller lendroit o
est dfini lidentificateur.
Ensuite, cliquez sur la flche
Prcdent pour revenir
lemplacement prcdent.

Pour personnaliser lenvironnement de lditeur de code, voir Personnalisation


de lditeur de code la page 6-11.

Pour plus dinformations...


Voir diteur de code dans lindex de laide en ligne.

Parcours rapide de lenvironnement 2-7


Lditeur de code

La page Diagramme
En bas de lditeur de code, il peut y avoir un ou plusieurs onglets, en fonction
de ldition de C++Builder que vous utilisez. La page de code dans laquelle vous
crivez votre code apparat par dfaut au premier plan. La page Diagramme
affiche des icnes relies par des lignes reprsentant les relations entre les
composants que vous avez placs dans une fiche ou un module de donnes.
Ces relations stablissent entre enfants, de parents enfants ou entre les
composants et les proprits.
Pour crer un diagramme, cliquez sur la page Diagramme. Depuis larborescence
dobjets, faites glisser vers la page Diagramme une ou plusieurs icnes pour
les organiser verticalement. Pour les organiser horizontalement, appuyez sur Maj
tout en dplaant les icnes. Quand vous dplacez des icnes ayant des
dpendances de type parent-enfant ou composant-proprit, des lignes
(ou connecteurs) affichant la relation de dpendance sont automatiquement
ajoutes. Si, par exemple, vous ajoutez un composant ensemble de donnes un
module de donnes, puis dplacez dans la page Diagramme licne ensemble
de donnes plus ses icnes de proprit, le connecteur de proprit relie
automatiquement les icnes de proprits licne de lensemble de donnes.
Pour les composants nayant pas de relation de dpendance mais o vous voulez
en voir une, utilisez les boutons de la barre doutils en haut de la page
Diagramme pour ajouter lun des quatre types de connecteurs (bloc de texte,
proprit, matre/dtail et rfrence). Vous pouvez galement ajouter des blocs
de commentaire qui se connectent ensemble ou licne approprie.

Depuis larborescence des objets, Pour voir dautres diagrammes nomms du projet
faites glisser les icnes des en cours, choisissez dans la liste droulante.
composants dans la page
Entrez le nom et la description de votre
Diagramme.
diagramme.

Utilisez les boutons de la barre doutils


de la page Diagramme (Proprit,
Matre /dtail, Rfrence) pour dsigner
la relation entre des composants ou
entre des composants et leurs
proprits. Le type de trait change
selon le type de relation.
Cliquez sur le bouton Bloc de
commentaire pour ajouter un bloc de
commentaire et sur le bouton
Connecteur de blocs de texte pour
tablir une connexion avec un autre
bloc de commentaire ou une icne.

Vous pouvez attribuer un nom et une description votre diagramme,


lenregistrer et limprimer une fois quil est complet.

Pour plus dinformations...


Voir page diagramme dans lindex de laide en ligne.

2-8 Prise en main


Lexplorateur de classe

Visualisation du code des fiches


Les fiches constituent la partie visible de la majorit des projets C++Builder.
Cest l que vous concevez linterface utilisateur dune application. Normalement,
vous concevez les fiches en utilisant les outils visuels de C++Builder, et
C++Builder les stocke dans des fichiers. Les fichiers des fiches (.dfm ou .xfm
pour une application CLX) dcrivent chacun des composants dune fiche,
y compris la valeur de toutes les proprits persistantes. Pour voir et modifier
le fichier dune fiche dans lditeur de code, cliquez avec le bouton droit sur
la fiche et slectionnez Voir comme texte. Pour revenir la vue graphique
de la fiche, cliquez avec le bouton droit et choisissez Voir comme fiche.
Vous pouvez enregistrer les fichiers des fiches soit en format texte (par dfaut)
soit en format binaire. Choisissez Outils|Options denvironnement, cliquez sur la
page Concepteur, et cochez ou non loption Nouvelles fiches comme texte pour
prciser le format utiliser pour les fiches nouvellement cres.

Pour plus dinformations...


Voir fichiers fiche dans lindex de laide en ligne.

Lexplorateur de classe
A louverture de C++Builder, lexplorateur de classe est ancr gauche de la
fentre de lditeur de code, la disponibilit de lexplorateur de code dpend
de ldition de C++Builder dont vous disposez. Lexplorateur de classe affiche
la table des matires sous la forme dune arborescence du code source ouvert
dans lditeur de code, en numrant les types, classes, proprits, mthodes,
variables globales et les routines dfinies dans lunit.
Vous pouvez utiliser lexplorateur de classe pour parcourir le contenu de
lditeur de code. Si par exemple, vous double-cliquez sur un nom de mthode
dans lexplorateur de classe, le curseur passe dans lditeur de code sa
dfinition dans la dclaration de classe de lunit dans la partie interface
de lunit.
Pour configurer laffichage du contenu de lexplorateur de code, choisissez
Outils|Options denvironnement et slectionnez longlet Explorateur.

Pour plus dinformations...


Voir explorateur de classe dans lindex de laide en ligne.

Le gestionnaire de projet
Lorsque vous dmarrez C++Builder pour la premire fois, il ouvre
automatiquement un nouveau projet. Un projet comprend plusieurs fichiers qui
constituent ensemble lapplication ou la DLL que vous dveloppez. Vous pouvez
voir et organiser ces fichiers, comme les fichiers fiche, unit, ressource, objet et

Parcours rapide de lenvironnement 2-9


Liste A faire

bibliothque, dans un outil de gestion des projets appel le gestionnaire de


projet. Pour afficher le gestionnaire de projet, choisissez Voir|Gestionnaire
de projet.

Vous pouvez utiliser le gestionnaire de projet pour combiner et afficher des


informations concernant des projets qui sont associs en un groupe de projets.
En organisant ainsi des projets, par exemple plusieurs excutables, vous pouvez
les compiler en mme temps. Pour modifier les options des projets, comme celles
de la compilation, reportez-vous Dfinition des options des projets la
page 6-8.

Pour plus dinformations...


Voir gestionnaire de projet dans lindex de laide en ligne.

Liste A faire
Les listes A faire enregistrent les lments terminer pour un projet. Vous
pouvez inclure dans une liste des lments du niveau du projet en les ajoutant
directement la liste ou vous pouvez ajouter des lments spcifiques
directement dans le code source. Choisissez Voir|Liste A faire pour ajouter
ou voir des informations associes un projet.

Cliquez avec le bouton droit sur une liste


A faire pour afficher les commandes
permettant de trier ou de filtrer cette liste.

Cliquez ici lorsque vous en avez termin


avec un lment.

Pour plus dinformations...


Voir liste A faire dans lindex de laide en ligne.

2-10 Prise en main


Chapitre

Programmation avec C++Builder


Chapitre 3
3
Les sections suivantes fournissent une analyse du dveloppement de logiciels
avec C++Builder : cration dun projet, travail sur les fiches, criture de code,
compilation, dbogage, dploiement et internationalisation des programmes.
Elles prsentent galement les types de projets que vous pouvez dvelopper.

Cration dun projet


Un projet est une collection de fichiers qui sont soit crs au moment de la
conception soit gnrs lorsque vous compilez le code source du projet.
Lorsque vous dmarrez C++Builder pour la premire fois, un nouveau projet
est ouvert. Cela gnre automatiquement, entre autres fichiers, un fichier projet
(Project1.dpr), un fichier unit (Unit1.pas) et un fichier ressource (Unit1.dfm,
Unit1.xfm pour les applications CLX).
Si un projet est dj ouvert et si vous voulez en ouvrir un nouveau, choisissez
Fichier|Nouveau|Application, ou choisissez Fichier|Nouveau|Autre et double-
cliquez sur licne Application. Fichier|Nouveau|Autre ouvre un rfrentiel
dobjets qui fournit les fiches, les cadres et les modules, ainsi que les modles
pr-fabriqus comme les botes de dialogue, que vous pouvez ajouter votre
projet. Pour en savoir plus sur le rfrentiel dobjets, reportez-vous Le
rfrentiel dobjets la page 2-5.
Lorsque vous dmarrez un projet, vous devez savoir ce que vous voulez
dvelopper, par exemple une application ou une DLL. Pour des informations sur
les types de projets que vous pouvez dvelopper avec C++Builder, voir Types
de projets la page 3-9.

Pour plus dinformations...


Voir projets dans lindex de laide en ligne.

Programmation avec C++Builder 3-1


Construction de linterface utilisateur

Ajout de modules de donnes


Un module de donnes est une sorte de fiche qui contient des composants
uniquement non visuels. Les composants non visuels dun module de donnes
peuvent tre placs sur des fiches normales, ct de composants visuels. Mais,
si vous prvoyez de rutiliser des groupes de bases de donnes et dobjets
systme, ou si vous voulez sparer les parties de votre application concernant la
connexion aux bases de donnes et les rgles de gestion, les modules de donnes
offrent un outil dorganisation pratique.
Pour crer un module de donnes, choisissez Fichier|Nouveau|Module de
donnes. C++Builder ouvre un module de donnes vide, ce qui affiche dans
lditeur de code un fichier unit supplmentaire, et ajoute le module au projet
en cours en tant que nouvelle unit. Pour ajouter des composants non visuels
un module de donnes, procdez comme avec une fiche.

Double-cliquez sur un composant


non visuel de la palette de
composants pour le placer dans le
module de donnes.

Lorsque vous rouvrez un module de donnes existant, C++Builder affiche


ses composants.

Pour plus dinformations...


Voir modules de donnes dans lindex de laide.

Construction de linterface utilisateur


Avec C++Builder, vous devez dabord crer une interface utilisateur (IU) en
slectionnant des composants dans la palette de composants et en les plaant sur
la fiche principale.

Positionnement des composants sur une fiche


Pour placer des composants sur une fiche :
1 Double-cliquez sur le composant ou
2 Cliquez une seule fois sur le composant puis sur la fiche lendroit o vous
voulez le faire apparatre.

3-2 Prise en main


Construction de linterface utilisateur

Slectionnez le composant et faites-le glisser l o vous voulez le faire apparatre


sur la fiche.
La palette des composants prsente de nombreux composants, groups par fonction.

Cliquez sur un composant dans la palette de composants

Cliquez ensuite sur lendroit o vous voulez le positionner sur la fiche.

Ou, choisissez un
composant dans une
liste alphabtique.

Vous pouvez installer de nouveaux


composants dans la palette des
composants.
Vous pouvez aussi rorganiser la palette
et lui ajouter de nouvelles pages.
Choisissez Options denvironnement,
puis la page Palette.

Pour plus dinformations...


Voir palette des composants dans lindex de laide en ligne.

Programmation avec C++Builder 3-3


Construction de linterface utilisateur

Dfinition des proprits des composants


Aprs avoir plac des composants sur une fiche, dfinissez leurs proprits
et codez leurs gestionnaires dvnements. En dfinissant les proprits dun
composant, vous changez la faon dont celui-ci apparat et se comporte dans
votre application. Lorsquun composant est slectionn sur une fiche, ses
proprits et ses vnements sont affichs dans linspecteur dobjets.

Utilisez cette liste droulante Vous pouvez slectionner


pour slectionner un objet. Ici, un composant, ou objet, sur
Button1 est slectionn et ses la fiche en cliquant dessus.
proprits sont affiches.

Slectionnez une proprit


et changez sa valeur dans
la colonne de droite.
Cliquez sur les points de
suspension pour ouvrir une
bote de dialogue
permettant de modifier les
proprits dun objet
utilitaire.
Vous pouvez aussi cliquer sur le signe plus pour
ouvrir une liste de dtails.

De nombreuses proprits possdent des valeurs simples, comme les noms des
couleurs, True ou False, et des entiers. Pour les proprits boolennes, vous
pouvez double-cliquer sur le mot pour passer alternativement de True False.
Certaines proprits sont associes des diteurs permettant de dfinir des
valeurs plus complexes. Lorsque vous cliquez sur la valeur dune de ces
proprits, des points de suspension apparaissent. Pour certaines proprits,
comme la taille, il faut entrer une valeur.
Double-cliquez ici pour
changer la valeur True
en False.

Cliquez sur les points


de suspension pour
afficher lditeur de
cette proprit.

Cliquez sur la flche vers le bas pour faire votre choix


parmi les valeurs valides de la proprit.

Lorsque plusieurs composants sont slectionns dans la fiche, linspecteur


dobjets affiche toutes les proprits partages par ces composants.

3-4 Prise en main


Ecriture du code

Linspecteur dobjets permet galement de dvelopper en ligne les rfrences


un composant. Cela permet daccder aux proprits et vnements dun
composant rfrenc sans avoir le slectionner. Si, par exemple, vous ajoutez
un bouton et un composant menu surgissant dans une fiche, vous pouvez
slectionner le composant bouton, dans linspecteur dobjets, initialiser sa
proprit PopupMenu PopupMenu1, ce qui affiche toutes les proprits du menu
surgissant.

Initialisez la proprit
PopupMenu du composant
bouton PopupMenu1 : toutes
les proprits du menu
surgissant apparaissent
quand vous cliquez sur le
signe plus (+).
Les rfrences en ligne aux
composants sont affiches
en rouge et les sous-
proprits en vert.

Pour plus dinformations...


Voir inspecteur dobjets dans lindex de laide en ligne.

Ecriture du code
La partie fondamentale de toute application est le code associ chaque
composant. Bien que lenvironnement RAD de C++Builder apporte la majorit
des blocs de construction de vos applications, comme les composants visuels
et non visuels pr-empaquets, il vous faudra habituellement crire des
gestionnaires dvnements et, sans doute, certaines de vos propres classes. Pour
vous aider dans cette tche, les milliers dobjets des bibliothques de classes VCL
et CLX de C++Builder sont votre disposition. Pour apprendre voir et
modifier votre code source, reportez-vous Lditeur de code la page 2-6.

Ecriture des gestionnaires dvnements


Votre code doit rpondre aux vnements qui se produisent pour un composant
au moment de lexcution. Un vnement est le lien tabli entre une occurrence
du systme, comme le clic dun bouton, et une portion de code qui rpond
cette occurrence. Le code qui rpond est le gestionnaire de lvnement. Ce code
modifie les valeurs des proprits et appelle des mthodes.

Programmation avec C++Builder 3-5


Ecriture du code

Pour voir les gestionnaires dvnements prdfinis pour un composant de la


fiche, slectionnez le composant et cliquez sur longlet Evnements dans
linspecteur dobjets.
Ici, Button1 est slectionn et son type est affich : TButton. Cliquez sur longlet
Evnements dans linspecteur dobjets pour voir les vnements que le composant
Button peut grer.

Slectionnez un
gestionnaire dvnement
existant dans la liste
droulante.
Ou double-cliquez sur la
colonne de la valeur pour
que C++Builder gnre le
squelette du code dun
nouveau gestionnaire.

Pour plus dinformations...


Voir vnements dans lindex de laide en ligne.

Utilisation des bibliothques VCL et CLX


C++Builder est fourni avec deux bibliothques de classes constitues dobjets,
certains tant galement des composants ou des contrles, que vous pouvez
utiliser pour crire du code. Vous pouvez utiliser la bibliothque de composants
visuels (VCL) pour les applications Windows et la bibliothque de composants
Borland multiplate-forme (CLX) pour les applications Windows et Linux. Ces
bibliothques contiennent des objets visibles lexcution, comme les contrles
de saisie, les boutons et les autres lments dinterface utilisateur, ainsi que des
contrles non visuels comme les ensembles de donnes ou les timers. Le
diagramme suivant montre certaines des classes principales constituant la VCL.
La hirarchie CLX est similaire.
TObject

Exception TStream TPersistent TComObject TInterface

TGraphicsObject TGraphic TComponent TCollection TStrings


La plupart des
composants visuels
TApplication TDataSet TMenu TControl TCommonDialog TField drivent de TWinControl
et dans la CLX de
TWidgetControl.
TGraphicControl TWinControl

TScrollingWinControl TCustomControl

TCustomForm

3-6 Prise en main


Compilation et dbogage des projets

Les objets drivs de TComponent possdent les proprits et les mthodes


autorisant leur installation dans la palette de composants et leur ajout aux fiches
C++Builder. Les composants de VCL et CLX tant troitement lis lEDI, vous
pouvez utiliser des outils comme le concepteur de fiche pour dvelopper des
applications trs rapidement.
Les composants apportent un haut degr dencapsulation. Par exemple, les
boutons sont pr-programms pour rpondre aux clics de souris en dclenchant
des vnements OnClick. Si vous utilisez un contrle bouton de VCL ou CLX,
vous navez pas crire de code grant les vnements gnrs lors dun clic sur
le bouton ; vous ntes charg que de la logique de lapplication qui doit
sexcuter en rponse au clic lui-mme.
La majorit des versions de C++Builder sont livres avec le code source complet
de la VCL et de CLX.

Pour plus dinformations...


Voir Rfrence de la bibliothque de composants visuels et Rfrence CLX
dans le sommaire de laide et VCL dans lindex de laide en ligne.

Compilation et dbogage des projets


Aprs avoir crit votre code, vous devez compiler et dboguer votre projet. Avec
C++Builder, vous pouvez soit compiler votre projet en premier et le dboguer
ensuite indpendamment, soit le compiler et le dboguer en une seule tape en
utilisant le dbogueur intgr. Pour compiler votre programme avec les
informations de dbogage, choisissez Projet|Options, cliquez sur la page
Compilateur, cochez Informations de dbogage.
C++Builder utilise un dbogueur intgr grce auquel vous pouvez contrler
lexcution du programme, suivre les variables et modifier les valeurs des
donnes. Vous pouvez avancer dans votre code ligne par ligne, en examinant
ltat du programme chaque point darrt. Pour vous servir du dbogueur
intgr, choisissez Outils|Options du dbogueur, cliquez sur longlet Gnral
et vrifiez que la case Dbogage intgr est coche.

Programmation avec C++Builder 3-7


Dploiement des applications

Vous pouvez commencer une session de dbogage dans lEDI en choisissant


Excuter|Excuter ou en appuyant sur F9.

Choisissez une des


commandes de dbogage
dans le menu Excuter.
Certaines commandes sont Bouton Excuter
aussi accessibles dans la
barre

Le dbogueur intgr met votre disposition de nombreuses fentres de


dbogage, notamment Points darrt, Pile dappels, Points de suivi, Variables
locales, Threads, Modules, CPU et Journal dvnements. Affichez-les en
choisissant Voir|Fentres de dbogage. Toutes les vues du dbogueur ne sont
pas disponibles dans toutes les ditions de C++Builder.

Pour simplifier lutilisation,


vous pouvez combiner
plusieurs fentres de
dbogage.

Pour savoir comment combiner les fentres de dbogage pour en faciliter


lutilisation, voir Ancrage des fentres doutils la page 6-2.
Lorsque vous avez dfini votre bureau tel que vous voulez quil fonctionne
pendant le dbogage, vous pouvez enregistrer ces paramtres en tant que bureau
de dbogage ou dexcution. Cette disposition du bureau sera utilise chaque fois
que vous dboguerez une application. Pour plus de dtails, voir Enregistrement
des dispositions du bureau la page 6-4.

Pour plus dinformations...


Voir dbogage et utilisation du dbogueur intgr dans lindex de laide.

Dploiement des applications


Vous pouvez permettre tous dinstaller et dexcuter votre application en la
dployant. Pour dployer une application, crez un paquet dinstallation incluant
non seulement les fichiers indispensables comme les excutables, mais aussi tous
les fichiers de support, les DLL, les fichiers paquet ou les applications
complmentaires. C++Builder est fourni avec un utilitaire dinstallation,
InstallShield Express, qui vous permet de crer un programme dinstallation avec

3-8 Prise en main


Internationalisation dapplications

ces fichiers. Pour installer InstallShield Express, dans lcran dinstallation


de C++Builder, choisissez ldition personnalise de InstallShield Express
pour C++Builder.

Pour plus dinformations...


Voir dploiement dans lindex de laide en ligne.

Internationalisation dapplications
C++Builder offre de nombreuses fonctionnalits consacres linternationalisation
et la localisation des applications pour diffrents paramtres rgionaux. LEDI
et la VCL apportent le support des diteurs de mthodes de saisie (IME) et des
jeux de caractres tendus pour internationaliser votre projet. Lorsque votre
application est internationalise, vous pouvez crer des versions localises pour
chacun des marchs trangers o vous voulez la distribuer. Avec certaines
ditions de C++Builder, vous disposez dun environnement de traduction qui
permet la localisation des logiciels et le dveloppement simultan dans plusieurs
langues. Il vous permet de grer plusieurs versions localises dune application
comme des parties dun mme projet.
Lenvironnement de traduction comprend trois outils intgrs :
Lexpert DLL ressource, un expert DLL qui gnre et gre les DLL de
ressources.
Le gestionnaire de traduction, une grille pour visualiser et modifier les
ressources traduites.
Le rfrentiel de traduction, base de donnes partageable pour les traductions.
Pour ouvrir lexpert DLL ressource, choisissez Fichier|Nouveau|Autre et double-
cliquez sur licne Expert DLL de ressources. Pour configurer les outils de
traduction choisissez, Outils|Options des outils de traduction.

Pour plus dinformations...


Voir applications internationales dans lindex de laide en ligne.

Types de projets
Toutes les ditions de C++Builder grent la programmation Windows 32 bits
gnrale et permettent dcrire une grande varit dapplications GUI, de DLL,
de paquets, de composants personnaliss, de contrleurs COM. Certaines ditions
supportent les applications serveur comme les applications serveur Web, les
applications de bases de donnes, les serveurs COM, les applications
multiniveaux, les applications CORBA et des systmes daide la dcision.

Programmation avec C++Builder 3-9


Types de projets

Pour plus dinformations...


Pour connatre les outils que grent votre dition, voir la liste des
caractristiques ladresse www.borland.com.

Applications CLX
Vous pouvez utiliser C++Builder pour dvelopper des applications 32 bits
multiplates-formes fonctionnant la fois sous Windows et sous Linux. Pour
Linux, la solution Borland C++ nest pas encore disponible, mais vous pouvez
prendre les devants en dveloppant lapplication avec C++Builder aujourdhui.
Pour dvelopper une application CLX, choisissez Fichier|Nouveau|Application
CLX. LEDI est similaire lenvironnement dune application C++Builder
normale, cette diffrence que napparaissent dans la palette des composants et
dans le rfrentiel dobjets que les lments utilisables dans une application CLX.
Les caractristiques spcifiques Windows gres par C++Builder ne sont pas
portes directement dans un environnement Linux.

Pour plus dinformations...


Pour connatre les composants disponibles dans les applications multiplates-
formes, voir rfrence CLX dans le sommaire de laide.

Applications serveur Web


Une application serveur Web fonctionne avec un serveur Web en traitant les
requtes dun client et en renvoyant un message HTTP sous la forme dune page
Web. Pour publier des donnes sur le Web, C++Builder propose deux
technologies diffrentes, selon ldition de C++Builder dont vous disposez.
La technologie dapplication serveur Web la plus ancienne de C++Builder est
lagent Web (Web Broker). Les applications agent Web peuvent rpartir des
requtes, effectuer des actions et renvoyer des pages Web aux utilisateurs.
La plus grande partie de la logique mtier dune application est dfinie dans
des gestionnaires dvnements crits par le dveloppeur de lapplication. Pour
crer une application serveur agent Web, choisissez Fichier|Nouveau|Autre et
double-cliquez sur licne Application Serveur Web. Vous pouvez ajouter votre
module Web des composants des pages Internet et InternetExpress de la palette
des composants.
WebSnap apporte en plus des adaptateurs, des rpartiteurs et des gnrateurs de
page supplmentaires, la gestion des sessions et des modules de page Web. Ces
fonctionnalits supplmentaires ont t conues pour grer automatiquement les
tches courantes des applications serveur Web. Le dveloppement WebSnap est
plus simple et plus visuel que le dveloppement Web Broker. Un dveloppeur
dapplications WebSnap peut consacrer davantage de temps la conception de la
logique mtier de lapplication, plutt qu lcriture de gestionnaires
dvnements pour les tches communes de transfert de pages. Pour crer une
nouvelle application serveur WebSnap, choisissez Fichier|Nouveau|Autre,
slectionnez la page WebSnap et double-cliquez sur licne Application

3-10 Prise en main


Types de projets

WebSnap. Vous pouvez ajouter les composants de la page WebSnap de la palette


des composants.
Vous pouvez crer une
application sexcutant sur
divers types de serveurs Web,
y compris un serveur de test qui
vous permet de dboguer votre
application serveur Web.
Vous pouvez galement
accder au module de Dcidez si vous souhaitez un
donnes dapplication module de donnes ou un
WebSnap en choisissant module de page qui affiche votre
Voir|Barres doutils| page HTML.
Internet, et en cliquant sur
licne Nouvelle application
WebSnap.

Pour plus dinformations...


Voir applications Web dans lindex de laide en ligne.

Applications de bases de donnes


C++Builder apporte une grande varit doutils de bases de donnes et
de connectivit qui simplifient le dveloppement des applications de bases
de donnes.
Pour crer une application de bases de donnes, commencez par concevoir
linterface dune fiche en utilisant les composants de page ContrleBD. Puis,
ajoutez une source de donnes dans un module de donnes en utilisant la page
AccsBD. Enfin, pour vous connecter divers serveurs de bases de donnes,
ajoutez un composant ensemble de donnes ou connexion de donnes au module
de donnes depuis les pages dj cites de la palette ou depuis celles associes
aux outils de connectivit suivants :
dbExpress est un ensemble de pilotes utiliss par des applications multiplates-
formes donnant un accs rapide des serveurs SQL comme DB2, InterBase,
MySQL et Oracle. Avec un pilote dbExpress, vous pouvez accder aux bases
de donnes en utilisant des ensembles de donnes unidirectionnels.
Le BDE (Borland Database Engine) est un ensemble de pilotes supportant de
nombreux formats de bases de donnes parmi les plus utiliss, y compris
dBASE, Paradox, FoxPro, Microsoft Access, et toute source de donnes ODBC.
Les pilotes SQL Links, disponibles dans certaines versions de C++Builder,
prennent en charge les serveurs tels quOracle, Sybase, Informix, DB2, SQL
Server et InterBase.
ADO (ActiveX Data Objects) est une interface Microsoft de haut niveau pour
toute source de donnes, dont les bases de donnes relationnelles ou non, les

Programmation avec C++Builder 3-11


Types de projets

systmes de messagerie lectronique et les systmes de fichiers, le texte et


les graphiques, ainsi que les objets de gestion personnaliss.
Les composants InterBase Express (IBX) sont bass sur larchitecture de
composants daccs aux donnes personnaliss de C++Builder. Les applications
IBX donnent accs aux fonctionnalits avances dInterBase et offrent une
interface de composants ultra-performante pour InterBase 5.5 et ses versions
ultrieures. IBX est compatible avec la bibliothque C++Builder de composants
orients donnes.
Certains outils de connectivit aux bases de donnes ne sont pas proposs dans
toutes les ditions de C++Builder.

Pour plus dinformations...


Voir Applications de bases de donnes dans lindex de laide en ligne.

Administrateur BDE
Utilisez ladministrateur BDE (BDEAdmin.exe) pour configurer les pilotes BDE et
dfinir les alias employs par les contrles orients donnes de la VCL pour se
connecter aux bases de donnes.

Pour plus dinformations...


A partir du menu Dmarrer de Windows, choisissez Programmes|Borland
C++Builder|Administrateur BDE. Choisissez ensuite Aide|Index.

Explorateur SQL (explorateur de base de donnes)


Lexplorateur SQL (DBExplor.exe) vous permet de parcourir et de modifier les
bases de donnes. Vous pouvez lutiliser pour crer des alias, voir les
informations de schma, excuter des requtes SQL et maintenir les dictionnaires
de donnes ou les jeux dattributs.

Pour plus dinformations...


Depuis le menu principal de C++Builder, choisissez Base de donnes|
Explorateur pour ouvrir lexplorateur, puis appuyez sur F1. Ou recherchez
explorateur de base de donnes dans lindex principal de laide.

Module base de donnes


Le module base de donnes (DBD32.exe) vous permet de crer, de voir et de
modifier les tables des bases de donnes Paradox et dBase dans divers formats.

Pour plus dinformations...


A partir du menu Dmarrer de Windows. Choisissez Programmes|Borland
C++Builder|Module Base de donnes. Puis, choisissez Aide|Guide de
lutilisateur.

3-12 Prise en main


Types de projets

Dictionnaire de donnes
Le dictionnaire de donnes fournit un espace de stockage personnalisable
indpendant de vos applications dans lequel vous pouvez crer des jeux
dattributs de champs tendus dcrivant le contenu et laspect des donnes.
Le dictionnaire de donnes peut rsider sur un serveur distant pour un partage
des informations encore plus important.

Pour plus dinformations...


Choisissez Aide|C++Builder et recherchez dictionnaire des donnes.

Composants personnaliss
Les composants livrs avec C++Builder sont pr-installs dans lEDI et proposent
des fonctionnalits suffisamment tendues pour rpondre la majorit des
besoins de dveloppement. Vous pourriez programmer avec C++Builder pendant
des annes sans avoir besoin dinstaller de nouveaux composants. Mais, parfois
pour rsoudre certains problmes spciaux ou encapsuler des types de
comportement trs particuliers, la contribution des composants personnaliss
devient ncessaire. Les composants personnaliss favorisent la rutilisation du
code et la cohrence des applications.
Vous pouvez installer des composants personnaliss fournis par des tiers ou
crer les vtres. Pour crer un nouveau composant, choisissez Composant|
Nouveau composant pour afficher lexpert nouveau composant. Pour installer
des composants fournis par un tiers, voir Installation de paquets de
composants la page 6-6.

Pour plus dinformations...


Voir la Partie V, Cration de composants personnaliss dans le Guide du
dveloppeur et composants, cration dans lindex de laide en ligne.

DLL
Les DLL (bibliothques de liaison dynamique) sont des modules compils
contenant des routines pouvant tre appeles par les applications et dautres
DLL. Une DLL contenant du code et des ressources partageables, elle est
habituellement utilise par plusieurs applications. Pour crer un modle de DLL,
choisissez Fichier|Nouveau|Autre et double-cliquez sur licne Expert DLL.

Pour plus dinformations...


Voir DLL dans lindex de laide en ligne.

Programmation avec C++Builder 3-13


Types de projets

COM et ActiveX
C++Builder supporte le standard COM de Microsoft et offre des experts facilitant
la cration des contrles ActiveX. Des exemples de contrles ActiveX sont
installs dans la page ActiveX de la palette de composants. De nombreux
composants serveur COM sont proposs dans longlet Serveurs de la palette de
composants. Vous pouvez les utiliser comme des composants de la VCL.
Par exemple, vous pouvez placer un des composants Microsoft Word sur une
fiche, afin doffrir une instance de Microsoft Word linterface dune application.

Pour plus dinformations...


Voir COM et ActiveX dans lindex de laide en ligne.

Bibliothques de types
Les bibliothques de types sont des fichiers contenant des informations sur les
types de donnes, les interfaces, les fonctions membres et les classes dobjets
prsentes dans un contrle ou un serveur ActiveX. En incluant une bibliothque
de types votre application COM ou votre bibliothque ActiveX, vous mettez
ces informations la disposition dautres applications et dautres outils de
programmation. C++Builder possde un diteur de bibliothques de types qui
permet la cration et la maintenance de celles-ci.

Pour plus dinformations...


Voir bibliothque de types dans lindex de laide en ligne.

3-14 Prise en main


Chapitre

Tutoriel : cration
Chapitre 4
4
dun diteur de texte
Ce tutoriel vous guide dans les tapes de la cration dun diteur de texte
complet avec des menus, une barre doutils et une barre dtat.
Remarque Ce tutoriel est ralisable avec toutes les ditions de C++Builder.

Dmarrage dune nouvelle application


Avant de dmarrer une nouvelle application, crez un rpertoire destin
contenir ses fichiers source.
1 Crez un rpertoire appel TextEditor dans votre rpertoire C:\Program Files\
Borland\CBuilder6\Projects.
2 Commencez un nouveau projet en choisissant Fichier|Nouveau|Application
ou utilisez le projet par dfaut qui est dj ouvert lorsque vous dmarrez
C++Builder.
Chaque application est reprsente par un projet. Lorsque vous dmarrez
C++Builder, il ouvre par dfaut un projet vide et cre automatiquement
les fichiers suivants.
Project1.cpp : le fichier de code source associ au projet. Cest ce que nous
appellerons un fichier projet.
Unit1.cpp : le fichier de code source associ la fiche principale du projet.
Cest ce que nous appellerons un fichier unit.
Unit1.h: un fichier en-tte associ la fiche principale du projet. Cest ce
que nous appellerons fichier en-tte dunit.
Unit1.dfm: le fichier de ressources stockant les informations de la fiche
principale du projet. Cest ce que nous appellerons un fichier fiche.

Tutoriel : cration dun diteur de texte 4-1


Dfinition des valeurs dune proprit

Chaque fiche possde ses propres fichiers unit (Unit1.cpp), en-tte (Unit1.h)
et fiche (Unit1.dfm). Si vous crez une deuxime fiche, une deuxime unit
(Unit2.cpp), un deuxime en-tte (Unit2.h) et un deuxime fichier fiche
(Unit2.dfm) sont automatiquement crs.
3 Choisissez Fichier|Tout enregistrer pour enregistrer vos fichiers sur disque.
Lorsque la bote de dialogue Enregistrer sous apparat :
Positionnez-vous sur votre rpertoire TextEditor.
Enregistrez Unit1 en utilisant le nom par dfaut Unit1.cpp.
Enregistrez le projet sous le nom TextEditor.bpr. (Lexcutable portera le
mme nom que le projet, avec lextension .exe.)
Par la suite, vous pourrez enregistrer votre travail tout moment en choisissant
Fichier|Tout enregistrer.
Lorsque vous enregistrez votre projet, C++Builder cre des fichiers
supplmentaires dans le rpertoire de votre projet. Ne le supprimez pas.

La fiche par dfaut dispose des


boutons Agrandissement et
Rduction, dun bouton Fermeture
et dun menu de contrle.
Si vous excutez prsent la fiche
en appuyant sur F9, vous verrez ces
boutons luvre.
Pour revenir en mode conception,
cliquez sur le X pour fermer la fiche.

Dfinition des valeurs dune proprit


Lorsque vous ouvrez un nouveau projet, C++Builder affiche la fiche principale
du projet, appele par dfaut Form1. Vous allez crer linterface utilisateur et les
autres parties de votre application en plaant des composants dans cette fiche.
A ct de la fiche se trouve linspecteur dobjets qui vous permet de modifier la
valeur des proprits de la fiche et des composants placs dedans. Lorsque vous
dfinissez des proprits, cest C++Builder qui met jour pour vous le code
source. La dfinition des valeurs dans linspecteur dobjets est appele
paramtrage en mode conception.

4-2 Prise en main


Ajout de composants la fiche

1 Trouvez dans linspecteur dobjets la proprit Caption de la fiche et entrez


Tutoriel diteur de texte la place du libell par dfaut Form1. Notez que
lintitul en haut de la fiche change au fil de la saisie.

La liste droulante en haut de linspecteur dobjets


indique le composant slectionn. Dans ce cas, le
composant est Form1 et son type est TForm1.

Quand un composant est slectionn, linspecteur


dobjets affiche ses proprits.

2 Mme sil ny a pas de composants dans la fiche, excutez lapplication


en appuyant sur F9.
3 Pour revenir la vue de Form1 en conception, vous pouvez, au choix :
Cliquer sur le X dans le coin suprieur droit de la barre de titre de votre
application (la vue de la fiche lexcution) ;
Cliquer sur le bouton Quitter lapplication dans le coin suprieur gauche
de la barre de titre et cliquer sur Fermer ;
Choisir Voir|Fiches, slectionner Form1 et cliquer sur OK ;
Choisir Excuter|Rinitialiser le programme.

Ajout de composants la fiche


Avant de commencer ajouter des composants la fiche, vous devez rflchir
la meilleure manire dorganiser linterface utilisateur de votre application.
Linterface utilisateur est ce qui permet lutilisateur de votre application
dinteragir avec elle ; elle doit donc tre conue pour simplifier lutilisation
de lapplication.
C++Builder propose de nombreux composants qui reprsentent des lments
dune application. Par exemple, des composants de la palette (appels galement
objets) simplifient la programmation des menus, des barres doutils, des botes de
dialogue et de nombreux autres lments de programme, visuels ou non visuels.
Lapplication diteur de texte ncessite une zone de saisie, une barre dtat pour
afficher des informations comme le nom du fichier en cours de modification,
des menus et une barre doutils avec des boutons pour simplifier laccs aux
commandes. La puissance de C++Builder pour la conception dinterface tient ce
que vous pouvez exprimenter diffrents composants et voir immdiatement
le rsultat. De cette manire, vous pouvez raliser trs vite un prototype de
linterface de lapplication.
Pour commencer la conception de lditeur de texte, ajoutez la fiche une zone
de texte et une barre dtat.

Tutoriel : cration dun diteur de texte 4-3


Ajout de composants la fiche

1 Pour crer une zone de texte, ajoutez dabord un composant RichEdit. Pour
trouver le composant RichEdit, sur la page Win32 de la palette de composants,
pointez le curseur de la souris sur une icne de la palette pendant quelques
instants ; C++Builder affiche un conseil daide qui donne le nom du
composant.

Lorsque vous avez trouv le composant RichEdit, vous pouvez, au choix :


Slectionner le composant dans la palette et cliquer sur la fiche l o vous
voulez le faire apparatre ;
Double-cliquer dessus pour le placer au milieu de la fiche.

Chaque composant C++Builder est une classe ; en plaant un composant dans


la fiche, vous crez une instance de cette classe. Une fois le composant plac
dans la fiche, C++Builder gnre le code ncessaire la construction dune
instance de lobjet lors de lexcution de votre programme.
2 Le composant RichEdit tant slectionn, cliquez dans linspecteur dobjets sur
la flche vers le bas de la proprit Align et choisissez la valeur alClient.
Vrifiez que le composant RichEdit1
est bien slectionn dans la fiche.
Recherchez la proprit Align dans
linspecteur dobjets. Cliquez sur la
flche vers le bas pour afficher la liste
droulante de la proprit.
Slectionnez alClient.

4-4 Prise en main


Ajout de composants la fiche

Maintenant, le composant RichEdit remplit toute la fiche et vous disposez


dune zone ddition plus grande. En choisissant la valeur alClient pour la
proprit Align, la taille du contrle RichEdit varie pour remplir la taille dans
laquelle la fentre est affiche, et ce mme si la fiche est redimensionne.
3 Double-cliquez sur le composant StatusBar de la page Win32 de la palette
de composants, pour ajouter une barre dtat en bas de la fiche.

Zone de saisie

Barre dtat

4 Double-cliquez sur la barre dtat pour ouvrir la bote de dialogue


Modification de StatusBar1->Panels.
Astuce Vous pouvez galement ouvrir la bote de dialogue Modification de
StatusBar1->Panels en cliquant sur les points de suspension (TStatusPanel) de
la proprit Panels de la barre dtat.
5 Cliquez sur le bouton Ajouter nouveau dans la barre doutils de la bote
de dialogue ou cliquez avec le bouton droit et choisissez Ajouter, afin dajouter
un volet la barre dtat. Le volet affichera le nom et le chemin daccs du
fichier en cours de modification dans votre diteur de texte.

Cliquez avec le bouton droit de


la souris pour afficher le menu
contextuel. Choisissez Ajouter
pour crer dans la barre dtat
un volet qui puisse contenir
du texte persistant.

Tutoriel : cration dun diteur de texte 4-5


Ajout du support pour un menu et une barre doutils

6 Dans linspecteur dobjets, dfinissez la proprit Text par sans titre.txt.


Quand vous utilisez lditeur de texte, si le fichier en cours de modification
na pas encore t enregistr, il est nomm sans titre.txt.
7 Cliquez sur le X pour fermer la bote de dialogue Modification
de StatusBar1->Panels.
Maintenant, la zone ddition principale de linterface utilisateur est dfinie.

Ajout du support pour un menu et une barre doutils


Pour que lapplication fasse quelque chose, elle a besoin dun menu, de
commandes et, pour le confort, dune barre doutils. Bien que vous puissiez
coder les commandes sparment, C++Builder fournit une liste dactions ou un
gestionnaire dactions qui centralise les actions, les images et le code pour les
commandes des menus et les barres doutils.
Par convention, les actions connectes aux commandes de menu sont nommes
en utilisant le nom du menu de niveau suprieur et le nom de la commande.
Ainsi, laction FichierQuitter dsigne la commande Quitter du menu Fichier.
Le tableau suivant numre les commandes de menu dont a besoin votre
application diteur de texte et indique si laction est associe un bouton de
la barre doutils :

Tableau 4.1 Les commandes prvues pour lditeur de texte


Dans
la barre
Menu Commande doutils ? Description
Fichier Nouveau Oui Cre un nouveau fichier.
Fichier Ouvrir Oui Ouvre un fichier existant pour le modifier.
Fichier Enregistrer Oui Stocke sur disque le fichier en cours.
Fichier Enregistrer Non Stocke un fichier sous un nouveau nom (vous permet
sous galement de stocker un nouveau fichier en utilisant un
nom spcifi).
Fichier Quitter Oui Sort du programme diteur.
Edition Couper Oui Efface du texte et le stocke dans le Presse-papiers.
Edition Copier Oui Copie du texte et le stocke dans le Presse-papiers
Edition Coller Oui Insre le texte contenu dans le Presse-papiers.
Aide Rubriques Non Affiche lcran de sommaire qui vous permet daccder
daide aux rubriques de laide.
Aide Index Non Affiche lcran de lindex de laide.
Aide A propos Non Affiche dans une bote de dialogue des informations
sur lapplication.

4-6 Prise en main


Ajout du support pour un menu et une barre doutils

Diffrences entre lditeur du gestionnaire dactions et lditeur de


liste dactions
Selon votre dition de C++Builder, il existe deux moyens de grer les actions
et les images de vos menus et de la barre doutils. Toutes les ditions de
C++Builder proposent un diteur de liste dactions, qui fournit un emplacement
pour centraliser les rponses des commandes utilisateur. Lditeur de liste dactions
fait partie de la bibliothque de composants multiplate-forme (CLX) Borland et
doit tre utilise la place de lditeur du gestionnaire dactions si vous prvoyez
de migrer plus tard vers une autre plate-forme (par exemple Linux).
Lditeur du gestionnaire dactions offre des fonctionnalits spciales, mais nest
disponible qu partir de la bibliothque de composants visuels (VCL), spcifique
la plate-forme Windows. Lutilisation du dialogue de personnalisation de lditeur
du gestionnaire dactions peut offrir des actions de menu personnalisables par
lutilisateur final, et possdant des proprits de Microsoft Office (comme cacher
les options de menus rarement utilises). En outre, le gestionnaire dactions offre
un processus de dveloppement plus rapide, car il suffit de faire glisser les
actions du dialogue de personnalisation du gestionnaire dactions vers le composant
de menu se trouvant sur la fiche.
Attention Ce tutoriel utilise le dialogue de personnalisation du gestionnaire dactions pour les
ditions Entreprise et Professionnelle de C++Builder. Si vous possdez ldition
Entreprise ou Professionnelle, continuez par Ajout dimages aux menus et la
barre doutils (Entreprise et Professionnel), ci-aprs.
Si vous possdez ldition Personnelle ou si vous voulez utiliser lditeur de liste
dactions, allez directement Ajout dune liste dimages et dimages (dition
Personnelle), page 4-15.

Ajout dimages aux menus et la barre doutils (Entreprise et


Professionnel)
Dans cette section, vous allez ajouter des images utiliser avec des bandes
dactions.
Dans la plupart des cas, vous voudrez ajouter un composant ImageList1 votre
fiche et importer vos propres images. Pour ce tutoriel, vous gagnerez du temps
en important la liste dimages qui a t utilise pour crer lEDI de C++Builder.
Au lieu de vos propres graphiques, le composant ImageList1 de la palette utilise
des images par dfaut pour les actions standard.
Pour ajouter la liste dimages existante :
1 Si vous avez install C++Builder dans le rpertoire par dfaut, choisissez
Fichier|Ouvrir et slectionnez C:\Program Files\Borland\CBuilder6\Source\
vcl\actnres.pas. Pour voir ce fichier, dfinissez le type de fichier par (Tous les
fichiers *.*) dans le dialogue douverture.

Tutoriel : cration dun diteur de texte 4-7


Ajout du support pour un menu et une barre doutils

2 Slectionnez le composant ImageList1, copiez-le, puis collez-le dans votre fiche.


Cest un composant non visuel, peu importe o vous le collez.
Remarque Pour copier ImageList1, cliquez avec le bouton droit de la souris sur le
composant et slectionnez Edition|Copier. Dans la fiche, cliquez avec le
bouton droit de la souris et slectionnez Edition|Coller.
3 Fermez la fentre StandardActions.
4 Double-cliquez sur ImageList1 afin dafficher toutes les images que vous
pouvez utiliser.

Les nombres sous les


images correspondent
la valeur de la proprit
ImageIndex de chaque
action.

Vous pouvez cliquer sur


le bouton Ajouter pour
ajouter dautres images.

Les proprits ImageIndex des actions standard et de lImageList1 que nous


avons ajoutes incluent :

Commande Proprit ImageIndex


Edition|Couper 0
Edition|Copier 1
Edition|Coller 2
Fichier|Nouveau 6
Fichier|Ouvrir 7
Fichier|Enregistrer 8
Fichier|Enregistrer sous 30
Fichier|Quitter 43
Aide|Rubriques daide 40

Remarque Il est possible dajouter des images dune autre liste. Voir Ajout dune liste
dimages et dimages (dition Personnelle), page 4-15. Cliquez sur OK pour
fermer le dialogue ImageList1.

4-8 Prise en main


Ajout du support pour un menu et une barre doutils

Ajout dactions au gestionnaire dactions (Entreprise et


Professionnel)
Les ditions Entreprise et Professionnelle proposent un gestionnaire dactions qui
facilite lajout dactions aux menus et aux barres doutils. Vous ajoutez dabord le
gestionnaire dactions et vous ajoutez les actions ensuite.
1 Dans la page Supplment de la palette de composants, double-cliquez sur le
composant ActionManager pour le dposer dans la fiche. Comme cest un
composant non-visuel, vous pouvez le placer nimporte o dans la fiche.
Astuce Pour afficher le libell des composants placs dans une fiche, choisissez
Outils|Options denvironnement, slectionnez la page Concepteur,
slectionnez loption Afficher les libells des composants puis cliquez sur OK.
Passer la souris au-dessus dun composant affiche galement son nom.
2 ActionManager1 tant toujours slectionn dans la fiche, dfinissez sa proprit
Images dans linspecteur dobjets par ImageList1.

Cliquez sur la proprit Images, puis sur la flche vers le bas ct de Images.
ImageList1 apparat. Slectionnez-le. Cela associe les images de la liste
dimages aux actions de la liste dactions.

Vous allez ensuite ajouter les actions au gestionnaire dactions et dfinir leurs
proprits. Vous allez ajouter des actions non standard dont vous dfinirez
toutes les proprits ainsi que des actions standard dont les proprits sont
dfinies automatiquement.
3 Double-cliquez sur le composant ActionManager pour louvrir.
La bote de dialogue Modification de Form1->ActionManager1, appele aussi
diteur du gestionnaire dactions, apparat.
4 Assurez-vous que longlet Actions est affich. Cliquez sur le bouton flche
vers le bas ct du bouton Nouvelle Action et slectionnez Nouvelle Action.
Astuce Vous pouvez galement cliquer avec le bouton droit de la souris dans
lditeur du gestionnaire dactions et choisir Nouvelle action.

Tutoriel : cration dun diteur de texte 4-9


Ajout du support pour un menu et une barre doutils

Cliquez sur le bouton flche vers


le bas ct du bouton Nouvelle
Action pour crer une nouvelle
action du gestionnaire dactions.
Quand le bouton Supprimer est
activ, vous pouvez retirer de la
liste daction des actions
existantes.

5 Vrifiez que pas de catgorie est slectionne dans la liste dactions et que
Action1 est slectionne sous Actions. Dans linspecteur dobjets, dfinissez
les proprits suivantes :
Pour Caption, saisissez &Nouveau. Remarquez comment la saisie dun caractre
& avant lune des lettres fait de cette lettre un raccourci pour accder la
commande.
Pour Category, saisissez Fichier (cela regroupe les commandes de fichier
en un seul emplacement).
Pour Hint, saisissez Crer un fichier (cest le conseil daide).
Vrifiez que ImageIndex est dfinie par 6 (Cela correspond la liste dimage
que nous avons importe. Vous pouvez aussi cliquer sur la flche vers
le bas et slectionner limage approprie).
Pour Name, entrez FichierNouveau (pour la commande Fichier|Nouveau)
et appuyez sur Entre pour enregistrer la modification.

Action1 tant slectionn


dans lditeur du
gestionnaire dactions,
modifiez ses proprits
dans linspecteur dobjets.
Caption est le nom de
laction, Category indique le
type daction, Hint est un
conseil daide, ImageIndex
permet de dsigner une
image de la liste dimages et
Name permet de dsigner
laction dans le code.

4-10 Prise en main


Ajout du support pour un menu et une barre doutils

6 Vrifiez que Fichier est slectionn dans la fentre Modification de Form1->


ActionManager1. Cliquez sur la flche vers le bas ct du bouton Nouvelle
Action et slectionnez Nouvelle Action.
7 Dans linspecteur dobjets, dfinissez les proprits suivantes :
Aprs Caption, saisissez &Enregistrer.
Assurez-vous que Category est dfinie par Fichier.
Aprs Hint, saisissez Enregistrer le fichier.
Aprs ImageIndex, slectionnez limage 8.
Aprs Name, saisissez FichierEnregistrer (pour la commande Fichier|
Enregistrer).
8 Cliquez sur le bouton flche vers le bas ct du bouton Nouvelle Action
et slectionnez Nouvelle Action.
9 Dans linspecteur dobjets, dfinissez les proprits suivantes :
Aprs Caption, saisissez &Index.
Aprs Category, saisissez Aide.
ImageIndex nest pas ncessaire. Laissez la valeur par dfaut.
Aprs Name, saisissez AideIndex (pour la commande Aide|Index).
10 Cliquez sur le bouton flche vers le bas ct du bouton Nouvelle Action et
slectionnez Nouvelle Action.
11 Dans linspecteur dobjets, dfinissez les proprits suivantes :
Aprs Caption, saisissez &A propos.
Aprs Category, saisissez Aide.
ImageIndex nest pas ncessaire. Laissez la valeur par dfaut.
Aprs Name, saisissez AideApropos (pour la commande Aide|A propos).
12 Gardez lcran le dialogue du gestionnaire dactions.
13 Enregistrez votre travail en cliquant sur Fichier|Tout enregistrer.

Ajout dactions standard (Entreprise et Professionnel)


Vous allez ensuite ajouter dans le gestionnaire dactions les actions standard
(ouvrir, enregistrer sous, quitter, couper, copier, coller et rubriques daide).
1 Lditeur du gestionnaire dactions doit toujours tre affich. Si ce nest pas
le cas, double-cliquez sur le composant ActionManager pour louvrir.
2 Cliquez sur la flche vers le bas ct du bouton Nouvelle Action et
slectionnez Nouvelle Action standard.
La bote de dialogue Classes dactions standard apparat.
3 Accdez la catgorie Edition et utilisez la touche Ctrl pour slectionner
TEditCut, TEditCopy et TEditPaste. Cliquez sur OK pour ajouter ces actions

Tutoriel : cration dun diteur de texte 4-11


Ajout du support pour un menu et une barre doutils

la nouvelle catgorie Edition dans la liste des catgories de la bote de


dialogue Modification de Form1->ActionManager1.
Cliquez avec le bouton droit de la souris dans
lditeur du gestionnaire dactions et choisissez
Nouvelle action standard.
Les actions standard disponibles sont affiches.
Pour en choisir une, double-cliquez dessus, ou
slectionnez plusieurs actions et cliquez sur OK.

4 Cliquez sur la flche vers le bas ct du bouton Nouvelle Action et


slectionnez Nouvelle Action standard.
5 Accdez la catgorie Fichier et slectionnez TFileOpen, TFileSaveAs et
TFileExit. Cliquez sur OK pour ajouter ces actions la catgorie Fichier.
6 Cliquez sur la flche vers le bas ct du bouton Nouvelle Action et
slectionnez Nouvelle Action standard.
7 Accdez la catgorie Aide et slectionnez THelpContents. Cliquez sur OK
pour ajouter cette action la catgorie Aide.
Remarque La commande Aide|Rubriques daide personnalise affiche un fichier daide
montrant toujours longlet Sommaire de laide. La commande standard
Aide|Rubriques daide ouvre le dernier onglet affich de la page :
Sommaire, Index ou Rechercher.
Vous venez dajouter toutes les actions standard dont a besoin votre
application. Les proprits des actions standard sont automatiquement
initialises, y compris lindice de limage. Vous pouvez changer lindice de
limage afin dafficher une autre image.
8 Si vous voulez, vous pouvez changer limage des actions standard. Par
exemple, slectionnez laction Fichier|Ouvrir dans le dialogue Modification
de Form1->ActionManager1. Remplacez maintenant limage par dfaut par
limage 7 de la liste.
9 Choisissez le bouton Fermer pour fermer lditeur du gestionnaire dactions.
10 Choisissez Fichier|Tout enregistrer pour enregistrer vos modifications.

4-12 Prise en main


Ajout du support pour un menu et une barre doutils

Ajout dun menu (Entreprise et Professionnel)


Dans les deux sections suivantes, vous allez ajouter une barre de menus
personnalisable et des bandes dactions doutils. La barre de menus de lditeur
de texte contient trois menus droulants (Fichier, Edition et Aide) ainsi que leurs
commandes de menu. Avec lditeur du gestionnaire dactions vous pouvez, en
une seule tape, faire glisser chaque catgorie de menu et ses commandes dans
la barre de menu.
1 Dans la page Supplment de la palette de composants, double-cliquez sur le
composant ActionMainMenuBar pour lajouter la fiche.
Une barre de menus vide apparat en haut de la fiche.
2 Ouvrez le dialogue de personnalisation du gestionnaire dactions sil nest pas
dj ouvert et slectionnez Fichier dans la liste Catgories. Si les commandes
du menu ne sont pas dans lordre souhait, vous pouvez changer ce dernier
en utilisant les boutons Vers le haut et Vers le bas ou les raccourcis Ctrl+ et
Ctrl+.
3 Slectionnez laction Ouvrir et cliquez sur le bouton Vers le haut dans la barre
doutils de dialogue de personnalisation du gestionnaire dactions afin que les
commandes du menu Fichier soient dans lordre suivant : Nouveau, Ouvrir,
Enregistrer, Enregistrer sous et Quitter.
4 Faites glisser la catgorie Fichier sur la barre de menus. Le menu Fichier et ses
commandes de menu apparaissent dans la barre de menus.
Astuce Vous pouvez galement positionner les commandes une fois quelles ont t
ajoutes dans la barre des menus. Par exemple, cliquez sur Fichier dans la
barre des menus afin de faire apparatre ses options, puis faites glisser Ouvrir
au-dessus de Nouveau et inversement.
5 Depuis la liste Catgories du dialogue de personnalisation du gestionnaire
dactions, faites glisser Edition droite de Fichier dans la barre de menus.
6 Depuis la liste Catgories du dialogue de personnalisation du gestionnaire
dactions, faites glisser Aide droite de Edition dans la barre de menus.
7 Cliquez sur le menu Aide, pour voir ses options de menu. Dplacez la
commande Rubriques daide au-dessus de la commande Index.
8 Appuyez sur Echap ou cliquez nouveau sur le menu Aide pour le refermer.
9 Choisissez Fichier|Tout enregistrer pour enregistrer vos modifications.
Vous pouvez maintenant ajouter une barre doutils pour proposer un accs plus
simple aux commandes.

Tutoriel : cration dun diteur de texte 4-13


Ajout du support pour un menu et une barre doutils

Ajout dune barre doutils (Entreprise et Professionnel)


Les actions ayant t dfinies dans le dialogue de personnalisation du
gestionnaire dactions, vous pouvez ajouter des actions utilises dans les menus
une barre doutils (une bande daction) qui acheve ressemble une barre
doutils Microsoft Office 2000.
1 Dans la page Supplment de la palette de composants, double-cliquez sur le
composant ActionToolBar afin de lajouter la fiche.
Une barre doutils bande dactions vide apparat en-dessous de la barre de
menus.
Astuce Vous pouvez galement ajouter une barre doutils bande dactions dans le
dialogue de personnalisation du gestionnaire dactions, en cliquant sur longlet
Barres doutils et en choisissant le bouton Nouvelle.
2 Si lditeur du gestionnaire dactions nest pas affich, ouvrez-le et
slectionnez Fichier dans la liste Catgories. Dans la liste Actions, slectionnez
Nouveau, Ouvrir, Enregistrer et Quitter et faites glisser ces lments dans la
barre doutils. Ils apparaissent automatiquement sous la forme de boutons,
chacun ayant limage qui lui a t attribue.
3 Dans le dialogue de personnalisation du gestionnaire dactions, faites glisser
dans la barre doutils la catgorie Edition. Toutes les commandes dEdition
doivent apparatre dans la barre doutils.
Remarque Si vous faites glisser par erreur une commande dans la barre doutils, vous
pouvez len extraire. Vous pouvez galement slectionner llment dans
larborescence des objets et utiliser la touche Suppr. Vous pouvez galement
repositionner les boutons en les faisant glisser vers la gauche ou vers la droite.
4 Choisissez Fichier|Tout enregistrer pour enregistrer vos modifications.
5 Appuyez sur F9 pour compiler et excuter le projet.
Astuce Vous pouvez galement excuter le projet en cliquant sur le bouton Excuter
de la barre doutils ou en choisissant Excuter|Excuter. Quand vous excutez
le projet, C++Builder ouvre le programme dans une fentre dexcution
semblable celle que vous avez conue dans la fiche.
Le programme dispose dj dun grand nombre de fonctionnalits. Si vous
slectionnez du texte, les boutons Couper, Copier et Coller fonctionnent.
Les menus fonctionnent tous, mme si beaucoup de commandes sont grises.
Pour activer certaines commandes, vous devrez crire des gestionnaires
dvnements.
6 Pour revenir en mode conception, cliquez sur le X dans le coin suprieur droit
de lapplication.
Pour continuer le tutoriel, passez Effacement de la zone de texte (toutes
ditions), page 4-24.

4-14 Prise en main


Ajout du support pour un menu et une barre doutils

Ajout dune liste dimages et dimages (dition Personnelle)


Dans cette section, vous allez ajouter un composant ImageList votre fiche et
ajouter des images cette liste. Slectionnez le composant ImageList dans la
palette de composants et cliquez sur la fiche pour ajouter un composant
ImageList1.
Voici les images utiliser pour chaque commande :

Commande Nom de limage Proprit ImageIndex


Fichier|Nouveau Filenew.bmp 0
Fichier|Ouvrir Fileopen.bmp 1
Fichier|Enregistrer Filesave.bmp 2
Fichier|Quitter Doorshut.bmp 3
Edition|Couper Cut.bmp 4
Edition|Copier Copy.bmp 5
Edition|Coller Paste.bmp 6
Aide|Rubriques daide Help.bmp 7

Remarque Sans importation de graphiques, ImageList utilise les images par dfaut des
actions standard.
Pour ajouter des images la liste dimages :
1 Double-cliquez sur le composant ImageList de la fiche afin dafficher lditeur
de liste dimages.
2 Cliquez sur le bouton Ajouter.
3 Dans la bote de dialogue Ajout dimages, allez dans le rpertoire buttons
fourni avec le logiciel. Lemplacement par dfaut est C:\Program Files\
Common Files\Borland Shared\Images\Buttons.
4 Double-cliquez sur filenew.bmp.
Quand un message vous demande si vous voulez sparer le bitmap en deux
icnes distinctes, rpondez Oui chaque fois. Chaque icne contient une
version active et une version grise de limage. Vous voyez alors deux images.
Supprimez limage grise (la seconde).
5 Ajoutez les autres images :
Cliquez sur Ajouter. Double-cliquez sur fileopen.bmp. Supprimez limage
grise.
Cliquez sur Ajouter. Double-cliquez sur filesave.bmp. Supprimez limage
grise.
Cliquez sur Ajouter. Double-cliquez sur doorshut.bmp. Supprimez limage
grise.
Cliquez sur Ajouter. Double-cliquez sur cut.bmp. Supprimez limage grise.

Tutoriel : cration dun diteur de texte 4-15


Ajout du support pour un menu et une barre doutils

Cliquez sur Ajouter. Double-cliquez sur copy.bmp. Supprimez limage


grise.
Cliquez sur Ajouter. Double-cliquez sur paste.bmp. Supprimez limage
grise.

Astuce Vous pouvez utiliser la touche Ctrl en cliquant sur les images pour en
slectionner plusieurs. Ensuite, revenez supprimer les images grises.
Cliquez sur OK pour fermer lditeur de liste dimages.
Vous avez ajout sept images la liste dimages ; elles sont numrotes de 0
6, ce qui est cohrent avec la proprit ImageIndex de chacune des actions.
Remarque Si elles sont dans le dsordre, vous pouvez utiliser le glisser-dplacer pour
placer les images la bonne position dans lditeur de liste dimages.
Vous pouvez maintenant ajouter un menu et une barre doutils.

Ajout dactions la liste dactions (dition Personnelle)


Vous avez dj ajout un composant ImageList la fiche et ajout des images
ImageList. Dans cette section, vous allez ajouter une liste dactions et des actions.
1 Double-cliquez sur le composant ActionList de longlet Standard de la palette
de composants. Le composant ActionList ajout la fiche est un composant
non visuel, donc lendroit o vous le placez na pas dimportance.

4-16 Prise en main


Ajout du support pour un menu et une barre doutils

2 Le composant ActionList tant toujours slectionn dans la fiche, initialisez sa


proprit Images ImageList1.

Cliquez sur la proprit Images, puis sur la flche vers le bas ct de Images.
ImageList1 apparat. Slectionnez-le. Cela associe les images que vous allez
ajouter la liste dimages aux actions de la liste dactions.

3 Double-cliquez sur le composant ActionList pour louvrir.


La bote de dialogue Modification de Form1->ActionList1 est affiche.
On lappelle aussi diteur de liste dactions.
4 Cliquez avec le bouton droit de la souris dans lditeur de listes dactions
et choisissez Nouvelle action.
Cliquez avec le bouton
droit de la souris dans
lditeur de listes
dactions et choisissez
Nouvelle action pour
crer une action dans la
liste dactions.

Astuce Vous pouvez aussi cliquer sur la flche vers le bas ct du bouton Nouvelle
Action et cliquer sur Nouvelle Action.

Tutoriel : cration dun diteur de texte 4-17


Ajout du support pour un menu et une barre doutils

5 Pour Action1, dfinissez les proprits suivantes dans linspecteur dobjets :


Pour Caption, saisissez &Nouveau. Remarquez comment la saisie dun caractre
& avant lune des lettres fait de cette lettre un raccourci pour accder la
commande.
Pour Category, saisissez Fichier (cela regroupe les commandes de fichier en
un seul emplacement).
Pour Hint, saisissez Crer un fichier (cest le conseil daide).
Pour ImageIndex, slectionnez limage associe (image 0 si vous avez ajout
votre liste dimages dans lordre crit plus haut).
Pour Name, entrez FichierNouveau (pour la commande Fichier|Nouveau) et
appuyez sur Entre pour enregistrer la modification.
6 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et
choisissez Nouvelle action.
7 Pour Action1, dfinissez les proprits suivantes dans linspecteur dobjets :
Aprs Caption, saisissez &Enregistrer.
Vrifiez que Category indique Fichier.
Aprs Hint, saisissez Enregistrer le fichier.
Pour ImageIndex, slectionnez limage associe (image 2 si vous avez ajout
vos images dans lordre crit plus haut).
Aprs Name, saisissez FichierEnregistrer (pour la commande Fichier|
Enregistrer).
8 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et
choisissez Nouvelle action.
9 Pour Action1, dfinissez les proprits suivantes dans linspecteur dobjets :
Aprs Caption, saisissez &Index.
Aprs Category, saisissez Aide.
ImageIndex nest pas ncessaire. Laissez la valeur par dfaut.
Aprs Name, saisissez AideIndex (pour la commande Aide|Index).
10 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et
choisissez Nouvelle action.
11 Pour Action1, dfinissez les proprits suivantes dans linspecteur dobjets :
Aprs Caption, saisissez &A propos.
Aprs Category, saisissez Aide.
ImageIndex nest pas ncessaire. Laissez la valeur par dfaut.
Aprs Name, saisissez AideApropos (pour la commande Aide|A propos).
Laissez lditeur de liste dactions lcran.

Ajout dactions standard la liste dactions (dition Personnelle)


C++Builder propose plusieurs actions standard frquemment utilises dans les
applications. Vous allez maintenant ajouter des actions standard (Couper, Copier
et Coller) la liste dactions.

4-18 Prise en main


Ajout du support pour un menu et une barre doutils

1 Lditeur de liste dactions doit tre encore affich. Si ce nest pas le cas,
double-cliquez sur le composant ActionList dans la fiche.
2 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et
cliquez sur Nouvelle action standard.
Astuce Vous pouvez aussi cliquer sur la flche vers le bas ct du bouton Nouvelle
Action et cliquer sur Nouvelle Action standard.
3 Dans la bote de dialogue Classes dactions standard, accdez la catgorie
Edition et utilisez la touche Ctrl pour slectionner TEditCut, TEditCopy, et
TEditPaste. Cliquez sur OK pour ajouter ces actions une nouvelle catgorie
Edition dans lditeur de liste dactions.
Cliquez avec le bouton droit de la souris dans
lditeur de liste dactions et choisissez Nouvelle
action standard.
Les actions standard disponibles sont affiches.
Pour en choisir une, double-cliquez dessus.

4 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et


cliquez sur Nouvelle action standard.
5 Accdez la catgorie Fichier et slectionnez TFileOpen, TFileSaveAs et
TFileExit. Cliquez sur OK pour ajouter ces actions la catgorie Fichier.
6 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et
cliquez sur Nouvelle action standard.
7 Accdez la catgorie Aide et slectionnez THelpContents. Cliquez sur OK
pour ajouter cette action la catgorie Aide.
Remarque La commande Aide|Rubriques daide personnalise affiche un fichier daide
montrant toujours longlet Sommaire de laide. La commande standard Aide|
Rubriques daide ouvre le dernier onglet affich de la page : Sommaire, Index
ou Rechercher.

Tutoriel : cration dun diteur de texte 4-19


Ajout du support pour un menu et une barre doutils

Les proprits des actions standard sont automatiquement initialises. Mais,


vous devez modifier la proprit indice de limage pour associer les actions
aux images livres avec ldition Personnelle.
8 Dans la liste Catgories de lditeur de liste dactions, choisissez (Toutes les
actions).
9 Les actions standard incluent des images par dfaut. Remplacez maintenant
les images par dfaut par les images que vous avez ajoutes prcdemment.
Dans la liste dactions, slectionnez les actions suivantes une par une et
changez leur proprit ImageIndex dans linspecteur dobjets :
Slectionnez EditCut1 et dfinissez sa proprit ImageIndex par 4.
Slectionnez EditCopy1 et dfinissez sa proprit ImageIndex par 5.
Slectionnez EditPaste1 et dfinissez sa proprit ImageIndex par 6.
Slectionnez FileOpen1 et dfinissez sa proprit ImageIndex par 1.
Slectionnez FileExit1 et dfinissez sa proprit ImageIndex par 3.
10 Cliquez sur le X pour fermer lditeur de liste dactions.
11 Choisissez Fichier|Tout enregistrer pour enregistrer vos modifications.

Ajout dun menu (dition Personnelle)


Dans cette section, vous allez ajouter une barre de menu principal contenant
trois menus droulants Fichier, Edition et Aide et vous ajouterez des
lments chacun deux en utilisant les actions de la liste dactions.
1 Depuis la page Standard de la palette de composants, dposez un composant
MainMenu dans la fiche. Lendroit o vous le positionnez na pas
dimportance.
2 Initialisez la proprit Images du menu principal ImageList1 afin dassocier les
images aux lments de menu.
3 Double-cliquez sur le composant MainMenu pour afficher le concepteur de
menus.

4-20 Prise en main


Ajout du support pour un menu et une barre doutils

4 Pour dfinir le premier lment du menu de niveau suprieur dans le


concepteur de menus, allez dans linspecteur dobjets, dfinissez la proprit
Caption par &Fichier et appuyez sur Entre.
Quand vous saisissez
&Fichier puis slectionnez
le concepteur de menus,
la commande de niveau
suprieure Fichier est
prte pour que vous
ajoutiez le premier
lment de menu.

5 Slectionnez llment vide sous la commande Fichier que vous venez


de crer.
6 Dans linspecteur dobjets, initialisez la proprit Action FichierNouveau.
Toutes les actions de la liste dactions apparaissent l.
Quand vous
slectionnez
FichierNouveau dans
la liste de la proprit
Action, la commande
Nouveau apparat
avec le bon libell et
le bon indice dimage.

Slectionnez llment en dessous de Nouveau et dfinissez sa proprit


Action par FileOpen1.
Slectionnez llment en dessous de Ouvrir et dfinissez sa proprit
Action par FichierEnregistrer.
Slectionnez llment en dessous de Enregistrer et dfinissez sa proprit
Action par FileSaveAs1.
Slectionnez llment en dessous de Enregistrer sous, entrez un tiret (-)
aprs sa proprit Caption puis appuyez sur Entre. Cela cre une barre
de sparation dans le menu.
Slectionnez llment en dessous de la barre de sparation et dfinissez
sa proprit Action par FileExit1.

Tutoriel : cration dun diteur de texte 4-21


Ajout du support pour un menu et une barre doutils

7 Ensuite, crez le menu Edition :


Slectionnez llment droite de la commande Fichier, dfinissez
sa proprit Caption par &Edition puis appuyez sur Entre.
La focalisation est maintenant sur llment situ sous Edition ; dfinissez sa
proprit Action par EditCut1.
Slectionnez llment en dessous de Couper et dfinissez sa proprit
Action par EditCopy1.
Slectionnez llment en dessous de Copier et dfinissez sa proprit
Action par EditPaste1.

8 Crez un menu Aide :


Slectionnez llment droite de la commande Edition, dfinissez sa
proprit Caption par &Aide puis appuyez sur Entre.
Slectionnez llment en dessous de Aide et dfinissez sa proprit Action
par HelpContents.
Slectionnez llment en dessous de Rubriques daide et dfinissez sa
proprit Action par AideIndex.
Slectionnez llment en dessous de Index, entrez un tiret (-) aprs sa
proprit Caption puis appuyez sur Entre pour crer une barre de
sparation dans le menu Aide.
Slectionnez llment en dessous de la barre de sparation et dfinissez sa
proprit Action par AideApropos.
9 Cliquez sur le X pour fermer le concepteur de menus.
10 Choisissez Fichier|Tout enregistrer.
11 Pour revenir en mode conception, cliquez sur le X dans le coin suprieur droit
de lapplication.
Remarque Si vous ne voyez pas la fiche, cliquez sur Voir|Fiches, slectionnez Form1 et
cliquez sur OK.

4-22 Prise en main


Ajout du support pour un menu et une barre doutils

Ajout dune barre doutils (dition Personnelle)


Comme vous avez dfini des actions dans une liste dactions, vous pouvez
ajouter une barre doutils certaines des actions utilises dans les menus.
1 Dans la page Win32 de la palette de composants, double-cliquez sur le
composant ToolBar pour lajouter la fiche. Une barre doutils vide est ajoute
sous le menu principal.
2 La barre doutils tant slectionne, modifiez les proprits suivantes dans
linspecteur dobjets :
Initialisez sa proprit Images ImageList1.
Initialisez la proprit Indent de la barre doutils 4 (cela indente licne de
4 pixels de la gauche de la barre doutils).
Initialisez ShowHint true. (Conseil : Double-cliquez sur false pour changer
la valeur en true).
3 Pour ajouter des boutons la barre doutils, cliquez avec le bouton droit de la
souris et choisissez quatre fois Nouveau bouton.
4 Pour ajouter une barre de sparation la barre doutils, cliquez avec le bouton
droit de la souris et choisissez Nouveau sparateur.
5 Cliquez avec le bouton droit de la souris et choisissez Nouveau bouton encore
trois fois.
Remarque Ne vous inquitez pas si les images ne sont pas encore correctes. Les images
correctes seront ajoutes quand vous affecterez des actions aux boutons.

Par dfaut, lobjet barre


doutils est ajout sous les
menus.
Pour ajouter des boutons ou
des sparateurs, slectionnez
la barre doutils, cliquez avec
le bouton droit de la souris et
choisissez Nouveau bouton
ou Nouveau sparateur. Puis
attribuez des actions de la
liste dactions.

6 Attribuez des actions de la liste dactions au premier groupe de boutons.


Slectionnez le premier bouton et initialisez sa proprit Action
FichierNouveau.
Slectionnez le second bouton et initialisez sa proprit Action FileOpen1.

Tutoriel : cration dun diteur de texte 4-23


Effacement de la zone de texte (toutes ditions)

Slectionnez le troisime bouton et initialisez sa proprit Action


FichierEnregistrer.
Slectionnez le quatrime bouton et initialisez sa proprit Action
FileExit1.
7 Attribuez des actions au second groupe de boutons.
Slectionnez le cinquime bouton et initialisez sa proprit Action EditCut1.
Slectionnez le sixime bouton et initialisez sa proprit Action EditCopy1.
Slectionnez le dernier bouton et initialisez sa proprit Action EditPaste1.
8 Choisissez Fichier|Tout enregistrer.
9 Appuyez sur F9 pour compiler et excuter le projet.
Remarque Vous pouvez galement excuter le projet en cliquant sur le bouton Excuter
de la barre doutils Dbogage, ou en choisissant Excuter dans le menu
Excuter.
Quand vous appuyez sur F9
pour excuter le projet,
linterface de lapplication est
affiche. Les menus, la zone
de texte et la barre dtat
apparaissent dans la fiche.
Pour revenir en mode
conception, cliquez sur le X
pour fermer la fiche.

Quand vous excutez le projet, C++Builder ouvre le programme dans une


fentre dexcution semblable celle que vous avez conue dans la fiche.
Les menus fonctionnent tous, mme si beaucoup de commandes sont grises.
Les images apparaissent ct des lments de menu, associes par lindice
de limage.
Votre diteur de texte dispose dj dun grand nombre de fonctionnalits.
Vous pouvez saisir du texte dans la zone de saisie. Si vous slectionnez du
texte, les boutons Couper, Copier et Coller fonctionnent.
10 Cliquez sur le X dans le coin suprieur droit pour fermer lapplication et
revenir en mode conception de la fiche.

Effacement de la zone de texte (toutes ditions)


Important La suite de ce tutoriel est ralisable avec toutes les ditions.
Quand vous excutez votre programme, le nom RichEdit1 apparat dans la zone
de texte. Vous pouvez retirer ce texte en utilisant lditeur de liste de chanes.
Si vous neffacez pas le texte maintenant, le texte sera effac lors de
linitialisation de la fiche principale la dernire tape.

4-24 Prise en main


Ecriture de gestionnaires dvnements

Pour effacer la zone de texte :


1 Dans la fiche principale, cliquez sur le composant RichEdit1.
2 Dans linspecteur dobjets, droite de la proprit Lines, double-cliquez sur
la valeur (TStrings) afin dafficher lditeur de liste de chanes.
3 Dans lditeur de liste de chanes, slectionnez et supprimez le texte
(RichEdit1), puis cliquez sur OK.
4 Enregistrez vos modifications et excutez nouveau le programme.
La zone de texte est maintenant vide quand la fiche principale est affiche.

Ecriture de gestionnaires dvnements


Jusque l, vous avez dvelopp votre application sans crire la moindre ligne
de code. En utilisant linspecteur dobjets pour dfinir la valeur des proprits au
moment de la conception, vous avez pleinement bnfici des avantages de
lenvironnement RAD de C++Builder. Dans cette section, vous allez crire des
fonctions appeles gestionnaires dvnements qui rpondent aux saisies des
utilisateurs quand lapplication sexcute. Vous connecterez les gestionnaires
dvnements aux lments des menus et de la barre doutils, afin que
lapplication excute le code du gestionnaire quand un lment est slectionn
dans votre application.
Pour les actions non standard, vous devez crer des gestionnaires dvnements.
Pour les actions standard comme les commandes Fichier|Quitter ou Edition|
Coller, les vnements sont dj inclus dans le code. Nanmoins, pour certaines
actions standard comme la commande Fichier|Enregistrer sous, vous pouvez
crire votre propre gestionnaire dvnement pour personnaliser la commande.
Comme tous les lments de menu et les boutons de la barre doutils sont
centraliss dans lditeur du gestionnaire dactions ou dans lditeur de liste
dactions, cest l que vous allez crer les gestionnaires dvnements.
Important Si vous avez ldition Personnelle de C++Builder, utilisez le composant ActionList
au lieu du composant ActionManager dans les tapes suivantes.

Cration dun gestionnaire dvnement pour la commande


Nouveau
Pour crer un gestionnaire dvnement pour la commande Nouveau :
1 Choisissez Voir|Units et slectionnez Unit1 pour afficher le code associ
Form1.
2 Vous devez dabord dclarer un nom de fichier qui sera utilis dans le
gestionnaire dvnement. Ajoutez une proprit personnalise pour le nom
du fichier afin de la rendre accessible globalement. Ouvrez le fichier Unit1.h
en cliquant avec le bouton droit de la souris dans le fichier Unit1.cpp dans
lditeur de code et en choisissant Ouvrir le fichier source/en-tte

Tutoriel : cration dun diteur de texte 4-25


Ecriture de gestionnaires dvnements

(ou en cliquant sur longlet Unit1.h dans lditeur de code. Dans le fichier en-
tte, recherchez la section des dclarations publiques de la classe TForm1 et
aprs la ligne suivante
public: // Dclarations de lutilisateur
saisissez :
AnsiString NomFichier;
Votre cran doit avoir laspect suivant :

Cette ligne dfinit


NomFichier comme
une chane accessible
globalement par toutes
les autres mthodes.

3 Appuyez sur F12 pour revenir la fiche principale.


Astuce F12 est une bascule qui vous fait aller et venir entre une fiche et le code qui
lui est associ. Vous pouvez aussi choisir Voir|Fiches et choisir Form1.
4 Double-cliquez sur le composant ActionManager ou ActionList pour louvrir.
5 Double-cliquez sur laction FichierNouveau.
Astuce Vous pouvez galement double-cliquer sur laction FichierNouveau dans
larborescence dobjets.

4-26 Prise en main


Ecriture de gestionnaires dvnements

Lditeur de code souvre avec le curseur plac dans le gestionnaire


dvnement.
Commencez par double-cliquer sur lobjet liste dactions ou gestionnaire
dactions pour afficher lditeur appropri.

Puis, double-cliquez
sur laction pour crer un
gestionnaire dvnement
vide dans lequel vous
pouvez spcifier ce qui se
produit quand lutilisateur
excute la commande

6 Entrez les lignes suivantes, l o le curseur est positionn dans lditeur de


code (entre { et }) :
RichEdit1->Clear();
NomFichier = "sans titre.txt";
StatusBar1->Panels->Items[0]->Text = NomFichier;
Une fois termin, le gestionnaire dvnement doit avoir laspect suivant :

Cette ligne efface la zone


de texte quand vous crez
un nouveau fichier.
Cette ligne appelle
le nouveau fichier
sans titre.txt.
Cette ligne place le nom
du fichier dans la barre
dtat.

7 Choisissez Fichier|Tout enregistrer.


Remarque Vous pouvez redimensionner la partie code de la fentre pour rduire
le dfilement horizontal.

Tutoriel : cration dun diteur de texte 4-27


Ecriture de gestionnaires dvnements

Cration dun gestionnaire dvnement pour la commande Ouvrir


Pour ouvrir un fichier dans lditeur de texte, vous devez utiliser une bote de
dialogue standard Windows douverture de fichier. Vous avez dj ajout une
commande standard Fichier|Ouvrir dans lditeur du gestionnaire dactions ou
dans lditeur de liste dactions, ce qui inclut automatiquement la bote de
dialogue. Cependant, il reste personnaliser le gestionnaire dvnement de la
commande.
1 Appuyez sur F12 pour localiser la fiche principale et double-cliquez sur le
composant ActionManager ou ActionList pour le mettre au premier plan.
2 Slectionnez laction FileOpen1.
3 Dans linspecteur dobjets, cliquez sur le signe plus gauche de Dialog pour
dvelopper ses proprits. Dialog est un composant rfrenc qui cre la bote
de dialogue douverture. C++Builder nomme par dfaut la bote de dialogue
FileOpen1->OpenDialog. Quand la mthode Execute de OpenDialog1 est appele,
elle dclenche la bote de dialogue standard douverture de fichier.
4 Dfinissez la proprit DefaultExt par txt.
5 Double-cliquez dans la zone de texte ct de Filter pour afficher lditeur de
filtres.
Dans la premire ligne de la colonne Nom de filtre, entrez Fichiers texte
(*.txt). Dans la colonne Filtrer, entrez *.txt.
Dans la deuxime ligne, entrez Tous les fichiers (*.*) dans la colonne
Nom de filtre et *.* dans la colonne Filtrer.
Cliquez sur OK.

Utilisez lditeur de filtres


pour dfinir les filtres des
actions FileOpen1.Dialog et
FileSaveAs1.Dialog.

6 Dfinissez Title par Ouvrir fichier. Ces mots apparaissent en haut de la bote
de dialogue douverture.
7 Cliquez sur longlet Evnements. Double-cliquez sur la zone droite de
lvnement OnAccept afin de faire apparatre FileOpen1Accept.
Lditeur de code souvre, le curseur tant positionn dans le gestionnaire
dvnement.
8 Entrez les lignes suivantes, l o le curseur est positionn (entre { et }) :
RichEdit1->Lines->LoadFromFile (FileOpen1->Dialog->FileName);

4-28 Prise en main


Ecriture de gestionnaires dvnements

NomFichier = FileOpen1->Dialog->FileName;
StatusBar1->Panels->Items[0]->Text = NomFichier;
Astuce Vous pouvez utiliser les outils daudit de code dcrits page 2-6 pour crire
plus rapidement votre code. Par exemple, aprs avoir tap la flche (->)aprs
RichEdit1, la bote de dialogue dachvement du code apparat. Tapez un l
pour que Lines : TStrings; apparaisse en haut de la bote de dialogue.
Appuyez sur Entre ou double-cliquez dessus pour lajouter votre code.
Une fois termin, le gestionnaire dvnement FileOpen doit avoir laspect
suivant :

Cette ligne insre le texte


du fichier spcifi.
Cette ligne initialise le nom
de fichier avec la valeur
spcifie dans la bote de
dialogue douverture.
Cette ligne place le nom du
fichier dans la barre dtat.

Cest termin pour la commande Fichier|Ouvrir et la bote de dialogue


douverture.

Cration dun gestionnaire dvnement pour la commande


Enregistrer
Pour crer un gestionnaire dvnement pour la commande Enregistrer :
1 Appuyez sur F12 pour afficher la fiche et double-cliquez sur le composant
ActionManager ou ActionList.
2 Double-cliquez sur laction FichierEnregistrer.
Lditeur de code souvre, le curseur tant positionn dans le gestionnaire
dvnement.
Astuce Vous pouvez galement double-cliquer sur laction FichierEnregistrer dans
larborescence dobjets.
3 Entrez les lignes suivantes, l o le curseur est positionn (entre { et }) :
if (NomFichier == "sans titre.txt")
FileSaveAs1->Execute();
else
RichEdit1->Lines->SaveToFile(NomFichier);
Ce code indique lditeur de code dafficher une bote de dialogue
Enregistrer sous si le fichier na pas encore de nom afin que lutilisateur

Tutoriel : cration dun diteur de texte 4-29


Ecriture de gestionnaires dvnements

puisse lui attribuer un nom. Sinon, le fichier est enregistr en utilisant le nom
en cours. La bote de dialogue Enregistrer sous est dfinie dans le gestionnaire
dvnement de la commande Enregistrer sous. FileSaveAs1BeforeExecute est le
nom automatiquement gnr pour la commande Enregistrer sous.
Une fois termin, le gestionnaire dvnement doit avoir laspect suivant :

Si le fichier na pas de
nom, affiche la bote de
dialogue Enregistrer sous.
Sinon, enregistre le fichier
nomm.

Cest termin pour la commande Fichier|Enregistrer.

Cration dun gestionnaire dvnement pour la commande


Enregistrer sous
Quand la mthode Execute de SaveDialog est appele, elle dclenche la bote de
dialogue standard denregistrement de fichier, Enregistrer sous. Pour crer un
gestionnaire dvnement pour la commande Enregistrer sous :
1 Appuyez sur F12 pour afficher la fiche et double-cliquez sur le composant
ActionManager ou ActionList.
2 Slectionnez laction FileSaveAs1.
3 Dans linspecteur dobjets, cliquez sur longlet Proprits. Cliquez sur le signe
plus gauche de Dialog pour dvelopper ses proprits. Dialog fait rfrence
au composant de la bote de dialogue Enregistrer sous et affiche ses
proprits.
4 Initialisez DefaultExt txt.
5 Double-cliquez dans la zone de texte ct de Filter pour afficher lditeur de
filtres. Dans lditeur de filtres, spcifiez les filtres pour les types de fichiers
comme dans la bote de dialogue douverture.
Dans la premire ligne de la colonne Nom de filtre, entrez Fichiers texte
(*.txt). Dans la colonne Filtrer, entrez *.txt.
Dans la deuxime ligne, entrez Tous les fichiers (*.*) dans la colonne
Nom de filtre et *.* dans la colonne Filtrer.
Cliquez sur OK.
6 Initialisez Title Enregistrer sous.

4-30 Prise en main


Ecriture de gestionnaires dvnements

7 Cliquez sur longlet Evnements. Double-cliquez dans la zone de texte ct


de BeforeExecute afin que lditeur de code souvre avec le curseur dans le
gestionnaire dvnement FileSaveAs1BeforeExecute.
8 A droite de la position du curseur dans lditeur de code, saisissez la ligne
suivante :
FileSaveAs1->Dialog->InitialDir = ExtractFilePath (NomFichier);
9 Longlet Evnements doit encore tre affich. Double-cliquez dans la zone de
texte ct de lvnement OnAccept de sorte que FileSaveAs1Accept apparaisse
dans lditeur de code.
10 A lendroit mme o le curseur est positionn, entrez les lignes suivantes :
NomFichier = FileSaveAs1->Dialog->FileName;
RichEdit1->Lines->SaveToFile(Nomfichier);
StatusBar1->Panels->Items[0]->Text = NomFichier;

Une fois termin, le gestionnaire dvnement FileSaveAs doit avoir laspect


suivant :

Le rpertoire par dfaut est


initialis au dernier utilis.
Cette ligne initialise la proprit
NomFichier de la fiche principale
la valeur spcifie dans la bote
de dialogue Enregistrer sous.
Cette ligne enregistre le texte
dans le fichier spcifi.
Cette ligne place le nom du
fichier dans le volet texte de la
barre dtat.

11 Choisissez Fichier|Tout enregistrer pour enregistrer vos modifications.


12 Pour voir ce que donne lapplication ce stade, appuyez sur F9.

Lapplication en cours
dexcution ressemble
beaucoup la fiche principale
en conception. Remarquez
que les objets non visuels
napparaissent pas.
Vous pouvez fermer
lapplication de trois
manires :
Cliquez sur le X.
Choisissez Fichier|Quitter.
Cliquer sur le bouton Quitter
lapplication dans la barre
doutils.

Tutoriel : cration dun diteur de texte 4-31


Cration dun fichier daide

Si vous obtenez un message derreur en bas de lditeur de code, double-


cliquez dessus pour vous positionner l o lerreur sest produite dans le
code. Assurez-vous que vous avez bien suivi les tapes de ce tutoriel.
13 Pour revenir en mode conception, cliquez sur le X dans le coin suprieur droit
de lapplication.

Cration dun fichier daide


Cest une bonne ide de crer un fichier daide qui explique lutilisateur
comment utiliser votre application. C++Builder propose lutilitaire Microsoft Help
Workshop dans le rpertoire C:\Project Files\Borland\CBuilder6\Help\Tools,
qui contient des informations sur la conception et la compilation dun fichier
daide Windows. Dans lapplication exemple diteur de texte, les utilisateurs
peuvent choisir les commandes Aide|Rubriques daide et Aide|Index pour
accder un fichier daide en affichant soit les rubriques daide, soit lindex de
laide.
Vous avez cr prcdemment les actions Rubriques daide et Index dans le
gestionnaire dactions ou la liste dactions pour afficher, respectivement, longlet
Sommaire et longlet Index dun fichier daide compil. Il est ncessaire daffecter
des valeurs de constantes aux paramtres daide et de crer des gestionnaires
dvnements qui affichent ce que vous voulez.
Pour utiliser les commandes daide, vous avez besoin de crer et de compiler un
fichier daide Windows. La cration de fichiers daide sort du cadre de ce
tutoriel. Vous pouvez utiliser un fichier exemple rtf (TextEditor.rtf), un fichier
daide (TextEditor.hlp) et un fichier sommaire (TextEditor.cnt) :
1 Dans lexplorateur de Windows, depuis votre rpertoire C:\Program Files\
Borland\CBuilder6\Help, ouvrez B6X1.zip
2 Extrayez et enregistrez les fichiers .hlp et .cnt dans le rpertoire de votre
diteur de texte, par dfaut C:\Program Files\Borland\CBuilder6\Projects\
TextEditor.
Remarque Vous pouvez aussi utiliser dans votre projet nimporte quel fichier .hlp ou .cnt
(par exemple lun des fichiers daide de C++Builder et son fichier .cnt associ).
Il vous suffit juste de le copier dans le rpertoire de votre projet et de les
renommer TextEditor.hlp et TextEditor.cnt afin que lapplication puisse les
trouver.

Cration dun gestionnaire dvnement pour la commande


Rubriques daide
Pour crer un gestionnaire dvnement pour la commande Rubriques daide :
1 Double-cliquez sur le composant ActionManager ou ActionList.
2 Double-cliquez sur laction HelpContents1.

4-32 Prise en main


Cration dun fichier daide

Lditeur de code souvre, le curseur tant positionn dans le gestionnaire


dvnement.
3 Juste aprs la position du curseur, entrez les lignes suivantes :
const static int ONGLET_AIDE = 15;
const static int SOMMAIRE_ACTIF = -3;
Application->HelpCommand(ONGLET_AIDE, SOMMAIRE_ACTIF);
Ce code dfinit les valeurs des constantes utilises comme paramtres de la
mthode HelpCommand. ONGLET_AIDE est initialise 15 pour afficher la
bote de dialogue Aide et SOMMAIRE_ACTIF -3 pour afficher longlet
Sommaire de laide.
Une fois termin, le gestionnaire dvnement doit avoir laspect suivant :

Ces lignes dfinissent


les paramtres
commande et donnes
de la mthode
HelpCommand de
TApplication.
Cette ligne demande
louverture de la bote
de dialogue daide
en affichant longlet
Sommaire.

Remarque Pour obtenir des informations sur la mthode HelpCommand, placez le


curseur ct de HelpCommand dans lditeur et appuyez sur F1.
Cest tout pour la commande Aide|Rubriques daide.

Cration dun gestionnaire dvnement pour la commande Index


de laide
Pour crer un gestionnaire dvnement pour la commande Index de laide :
1 Le gestionnaire dactions ou lditeur de liste dactions doit tre encore affich.
Si ce nest pas le cas, double-cliquez sur le composant ActionManager ou
ActionList dans la fiche.
2 Double-cliquez sur laction AideIndex.
Lditeur de code souvre, le curseur tant positionn dans le gestionnaire
dvnement.
3 Juste avant la position du curseur dans lditeur de code, entrez les lignes
suivantes :
const static int ONGLET_AIDE = 15;
const static int INDEX_ACTIF = -2;
Application->HelpCommand(ONGLET_AIDE, INDEX_ACTIF);

Tutoriel : cration dun diteur de texte 4-33


Cration dune bote de dialogue A propos

Ce code dfinit les valeurs de constantes utilises comme paramtres de la


mthode HelpCommand. ONGLET_AIDE est initialise 15 pour afficher la
bote de dialogue Aide et INDEX_ACTIF -2 pour afficher longlet Index
de laide.
Une fois termin, le gestionnaire dvnement doit avoir laspect suivant :

Ces lignes dfinissent


les paramtres
commande et donnes
de la mthode
HelpCommand de
TApplication.
Cette ligne demande
louverture de la bote
de dialogue daide en
affichant longlet Index.

Cest tout pour la commande Aide|Index.

Cration dune bote de dialogue A propos


De nombreuses applications proposent une bote de dialogue A propos qui
affiche des informations sur le produit : son nom, la version, un logo ou dautres
informations lgales comme le copyright.
Vous avez dj dfini une commande AideApropos dans lditeur du
gestionnaire dactions ou de liste dactions.
Pour crer une bote de dialogue A propos :
1 Choisissez Fichier|Nouveau|Autre pour afficher la bote de dialogue
Nouveaux lments.
2 Cliquez sur longlet Fiches et double-cliquez sur licne Bote A propos.

La bote de dialogue Nouveaux lments est


galement appele Rfrentiel dobjets.
Quand vous crez un lment partir dun
lment du rfrentiel, vous pouvez copier,
hriter ou utiliser llment.
Copier (pris par dfaut) cre une copie
de llment dans votre projet. Hriter signifie
que les modifications faites lobjet dans le
rfrentiel sont hrites par lobjet dans votre
projet. Utiliser signifie que les modifications
faites dans lobjet de votre projet sont
appliques lobjet du rfrentiel.

4-34 Prise en main


Cration dune bote de dialogue A propos

Une fiche prdfinie pour la bote A propos apparat.


3 Slectionnez la fiche elle-mme (cliquez sur la grille) et dans linspecteur
dobjets, cliquez sur longlet Proprits et changez sa proprit Caption en
A propos de lditeur de texte.
4 Cliquez nouveau sur la fiche (remarquez quelle sappelle maintenant
A propos de lditeur de texte). Pour changer chaque valeur sur la fiche, cliquez
dessus pour la mettre en vidence et tapez la nouvelle valeur.
Changez Product Name en Editeur de texte.
Changez Version en Version 1.0.
Changez Copyright en Copyright 2002.

Le rfrentiel dobjets
contient une bote
A propos standard que
vous pouvez modifier
votre guise pour dcrire
votre application.

5 Enregistrez la fiche A propos en choisissant Fichier|Enregistrer sous et en


lenregistrant sous le nom Apropos.cpp.
Dans lditeur de code de C++Builder, vous devez avoir plusieurs fichiers
affichs : Unit1.cpp, Unit1.h, Apropos.cpp, et ActnRes (si vous disposez de
ldition Entreprise ou Professionnelle et avez utilis lditeur du gestionnaire
dactions). Vous navez pas besoin de lunit ActnRes, mais vous pouvez
la laisser l.
6 Cliquez sur longlet Unit1.cpp et positionnez-vous au dbut de lditeur de
code. Dans Unit1, ajoutez une instruction include pour lunit Apropos.
Choisissez Fichier|Inclure len-tte dunit, puis slectionnez Apropos

Tutoriel : cration dun diteur de texte 4-35


Achvement de lapplication

et cliquez sur OK. Remarquez que #include "Apropos.h" a t ajout au dbut


du fichier .cpp.
Cliquez sur longlet pour afficher le fichier associ lunit. Si vous ouvrez
dautres fichiers alors que vous travaillez dans un projet, lditeur de code
affiche des onglets supplmentaires.

Quand vous crez une nouvelle fiche dans lapplication, vous devez lajouter la fiche
principale. Choisissez Fichier|Inclure len-tte dunit et slectionnez len-tte ajouter.

7 Appuyez sur F12 pour revenir en mode conception. Double-cliquez sur le


composant ActionManager ou ActionList pour louvrir.
8 Double-cliquez sur laction Aide|A propos pour crer un gestionnaire
dvnement. A droite de la position du curseur dans lditeur de code,
saisissez la ligne suivante :
AboutBox->ShowModal();
Ce code ouvre la bote de dialogue A propos quand lutilisateur choisit Aide|
A propos. ShowModal ouvre la fiche ltat modal. Cela signifie que
lutilisateur ne peut rien faire lexcution tant que la fiche nest pas ferme.
9 Choisissez Fichier|Tout enregistrer.

Achvement de lapplication
Lapplication est presque termine. Il reste cependant spcifier certains
lments dans la fiche principale. Pour achever lapplication :
1 Appuyez sur F12 pour vous positionner sur la fiche principale.
2 Slectionnez la fiche. La focalisation doit se trouver sur la fiche, pas sur lun
de ses composants. Si ce nest pas le cas, slectionnez Form1 TForm1 dans la
liste droulante en haut de linspecteur dobjets.

4-36 Prise en main


Achvement de lapplication

3 Cliquez sur longlet Evnements et double-cliquez sur la zone ct de


OnCreate.
Vrifiez ici que la focalisation se trouve sur
la fiche principale. Si ce nest pas le cas,
slectionnez Form1 dans la liste droulante.

Double-cliquez ici pour crer un gestionnaire


dvnement pour lvnement OnCreate de
la fiche.

4 A lendroit mme o le curseur est positionn dans lditeur de code, entrez


les lignes suivantes :
Application->HelpFile = ExtractFilePath(Application->ExeName) + "TextEditor.hlp";
NomFichier = "sans titre.txt";
StatusBar1->Panels->Items[0]->Text = NomFichier;
RichEdit1->Clear();
Ce code initialise lapplication : il associe un fichier daide, initialise la valeur
de NomFichier sans titre.txt, place le nom du fichier dans la barre dtat
et efface la zone de texte.

5 Choisissez Fichier|Tout enregistrer pour enregistrer vos modifications.


6 Appuyez sur F9 pour excuter lapplication.
Flicitations ! Vous avez fini.

Tutoriel : cration dun diteur de texte 4-37


4-38 Prise en main
Chapitre

Tutoriel : cration dune application


Chapitre 5
5
de base de donnes CLX
Ce tutoriel vous guide dans la cration dune application multiplate-forme vous
permettant de voir et de mettre jour la base de donnes exemple employee.
Les applications multiplates-formes utilisent CLX, la bibliothque de composants
pour le dveloppement multiplates-formes de Borland. Conues pour tre
compiles et excutes sur diffrentes plates-formes, les applications CLX
ncessitent un minimum de modifications entre les ports Windows et Linux.
(Voir les dernires offres de produits Borland relatives au support du
compilateur multiplate-forme.)
Remarque Ce tutoriel est crit pour les ditions du produit qui incluent les composants
pour bases de donnes. Il dfinit des accs aux bases de donnes qui exigent des
fonctionnalits non disponibles dans ldition Personnelle. De plus, vous devez
avoir install InterBase pour effectuer ce tutoriel avec succs.

Prsentation de larchitecture des bases de donnes


De prime abord, larchitecture dune application de base de donnes peut
paratre complique, mais, lutilisation de plusieurs composants simplifie le
dveloppement et la maintenance des applications de bases de donnes relles.
Les applications de bases de donnes se composent de trois parties principales :
linterface utilisateur, un ensemble de composants daccs aux donnes et la base
de donnes elle-mme. Dans ce tutoriel, vous allez crer une application de base
de donnes dbExpress. Les applications relatives aux autres bases de donnes
prsentent une architecture similaire.
Linterface utilisateur contient des contrles orients donnes, comme une grille,
permettant aux utilisateurs de modifier et de valider les donnes de la base.
Les composants daccs aux donnes comprennent la source de donnes,

Tutoriel : cration dune application de base de donnes CLX 5-1


Cration dune nouvelle application CLX

lensemble de donnes client, le fournisseur de donnes, un ensemble de donnes


unidirectionnel et un composant connexion. La source de donnes relie linterface
utilisateur un ensemble de donnes client. Lensemble de donnes client est le
cur de lapplication car il contient un ensemble denregistrements issus de la
base de donnes sous-jacente et placs dans un tampon en mmoire.
Le fournisseur transfre les donnes entre lensemble de donnes client et
lensemble de donnes unidirectionnel, qui lit directement les donnes depuis
la base de donnes. Enfin, le composant connexion tablit la connexion la base
de donnes. Chaque type densemble de donnes unidirectionnel utilise un type
de composant connexion diffrent.

Pour plus dinformations sur le dveloppement de bases de donnes, voir


Conception dapplications de bases de donnes dans le Guide du dveloppeur ou
dans laide en ligne.

Cration dune nouvelle application CLX


Avant de commencer le tutoriel, crez le dossier qui contiendra les fichiers
source. Puis, crez et enregistrez un nouveau projet.
1 Crez un dossier appel Tutoriel pour contenir les fichiers du projet que vous
allez crer pendant votre travail au cours de ce tutoriel.
2 Commencez un nouveau projet CLX. Pour crer un nouveau projet multiplate-
forme, choisissez Fichier|Nouveau|Application CLX.
3 Choisissez Fichier|Tout enregistrer pour enregistrer sur disque vos fichiers.
Lorsque le dialogue denregistrement apparat, naviguez jusqu votre dossier
Tutoriel et enregistrez chaque fichier en utilisant le nom par dfaut.

5-2 Prise en main


Installation des composants daccs aux donnes

Par la suite, vous pourrez enregistrer votre travail tout moment en


choisissant Fichier|Tout enregistrer. Si vous dcidez de ne pas terminer le
tutoriel en une fois, vous pourrez ouvrir la version enregistre en choisissant
Fichier|Rouvrir et en slectionnant le tutoriel dans la liste.

Installation des composants daccs aux donnes


Les composants daccs aux donnes reprsentent la fois les donnes
(ensembles de donnes) et les composants qui connectent ces ensembles de
donnes aux autres parties de votre application. Chacun de ces composants
daccs aux donnes pointe sur le composant immdiatement infrieur.
Par exemple, la source de donnes pointe sur lensemble de donnes client,
lensemble de donnes client pointe sur le fournisseur, et ainsi de suite.
Donc, quand vous installez vos composants daccs aux donnes, ajoutez-les dans
lordre appropri.
Dans les sections suivantes, vous allez ajouter les composants de bases de
donnes pour crer la connexion la base, lensemble de donnes
unidirectionnel, le fournisseur, lensemble de donnes client et la source de
donnes. Ensuite, vous crerez linterface utilisateur de lapplication.
Ces composants se trouvent sur les pages dbExpress, AccsBD et ContrleBD
de la palette de composants.
Astuce Il est conseill disoler linterface utilisateur sur une fiche indpendante et de
placer les composants daccs aux donnes dans un module de donnes. Mais,
pour simplifier ce tutoriel, vous placerez linterface utilisateur et tous les
composants sur la mme fiche.

Installation de la connexion la base de donnes


La page dbExpress contient un ensemble de composants qui permettent
daccder rapidement aux serveurs de base de donnes SQL.
Vous devez ajouter un composant connexion qui vous permettra de vous
connecter une base de donnes. Le type du composant connexion dpendra du
type de composant ensemble de donnes utilis. Dans ce tutoriel, vous utiliserez
les composants TSQLConnection et TSQLDataSet.
Pour ajouter un composant de connexion dbExpress :
1 Cliquez sur la page dbExpress de la palette des composants et double-cliquez
sur le composant TSQLConnection pour le placer sur la fiche. Pour trouver le
composant TSQLConnection, pointez sur chaque icne de la palette pendant un
moment ; un conseil daide vous montrera le nom de chaque composant.
Le composant est nomm SQLConnection1 par dfaut.
Le composant TSQLConnection ntant pas visuel, lendroit o vous le placez
na pas dimportance. Mais pour ce tutoriel, le plus simple est daligner les
composants non visuels en haut de la fiche.

Tutoriel : cration dune application de base de donnes CLX 5-3


Installation des composants daccs aux donnes

Astuce Pour afficher les libells des composants que vous placez sur une fiche,
choisissez Outils|Options denvironnement et cliquez sur Afficher les libells
des composants.
2 Dans linspecteur dobjets, dfinissez sa proprit ConnectionName par IBLocal
(ce terme apparat dans la liste droulante).
3 Initialisez la proprit LoginPrompt false. (Dfinir cette proprit par false
vite une demande de connexion chacun de vos accs la base.)
4 Double-cliquez sur le composant TSQLConnection pour afficher lditeur de
connexion.

Vous utiliserez lditeur de connexion afin de slectionner une configuration


de connexion pour le composant TSQLConnection ou pour modifier les
connexions stockes dans le fichier dbxconnections.ini. Toutes les
modifications effectues dans le dialogue sont crites dans ce fichier lorsque
vous cliquez sur OK. De plus, lorsque vous cliquez sur OK, la connexion
slectionne est attribue comme valeur la proprit ConnectionName du
composant connexion SQL.
5 Dans lditeur de connexion, spcifiez le chemin daccs sur votre systme au
fichier base de donnes employee.gdb. Dans ce tutoriel, vous vous connecterez
une base de donnes exemple InterBase, employee.gdb, fournie avec
C++Builder. Par dfaut, linstallation dInterBase place employee.gdb dans
C:\Program Files\Common Files\Borland Shared\Data.
6 Vrifiez que les champs Nom dutilisateur et Mot de passe contiennent des
valeurs acceptables. Si vous navez pas modifi les valeurs par dfaut, vous
navez pas besoin de modifier ces champs. Si laccs la base de donnes est
sous le contrle dun autre administrateur, vous risquez davoir besoin dun
nom dutilisateur et dun mot de passe par avoir accs la base de donnes.
7 Lorsque vous avez fini de vrifier et de modifier les champs, cliquez sur OK
pour fermer lditeur de connexion et enregistrer vos modifications.

5-4 Prise en main


Installation des composants daccs aux donnes

Ces modifications sont crites dans le fichier dbxconnections.ini et la


connexion slectionne est attribue comme valeur la proprit
ConnectionName du composant connexion SQL.
Astuce Si vous avez besoin dune assistance particulire lorsque vous utilisez lditeur
de connexion, cliquez sur le bouton Aide.
8 Choisissez Fichier|Tout enregistrer pour enregistrer votre projet.

Installation de lensemble de donnes unidirectionnel


Une application de base de donnes type utilise un ensemble de donnes pour
accder aux informations de la base. Dans les applications dbExpress, on utilise
un ensemble de donnes unidirectionnel. Un ensemble de donnes
unidirectionnel lit les donnes de la base mais ne les met pas jour.
Pour ajouter lensemble de donnes unidirectionnel :
1 A partir de longlet dbExpress, placez un TSQLDataSet en haut de la fiche.
2 Dans linspecteur dobjets, dfinissez sa proprit SQLConnection par
SQLConnection1 (la connexion de base de donnes cre prcdemment).
3 Dfinissez CommandText par select * from SALES pour spcifier la commande
excute par lensemble de donnes. Vous pouvez soit taper linstruction
Select dans linspecteur dobjets, soit cliquer sur les points de suspension
droite de CommandText pour afficher lditeur de CommandText, dans lequel
vous pouvez construire votre propre instruction de requte.
Astuce Si vous avez besoin dune assistance particulire lorsque vous utilisez lditeur
de CommandText, cliquez sur le bouton Aide.
4 Dfinissez Active par true pour ouvrir lensemble de donnes.
5 Choisissez Fichier|Tout enregistrer pour enregistrer le projet.

Installation du fournisseur, de lensemble de donnes client et de


la source de donnes
La page AccsBD contient des composants pouvant tre utiliss avec nimporte
quel mcanisme daccs aux donnes, et pas seulement avec dbExpress.
Les composants fournisseur sont pour les ensembles de donnes client le moyen
dobtenir leurs donnes en provenance des autres ensembles de donnes.
Le fournisseur reoit les demandes de donnes issues de lensemble de donnes
client, lit les donnes, cre des paquets de donnes et les renvoie lensemble
de donnes client. Si vous utilisez dbExpress, le fournisseur reoit les mises
jour dun ensemble de donnes client et les applique au serveur de la base
de donnes.

Tutoriel : cration dune application de base de donnes CLX 5-5


Conception de linterface utilisateur

Pour ajouter le fournisseur :


1 A partir de la page AccsBD, dposez un composant TDataSetProvider en haut
de la fiche.
2 Dans linspecteur dobjets, dfinissez la proprit DataSet du fournisseur par
SQLDataSet1.
Lensemble de donnes client met ses donnes en mmoire tampon. Il met
galement en mmoire cache les mises jour envoyer la base de donnes.
Vous pouvez utiliser les ensembles de donnes client pour fournir des donnes
aux contrles orients donnes de linterface utilisateur laide du composant
source de donnes.
Pour ajouter lensemble de donnes client :
1 A partir de la page AccsBD, dposez un composant TClientDataSet droite
du composant TDataSetProvider.
2 Dfinissez la proprit ProviderName par DataSetProvider1.
3 Dfinissez la proprit Active par true pour permettre la transmission des
donnes votre application.
Une source de donnes se connecte lensemble de donnes client par des
contrles orients donnes. Chaque contrle orient donnes doit tre associ
un composant source de donnes afin de pouvoir afficher et manipuler des
donnes. De mme, tous les ensembles de donnes doivent tre associs un
composant source de donnes afin que leurs donnes puissent tre affiches et
manipules dans les contrles orients donnes dune fiche.
Pour ajouter la source de donnes :
1 A partir de la page AccsBD, dposez un composant TDataSource droite du
composant TClientDataSet.
2 Dfinissez la proprit DataSet de la source de donnes par ClientDataSet1.
3 Choisissez Fichier|Tout enregistrer pour enregistrer le projet.
Jusquici vous avez ajout votre application son infrastructure de base de
donnes non visuelle. Maintenant, vous devez concevoir son interface utilisateur.

Conception de linterface utilisateur


Vous devez maintenant ajouter les contrles visuels de lapplication afin que les
utilisateurs puissent voir, modifier et enregistrer les donnes. La page
ContrleBD fournit un jeu de contrles orients donnes qui fonctionnent avec
les donnes dune base et construisent une interface utilisateur. Vous allez
afficher la base de donnes dans une grille et ajouter quelques commandes et
une barre de navigation.

5-6 Prise en main


Conception de linterface utilisateur

Cration de la grille et de la barre de navigation


Pour crer linterface de lapplication :
1 Vous pouvez commencer par ajouter une grille la fiche. A partir de la page
ContrleBD, dposez un composant TDBGrid sur la fiche.
2 Dfinissez les proprits de DBGrid afin dancrer la grille. Cliquez sur le
signe + proche de Anchors dans linspecteur dobjets afin dafficher akLeft,
akTop, akRight et akBottom ; dfinissez-les tous par true. La faon la plus simple
est de double-cliquer sur false en face de chaque proprit dans linspecteur
dobjets.
3 Alignez la grille et le bas de la fiche en dfinissant la proprit Align par
alBottom. Vous pouvez aussi augmenter la taille de la grille en la faisant glisser
ou en dfinissant sa proprit Height par 400.
4 Dfinissez la proprit DataSource de la grille par DataSource1. Lorsque vous
faites cela, la grille se remplit de donnes issues de la base de donnes
employee. Si la grille naffiche pas de donnes, vrifiez que vous avez
correctement dfini les proprits de tous les objets prsents sur la fiche,
comme expliqu par les instructions prcdentes.
A ce stade, votre application doit ressembler ceci :

Le contrle DBGrid affiche les donnes en mode conception, pendant que vous
travaillez dans lEDI. Cela vous permet de vrifier que vous tes bien connect
la base de donnes. Vous ne pouvez pas, cependant, modifier les donnes
pendant les phases de conception ; pour modifier les donnes de la table, vous
devez excuter lapplication.
5 A partir de la page ContrleBD, placez un contrle TDBNavigator sur la fiche.
Un navigateur dans une base de donnes est loutil assurant le dplacement
dans les donnes dun ensemble de donnes (en utilisant les flches suivante

Tutoriel : cration dune application de base de donnes CLX 5-7


Conception de linterface utilisateur

et prcdente, par exemple), comme lexcution des diverses oprations sur les
donnes.
6 Dfinissez la proprit DataSource de la barre de navigation par DataSource1 de
faon ce que le navigateur recherche les donnes dans lensemble de
donnes client.
7 Dfinissez la proprit ShowHint de la barre de navigation par true. (Dfinir
ShowHint par true permet de faire apparatre les conseils lorsque, au cours de
lexcution, le curseur est positionn sur nimporte lequel des lments de la
barre de navigation.)
8 Choisissez Fichier|Tout enregistrer pour enregistrer le projet.
9 Appuyez sur F9 pour compiler et excuter le projet. Vous pouvez galement
excuter le projet en cliquant sur le bouton Excuter dans la barre doutils du
dbogueur, ou en choisissant Excuter dans le menu Excuter.

Lorsque vous excutez votre projet, le programme souvre dans une fentre
semblable celle que vous avez dessine sur la fiche. Vous pouvez tester la
barre de navigation sur la base de donnes employee. Par exemple, vous
pouvez aller denregistrement en enregistrement en utilisant les commandes
flches, ajouter des enregistrements en utilisant la commande +, supprimer
des enregistrements en utilisant la commande -.
Astuce Si une erreur se produit lorsque vous testez une version initiale de votre
application, choisissez Excuter|Rinitialiser le programme pour revenir la
vue conception.

Ajout du support pour un menu


Bien que votre programme possde un certain nombre de fonctionnalits, il lui
manque encore la majorit des fonctions habituellement disponibles dans les
applications interface utilisateur graphique. Par exemple, la plupart des
applications implmentent des menus et des boutons pour faciliter leur
utilisation.

5-8 Prise en main


Conception de linterface utilisateur

Dans cette section, vous allez ajouter une liste dactions. Bien quil soit tout fait
possible de crer menus, barres doutils et boutons sans liste dactions, celles-ci
simplifient le dveloppement et la maintenance en centralisant les rponses aux
commandes de lutilisateur. (Notez que dans le cadre du dveloppement pour
Windows uniquement, vous pouvez aussi utiliser les bandes dactions pour
faciliter la cration des barres doutils et des menus.)
1 Si lapplication sexcute toujours, cliquez sur le X dans le coin suprieur
droit, pour la fermer et revenir la vue conception de la fiche.
2 A partir de la page Contrles communs de la palette de composants, dposez
un composant ImageList sur la fiche. Alignez-le ct des composants non
visuels. ImageList contiendra des icnes reprsentant des actions standard
comme couper et coller.
3 A partir de la page Standard de la palette de composants, dposez un
composant ActionList sur la fiche. Dfinissez la proprit Images de la liste
dactions par ImageList1.
4 Double-cliquez sur la liste dactions pour afficher lditeur de liste dactions.
Cliquez avec le bouton droit
de la souris dans lditeur et
choisissez Nouvelle action
standard pour afficher la
bote liste Actions standard.
Slectionnez les actions
que vous voulez et cliquez
sur OK. Appuyez sur Ctrl
pour slectionner plusieurs
actions.

5 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et


choisissez Nouvelle action standard. La bote liste Actions standard apparat.
6 Slectionnez les actions suivantes : TEditCopy, TEditCut et TEditPaste. (Utilisez
la touche Ctrl pour slectionner plusieurs lments.) Cliquez ensuite sur OK.

Vous avez ajout des actions


standard livres avec le produit.
Vous les utiliserez sur un menu.

7 Cliquez avec le bouton droit de la souris dans lditeur de liste dactions et


choisissez Nouvelle action pour ajouter une action qui nest pas fournie par
dfaut. Action1 est ajoute par dfaut. Dans linspecteur dobjets, dfinissez sa
proprit Caption par Mise jour immdiate !
La mme action sera utilise par un menu et un bouton. Par la suite, nous
ajouterons un gestionnaire dvnement qui mettra jour la base de donnes.

Tutoriel : cration dune application de base de donnes CLX 5-9


Conception de linterface utilisateur

8 Cliquez sur (pas de catgorie), cliquez avec le bouton droit de la souris et


choisissez Nouvelle action pour ajouter une autre action. Action2 est ajoute.
Dfinissez sa proprit Caption par &Quitter.
9 Cliquez sur le X (dans le coin suprieur droit) pour fermer lditeur de liste
dactions.
Vous avez ajout trois actions standard plus deux autres actions que nous
connecterons plus tard des gestionnaires dvnements.
10 Choisissez Fichier|Tout enregistrer pour enregistrer le projet.

Ajout dun menu


Dans cette section, vous allez ajouter une barre de menu principal contenant
deux menus droulants Fichier et Edition et vous ajouterez des lments
chacun deux en utilisant les actions de la liste dactions.
1 A partir de la page Standard de la palette de composants, dposez un
composant TMainMenu sur la fiche. Faites-le glisser ct des autres
composants non visuels.
2 Dfinissez la proprit Images du menu principal par ImageList1 afin dassocier
la liste dimages aux lments des menus.
3 Double-cliquez sur le composant menu pour afficher le concepteur de menus.

4 Tapez &Fichier pour dfinir la proprit Caption du premier lment de niveau


suprieur et appuyez sur Entre.

Quand vous tapez


&Fichier et appuyez sur
Entre, la commande
Fichier de niveau
suprieur apparat, prte
pour lajout du premier
lment de menu.
Le et commercial avant
un caractre active une
touche acclratrice.

5-10 Prise en main


Conception de linterface utilisateur

5 Slectionnez llment de menu vierge sous le menu Fichier. Dfinissez la


proprit Action de llment de menu vierge par Action2. Llment de menu
Quitter apparat sous le menu Fichier.
6 Cliquez sur le deuxime lment de menu de niveau suprieur ( droite de
Fichier). Dfinissez sa proprit Caption par &Edition et appuyez sur Entre.
Slectionnez llment de menu vierge qui apparat sous le menu Edition.
7 Dans linspecteur dobjets, dfinissez sa proprit Action par EditCut1 et
appuyez sur Entre. Le libell de llment est dfini automatiquement par
Couper et le bitmap couper par dfaut apparat sur le menu.
8 Slectionnez llment de menu vierge suivant (sous Couper) et dfinissez sa
proprit Action par EditCopy1 (le bitmap copier par dfaut apparat sur le
menu).
9 Slectionnez llment de menu vierge suivant (sous Copier) et dfinissez sa
proprit Action par EditPaste1 (le bitmap coller par dfaut apparat sur le
menu).
10 Slectionnez llment de menu vierge suivant (sous Coller) et dfinissez sa
proprit Caption par un tiret (-) afin de crer une ligne de sparation dans le
menu. Appuyez sur Entre.
11 Slectionnez llment de menu vierge suivant (sous la ligne de sparation ) et
dfinissez sa proprit Action par Action1. Llment de menu affiche Mise
jour immdiate !
12 Cliquez sur le X pour fermer le concepteur de menus.
13 Choisissez Fichier|Tout enregistrer pour enregistrer le projet.
14 Appuyez sur F9 ou sur Excuter dans la barre doutils pour excuter votre
programme et voir quoi il ressemble.

Plusieurs commandes du menu Edition et la barre de navigation sont dsormais


oprationnelles. Couper et Copier seront estompes dans le menu Edition tant
que vous ne slectionnerez pas du texte dans la base de donnes. Vous pouvez

Tutoriel : cration dune application de base de donnes CLX 5-11


Affichage dun titre et dune image

utiliser la barre de navigation pour aller denregistrement en enregistrement


dans la base, insrer un enregistrement ou supprimer un enregistrement.
La commande Mise jour ne fonctionne pas encore.
Fermez lapplication lorsque vous tes prt poursuivre.

Ajout dun bouton


Cette section dcrit comment ajouter lapplication un bouton Mise jour
immdiate. Ce bouton servira appliquer toutes les modifications apportes par
un utilisateur la base de donnes, comme la modification, lajout ou la
suppression denregistrements.
Pour ajouter un bouton :
1 A partir de la page Standard de la palette de composants, dposez un
composant TButton sur la fiche. (Slectionnez le composant et cliquez sur la
fiche proximit de la barre de navigation.)
2 Dfinissez la proprit Action du bouton par Action1.
Lintitul du bouton est modifi en Mise jour immdiate ! Lorsque vous
excuterez lapplication, il restera estomp tant quun gestionnaire
dvnement ne sera pas ajout pour le faire fonctionner.

Affichage dun titre et dune image


Vous pouvez ajouter le nom de votre socit et une image pour donner votre
application un aspect plus professionnel :
1 A partir de la page Standard de la palette de composants, dposez un
composant TLabel sur la fiche (nomm Label1 par dfaut).
2 Dans linspecteur dobjets, modifiez la proprit Caption du libell par World
Corp ou un autre nom de socit.
3 Changez la police du nom de la socit en cliquant sur le proprit Font.
Cliquez sur les points de suspension qui apparaissent droite et, dans la bote
de dialogue des fontes, dfinissez la police par Helvetica Gras, 16 points.
Cliquez sur OK.

5-12 Prise en main


Affichage dun titre et dune image

Vous pouvez changer


la police du libell en
utilisant la proprit Font
dans linspecteur dobjets.
Cliquez sur les points de
suspension pour afficher
le dialogue standard
des fontes.

4 Positionnez le libell dans le coin suprieur droit.


5 A partir de la page Supplment de la palette de composants, dposez un
composant TImage proximit du libell (nomm Image1 par dfaut).
6 Pour ajouter une image au composant Image1, cliquez sur la proprit Picture.
Cliquez sur les points de suspension pour afficher lditeur dimages.
7 Dans lditeur dimages, choisissez Charger et naviguez jusquau fichier
earth.ico (pour C++Builder, le chemin daccs est Program Files\Common
Files\Borland Shared\images\icons\earth.ico).
8 Double-cliquez sur earth.ico. Cliquez sur OK pour charger limage et fermer
lditeur dimages.
9 Donnez la zone image par dfaut la taille de limage. Placez limage prs du
libell.
Vous pouvez faire glisser
le bord pour dfinir la
largeur de Image, ou
dfinir sa proprit Width
dans linspecteur dobjets.

10 Pour aligner texte et image, slectionnez les deux objets sur la fiche, cliquez
avec le bouton droit et choisissez Aligner. Dans la bote de dialogue
Alignement, cliquez sur Bas, sous Vertical.
11 Choisissez Fichier|Tout enregistrer pour enregistrer le projet.
12 Appuyez sur F9 pour compiler et excuter votre application.
Fermez lapplication lorsque vous tes prt poursuivre.

Tutoriel : cration dune application de base de donnes CLX 5-13


Ecriture dun gestionnaire dvnements

Ecriture dun gestionnaire dvnements


La majorit des composants de la palette possdent des vnements, et beaucoup
ont un vnement par dfaut. OnClick est un vnement par dfaut commun, qui
est appel chaque fois que lon clique sur un composant, par exemple sur un
TButton. Si vous slectionnez un composant dans une fiche et cliquez sur longlet
Evnements de linspecteur dobjets, vous verrez la liste des vnements de ce
composant.
Pour plus dinformations sur les vnements et sur les gestionnaires
dvnements, voir Dveloppement de linterface utilisateur dune application
dans le Guide du dveloppeur ou dans laide en ligne.

Ecriture dun gestionnaire dvnement pour la commande Mise


jour immdiate !
Dabord, vous allez crire le gestionnaire dvnement pour la commande et le
bouton Mise jour immdiate ! :
1 Double-cliquez sur le composant ActionList pour afficher lditeur de liste
dactions.
2 Slectionnez (pas de catgorie) pour voir Action1 et Action2.
3 Double-cliquez sur Action1. Dans lditeur de code, le squelette du
gestionnaire dvnement apparat :
void __fastcall TForm1::Action1Execute(TObject *Sender)
{

}
Exactement la position du curseur (entre les accolades), tapez :
if(ClientDataSet1->State == dsEdit || ClientDataSet1->State == dsInsert)
ClientDataSet1->Post();

ClientDataSet1->ApplyUpdates(-1);
Ce gestionnaire dvnement teste dabord ltat dans lequel se trouve la base de
donnes. Lorsque vous quittez un enregistrement modifi, celui-ci est
automatiquement post. Mais, si vous ne quittez pas lenregistrement modifi, la
base reste en mode dition ou en mode insertion. Linstruction if poste toute
donne ventuellement modifie mais non transmise lensemble de donnes
client. Linstruction suivante applique la base les mises jour contenues dans
lensemble de donnes client.
Remarque Les modifications apportes aux donnes ne sont pas automatiquement postes
dans la base lorsque vous utilisez dbExpress. Il vous faut appeler la mthode
ApplyUpdates pour crire tous les enregistrements modifis, insrs ou supprims,
depuis lensemble de donnes client vers la base de donnes.

5-14 Prise en main


Ecriture dun gestionnaire dvnements

Ecriture dun gestionnaire dvnement pour la commande Quitter


Ensuite, nous allons crire le gestionnaire dvnement pour la commande
Quitter :
1 Double-cliquez sur le composant ActionList pour afficher lditeur de liste
dactions si ce nest dj fait.
2 Cliquez sur (pas de catgorie) pour voir Action2.
3 Double-cliquez sur Action2. Lditeur de code affiche le squelette du
gestionnaire dvnement :
void __fastcall TForm1::Action2Execute(TObject *Sender)
{

}
Exactement la position du curseur (entre les accolades), tapez :
Close();
Ce gestionnaire dvnement fermera lapplication lorsque la commande
Fichier|Quitter du menu sera utilise.
4 Fermez lditeur de liste dactions.
5 Choisissez Fichier|Tout enregistrer pour enregistrer le projet.

Ecriture dun gestionnaire dvnement pour fermer la fiche


Enfin, vous allez crire un autre gestionnaire dvnement qui sera invoqu
lorsque lapplication se ferme. Lapplication peut tre ferme soit en utilisant
Fichier|Quitter, soit en cliquant sur le X du coin suprieur droit. De toute faon,
le programme vrifie sil y a des mises jour en attente par rapport la base de
donnes et affiche ventuellement une fentre de message demandant
lutilisateur ce quil souhaite en faire.
Vous pourriez placer ce code dans le gestionnaire de lvnement Quitter, mais
les ventuelles modifications de la base seraient perdues dans les cas o
lutilisateur aurait choisi de fermer lapplication avec le X.
1 Cliquez sur la fiche (et non sur un des objets quelle contient) pour la
slectionner.
2 Slectionnez longlet Evnements de linspecteur dobjets pour voir les
vnements de la fiche.
3 Double-cliquez sur OnClose (ou tapez FormClose ct de lvnement
OnClose et cliquez dessus). Le squelette dun gestionnaire de lvnement
FormClose est crit et affich dans lditeur de code la suite des autres
gestionnaires dvnements.
void __fastcall TForm1::FormClose(TObject *Sender, TCloseAction &Action)
{
}

Tutoriel : cration dune application de base de donnes CLX 5-15


Ecriture dun gestionnaire dvnements

Exactement la position du curseur (entre les accolades), tapez :


TMessageButton Option;
TMessageButtons msgButtons;

msgButtons << smbYes << smbNo << smbCancel;

Action = caFree;
if(ClientDataSet1->State == dsEdit || ClientDataSet1->State == dsInsert)
ClientDataSet1->Post();
if(ClientDataSet1->ChangeCount > 0) {

Option = Application->MessageBox("Il y a des mises jour en attente. Voulez-vous les


crire dans la base ?", "Mises jour en attente", msgButtons, smsWarning, smbYes, smbNo);
if(Option == smbYes)
ClientDataSet1->ApplyUpdates(-1);
else
if(Option == smbCancel)
Action = caNone;
}
Ce gestionnaire dvnement teste ltat de la base de donnes. Si des mises
jour sont en attente, elles sont postes dans lensemble de donnes client o le
compteur de modifications est incrment. Puis, avant la fermeture de
lapplication, une bote de message est affiche pour demander comment grer
ces modifications. Les rponses possibles sont Oui, Non ou Annuler. Rpondre
Oui applique les mises jour la base ; Non ferme lapplication sans modifier
la base ; Annuler annule la sortie sans annuler les modifications de la base de
donnes et conserve lapplication en excution.
4 Vrifiez que lensemble de la procdure ressemble ce qui suit :
void __fastcall TForm1::FormClose(TObject *Sender, TCloseAction &Action)
{
TMessageButton Option;
TMessageButtons msgButtons;

msgButtons << smbYes << smbNo << smbCancel;

Action = caFree;
if(ClientDataSet1->State == dsEdit || ClientDataSet1->State == dsInsert)
ClientDataSet1->Post();
if(ClientDataSet1->ChangeCount > 0) {

Option = Application->MessageBox("Il y a des mises jour en attente. Voulez-vous les


crire dans la base ?", "Mises jour en attente", msgButtons, smsWarning, smbYes, smbNo);
if(Option == smbYes)
ClientDataSet1->ApplyUpdates(-1);
else
if(Option == smbCancel)
Action = caNone;
}
}

5-16 Prise en main


Ecriture dun gestionnaire dvnements

5 Pour finir, choisissez Fichier|Tout enregistrer pour enregistrer le projet.


Puis, appuyez sur F9 pour excuter lapplication.
Astuce Corrigez les erreurs en double-cliquant sur le message correspondant pour
aller la ligne de code concerne ou en appuyant sur F1 pour obtenir de
laide sur le message.
Et voil ! Vous pouvez essayer lapplication et observer son fonctionnement.
Lorsque vous voulez quitter le programme, vous pouvez utiliser la commande
Fichier|Quitter dsormais totalement fonctionnelle.

Tutoriel : cration dune application de base de donnes CLX 5-17


5-18 Prise en main
Chapitre

Personnalisation du bureau
Chapitre 6
6
Ce chapitre explique quelques-unes des mthodes permettant de personnaliser
lEDI de C++Builder.

Organisation de votre espace de travail


LEDI dispose de nombreux outils supportant le dveloppement, Avec autant
doutils, il est ncessaire dorganiser son espace de travail afin de travailler de la
manire la plus efficace, notamment en agenant les menus et les barres doutils,
en combinant les fentres doutils et en enregistrant le nouvel aspect du bureau.

Agencement des menus et des barres doutils


Dans la fentre principale, vous pouvez rorganiser le menu, les barres doutils
et la palette de composants en cliquant sur la poigne situe leur gauche et en
les faisant glisser jusqu un autre emplacement.
Fentre principale
dans lagencement
par dfaut.

Vous pouvez dplacer barres doutils et menus au sein de la fentre principale. Cliquez sur
la poigne (la double barre situe gauche) et faites-la glisser jusqu lendroit voulu.

Fentre principale
organise
diffremment.

6-1 Prise en main


Organisation de votre espace de travail

Vous pouvez sparer des lments de la fentre principale et les placer ailleurs
sur lcran ou les supprimer compltement du bureau. Cest utile lorsque vous
avez une double configuration de moniteur.

Fentre principale
organise
diffremment.

Vous pouvez ajouter des outils aux barres doutils, ou en supprimer, en


choisissant Voir|Barres doutils|Personnaliser. Cliquez sur la page Commandes,
slectionnez une catgorie, slectionnez une commande et faites la glisser dans
la barre doutils o vous voulez la voir apparatre.

Dans la page Commandes, slectionnez


une commande et faites la glisser dans une
barre doutils.
Dans la page Options, cochez loption
Afficher les conseils pour que les conseils
apparaissent pour les composants et les
icnes de la barre doutils.

Pour plus dinformations...


Voir barres doutils, personnaliser dans lindex de laide en ligne.

Ancrage des fentres doutils


Vous pouvez ouvrir et fermer les fentres doutils individuellement et les
agencer sur le bureau votre convenance. Nombre dentre elles peuvent
galement tre ancres une autre pour faciliter leur manipulation. Lancrage
(qui signifie soit attacher les fentres les unes aux autres afin quelles se
dplacent ensemble, soit combiner plusieurs fentres en un classeur onglets
unique) vous permet de grer lespace de lcran avec efficacit tout en
bnficiant dun accs rapide aux diffrents outils.
Dans le menu Voir, vous pouvez faire apparatre nimporte quelle fentre doutil
et lancrer directement une autre. Par exemple, lorsque vous ouvrez pour la
premire fois C++Builder dans sa configuration par dfaut, lexplorateur de
classes est ancr gauche de lditeur de code. Vous pouvez ajouter le
gestionnaire de projet aux deux premiers et crer ainsi trois fentres ancres
ensemble.

6-2 Prise en main


Organisation de votre espace de travail

Ici, le gestionnaire de projet et lexplorateur


de code sont ancrs lditeur de code.

Vous pouvez
combiner, ou ancrer
des fentres, soit
avec les poignes,
comme gauche, soit
avec les onglets.

Pour ancrer une fentre, cliquez sur sa barre doutils et faites-la glisser par
dessus une autre fentre. Lorsque le cadre montrant lemplacement de la
premire fentre devient un rectangle troit et saccroche un coin de la
seconde, relchez la souris. Les deux fentres sont ancres.

Pour ancrer des fentres en


utilisant les poignes, relchez
la souris lorsque le cadre de
dplacement saccroche au
coin de lautre fentre.

Vous pouvez galement ancrer les outils entre eux et former une fentre
onglets.

Personnalisation du bureau 6-3


Organisation de votre espace de travail

Pour ancrer des fentres en


utilisant un classeur, relchez
la souris avant que le cadre de
dplacement saccroche au coin
de lautre fentre.

Pour dsancrer une fentre, double-cliquez sur sa poigne ou sur son onglet.
Pour dsactiver lancrage automatique, appuyez sur la touche Ctrl tout en
dplaant une fentre ou choisissez Outils|Options denvironnement,
slectionnez la page Prfrences et enlevez la coche de loption Ancrage
automatique par glissement.

Pour plus dinformations...


Voir ancrage dans lindex de laide.

Enregistrement des dispositions du bureau


Vous pouvez personnaliser et enregistrer les dispositions du bureau. La barre
doutils Bureau, dans lEDI, offre une liste de slection des dispositions de
bureau disponibles et deux icnes facilitant la personnalisation du bureau.
Enregistrer le bureau en cours

Les dispositions de bureau Dfinir le bureau


nommes sont listes ici. de dbogage

6-4 Prise en main


Personnalisation de la palette de composants

Agencez le bureau votre convenance : affichez, redimensionnez et ancrez


certaines fentres, et placez-les o vous voulez sur lcran.
Cliquez sur licne Enregistrer le bureau en cours dans la barre doutils Bureau
ou choisissez Voir|Bureaux|Enregistrer le bureau, et entrez un nom pour la
nouvelle disposition.

Entrez un nom pour la disposition de


bureau enregistrer et cliquez sur OK.

Pour plus dinformations...


Voir disposition du bureau dans lindex de laide.

Personnalisation de la palette de composants


Dans sa configuration par dfaut, la palette de composants affiche de nombreux
objets VCL utiles, regroups de manire fonctionnelle en plusieurs pages
onglets. Vous pouvez personnaliser la palette de composants et :
Cacher ou rorganiser des composants
Ajouter, supprimer, rorganiser ou renommer des pages
Crer des modles de composants et les ajouter la palette
Installer de nouveaux composants

Organisation de la palette de composants


Pour ajouter, supprimer, rorganiser ou renommer des pages, ou pour cacher ou
rorganiser des composants, utilisez la bote de dialogue Proprits de la palette.
Vous pouvez ouvrir cette bote de dialogue de diffrentes faons :
Choisissez Composant|Configurer la palette.
Choisissez Outils|Options denvironnement et cliquez sur longlet Palette.
Cliquez avec le bouton droit sur la palette de composants et slectionnez
Proprits.

Pour plus dinformations...


Cliquer sur le bouton Aide de la bote de dialogue Proprits de la palette.

Cration de modles de composants


Les modles de composants sont des groupes de composants que vous ajoutez
une fiche en une seule opration. Les modles vous permettent de configurer des
composants sur une fiche, puis de sauvegarder leur agencement, leurs proprits

Personnalisation du bureau 6-5


Personnalisation de la palette de composants

par dfaut et leurs gestionnaires dvnements dans la palette de composants,


afin de les rutiliser dans dautres fiches.
Pour crer un modle de composants, disposez simplement un ou plusieurs
composants dans une fiche, dfinissez leurs proprits dans linspecteur dobjets,
puis slectionnez-les tous en faisant glisser la souris autour deux. Choisissez
ensuite Composant|Crer un modle de composant. Lorsque souvre la bote de
dialogue Informations sur le modle de composant, vous pouvez choisir un nom
pour le modle, la page de la palette sur laquelle il doit apparatre et licne
devant le reprsenter dans celle-ci.
Aprs avoir positionn le modle sur une fiche, vous pouvez repositionner les
composants indpendamment les uns des autres, rinitialiser leurs proprits,
et crer ou modifier des gestionnaires dvnements comme si vous aviez
positionn chaque composant sparment.

Pour plus dinformations...


Voir modles de composants dans lindex de laide en ligne.

Installation de paquets de composants


Que vous criviez vos propres composants personnaliss ou les obteniez dun
fournisseur extrieur, les composants doivent tre compils en un paquet avant
de pouvoir tre installs dans la palette de composants.
Un paquet est une DLL spciale contenant du code partageable par les
applications C++Builder, lEDI, ou les deux. Les paquets dexcution apportent
les fonctionnalits lorsque lutilisateur excute une application. Les paquets de
conception sont utiliss pour installer des composants dans lEDI. Les paquets
C++Builder ont lextension .bpl.
Lorsque des composants de dveloppeurs tiers sont dj compils en paquet,
suivez les instructions de ce fournisseur ou choisissez Composant|Installer
des paquets.

6-6 Prise en main


Personnalisation de la palette de composants

Ces composants sont pr-installs


dans C++Builder. Lorsque vous
installez de nouveaux composants
provenant de fournisseurs tiers, leur
paquet apparat dans cette liste.
Cliquez sur Composants pour voir les
composants contenus dans le paquet.

Pour plus dinformations...


Voir installation des composants et paquets dans lindex de laide.

Utilisation des cadres


Un cadre (TFrame) sert, comme une fiche, de conteneur des composants que
vous voulez rutiliser. Un cadre ressemble en fait plus un composant
personnalis qu une fiche. Il est possible dintgrer un cadre la palette des
composants afin de le rutiliser plus facilement. Les cadres peuvent tre
imbriqus dans une fiche, dans dautres cadres ou dans dautres objets
conteneur. Une fois un cadre cr et enregistr, il continue fonctionner comme
une unit et hrite des modifications apportes aux composants quil contient (y
compris des cadres). Quand un cadre est incorpor dans un autre cadre ou une
fiche, il continue hriter des modifications apportes au cadre dont il drive.
Pour ouvrir un nouveau cadre, choisissez Fichier|Nouveau|Cadre.

Vous pouvez ajouter au cadre les composants visuels


ou non visuels de votre choix. Une nouvelle unit est
automatiquement ajoute dans lditeur de code.

Pour plus dinformations...


Voir cadres et TFrame dans lindex de laide en ligne.

Personnalisation du bureau 6-7


Dfinition des options des projets

Ajout de contrles ActiveX


Vous pouvez ajouter des contrles ActiveX la palette de composants et les
utiliser dans vos projets C++Builder. Choisissez Composant|Importer un contrle
ActiveX pour ouvrir la bote de dialogue Importation dActiveX. Vous pouvez
alors recenser de nouveaux contrles ActiveX ou en slectionner un dj recens
en vue de son installation dans lEDI. Lorsque vous installez un contrle
ActiveX, C++Builder cre et compile un fichier unit enveloppe pour
ce contrle.

Pour plus dinformations...


Choisissez Composant|Importer un contrle ActiveX et cliquez sur le bouton
Aide.

Dfinition des options des projets


Si vous devez grer les rpertoires de votre projet ou spcifier les options de
fiche, application, compilateur et lieur de votre projet, choisissez Projet|Options.
Lorsque vous effectuez des modifications dans la bote de dialogue Options du
projet, elles naffectent que le projet en cours ; vous pouvez cependant enregistrer
vos slections comme paramtres de fonctionnement par dfaut des nouveaux
projets.

Dfinition des options de projet par dfaut


Pour enregistrer vos slections comme paramtres de fonctionnement par dfaut
de tous les nouveaux projets, cochez Dfaut, dans le coin infrieur gauche de la
bote de dialogue Options du projet. Lactivation de la case Dfaut crit les
paramtres en cours du dialogue dans le fichier doptions default.bpr, plac dans
le rpertoire Cbuilder6\Bin. Pour rendre C++Builder ses paramtres par dfaut
dorigine, supprimez ou renommez le fichier default.bpr.

Spcification des modles de projet et de fiches par dfaut


Lorsque vous choisissez Fichier|Nouveau|Application, un nouveau projet est
ouvert dans lEDI. C++Builder cre une nouvelle application avec une fiche vide,
sauf si vous spcifiez un modle de projet comme projet par dfaut. Vous pouvez
enregistrer vos propres projets en tant que modles dans le rfrentiel dobjets
dans la page Projets en choisissant Projet|Ajouter au rfrentiel (voir Ajout de
modles au rfrentiel dobjets la page 6-9). Vous pouvez aussi utiliser lun
des modles de projet du rfrentiel dobjets C++Builder (voir Le rfrentiel
dobjets la page 2-5).
Pour spcifier votre modle de projet comme projet par dfaut, choisissez
Outils|Rfrentiel. Dans la bote de dialogue Rfrentiel dobjets, slectionnez
Projets sous Pages. Si vous avez enregistr un projet en tant que modle dans

6-8 Prise en main


Spcification des modles de projet et de fiches par dfaut

la page Projets, il apparat dans la liste Objets. Slectionnez le nom du modle et


cochez Nouveau projet, puis choisissez OK.

Les pages du rfrentiel dobjets contiennent soit des


modles de projets, soit des modles de fiches, soit les
deux.
Pour dfinir un modle de projet comme projet par
dfaut, slectionnez un lment dans la liste des
objets et cochez Nouveau projet.
Pour dfinir un modle de fiche comme fiche par
dfaut, slectionnez un lment dans la liste des
objets et cochez Nouvelle fiche ou Fiche principale.

Lorsque vous avez spcifi un modle de projet comme projet par dfaut,
C++Builder louvre automatiquement chaque fois que vous choisissez Fichier|
Nouveau|Application.
De la mme faon que vous spcifiez un projet par dfaut, vous pouvez spcifier
une fiche principale par dfaut et une nouvelle fiche par dfaut en les choisissant dans
la liste des modles de fiches existant dans le rfrentiel dobjets. La nouvelle
fiche par dfaut est la fiche cre lorsque vous choisissez Fichier|Nouveau|Fiche
pour ajouter une fiche supplmentaire un projet ouvert. La fiche principale par
dfaut est la fiche cre lorsque vous ouvrez une nouvelle application. Si vous
navez pas spcifi de fiche par dfaut, C++Builder utilise une fiche vierge.
Vous pouvez toujours remplacer le projet ou les fiches par dfaut en choisissant
Fichier|Nouveau|Autre et en slectionnant un modle diffrent dans la bote de
dialogue Nouveaux lments.

Pour plus dinformations...


Voir modles, ajout au rfrentiel dobjets, projets, spcification des valeurs
par dfaut et fiches, spcification des valeurs par dfaut dans lindex de
laide.

Ajout de modles au rfrentiel dobjets


Vous pouvez ajouter vos propres objets au rfrentiel dobjets afin de les utiliser
comme modles que vous rutilisez ou partagez avec dautres dveloppeurs via
un rseau. La rutilisation dobjets vous permet de concevoir des familles
dapplications ayant une interface utilisateur et des fonctionnalits communes,
ce qui rduit les temps de dveloppement tout en amliorant la qualit.

Personnalisation du bureau 6-9


Dfinition des prfrences pour les outils

Par exemple, pour ajouter un projet comme modle dans le rfrentiel,


commencez par enregistrer le projet, puis choisissez Projet|Ajouter au rfrentiel.
Compltez alors la bote de dialogue Ajout au rfrentiel.

Saisissez le titre, la description et lauteur.


Dans la liste Page, choisissez Projets pour
que votre projet apparaisse dans la page
Projets du rfrentiel dobjets.

A la prochaine ouverture de la bote de dialogue Nouveaux lments, votre


modle de projet apparat dans la page Projets (ou dans la page spcifie). Pour
que votre modle soit le modle par dfaut la prochaine ouverture de
C++Builder, voir Spcification des modles de projet et de fiches par dfaut
la page 6-8.

Pour plus dinformations...


Voir modles, ajouter au rfrentiel dobjets dans lindex de laide en ligne.

Dfinition des prfrences pour les outils


Vous pouvez contrler un grand nombre des outils dterminant laspect et le
comportement de lEDI, comme le concepteur de fiche, linspecteur dobjets ou
lexplorateur de code. Ces paramtres affectent non seulement le projet en cours
mais aussi les projets que vous allez ouvrir et compiler. Pour modifier les
paramtres de lEDI pour tous les projets, choisissez Outils|Options
denvironnement.

Pour plus dinformations...


Voir Options denvironnement, bote de dialogue dans lindex de laide en
ligne ou cliquer sur le bouton Aide figurant sur lune des pages de la bote de
dialogue Options denvironnement.

Personnalisation du concepteur de fiche


La page Concepteur de la bote de dialogue Outils|Options denvironnement
propose des options qui affectent le concepteur de fiche. Par exemple, vous
pouvez activer ou dsactiver la fonction Aligner sur la grille, qui aligne les
composants avec la ligne de grille la plus proche ; vous pouvez galement
afficher ou masquer le nom, ou le lintitul, des composants non visuels placs
dans les fiches.

6-10 Prise en main


Dfinition des prfrences pour les outils

Pour plus dinformations...


Dans la bote de dialogue Options denvironnement, cliquez sur le bouton Aide
de la page Concepteur.

Personnalisation de lditeur de code


Vous souhaiterez sans doute personnaliser lditeur de code immdiatement.
Plusieurs pages de la bote de dialogue Outils|Options de lditeur proposent
des options ddition du code. Par exemple, vous pouvez choisir les quivalences
des touches, les fontes, la largeur des marges, les couleurs, la mise en vidence
syntaxique, les tabulations et les styles dindentation.
Vous pouvez galement configurer les outils daudit de code, utilisables dans
lditeur, sur la page Audit de code de la bote de dialogue Proprits de
lditeur. Pour savoir comment utiliser ces outils, reportez-vous Audit de
code la page 2-6.

Pour plus dinformations...


Dans la bote de dialogue Proprits de lditeur, cliquez sur le bouton Aide
figurant sur les pages Gnral, Affichage, Affectations de touches, Couleurs
et Audit de code.

Personnalisation du bureau 6-11


6-12 Prise en main
Index
A BDE (Borland Database
Engine) 3-11
contrles
base de donnes 3-12
A propos (bote de dialogue), administrateur 3-12 orients donnes 3-12
ajout 4-34 alias 3-12 contrles, ajout une fiche 4-3
achvement du code 2-6 bibliothques de classes 3-6 conventions typographiques 1-6
actions standard, ajout une bibliothques de liaison
application 4-18 dynamique 3-13 D
actions, ajout une bibliothques de types 3-14
application 4-9, 4-11, 4-18 DB2 3-11
bitmaps, ajout une
dbExpress 3-11
ActiveX 3-14 application 4-7, 4-15
installation des contrles 6-8 dbogage des programmes 3-7
botes de dialogue
page de la palette 3-14 3-8, 4-14
modles 2-5
ADO (ActiveX Data dbogueur intgr 3-7
.BPR, fichiers 4-2
dfaut
Objects) 3-11 bureau, organisation 6-16-5
affectation des touches 6-11 modles de projet et de
affichage des images 5-12 C fiches 6-8
aide en ligne, fichiers 1-4 options de projet 6-8
aide, conseils 4-4 C++Builder dfinition des proprits 3-4,
Aide, F1 1-4 personnalisation 6-16-11 4-2, 4-10, 4-12, 4-18
ajout programmation 3-1 dmarrage de C++Builder 2-1
composants une fiche 4-20 cadres 6-7 dploiement des
ajout dlments au rfrentiel classes, dfinition 4-4 programmes 3-8
dobjets 2-5 clic droit .dfm, fichiers 4-1
ajout de composants une menus 2-3 Diagramme, page 2-8
fiche 4-3 CLX dictionnaire de donnes 3-13
ancrage des fentres 6-26-4 applications, cration 3-10 DLL 3-13
applications dfinition 3-6 documentation
compilation et code imprime 1-6
dbogage 4-14, 4-24 visualisation et recherche 1-3
cration 3-10 modification 2-6 donnes
applications de bases de COM 3-14 modules 3-2
donnes compilation des
accs 5-35-5 programmes 4-24, 5-8 E
arborescence dobjets 2-4 composants
criture du code 3-5
audit de code 2-6 agencement dans la
EDI
audit de symbole dans palette 6-5
dfinition 1-1
conseil 2-7 ajout une fiche 3-2, 4-4
organisation 6-1
bibliothque de classes
personnalisation 6-16-11
B CLX 3-7
dfinition 4-3
diteur de bibliothque de
barres doutils 2-22-3 types 3-14
dfinition des proprits 3-4,
ajout une application 4-14, diteur de code
4-2
combinaison avec dautres
4-23 installation 3-13, 6-6
configuration 6-1 fentres 6-2
modles 6-5
personnalisation 6-11
organisation 6-1 personnalisation 3-13, 6-5
base de donnes exemple 5-1 utilisation 2-6
concepteur de fiche
5-17 diteur de texte, tutoriel 4-1
personnalisation 6-10
bases de donnes 4-37
utilisation 2-4
accs 3-11 diteur du gestionnaire
conseils daide 4-4
explorateur 3-12 dactions 4-94-12
contexte
diteurs de mthodes de saisie
accs aux menus 2-3
(IME) 3-9

Index I-1
ditions de C++Builder 3-9 fichiers fiche modles
enregistrement visualisation du code 2-9 ajout au rfrentiel
dispositions du bureau 6-4 fichiers projet 4-2 dobjets 6-9
projets 4-2 noms par dfaut 4-1 spcification comme
en-ttes dunits, fichiers 4-1 dfaut 6-8
environnement de G modles de code 2-6
dveloppement intgr modles de composants
gestionnaire de projet 2-92-10
(EDI) 2-1 cration 6-5
gestionnaires dvnements 3-5,
personnalisation 6-16-11 Modification de
5-145-17
quivalents clavier 2-3 StatusBar1.Panels, bote de
cration 4-254-32
erreurs, messages 4-32 dialogue 4-5
graphiques, affichage 5-12
valuation dexpression dans module base de donnes 3-12
groupes de projets 2-10
conseil 2-7 modules de donnes 2-5, 3-2
GUI, cration 3-2, 4-2
vnements 5-145-17 multiplate-forme
excutables 3-8 dveloppement
Excuter, bouton 5-8
I dapplications pour 3-10
excution dune images
application 4-14 affichage 5-12 N
excution des application 4-24, images, ajout une
newsgroups 1-6
5-8 application 4-7, 4-15
nouveauts 1-3
expert DLL ressource 3-9 Informix 3-11
Nouveaux lments, bote de
experts 3-14 inspecteur dobjets 3-6
dialogue
experts (rfrentiel dobjets) 2-5 prsentation 3-4
enregistrement des
explorateur de classe 2-9 rfrence de composants en
modles 6-86-9, 6-10
utilisation 2-9 ligne 3-5
utilisation 2-5, 4-34
explorateur SQL 3-12 utilisation 3-4, 4-2
installation des composants O
F personnaliss 6-6
InterBase 3-11, 3-12 objets, dfinition 3-6
fentres onglets, configuration
interfaces utilisateur, ODBC 3-11
de lEDI 6-3
cration 3-2, 4-2, 4-3 options
fentres doutils
internationalisation des projets 6-8
ancrage 6-2
applications 3-9 Options denvironnement, bote
fentres, combinaison 6-2
de dialogue 6-10
fermeture dune fiche 4-3
fiches
J Options de lditeur, bote de
dialogue 6-11
ajout de composants 3-2, 4-3 jeux de caractres tendus 3-9
Options du projet, bote de
dans le rfrentiel
dialogue 6-8
dobjets 2-5 L Oracle 3-11
fermeture 4-3
listes A faire 2-10 outils de traduction 3-9
fichiers 2-9
principales 4-2, 6-9 localisation des applications 3-9
spcification de la fiche par
P
dfaut 6-9 M page diagramme 2-8
fiches, fichiers MainMenu, composant 5-10 palette de composants
dfinition 4-1 makefiles 4-2 dfinition 2-3
fichiers menus personnalisation 6-56-7
enregistrement 4-2 ajout une application 4-20 utilisation 3-2
fiche 4-1 configuration 6-1 Panel, composant 5-12
projet 4-1 contextuels 2-3 paquets 3-8, 3-9
units 4-1 dans C++Builder 2-3 dfinition 6-6
fichiers daide, ajout une organisation 2-22-3, 6-1 Paradox 3-11
application 4-32 messages derreur 4-32 paramtres du code 2-6
fichiers en-tte 4-1 .pas, fichiers 4-1

I-2 Prise en main


personnalisation proprits, dfinition 4-2, 4-10, T
concepteur de fiche 6-10 4-12, 4-18
EDI 6-16-11 tutoriel 4-14-37, 5-15-17
diteur de code 6-11 R types
palette de composants 2-2 bibliothques 3-14
raccourcis clavier 2-3
programmation 3-1
programme exemple 4-14-37,
rfrentiel dobjets
ajout des modles 6-8
U
5-15-17
dfinition 2-5 units, fichiers 4-1, 6-8
programmes
utilisation 2-5, 3-1
applications CLX 3-10
compilation et
relations parent-enfant 2-4 V
dbogage 4-14, 4-24 VCL
projets
S composants 2-3
ajout dlments 2-5 serveurs SQL 3-11 utilisation 3-6
cration 3-1 services de support 1-6 vue de conception, fermeture
dfinition des options par site Web de Borland 1-6 des fiches 4-3
dfaut 6-8 SQL 3-11
enregistrement 4-2 explorateur 3-12 W
gestion 2-92-10 SQL Links 3-11
spcification comme projet Web, site Borland 1-6
SQL Server 3-11
par dfaut 6-8 support pour dveloppeurs 1-6
types 3-93-13 support technique 1-6
X
proprits Sybase 3-11 .xfm, fichiers 2-9
dfinition 3-4

Index I-3
I-4 Prise en main

Vous aimerez peut-être aussi