Sommaire:
 

	Propriétés générales	Propriétés communes à la majorité des contrôles
	Contrôle TEdit	Saisie sur une ligne
	Contrôle TMaskEdit (voir aussi TEdit)	Saisie sur une ligne avec masque
	Contrôle TMemo	Saisie multi-lignes
	Contrôle TButton	Bouton de validation ou autre
	Contrôle TLabel	Texte fixe
	Contrôle TPageControl et TTabControl	Onglets

Retour à la page principale Builder

Toutes les remarques sont les bienvenues.
Toutes les questions auront une réponse soit personnelle soit par une variation de la page correspondante.

Ecrivez-moi à

Name:
Permet de nommer le composant - CETTE PROPRIETE NE PEUT ETRE VIDEE -
- TOUT COMPOSANT DOIT OBLIGATOIREMENT PORTER UN NOM -
• Vider le contenu de cette propriété provoque une erreur de linkage concernant les composants de la famille correspondante.
• Personnaliser le nom permet de se souvenir plus facilement de la fonction associée à ce composant
• Le changement de nom ne doit pas se faire après avoir commencé à gérer les événements le concernant

 
TabOrder:
Permet de définir l'ordre dans lequel les composants seront atteints par appui sur la touche de tabulation (valeur 0 pour le composant qui sera sélectionné au lancement de l'application)
• A initialiser à l'aide de l'inspecteur d'objets
• Deux composants ne peuvent pas avoir la même valeur dans un même groupe (fiche ou panel)
 
Visible:
Permet de rendre visible ou non le contrôle
Application:
        Edit1->Visible = true ;
Font:
Permet de sélectionner la police utilisée pour les affichages dans le contrôle ainsi que la taille et le style
• A initialiser à l'aide de l'inspecteur d'objets
 
Top / Left / Width / Height:
Permet de définir avant ou pendant l'éxécution la position du contrôle (Point supérieur gauche) ainsi que sa largeur et sa hauteur
Application:
Edit1->Top = 100 ;        // Références par rapport à l'intérieur de la fenetre
Sommaire

Permet la saisie de valeurs de différentes façons:
.Saisie de texte simple
.Saisie de mot de passe (caractères saisis non affichés)
 
Principales méthodes et propriétés:
GetTextLen: (Méthode)
Permet de déterminer la longueur du texte contenu dans la zone d'édition
Application:
int Taille ;
Taille = Edit1->GetTextLen() ;
 
GetTextBuf: (Méthode)
Permet de récupérer dans une table de caratères le contenu d'une zone d'édition
Application 1 - Utilisation simple (dimension maximalisée):
char Table[80] ;
Edit1->GetTextBuf( Table, Edit1->GetTextLen()+1) ;
Application 2 - Utilisation associée à une allocation dynamique:
int Taille ;
char * pTable ;
Taille = Edit1->GetTextLen() ;
pTable = new char [Taille+1] ;         // +1 pour le caractère '\0' final
Edit1->GetTextBuf( pTable, Taille+1) ;
 
CopyToClipboard: (Méthode)
Si tout ou partie du contenu du contrôle est sélectionné, cette méthode remplace le contenu du presse-papiers par le texte sélectionné
Application:
Edit1->CopyToClipboard() ;
 
CutToClipboard: (Méthode)
Si tout ou partie du contenu du contrôle est sélectionné, cette méthode remplace le contenu du presse-papiers par le texte sélectionné. Elle efface ensuite le contneu de la sélection
Application:
Edit1->CutToClipboard() ;
 
PasteFromClipboard: (Méthode)
Place à l'emplacement du curseur une copie du contenu du presse-papiers.
Application:
Edit1->PasteFromClipboard() ;
 
Text: (Propriété)
Permet de connaitre le contenu (sous forme de TString) d'une zone d'édition ou de changer ce contenu.
REMARQUE:
La méthode c_str() de la classe TString permet de convertir un type TString en type chaine (à caractère '\0' terminal)
Application 1:
char Table[80] ;
strcpy(Table, Edit1->Text.c_str()) ;
strupr(Table) ;             // La zone d'édition Edit 2 contient la même
Edit2->Text=Table ;   // chose que Edit1convertie en Majuscule
Application 2:
Edit3->Text=125 ;        // La zone d'édition Edit3 contient maintenant "125";
Application 3:
char Table[80] ;
strcpy(Table, Edit4->Text.c_str() ) ;
// La zone d'édition Edit4 est conpiée dans Table
 
MaxLength: (Propriété)
Permet de configurer le nombre maximum de caractères autoriser lors de la saisie (caractère '\0' non compté)
Application:
Edit1->MaxLength=0 ;        // Pas de limites
Edit1->MaxLength=15 ;     // 15 caractères maximum à saisir
 
PasswordChar: (Propriété)
Permet de configurer le caractère à afficher à la place du caractère réellement saisi (Le texte est correctement rangé dans la zone prévue pour)
Application:
Edit1->PasswordChar='A' ;        // Les caractères saisis ne sont pas affichés mais
                                                       // remplacés par un 'A'
Edit1->PasswordChar=0 ;           // Les caractères saisis sont réellement affichés
 
CharCase: (Propriété)
Permet de configurer la méthode d'affichage des caractère entre minuscules et majuscules.
3 valeurs possibles selon le cas:
• ecLowerCase Le texte est converti en minuscules.
• ecNormal Le texte apparaît tel quel, il n'y a pas de conversion.
• ecUpperCase Le texte est converti en majuscules.
Application:
Edit1->CharCase=ecUpperCase ;
Sommaire

Idem TEdit mais avec, en plus, la possibilité de sélectionner ou modifier un masque de saisie (pour saisir un code postal, une date, une heure en respectant une mise en forme)

Propriété complémentaire:

EditMask:
Permet de mettre en place un masque de saisie prédéterminé (à sélectionner dans une liste en fonction de la langue)
Un masque de saisie permet de n'autoriser que certains types de caractères sur une partie de la saisie puis un autre type de caractères sur une autre partie de la saisie
L'exemple typique est la saisie d'un nombre comme le numéro de sécurité sociale (13 chiffres). Dans ce cas, il faut refuser tous les caractères qui ne sont pas des chiffres.
Cette propriété permet aussi de modifier les masques de saisies prédéterminés afin de les adapter à la situation
• S'utilise directement dans l'inspecteur d'objets
Exemple de masque de saisie pour un code à 4 chiffres:
0000;1;_
(Adapté depuis celui du code postal en supprimant un zéro, donc un chiffre)
 Exemple de masque de saisie pour une date style "20 jan 2000" :
!99 >L<LL 0000;1;_
(Directement dans la liste)
Sommaire

Contrôle réalisant une zone d'édition multilignes
 
Principales méthodes, propriétés et événements:
Gestion du presse-papiers: (Méthodes)
        Voir les fonctions CopyToClipboard, CutToClipboard, PasteFromClipboard de TEdit

Clear: (Méthode)

Efface le contenu du composant
Application:
Memo1->Clear() ;
 
Text: (Propriété)
Permet de connaitre le contenu (sous forme de TString)  du composant. Si le contenu est multilignes, les lignes sont séparées les unes des autres par un caractère '\r' suivi du caractère '\n'
Application:
Memo1->Text = "Ligne 1 \r\n Ligne 2   \r\nTroisième ligne" ;
 
Lines: (Propriété)
Objet permettant d'atteindre le contenu du contrôle ligne par ligne
Il s'agit d'un objet de type TStrings. Toutes les méthodes et propriétés de TStrings peuvent donc être appliqués.
Application:
Memo1->Lines->Add("Ligne 4") ;    // Ajoute une ligne contenant "Ligne 4"
Remarque concernant la méthode Add:
    L'argument passé à cette méthode ne doit contenir ni '\n' ni '\r'. Sinon, cela provoque une erreur lors de l'éxécution
Détails des Méthodes de l'objet TStrings: Cliquer ici
Détail des Propriétés de l'objet TStrings: Cliquer ici

ScrollBars: (Propriété)
Détermine s'il faut ajouter des barres de défilement au contrôle mémo.
Les valeurs possibles sont ssNone, ssHorizontal, ssVertical, ssBoth
Application:
Memo1->ScrollBars=ssVertical ;
Sommaire

Contrôle réalisant un bouton poussoir
Caption: (Propriété)
Permet de définir le texte qui va être affiché sur le bouton.
Pour mettre en place un raccourci-clavier sélectionnant un bouton, il suffit de placer devant la lettre correspondant au raccourcui voulu un "Et commercial" - & -
Application:
Button1->Caption = "&Validation" ; // Le raccourci clavier sera "Alt-V"
Sommaire

Contrôle Affichant un texte
Caption: (Propriété)
Permet de définir le texte qui va être affiché sur le label.
Pour mettre en place un raccourci-clavier sélectionnant un bouton, il suffit de placer devant la lettre correspondant au raccourcui voulu un "Et commercial" - & -
Application:
Label1->Caption = "&Nom de la personne" ; // Le raccourci clavier sera "Alt-N"

FocusControl: (Propriété)
Permet de définir le contrôle qui sera sélectionné lorsque le raccourci clavier placé dans la propriété caption est activé
Application:
Label1->FocusControl = Edit1 ;
Sommaire

Contrôle gérant un affichage type boite de dialogue avec onglets
Ils possèdent tous les deux un fonctionnement très proche: Par Controle-Tabulations successives, les onglets sont passés en revue un par un.
Par contre, le résultat n'est pas identique:
• Dans le cas du contrôle TPageControl, chaque page ou onglet possède ses propres contrôles. Le fait de passer d'un onglet à un autre change aussi, automatiquement, les contrôles qui sont visibles
• Par contre, dans le cas du contrôle TTabControl, le changement d'onglet ne provoqiue aucun changement d'affichage automatiquement. Si certains contrôles doivent disparaitre lors du changement d'onglet, il faut le faire par programme, dans la fonction de réponse à l'événement "OnChange"

Pour choisir entre les deux, il faut savoir si certains contrôles doivent persister entre différents onglets.
• Si oui, il est préférable d'utiliser un contrôle TTabControl
• Sin non, choisir un contrôle TPageControl

Mise en oeuvre du contrôle TPageControl:
• Après avoir mis le contrôle sur la fiche, cliquer droit dessus puis sélectionner "Nouvelle page". Cela crée un nouveau contrôle "TTabSheet" sur lequel il est possible de placer de nouveau contrôles tels que des zones d'édition des labels et autres.
• Avant d'ajouter un contrôle sur un 'TTabSheet", changer le nom de ce contrôle ainsi que sa propriété "Caption"
• Il est inutile de placer un symbole "&" dans la propriété caption car cela ne fonctionne pas correctement (le changement d'onglet se fait bien mais pas la mise à jour des affichages des contrôles)

Mise en oeuvre du contrôle TTabControl:
• Après avoir mis le contrôle sur la fiche, sélectionner la propriété "Tabs" dans l'inspecteur d'objets. Cela lance un éditeurs multilignes. Chacune de ces lignes représente un nouvel onglet. Créer autant de ligne que necéssaire.
• Placer sur ce contrôle tous les contrôles qui vont en dépendre.
• La propriété "TabIndex" permet de définir ou de connaitre l'onglet qui a été sélectionné.

(Valeur 0 pour l'onglet de gauche puis 1 pour celui immédiatement à sa droite et ainsi de suite) Dans l'inspecteur d'objets - Onglet événements - séléctionner l'événement "OnChange" puis saisir un nom pour la fonction qui va gérer cet événement ou double-vliquer dessus pour laisser à Builder le choix du nom.
• Mettre en place dans la fonction de réponse à cet événement une structure de type SWITCH pour traiter les différentes valeurs de la propriétés de "TabIndex". Chacun des cas doit rendre visible les contrôles intégrés qui doivent l'être mais aussi rendre invisible ceux qui ne doivent pas être visibles.
Sommaire