Russian Belarusian English German Japanese Ukrainian

Rashka.studio - игры и приложения для Android! Заходи, ждём тебя =)

TStrings

CuBook25

Описание

Класс TStrings содержит методы и свойства, позволяющие манипулировать со списками строк:
- добавлять и удалять строки в указанных позициях;
- перестраивать и упорядочивать последовательность строк;
- получать доступ к конкретным строкам;
- читать и записывать списки строк в файлы и потоки;
- связывать с каждой строкой некоторый объект.
 
Иерархия

TObject - TPersistent
 
Модуль

classes
 
Свойства

Свойство Тип Описание
Capacity int Указывает число строк, которые может содержать список. В классе TStrings чтение Capacity возвращает значение Count, а запись значения Capacity ничего не изменяет в списке. Но в некоторых классах, производных от TStrings, свойство Capacity позволяет заранее выделить память для добавления нескольких строк.
CommaText AnsiString Возвращает текст, в котором отдельные строки объединены в одну строку формата SDF (system data format). Отдельные исходные строки разделяются в итоговой строке запятыми и каждая строка, если в ней имеются символы пробелов, заключается в двойные кавычки. Если в исходных строках использовались символы двойных кавычек, они дублируются (получается два следующих друг за другом символа).
Count int Число строк в списке. Свойство только для чтения.
DelimitedText AnsiString Возвращает текст, в котором отдельные строки выделены кавычками, определенными свойством QuoteChar, и, кроме того, отделены друг от друга символом, указанным в свойстве Delimiter.
Delimiter char Символ разделителя, используемый в свойстве DelimitedText.
Names [int Index] System::AnsiString Применяется для списков, имеющих структуру «Имя = Значение». Такую структуру имеют, например, файлы .ini. Свойство Names возвращает Имя, использованное в строке с указанным индексом. Если строка не имеет форму «Имя = Значение», возвращается пустая строка. Свойство только для чтения.
Objects [int Index] TObject * Возвращает объект, связанный с указанной строкой свойства Strings. В классе TStrings свойство Objects не используется, но может использоваться в некоторых классах, производных от TStrings.
OuoteChar char Символ кавычек, используемый в свойстве DelimitedText.
Strings [int Index] System::AnsiString Текст строки с указанным индексом. Индекс первой строки - 0.
Text System::AnsiString Представляет весь список как одну строку, внутри которой используются разделители типа символов возврата каретки и перевода строки.
Values [System::AnsiString Name] System::AnsiString Применяется для списков, имеющих структуру «Имя = Значение». Такую структуру имеют, например, файлы .ini. Свойство Values возвращает Значение, в строке с указанным именем Name. Если заданное имя Name не найдено, возвращается пустая строка.
 
Методы

Метод Описание
int Add(const System::AnsiString S) Добавляет Строку S в конец списка. Возвращает индекс добавленной строки. В окнах редактирования добавляемая строка может оказаться разбитой на несколько, так что в этих случаях возвращаемый индекс ни о чем не говорит.
int AddObject(const System::AnsiString S, System::TObject* AObject) Добавляет в список строку S и связанный с ней объект AObject. Возвращает индекс добавленной строки и объекта.
void AddStrings(TStrings* Strings) Добавляет в список группу строк Strings типа TStrings.
void Append(const System::AnsiString S) Добавляет строку в конец списка. Метод аналогичен Add, но не возвращает индекс строки.
void Clear(void) Очищает список.
void Deletefint Index) Удаляет из списка указанную строку с индексом Index.
bool Equals(TStrings* Strings) Сравнивает данный список с заданным списком Strings. Возвращает true при идентичности списков.
void Exchange(int Index1, int Index2) Переставляет местами строки списка с индексами Index1 и Index2.
char * GetText (void) Возвращает буфер, под который выделяет память, и заполняет его значением свойства Text.
int IndexOf(const System::AnsiString S) Возвращает индекс указанной строки S. Если такой строки нет в списке, возвращается -1.
int IndexOfName(const
System::AnsiString Name)
Применяется для списков, имеющих структуру «Имя = Значение». Такую структуру имеют, например, файлы .ini. Возвращается индекс строки, в которой имя равно заданному значению Name. Если такой строки нет в списке, возвращается -1.
int IndexOfObject(System::TObject* AObject) Возвращает индекс первой строки, связанной с заданным объектом AObject. Если такой строки нет в списке, возвращается -1.
void Insert(int Index, const System::AnsiString S) Вставляет указанную строку S в заданную позицию Index. Если Index = 0, строка вставляется в первую позицию.
void InsertObject(int Index, const System::AnsiString S, System::TObject* AObject) Вставляет указанную строку S в заданную позицию Index и связывает с ней объект AObject. Если Index = 0, строка вставляется на первую позицию.
void LoadFromFiIe(const
System::AnsiString File Name)
Заполняет список строками текста из указанного файла FileName.
void LoadFromStream(TStream* Stream) Заполняет список строками текста из указанного потока Stream.
void Move(int Curlndex,
int Newlndex)
Изменяет позицию строки с индексом Curlndex, давая ей индекс Newlndex.
void SaveToFile(
const System:: AnsiString FileName)
Сохраняет строки списка в файле с указанным именем FileName.
void SaveToStream(
TStream* Stream)
Сохраняет значение свойства Text в указанном потоке Stream.
void SetText(char * Text) Задает значение свойства Text.
Если заметили ошибку, выделите фрагмент текста и нажмите Ctrl+Enter

Добавить комментарий