PureBasic

ButtonImageGadget()

Синтаксис

Result = ButtonImageGadget(#Gadget , x , y , Width , Height , ImageID [, Flags])

Описание


Создаёт Гаджет "Кнопка с картинкой" (Button Image Gadget) в текущем списке Гаджетов (GadgetList).

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height Позиция и размеры нового Гаджета.
ImageID Изображение для Гаджета. Используйте функцию ImageID(), чтобы получить этот идентификатор для изображения. Этот параметр может быть равен нулю для создания кнопки без изображения. Функция SetGadgetAttribute() может быть использована для последующего изменения изображения.
Flags (дополн.) В качестве этого параметра можно использовать значение #PB_Button_Toggle, для создания кнопки-переключателя (которая имеет состояние включения / выключения). По умолчанию создается простая кнопка.

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

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

Комментарии

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

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

Эти две функции используется с кнопками типа #PB_Button_Toggle :
-- SetGadgetState(): для смены состояния (1 = нажатое, 0 = обычное).
-- GetGadgetState(): для получения состояния кнопки (1 = нажатое, 0 = обычное).

- GetGadgetAttribute() со следующими значениями: 
  #PB_Button_Image       : Возвращает идентификатор отображаемого изображения, например, ImageID (#MyImage).
  #PB_Button_PressedImage: Возвращает идентификатор отображаемого изображения при нажатии кнопки, например, ImageID (#MyImagePressed).
- SetGadgetAttribute() со следующими значениями: 
  #PB_Button_Image       : Задаёт отображаемое изображение.
  #PB_Button_PressedImage: Задаёт изображение, отображаемое при нажатии кнопки.

Пример

If OpenWindow(0, 0, 0, 320, 100, "Гаджет Кнопка с изображением", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If LoadImage(0, "map.bmp") ; Измените второй параметр на путь/имя файла для вашего изображения
        ButtonImageGadget(0, 10, 10, 100, 83, ImageID(0))
    EndIf
    Repeat
    Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf


См. также

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), ButtonGadget(), ImageID(), EventGadget()

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

Все

<- ButtonGadget() - Оглавление Gadget - CalendarGadget()->