PureBasic

PanelGadget()

Синтаксис

Result = PanelGadget(#Gadget , x , y , Width , Height)

Описание


Создает Гаджет "Панель" (Panel Gadget) в текущем списке Гаджетов (GadgetList).

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height Позиция и размеры нового Гаджета.

Возвращаемое значение

Возвращает не нулевое значение в случае успешного создания Гаджета, в противном случае возвращает ноль. Если в качестве параметра #Gadget использовалось значение #PB_Any, то в случае успеха, возвращаемым значением будет сгенерированный Номер Гаджета.

Комментарии

Вы можете добавить 'Всплывающую мини-подсказку' к этому Гаджету с помощью функции GadgetToolTip().

Для работы с содержимым списка Гаджета "Панель" можно использовать следующие функции:

- AddGadgetItem() : Добавляет дочернюю Панель (вкладку) к указанной Панели.
- RemoveGadgetItem() : Удаляет Панель (вкладку) из указанной Панели.
- CountGadgetItems() : Возвращает количество Панелей (вкладок) в указанной Панели.
- ClearGadgetItems() : Удаляет все Панели (вкладки) из указанной Панели.
- GetGadgetItemText() : Возвращает заголовок Панели (вкладки).
- SetGadgetItemText() : Изменяет заголовок указанной Панели (вкладки).
- SetGadgetItemImage() : Изменяет изображение в заголовке указанной Панели (вкладки). (не поддерживается на OS X)
- GetGadgetItemData() : Возвращает значение, связанное (сохранённое) с указанной Панелью (вкладкой).
- SetGadgetItemData() : Связывает (сохраняет) заданное значение с указанной Панелью (вкладкой).

- SetGadgetState() : Делает указанную Панель (вкладку) текущей (активной).
- GetGadgetState() : Возвращает индекс текущей (активной) Панели (вкладки), или -1 если ни одна Панель (вкладка) не выбрана.
- GetGadgetAttribute() : С одним из следующих атрибутов: (для этого должен быть хотя бы один элемент)
  #PB_Panel_ItemWidth : Возвращает ширину внутренней области, где отображаются дочерние Гаджеты.
  #PB_Panel_ItemHeight : Возвращает высоту внутренней области, где отображаются дочерние Гаджеты.
  #PB_Panel_TabHeight : Возвращает высоту кнопки выбора Панели (вкладки).
Через EventType() поддерживаются следующие события:
  #PB_EventType_Change : Текущая отображаемая Панель (вкладка) была изменена.
  #PB_EventType_Resize: Размер Гаджета был изменен.
После создания Панели её список дочерних Панелей (вкладок) пуст. Вы должны вызвать функцию AddGadgetItem(), чтобы добавить хотя бы одну вкладку, прежде чем вы сможете добавлять другие Гаджеты внутрь этого Гаджета "Панель". Последующие Гаджеты будут автоматически добавляться на последнюю добавленную вкладку. Это весьма удобно. Когда Гаджет "Панель" заполнен всеми необходимыми Гаджетами, следует вызвать функцию CloseGadgetList(), для возвращения к прежнему списку Гаджетов. Это означает, что внутри Гаджета "Панель" можно создать другой (дочерний) Гаджет "Панель"...

Пример

; Показывает использование нескольких Панелей...
If OpenWindow(0, 0, 0, 422, 220, "Гаджет Панель", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    PanelGadget(0, 8, 8, 356, 203)
    AddGadgetItem(0, -1, "Панель 1")
    PanelGadget(1, 5, 5, 340, 166)
    AddGadgetItem(1, -1, "Под-Панель 1")
    AddGadgetItem(1, -1, "Под-Панель 2")
    AddGadgetItem(1, -1, "Под-Панель 3")
    CloseGadgetList()
    AddGadgetItem(0, -1, "Панель 2")
    ButtonGadget(2, 10, 15, 80, 24, "Кнопка 1")
    ButtonGadget(3, 95, 15, 80, 24, "Кнопка 2")
    CloseGadgetList()
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf


См. также

AddGadgetItem(), RemoveGadgetItem(), CountGadgetItems(), ClearGadgetItems(), GetGadgetItemText(), SetGadgetItemText(), GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), CloseGadgetList(), OpenGadgetList(), SetGadgetItemImage()

Поддерживаемые OS

Все

<- OptionGadget() - Оглавление Gadget - ProgressBarGadget()->