La classe TStrings dans C++Builder

TStrings est la classe de base de tous les objets représentant une liste de chaînes.

Cette classe est utilisée dans certains composants tels que TMemo. Elle ne peut être instanciée directement car la majorité de ses méthodes sont virtuelles.

La classe TStringsList, qui hérite de TStrings, peut, elle, être instanciée pour ranger des chaines.

Chaque chaine est un objet AnsiString et peut donc être manipulé en utilisant les propriétés et méthodes de cet objet.

    Les Méthodes de TStrings

    Les Méthodes de TStrings héritées de TPersistent

    Les Méthodes de TStrings héritées de TObject

   Les Propriétés de TStrings

Cette méthode permet d'ajouter une ligne. Cette ligne ne doit pas contenir ni le caractère '\r' ni le caractère '\n'.
Elle renvoie l'indice de la ligne ajoutée. voir la différence de fonctionnement avec Append.
Exemple pour un composant Memo:

Memo1->Lines->Add ("Première ligne") ;

Retour

Même fonctionnement que Add mais ne renvoie pas l'indice de la ligne ajoutée.
Dans le cas où le texte à ajouter sur la ligne dépasse, la suite est positionnée sur la ou les ligne(s) suivante(s).
La méthode "Add" renvoie l'indice de la première ligne où commence le texte inséré quel que soit le nombre de lignes réellement ajoutées. L'indice n'a alors pas de valeur très significative. Cela dépend de l'application.
Exemple pour un composant Memo:

Memo1->Lines->Append ("Première ligne") ;

Retour

Cette méthode permet d'effacer toutes les lignes
Exemple pour un composant Memo:

Memo1->Lines->Clear() ;

Retour

Cette méthode permet d'effacer une seule ligne.
Exemple pour un composant Memo:

Memo1->Lines->Delete(0) ;

Retour

Cette méthode alloue dynamiquement un buffer de dimension suffisante puis le remplit avec le texte contenu dans l'objet TStrings.
Attention: L'utilisateur n'alloue pas la mémoire nécessaire mais il doit la désallouer lorsqu'il n'en a plus besoin.
Exemple pour un composant Memo:

char * pChaine ;
pChaine = Memo1->Lines->GetText() ;
...
delete [] pChaine ;

Retour

Cette méthode recherche la position d'une chaine dans la liste.
Elle renvoie 0 si la chaine est en première position, 1 en deuxième position et ainsi de suite.
Si la chaine n'est pas dans la liste, elle renvoie -1.
Si la chaine est présente plusieurs fois dans la liste, la valeur renvoyée correspond à la première trouvée en recherchant depuis le début.
Exemple pour un composant Memo :

int Indice ;
Indice = Memo1->Lines->IndexOf("Bonsoir") ;

Retour

Cette méthode insére une chaine au milieu de celles déjà existantes.
Exemple pour un composant Memo (Insère la ligne en deuxième position) :

Memo1->Lines->Insert(1,"Bonsoir") ;

Retour

Cette méthode charge le contenu d'un fichier dans l'objet TStrings
Exemple pour un composant Memo:

Memo1->Lines->LoadFromFile("C:\Autoexec.bat") ;

Retour

Cette méthode sauve le contenu de l'objet TStrings dans un fichier
Exemple pour un composant Memo:

Memo1->Lines->SaveToFile("C:\Autoexec.ref") ;

Retour

Cette méthode remplace le contenu de l'objet TStrings avec ce qui est passé en paramètre à la méthode. Fonctionne de la même façon que la propriété Text.
Exemple pour un composant Memo:

Memo1->Lines->SetText("Nouv. Ligne 1\r\nLigne2 remodifiée") ;

Retour

Renvoie le nombre de chaines de l'objet TStrings

Retour

Cette propriété permet de gérer le tableau de chaines. Ces chaines sont au format AnsiString

Cela permet d'atteindre en lecture ou en écriture la ième chaine du contrôle, à condition que cette ligne existe.
Exemple: Memo1->Lines->Strings[2]="Ligne 2 modifiée" ;

Retour

 
Cette propriété permet de définir ou d'obtenir l'ensemble des chaines contenues dans un objet TStrings sous forme d'une seule chaine, deux lignes étant séparées par la séquence "\r\n". Cette chaine globale est une AnsiString.

Cela permet de gérer le contenu d'un objet TStrings dans sa globalité.

Remarque: La propriété CommaText gère aussi le contenu global d'un objet TSrings mais en utilisant une autre méthode de gestion des différentes lignes. Voir l'aide de C++Builder pour plus de détails

Exemple: Memo1->Lines->Text="Ligne 1\r\nLigne2 modifiée" ;

Retour