CheckBoxGadget

CheckBoxGadget()

Синтаксис

Result = CheckBoxGadget(#Gadget , x , y , Width , Height , Text$ [, Flags])

Описание

Создаёт Гаджет "Флажок", он же "Чекбокс" (CheckBoxGadget) в текущем списке Гаджетов (GadgetList).

Параметры

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

x, y, Width, Height Позиция и размеры нового Гаджета.

Text$ Текст для отображения рядом с флажком.
Flags (дополн.)
Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'):
  #PB_CheckBox_Right     : Выравнивает текст по правому краю.
  #PB_CheckBox_Center    : Центрирует текст.
  #PB_CheckBox_ThreeState: Создаёт чекбокс, который может иметь третье "промежуточное" состояние.
Флаг #PB_CheckBox_ThreeState может использоваться для флажка, который представляет состояние нескольких элементов. Состояния "промежуточные" могут быть затем использованы, чтобы указать, что настройка не одинакова для всех элементов. Нажимая на флажок, пользователь может вернуть его в состояние "включено" или "выключено", чтобы применить его ко всем элементам. Поэтому "промежуточное" состояние может быть установлено только программой через SetGadgetState(), а не пользователем щелкнув на флажке.

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

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

Комментарии

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

- GetGadgetState() Возвращает текущее состояние Гаджета. (отмечен или не отмечен)
- SetGadgetState() Изменяет состояние Гаджета. (отмечен или не отмечен)

Пример

If OpenWindow(0, 0, 0, 270, 160, "Гаджет Чекбокс", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
CheckBoxGadget(0, 10, 10, 250, 20, "CheckBox стандартный")
CheckBoxGadget(1, 10, 40, 250, 20, "CheckBox отмеченный"): SetGadgetState(1, #PB_Checkbox_Checked)
CheckBoxGadget(2, 10, 70, 250, 20, "CheckBox с тремя состояниями", #PB_CheckBox_ThreeState): SetGadgetState(2, #PB_Checkbox_Inbetween)
CheckBoxGadget(3, 10, 100, 250, 20, "CheckBox с прав. текстом", #PB_CheckBox_Right)
CheckBoxGadget(4, 10, 130, 250, 20, "CheckBox с центр. текстом", #PB_CheckBox_Center)
Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf

См. также

GetGadgetState(), SetGadgetState(), OptionGadget()

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

Все

<- ChangeListIconGadgetDisplay() - Оглавление Gadget - ClearGadgetItemList()->

#Gadget	Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height	Позиция и размеры нового Гаджета.
Text$	Текст для отображения рядом с флажком.
Flags (дополн.)	Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '\|'): #PB_CheckBox_Right : Выравнивает текст по правому краю. #PB_CheckBox_Center : Центрирует текст. #PB_CheckBox_ThreeState: Создаёт чекбокс, который может иметь третье "промежуточное" состояние. Флаг #PB_CheckBox_ThreeState может использоваться для флажка, который представляет состояние нескольких элементов. Состояния "промежуточные" могут быть затем использованы, чтобы указать, что настройка не одинакова для всех элементов. Нажимая на флажок, пользователь может вернуть его в состояние "включено" или "выключено", чтобы применить его ко всем элементам. Поэтому "промежуточное" состояние может быть установлено только программой через SetGadgetState(), а не пользователем щелкнув на флажке.