Académique Documents
Professionnel Documents
Culture Documents
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
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.
Remarque Sauf si vous avez une raison particulire de ne pas le faire, prfrez loption
denregistrement 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.
Appuyez sur F1 au
niveau dun objet dans
le concepteur de fiche.
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.
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.
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.
Palette de composants
prts tre utiliss dans
votre application.
Editeur de code
permettant de visualiser
et de modifier le code.
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.
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
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.
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.
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.
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.
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.
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
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.
Ou, choisissez un
composant dans une
liste alphabtique.
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.
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.
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.
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.
TScrollingWinControl TCustomControl
TCustomForm
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Zone de saisie
Barre dtat
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.
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.
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.
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.
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.
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.
Astuce Vous pouvez aussi cliquer sur la flche vers le bas ct du bouton Nouvelle
Action et cliquer sur Nouvelle Action.
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.
(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 :
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 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);
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 :
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.
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.
Le rfrentiel dobjets
contient une bote
A propos standard que
vous pouvez modifier
votre guise pour dcrire
votre application.
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.
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.
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.
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
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.
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.
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.
}
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.
}
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.
Action = caFree;
if(ClientDataSet1->State == dsEdit || ClientDataSet1->State == dsInsert)
ClientDataSet1->Post();
if(ClientDataSet1->ChangeCount > 0) {
Action = caFree;
if(ClientDataSet1->State == dsEdit || ClientDataSet1->State == dsInsert)
ClientDataSet1->Post();
if(ClientDataSet1->ChangeCount > 0) {
Personnalisation du bureau
Chapitre 6
6
Ce chapitre explique quelques-unes des mthodes permettant de personnaliser
lEDI de C++Builder.
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.
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
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.
Vous pouvez galement ancrer les outils entre eux et former une fentre
onglets.
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.
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.
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
Index I-3
I-4 Prise en main