PureBasic
ListViewGadget()
Синтаксис
Result = ListViewGadget(#Gadget , x , y , Width , Height [, Flags])
Описание
Создает Гаджет "Список" (ListView) в текущем списке Гаджетов (GadgetList).
Параметры
#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически. x, y, Width, Height Позиция и размеры нового Гаджета. Flags (дополн.) Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'): #PB_ListView_Multiselect: Разрешает выбор множества элементов. #PB_ListView_ClickSelect: Разрешает выбор множества элементов. Клик на элементе устанавливает/снимает выбор.
(В OS X, оба флага работают как #PB_ListView_Multiselect)
Возвращаемое значение
Возвращает не нулевое значение в случае успешного создания Гаджета, в противном случае возвращает ноль. Если в качестве параметра #Gadget использовалось значение #PB_Any, то в случае успеха, возвращаемым значением будет сгенерированный Номер Гаджета.
Комментарии
Вы можете добавить 'Всплывающую мини-подсказку' к этому Гаджету с помощью функции GadgetToolTip().Через EventType() поддерживаются следующие события:
Для работы с содержимым списка могут использоваться следующие функции:
- AddGadgetItem(): Добавляет элемент. ListViewGadget() ограничен 65 536 элементами.
- RemoveGadgetItem(): Удаляет указанный элемент из Гаджета.
- ClearGadgetItems(): Удаляет все элементы из Гаджета.
- CountGadgetItems(): Возвращает количество элементов указанного Гаджета.
- GetGadgetItemData(): Возвращает значение, которое было сохранено в элементе Гаджета.
- GetGadgetItemState(): Возвращает не нулевое значение, если элемент является выделенным, в противном случае 0.
- GetGadgetItemText(): Возвращает текстовое содержимое (имя) указанного элемента.
- GetGadgetState(): Возвращает индекс первого выделенного элемента Гаджета (-1 если ничего не выделено).
- GetGadgetText(): Возвращает текстовое содержимое (имя) текущего выбранного элемента
- SetGadgetItemData(): Сохраняет заданное значение в указанном элементе Гаджета.
- SetGadgetItemState(): Выделяет или снимает выделение с указанного элемента.
- SetGadgetItemText(): Изменяет текст (имя) указанного элемента.
- SetGadgetState(): Делает указанный элемент выделенным (все прочие выделенные элементы теряют этот статус). 'State'- это индекс элемента, если задано -1, не один элемент не будет выделен.
- SetGadgetText(): Выделяет первый встреченный элемент с данным текстом (именем), (текст должен точно совпадать).
Этот Гаджет поддерживает функции SetGadgetColor() и GetGadgetColor() со следующими значениями для параметра 'ColorType':#PB_Gadget_FrontColor: Цвет текста #PB_Gadget_BackColor : Цвет фона
#PB_EventType_LeftClick : Пользователь кликнул на элементе левой кнопкой мыши. (также срабатывает при изменении выбора) #PB_EventType_LeftDoubleClick : Пользователь сделал двойной клик на элементе левой кнопкой мыши. #PB_EventType_RightClick : Пользователь кликнул на элементе правой кнопкой мыши.
Пример
If OpenWindow(0, 0, 0, 270, 140, "Гаджет Список", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) ListViewGadget(0, 10, 10, 250, 120) For a = 1 To 12 AddGadgetItem(0, -1, "Элемент " + Str(a) + " Списка") ; Определить содержимое списка. Next SetGadgetState(0, 9) ; Установить (начиная с 0) десятый элемент как активный. Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow EndIf
См. также
AddGadgetItem(), RemoveGadgetItem(), ClearGadgetItems(), CountGadgetItems(), GetGadgetState(), SetGadgetState(), GetGadgetText(), SetGadgetText(), GetGadgetItemState(), SetGadgetItemState(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetItemData(), SetGadgetItemData(), GetGadgetColor(), SetGadgetColor(), ListIconGadget()
Поддерживаемые OS
Все
