13.3. Класи tstrings, tstringlist – набори рядків й об’єктів

Властивості класу TStringList

Властивості

Призначення

Proporty Capacity: Integer;

Поточна ємність набору рядків.

Property CommaText: String;

Служить для установки або одержання всього набору рядків у вигляді єдиного рядка з лапками й комами.

Property Count: Integer;

Поточна кількість рядків у наборі.

Property Duplicates: TDuplicates;

Властивість, що дозволяє управляти можливістю розміщення в наборі двох і більше ідентичних рядків.

Property Names[Index: integer] : String;

Для рядка з індексом Index повертає частина Name, якщо це рядок виду Name-Value, у противному випадку повертає порожній рядок

Property Objects[Index: Integer] : TObject;

Відкриває доступ до об'єкта, зв’заного з рядком з індексом Index.

Property Sorted: Boolean;

Ознака необхідності сортування рядків за абеткою.

Property Strings[Index: Integer] : String;

Доступ до рядка з індексом Index.

Property StringsAdapter:

TStringsAdapter;

Ця властивість використовується тільки при розробці компонентів, що відповідають стандарту Active.

Property Text: String;

Інтерпретує набір рядків у вигляді одного довгого рядка із внутрішніми роздільниками EOLN між окремими рядками набору.

Property OnChange:TNotifyEvent;

Визначає реакцію на зміну набору рядків. Виникає після останньої зміни.

Методи класу TStringList

Методи

Призначення

Function Add(const S: String): Integer;

Додає рядок у набір даних і повертає їх індекс.

function AddObject(const S: string; aObject: TObject): Integer;

Додає рядок й об'єкт у набір даних.

Procedure AddStrings( Strings:TStrings);

Додає до поточного набору новий набір рядків.

Procedure Assign(Source: TPersistent);

Знищує колишній набір рядків і завантажує з Source новий набір. У випадку невдачі виникає виключення EConvertError.

procedure Clear;

Очищає набір даних і звільняє пов'язану з ним пам'ять.

procedure Delete(Index: Integer) ;

Знищує елемент набору з індексом Index і звільняє пов'язану з ним пам'ять.

function Equals(Strings: TStrings): Boolean;

Порівнює по рядках поточний набір даних з набором Strings і повертає True, якщо набори ідентичні.

procedure Exchange(Indexl, Index2: Integer);

Міняє місцями рядки з індексами Indexl й Index2. Якщо об'єкт сортується (Sorted - True), викликає виключення EStringListError.

function Find(const S: String; var Index: Integer): Boolean;

Шукає в наборі рядок S й у випадку успіху в параметрі Index повертає індекс.

Function GetText: PChar;

Завантажує рядки з єдиного масиву, у якому вони відокремлюються один від одного ознакою EOLN.

function IndexOf(const S: String): Integer;

Для рядка S повертає індекс або -1, якщо такого рядка у наборі немає.

function IndexOfObject(aObject: TObject): Integer;

Для об'єкта aObject повертає індекс або -1, якщо такого об'єкта в наборі немає.

procedure Insert(Index: Integer; const S: String);

Вставляє рядок у набір і присвоює йому індекс Index.

procedure InsertObject(Index: Integer; const S: String; aObject: TObject)

Вставляє рядок й об'єкт у набір і присвоює їм індекс Index.

procedure LoadFromFile(const FileName: String);

Завантажує набір з файлу.

procedure Move(CurIndex, NewIndex: Integer);

Переміщає рядок з положення CurIndex у положення NewIndex.

procedure SaveToFile(const FileName: String);

Зберігає набір у файлі.

procedure SaveToStream(Stream: TStream);

Зберігає набір у потоці.

procedure SetText(Text: PChar);

Вивантажує рядки у єдиний масив, у якому вон відокремлюються один від другого ознакою EOLN.

Function Add(const S: String): Integer;

Додає рядок у набір даних і повертає їх індекс.

function AddObject(const S: string; aObject: TObject): Integer;

Додає рядок й об'єкт у набір даних.

Procedure AddStrings( Strings:TStrings);

Додає до поточного набору новий набір рядків.

procedure Assign(Source: TPersistent);

Знищує колишній набір рядків і завантажує з Source новий набір. У випадку невдачі виникає виключення EConvertError.

procedure Clear;

Очищає набір даних і звільняє пов'язану з ним пам'ять.

procedure Delete(Index: Integer) ;

Знищує елемент набору з індексом Index і звільняє пов'язану з ним пам'ять.

function Equals(Strings: TStrings):

Boolean;

Порівнює по рядках поточний набір даних з набором Strings і повертає True, якщо набори ідентичні.

procedure Exchange(Indexl, Index2:

Integer);

Міняє місцями рядки з індексами Indexl й Index2. Якщо об'єкт сортується (Sorted - True), викликає виключення EStringListError.

function Find(const S: String; var Index: Integer): Boolean;

Шукає в наборі рядок S й у випадку успіху в параметрі Index повертає індекс.

Function GetText: PChar;

Завантажує рядки з єдиного масиву, у якому вони відокремлюються один від одного ознакою EOLN.

function IndexOf(const S: String): Integer;

Для рядка S повертає індекс або -1, якщо такого рядка у наборі немає.

function IndexOfObject(aObject:

TObject): Integer;

Для об'єкта aObject повертає індекс або -1, якщо такого об'єкта в наборі немає.

procedure Insert(Index: Integer; const S: String);

Вставляє рядок у набір і присвоює йому індекс Index.

procedure InsertObject(Index: Integer; const S: String; aObject: TObject)

Вставляє рядок й об'єкт у набір і присвоює їм індекс Index.

procedure LoadFromFile(const FileName: String);

Завантажує набір з файлу.

procedure Move(CurIndex, NewIndex: Integer);

Переміщає рядок з положення CurIndex у положення NewIndex.

procedure SaveToFile(const FileName: String);

Зберігає набір у файлі.

procedure SaveToStream(Stream:

TStream);

Зберігає набір у потоці.

procedure SetText(Text: PChar);

Вивантажує рядки у єдиний масив, у якому вон відокремлюються один від другого ознакою EOLN.