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

TListItem

- визуальный компонент
Компонент TListItems
Определяет элемент списка компонента TListItems.
Создание объекта

lstItmObj=new TListItem(lstViewObj);

lstItmObj=lstViewObj.Items.Add();

Доступ к объекту

lstItmObj=lstViewObj.Items[Index];

lstItmObj=lstViewObj.Items.Item[Index];

Собственные свойства
Свойство Тип Описание
Caption String заголовок элемента списка
Checked Boolean состояние переключателя перед элементом списка
Cut Boolean над элементом списка выполнена операция "вырезать"
Data Number данные, ассоциированные с элементом списка
Focused Boolean элемент списка находится в фокусе ввода
GroupID Number идентификатор группы элементов списка
ImageIndex Number индекс изображения элемента в списке LargeImages или SmallImages
Indent Number отступ элемента списка относительно левой границы родительского компонента
Left Number левая координата элемента списка (в системе отсчета родительского компонента)
OverlayIndex Number индекс черно-белого изображения-маски элемента в списке LargeImages или SmallImages
Position TPoint позиция левого верхнего угла элемента списка (в системе отсчета родительского компонента)
Selected Boolean элемент списка выделен
StateIndex Number индекс изображения элемента в списке StateImages
SubItems TStrings субэлементы элемента списка
SubItemImages Number массив индексов изображений субэлементов в списке LargeImages или SmallImages
Top Number верхняя координата элемента списка (в системе отсчета родительского компонента)
Только чтение
Deleting Boolean элемент списка находится в процессе удаления
Handle Number дескриптор Windows GDI элемента списка
Index Number индекс элемента в списке Items родительского компонента
ListView TListView дескриптор родительского компонента

Собственные методы
Метод Описание
Assign копирует свойства указанного элемента списка
CancelEdit запрещает редактирование элемента списка пользователем
Delete удаляет элемент списка
DisplayRect возвращает прямоугольник, занимаемый различными частями элемента списка
EditCaption возвращает состояние редактирования элемента списка пользователем
GetPosition возвращает позицию верхнего левого угла элемента списка
MakeVisible прокручивает список до полной или частичной видимости элемента списка
SetPosition устанавливает позицию верхнего левого угла элемента списка
Update перерисовывает элемент списка

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

Пример (JS+)
// Главная форма
frm=new TForm();
frm.Caption="JS+ - визуальный компонент TListItem";
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=lsv.Items.Add();
  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/TListItems/TListItem.htm
© 2024,