12.8. Class LISTITEM

12.8.1. About

Класс предназначен для управления данными, организованными в список. Например, это может быть список файлов.

12.8.2. Description

 ListItemNew(<nLrow>,<nLcol>,<nRrow>,<nRcol>[,<nColumns>[,<sDelimiter>[,<sColor>]]]) --> ListItem object

12.8.2.1. Attributes

<ClassName> LISTITEM
<Item> Array, массив элементов.
<nTop> Numeric, координаты области редактирования LISTITEM
<nLeft> Numeric, координаты области редактирования LISTITEM
<nBottom> Numeric, координаты области редактирования LISTITEM
<nRight> Numeric, координаты области редактирования LISTITEM
<ColorSpec> String, цветовая спецификация.
  
  "clr1, clr2, clr3, clr4, clr5, clr6, clr7"
  clr1 - основной цвет и цвет обрамления
  clr2 - цвет текущего элемента, если объект в фокусе
  clr3 - цвет текущего элемента, если объект не в фокусе
  clr4 - цвет заголовков
  clr5 - цвет выделенных элементов
  clr6 - цвет текущего выделенного элемента
  clr7 - цвет выделенных операцией поиска символов
  
<ItemCount> Numeric, количество элементов в <::Item>
<Buffer> Numeric, номер текущего элемента
<First> Numeric, номер первого элемента в области просмотра
<ItemWin> Numeric, количество элементов в области просмотра
<Line> Numeric, текущая координата курсора - строка
<Col> Numeric, текущая координата курсора - колонка
<Pos> Numeric, номер текщей колонки
<ColWin> Numeric, количество колонок в области просмотра
<RowWin> Numeric, количество строк в области просмотра
<LenCol> Array, массив, содержащий ширину колонок
<Title> Array, массив заголовков колонок
<Delim> String, разделитель колонок
<HasFocus> Logical, если TRUE объект находится в фокусе
<FindBuffer> String, буфер поиска
  

12.8.2.2. Methods

ADDITEM Добавить новый элемент в список.
CLEAR Удалить все элементы из списка.
CLEARFINDBUFFER Очистить буфер поиска.
DELITEM Удалить элемент из списка.
DOWN Перемещение на следующий элемент.
DRAWTITLE Нарисовать заголовки колонок.
END Перемещение на последний элемент массива <::Item>
FIND Поиск подстроки.
GETITEM Получить текущий элемент.
GETSELECTED Возвращает номера выделенных элементов.
HANDLEKEY Обработчик кодов.
HOME Перемещение на первый элемент массива <::Item>
INSITEM Вставить новый элемент в список.
KILLFOCUS Снять фокус.
LEFT Перемещение налево.
LISTITEMNEW Конструктор объекта LISTITEM.
PAGEDOWN Перемещение на следующую страницу массива <::Item>
PAGEUP Перемещение на предыдущую страницу массива <::Item>
REFRESH Перерисовать область просмотра..
RIGHT Перемещение направо.
SELECT Выделить элемент.
SETCOLUMNS Задать количество колонок.
SETFOCUS Установить фокус.
SETITEM Установить текущий элемент.
SETKEY Установить блок кода, связанный с кодом клавиши.
SETTITLE Задать заголовки колонкам.
SETWIDTHCOL Задать ширину колонок.
UP Перемещение на предыдущий элемент.

12.8.2.31. Method LISTITEM:SETKEY()

Установить блок кода, связанный с кодом клавиши.

 SetKey(<nKey>[, <bData>]) 	--> bPreviouse

12.8.2.31.3. Description

SetKey() устанавливает новый кодовый блок, ассоциированный с кодом <nKey>. Когда при этом замещается существующий блок кода, метод возвращает этот существующий блок, иначе возвращает вновь установленный. Коды клавиш и связанные с ними кодовые блоки обрабатываются методом HandleKey().

Если <bData> NIL, SetKey() возвращает старый кодовый блок и удаляет код клавиши с ассоциированым с ним кодовым блоком.

По умолчанию с клавишами перемещения курсора(K_UP, K_DOWN, K_LEFT, K_RIGHT, K_PGUP, K_PGDN, K_HOME, K_END ....) ассоциированы соответствующие методы Left(), Right(), Up(), Down() и тд.

Блок кода, ассоциированный пользователем с кодом клавиши, получает два параметра: сам объект LISTITEM и код клавиши; и должен вернуть одно из следующих значений:

-1 Пользовательский запрос к LISTITEM потерять фокус

0 Кодовый блок, ассоциированный с кодом <nKey>, был выполнен

1 Неопределенный в словаре код <nKey>, код не был обработан