|
|
Определяет список элементов в стиле папок 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
| стиль отображения списка (см. ниже)
|
Только чтение
| [TYPE]
| [DESC]
|
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
| выделяет все элементы списка
|
|
Стандартные методы
Стандартные события
// Главная форма 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+ | Руководство пользователя
|
|
|
|
|
|