JS+
Усиленный язык сценариев для Windows
с возможностью встраивания
в ваши приложения
О языке JS+ Справочник Скачать JS+ DLL
Контакты
СПРАВОЧНИК ПО ЯЗЫКУ JS+ Содержание

TListView

- визуальный компонент
Компоненты JS+
Определяет список элементов в стиле папок Windows.

Создание объекта

lstViewObj=new TListView(Parent);

Собственные свойства
Свойство Тип Описание
AllocBy Number ожидаемое количество элементов списка (задание этого свойства может существенно повысить быстродействие операций со списком)
Checkboxes Boolean отображать переключатель перед каждым элементом списка
ColumnClick Boolean разрешить обработку кликов на заголовках столбцов
FlatScrollBars Boolean отображать полосы прокрутки в плоском виде
GridLines Boolean отображать разделительные линии между элементами списка
GroupHeaderImages TImageList список изображений для заголовков групп элементов списка
GroupView Boolean отображать группы элементов списка
Groups TListGroups коллекция групп элементов списка
HideSelection Boolean убирать выделение текущего элемента списка при потере фокуса ввода
HotTrack Boolean выделять элементы списка через некоторое время после наведения указателя мыши
HotTrackStyles Enum способ выделения элементов списка при установленном свойстве HotTrack (см. ниже)
HoverTime Number при наведении указателя мыши на элемент списка - время (миллисекунд), по истечении которого элемент становится выделенным (при установленном свойстве HotTrack)
ItemFocused TListItem элемент списка, находящийся в фокусе ввода
Items TListItems коллекция элементов списка
LargeImages TImageList список изображений для стиля отображения vsIcon
MultiSelect Boolean разрешить выбор нескольких элементов списка
OwnerData Boolean разрешить программную обработку элементов списка
OwnerDraw Boolean разрешить программную отрисовку элементов списка
ReadOnly Boolean запретить редактирование элементов списка
RowSelect Boolean разрешить выделение строки списка
Selected TListItem выделенный элемент списка
SmallImages TImageList список изображений для стиля отображения vsSmallIcon
SortType Enum тип автоматической сортировки списка (см. ниже)
StateImages TImageList список изображений для стиля отображения vsList
ViewStyle Enum стиль отображения списка (см. ниже)
Только чтение
BoundingRect TRect ограничивающий прямоугольник клиентской области компонента при стилях отображения vsIcon или vsSmallIcon
Canvas TCanvas дескриптор графической канвы
Columns TListColumns коллекция столбцов элементов (при стиле отображения vsReport)
SelCount Number количество выделенных элементов списка
TopItem TListItem верхний элемент списка при стилях отображения vsList или vsReport
ViewOrigin TPoint верхний левый угол клиентской области компонента при стилях отображения vsIcon или vsSmallIcon
VisibleRowCount Number количество видимых строк списка при стилях отображения vsList или vsReport

Свойство HotTrackStyles
Значение Описание
htHandPoint указатель над выделенным элементом мыши принимает вид кисти руки
htUnderlineCold не выделенные элементы подчеркиваются
htUnderlineHot выделенный элемент подчеркивается

Свойство SortType
Значение Описание
stNone без сортировки
stData сортировка по свойству Data элементов списка
stText сортировка по свойству Caption элементов списка
stBoth комбинированная сортировка по свойствам Data и Caption элементов списка

Свойство ViewStyle
vsIcon обычные значки
vsSmallIcon мелкие значки
vsList список элементов
vsReport таблица элементов

Стандартные свойства

Собственные методы
Метод Описание
AddItem добавляет новый элемент в конец списка
AlphaSort сортирует элементы списка
Arrange выравнивает значки при стилях отображения vsIcon или vsSmallIcon
Clear очищает список элементов
ClearSelection снимает выделение элементов списка
CopySelection копирует выделенные элементы в указанный список
DeleteSelected удаляет выделенные элементы списка
FindCaption выполняет последовательный поиск элемента в списке
GetCount возвращает количество элементов в списке
GetHitTestInfoAt возвращает информацию о точке в клиентской области компонента
GetItemAt возвращает элемент списка в указанной позиции
GetNearestItem возвращает ближайший элемент списка в указанной точке в указанном направлении
GetNextItem возвращает следующий элемент списка в указанном направлении
GetSearchString возвращает строку, введенную пользователем для поиска элемента списка
IsEditing сообщает, был ли заголовок одного из элементов списка отредактирован пользователем
Scroll прокручивает список элементов на указанное расстояние по горизонтали и вертикали
SelectAll выделяет все элементы списка

Стандартные методы

Собственные события
Событие Описание
OnAdvancedCustomDraw требуется поэтапная отрисовка списка
OnAdvancedCustomDrawItem требуется поэтапная отрисовка элемента списка
OnAdvancedCustomDrawSubItem требуется отрисовка субэлемента списка в различных состояниях
OnChange элемент списка был изменен
OnChanging элемент списка будет изменен
OnColumnClick произошел щелчок левой кнопкой мыши на заголовке столбца
OnColumnDragged заголовок столбца был перемещен на новое место
OnColumnRightClick произошел щелчок правой кнопкой мыши на заголовке столбца
OnCompare требуется сравнить два элемента списка
OnCustomDraw требуется отрисовка внешнего вида списка
OnCustomDrawItem требуется отрисовка элемента списка
OnCustomDrawSubItem требуется отрисовка субэлемента списка
OnData элемент списка будет отображен
OnDataHint изменился диапазон видимых на экране элементов
OnDataStateChange изменилось состояние элемента списка
OnDeletion пользователь удаляет элемент списка
OnDrawItem требуется отрисовка элемента списка
OnEdited произошло редактирование элемента списка
OnEditing произойдет редактирование элемента списка
OnGetImageIndex необходимо указать индекс значка для элемента списка
OnGetSubItemImage необходимо указать индекс значка для субэлемента списка
OnInfoTip пользователь навел указатель мыши на элемент и задержал его
OnInsert в список вставлен новый элемент
OnItemChecked изменилось состояние переключателя элемента списка
OnSelectItem выбран элемент списка

Стандартные события

Пример (JS+)
// Главная форма
frm=new TForm();
frm.Caption="JS+ - визуальный компонент TListView";
frm.Width =525;
frm.Height=375;

// Строка состояния
stb=new TStatusBar(frm);
stb.SimpleText=" Кликайте по элементам списка";

// Метка перед списком стилей
lbl=new TLabel(frm);
lbl.Left=10;
lbl.Caption="Стиль отображения списка элементов:";

// Стили отображения списка элементов
cmb=new TComboBox(frm);
cmb.Style=csDropDownList;
cmb.Left=lbl.Left+lbl.Width+10;
cmb.Top =10;
cmb.Width=frm.ClientWidth-lbl.Width-30;
cmb.Items.Add("vsIcon");
cmb.Items.Add("vsList");
cmb.Items.Add("vsReport");
cmb.ItemIndex=0;
cmb.OnSelect=cmb_Select;

lbl.Top=cmb.Top+(cmb.Height-lbl.Height)/2;

// Список элементов
lsv=new TListView(frm);
lsv.BorderStyle=bsSingle;
lsv.GridLines=true;
lsv.Left=lbl.Left;
lsv.Top =cmb.Top+cmb.Height+10;
lsv.Width =frm.ClientWidth-lbl.Left*2;
lsv.Height=stb.Top-lsv.Top-10;
lsv.OnSelectItem=lsv_SelectItem;

// Список изображений
iml=lsv.LargeImages=new TImageList(lsv);
iml.Width=iml.Height=32;

// Столбцы для стиля отображения vsReport
for (i=0;i<4;i++) {
  lsc=new TListColumn(lsv);
  switch (i) {
    case 0 : lsc.Caption="Элементы"; break;
    default: lsc.Caption="Субэлементы "+i;
  }
  lsc.Width=lsv.TextWidth(lsc.Caption)+20;
}

// Элементы списка
icn=new TIcon();
for (i=0;i<5;i++) {
  icn.LoadFromFile(JSPlus.HelpDir+"IMAGE\\TListView\\"+i+".ico");
  iml.AddIcon(icn);

  // Элемент списка
  lsi=new TListItem(lsv);
  lsi.Caption="Элемент "+(i+1);
  lsi.ImageIndex=i;

  // Субэлементы
  for (j=0;j<3;j++)
    lsi.SubItems.Add("Субэлемент "+(i+1)+"-"+(j+1));
}
icn.Delete();

cmb_Select(cmb);
frm.ShowModal();

// Обработчик события OnSelect
function cmb_Select(cmb)
{
  lsv.ViewStyle=eval(cmb.Items[cmb.ItemIndex]);
  lsv.SetFocus();
}

// Обработчик события OnSelectItem
function lsv_SelectItem(lsv,itm,sel)
{
  stb.SimpleText=" Выбран "+itm.Caption;
}
Совместимость
C++ Builder/Delphi
JS+Руководство пользователя
Адрес этой страницы: http://jsplus.ru/MANUAL/JSPlus/Component/TListView.htm
© 2024,