Встроенные классы КлассTlist- списки

Свойства класса:

property Capacity: Integer;

Содержит количество элементов массива указателей списка. Всегда больше Count.Если при добавлении очередного элементаCountстало равноCapacity,происходит автоматическое расширение списка на 16 элементов.

propertyCount: Integer;

Количество элементов списка. Это свойство изменяется при добавлении или удалении элемента.

property Iterns(Index:Integer) : Pointer;

Возвращает указатель на элемент списка по его индексу. Самый первый элемент списка имеет индекс 0.

property List: pPointerList;

Возвращает указатель на массив элементов списка.

Методы класса:

fаunction Add(Item: Pointer): Integer;

Добавляет элемент Item в конец списка и возвращает его индекс.

procedureClear;

Очищает список, удаляя из него все элементы. Не освобождает память, связанную с каждым удаленным элементом. Устанавливает свойства Count и Capacity значение 0

procedureDelete(Index:Integer);

Удаляет из списка элемент с индексом Index.Все элементы, расположенные за удаляемым, смещаются на одну позицию вверх.

class procedure Error(const Msg: String; Data: Integer); virtual

Возбуждает исключение EListErrorс параметрами Msg иData.

procedure Exchange(Indexl, Index2: Integer);

Меняет местами элементы с индексами Index1иIndex2.

functionExpand: TList;

Расширяет массив элементов, увеличивая Capacity.

functionFirst: Pointer;

Возвращает указатель на самый первый элемент списка.

function IndexOf(Item:Pointer): Integer;

Отыскивает в списке элемент Itemи возвращает его индекс.

procedure Insert(Index: Integer; Item: Pointer) ;

Вставляет элемент Itemв позициюIndexсписка: новый элемент получает индексIndex,все элементы с индексамиIndexи больше увеличивают свой индекс на 1. При необходимости расширяет список.

functionLast: Pointer

Возвращает указатель на последний элемент списка.

procedure Move(Curlndex, Newlndex: Integers)

Перемещает элемент в списке с позиции Curlndexв позициюNewlndex.Все элементы старого списка с индексами отCurlndexдоNewlndexуменьшают свой индекс на 1.

procedurePack;

Упаковывает список: удаляет пустые элементы в конце массива индексов.

function Remove(I tern:Pointer): Integers

Отыскивает в списке элемент Itemи удаляет его.

procedureSort(Compare:TListSortCompare);

Сортирует коллекцию с помощью функции Compare.

Свойства класса:

propertyCapacity: Integer

Текущая емкость набора строк.

propertyConanaText:String

Служит для установки или получения всего набора строк в виде единой строки с кавычками и запятыми (см. ниже пояснения).

propertyCount: Integers

Текущее количество строк в наборе.

property Names[Index: Integer]: String

Для строки с индексом Indexвозвращает частьName, если это строка видаName= Value,в противном случае возвращает пустую строку

property Objects[Index:integer] : TObject;

Открывает доступ к объекту, связанному со строкой с индексом Index.

property String[Index: Integer]: String

Открывает доступ к строке с индексом Index.

propertyStringAdapter: TStringAdapter;

Это свойство используется только при разработке компонентов, отвечающих стандарту ActiveX.

propertyText:String

Интерпретирует набор строк в виде одной длинной строки с разделителями EOLNмежду отдельными строками набора.

property Values[const Name: String] : String

По части Nameотыскивает в наборе и возвращает частьValue для строк видаName= Value.

Методы класса:

function Add(const S: String): Integer;

Добавляет строку в набор данных и возвращает ее индекс.

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

Добавляет строку и объект в набор данных.

procedureAddString(String: TString)

Добавляет к текущему набору новый набор строк.

procedure Append(const S: String)

То же, что Add,но не возвращает индекс вставленной строки.

procedureAssign(Source: TPersistent)

Уничтожает прежний набор строк и загружает из Sourceновый набор. В случае неудачи возникает исключениеEConvertError.

procedureBeginUpdate

Устанавливает флаг начала обновления. До вызова EndUpdateблокируется сортировка строк, что ускоряет процесс многократного изменения данных.

procedureClear

Очищает набор данных и освобождает связанную с ним память.

procedureDelete(Index: Integer)

Уничтожает элемент набора с индексом Indexи освобождает связанную с ним память.

procedureEndUpdate;

Сбрасывает флаг изменения и при необходимости сортирует строки.

function Equals(String: TString): Boolean

Сравнивает построчно текущий набор данных с набором Stringи возвращаетTrue,если наборы идентичны.

procedure Exchange(Indexl, Index3: Integer)

Меняет местами строки с индексами IndexlиIndex!. Если объект сортируется, вызывает исключениеEStringListError.

functionGetText: PChar

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

function IndexOf(const S: String): Integer

Для строки 5 возвращает ее индекс или -1, если такой строки в наборе нет.

function IndexOfName(const Name: String): Integer

Возвращает индекс первой строки вида Name= Value,в которой частьNameсовпадает с параметром обращения.

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

Загружает набор из файла.

procedureLoadFromStream(Stream: TStream)

Загружает набор из потока.

procedure Move(CurIndex, NwIndex: Integers

Перемещает строку из положения Curlndexв положениеNewlndex.

procedure SaveToFile(const FileName: String

Сохраняет набор в файле.

procedureSaveToStream(Stream: TStream)

Сохраняет набор в потоке.

procedureSetText(Text: PChar)

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