Основные события класса TListView

OnCustornDraw,

OnAdvancedCustomDraw

Программная отрисовка внешнего вида списка

OnCustom DrawItem,

OnAdvancedCustomDrawItem

Программная отрисовка элемента списка

OnCustom DrawSubItem,

OnAdvancedCustomDrawSubItem

Программная отрисовка вложенного элемента

(свойства) списка

OnChange

Элемент списка был изменен

OnChanging

Происходит изменение элемента списка

OnColumnClick

Щелчок мышкой на заголовке столбца

OnColumnDragged

Заголовок столбца был перемещен (перетащен мышью) в новое место

OnColumnRightClick

Щелчок на заголовке столбца правой кнопкой мыши

OnData

Генерируется перед тем, как элемент списка должен быть нарисован. Данное сообщение обрабатывается, когда содержимое каждого элемента формируется программно (режим "виртуального списка")

OnDataFind

Запрос на поиск данных от метода FindData

OnDataHint

Изменен диапазон видимых на экране элементов (например, при прокрутке)

OnDataStateChange

Изменение состояния элемента (событие возникает, только если значение свойства Owner Data равно True)

On Deletion

Пользователь отдал команду на удаление элемента

OnDrawItem

Программная отрисовка содержимого элемента (событие возникает, только если значение свойства OwnerData равно True )

OnEdited

Завершено редактирование элемента

OnEditing

Происходит редактирование элемента

OnGetImagelndex

Генерируется перед отображением элемента на экране. Его можно обрабатывать, чтобы динамически задавать номер картинки-значка из списка картинок

OnGetSubItemImage

То же для вложенного элемента (SubItem)

OnInfoTip

Пользователь навел указатель мыши на элемент и задержал его

OnInsert

В список добавлен новый элемент

OnSelectItem

В списке выбран элемент

 

Для использования всех возможностей компонента TListView необходимо также

познакомиться с методами класса TListItems (свойство Items в списке). Эти методы

представлены ниже. Важны также свойства и методы класса TListItem, который характеризует конкретный элемент списка (приведены ниже).

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

function Add: TListltem;

Создание нового элемента и его добавление в конец списка. Функция возвращает ссылку на этот элемент

procedure BeginUpdate;

procedure EndUpdate;

Процедура BeginUpdate блокирует перерисовку списка, а процедура EndUpdate снимает блокировку. Эти методы обычно используют во время выполнения большого числа

изменений, чтобы не замедлять работу перерисовкой ненужных временных деталей

procedure Clear;

Удаление всех элементов списка и освобождение занимаемой ими памяти

procedure Delete (Index: Integer);

Удаление указанного элемента

function IndexOf(Value: TListItem): Integer;

Возвращает номер элемента, указанного в качестве параметра

function Insert(Index: Integer): TListItem;

Создание нового элемента и его добавление в указанную позицию списка. Функция возвращает ссылку на этот элемент

procedure SetCount(Value: Integer);

Задание числа элементов в списке

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

Caption

Заголовок элемента

Checked

Имеет значение True, если флажок элемента включен (свойство CheckBoxes должно иметь значение True)

Cut

Элемент рисуется в виде, показывающем, что он вырезан командой Cut (Вырезать). Все действия по реализации процедуры такого рисования разработчик должен программировать самостоятельно

Data

Свойство, имеющее тип Pointer и указывающее на связанный с элементом объект

Focused

Имеет значение True, если элемент имеет фокус

ImageIndex

Номер значка в списке картинок

Index

Положение элемента в коллекции TListItems

Left

Горизонтальный сдвиг от левой границы списка

Position

Свойство типа TPoint, определяющее координаты (в пикселах) элемента внутри списка

Selected

Имеет значение True, если элемент выделен

StateIndex

Номер значка из дополнительного списка картинок

SubItemImages

Список картинок для свойств данного элемента

Subltems

Список названий свойств элемента (тип TStrings)

 

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

procedure Delete;

Удаление элемента из списка. Для освобождения занимаемой им памяти надо использовать метод Free

function DisplayRect(Code: Т Display С ode): TRect;

Определяет прямоугольные координаты элемента с учетом параметра Code (границы всего элемента, только значка, только текста, значка и текста)

function GetPosition: TPoint;

Определение положения элемента в списке: смещение верхнего левого угла относительно начала списка

procedure SetPosition(const Value: TPoint);

Установка нового положения элемента

procedure MakeVisible(PartialOK: Boolean);

Прокрутка списка так, чтобы элемент стал видимым. Если значение параметра PartialOK равно True и элемент уже частично виден, то прокрутка не выполняется

procedure Update;

Перерисовка элемента

 

(С практике у Хмельнова)