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

TCheckListBox

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

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

clbObj=new TCheckListBox(Parent);

Собственные свойства
Свойство Тип Описание
AllowGrayed Boolean разрешить неактивное состояние переключателей
AutoComplete Boolean автоматически прокручивать список до подходящей строки при вводе символа
AutoCompleteDelay Number задержка в миллисекундах между нажатием клавиши и прокруткой списка до подходящей строки
Checked[] Boolean индексированный список включенных переключателей
Columns Number количество столбцов в мультистолбцовом режиме
Count Number количество строк в списке
ExtendedSelect Boolean разрешить использование клавиш Ctrl и Shift при установленном свойстве MultiSelect
Flat Boolean отображать переключатели в плоском виде
Header[] Boolean индексированный список переключателей-заголовков
HeaderBackgroundColor TColor цвет фона для переключателя-заголовка
HeaderColor TColor цвет шрифта переключателя-заголовка
IntegralHeight Boolean подгонять высоту окна списка под общую высоту видимых переключателей
ItemEnabled[] Boolean индексированный список активных переключателей
ItemHeight Number высота одного переключателя
ItemIndex Number индекс выбранного переключателя
Items TStrings список строк
MultiSelect Boolean разрешить выбор нескольких переключателей
ScrollWidth Number ширина списка, превышение которой приводит к появлению полосы горизонтальной прокрутки
Selected[] Boolean индексированный список выделенных строк
Sorted Boolean сортировать список по алфавиту
State[] Enum индексированный список состояния переключателей (см. ниже)
Style Enum стиль отображения списка (см. ниже)
TabWidth Number ширина отступов в базовых единицах диалога (0 - стандартная ширина)
TopIndex Number индекс первой видимой строки в списке
Только чтение
Canvas TCanvas дескриптор графической канвы
SelCount Number количество выделенных строк в списке

Свойство State[]
Значение Описание
cbChecked включен
cbGrayed не активен
cbUnchecked выключен

Свойство Style
Значение Описание
lbStandard стандартный стиль (по умолчанию)
lbOwnerDrawFixed программная отрисовка списка с постоянной высотой строк
lbOwnerDrawVariable программная отрисовка списка с переменной высотой строк
lbVirtual виртуальный список
lbVirtualOwnerDraw виртуальный список с программной отрисовкой

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

Собственные методы
Метод Описание
AddItem добавляет новую строку в список
Clear очищает список
ClearSelection снимает выделение строк списка
CopySelection копирует выделенные строки в указанный список
DeleteSelected удаляет выделенные строки списка
ItemAtPos возвращает индекс строки в указанной позиции
ItemRect возвращает расположение строки с указанным индексом
MoveSelection перемещает выделенные строки в указанный список
SelectAll выделяет все строки списка

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

Собственные события
Событие Описание
OnClickCheck изменилось состояние одного из переключателей
OnData запрошен текст строки списка с указанным индексом
OnDataFind запрошен индекс строки списка с указанным текстом
OnDrawItem происходит отрисовка строки списка с указанным индексом
OnMeasureItem запрошена высота строки списка с указанным индексом

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

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

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

clb=new TCheckListBox(frm);
clb.BorderStyle=bsSingle;
clb.HeaderBackgroundColor=frm.Color;
clb.SetBounds(10,10,frm.ClientWidth/4,stb.Top-20);
clb.OnClickCheck=clb_ClickCheck;

for (i=1,j=0;i<=3;i++,j++) {
  clb.Items.Add(" Раздел "+i);
  clb.Header[j]=true;
  for (k=1;k<=3;k++,j++)
    clb.Items.Add("Пункт "+i+"-"+k);
}

frm.ShowModal();

// Обработчик события OnClickCheck
function clb_ClickCheck(clb)
{
  var i=clb.ItemIndex,clb_Str;

  if (clb.Header[i])
    return;

  clb_Str=' Переключатель "'+clb.Items[i]+'" в состоянии "';

  switch (clb.State[i]) {
    case cbChecked : clb_Str+='включен'; break;
    case cbGrayed : clb_Str+='не активен'; break;
    case cbUnchecked: clb_Str+='выключен';
  }

  stb.SimpleText=clb_Str+'"';
}
Совместимость
C++ Builder/Delphi
См. также
JS+Руководство пользователя
Адрес этой страницы: http://jsplus.ru/MANUAL/JSPlus/Component/TCheckListBox.htm
© 2024,