ImageGadget

ImageGadget()

Синтаксис

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

Описание

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

Параметры

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

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

Гаджет корректирует свою ширину и высоту в соответствии с отображаемым изображением. Указанная ширина и высота используются только тогда, когда нет отображаемого изображения.

ImageID Идентификатор изображения, которое требуется отобразить в данном Гаджете. Корректный идентификатор 'ImageID' можно получить с помощью функции ImageID(). Если этот параметр равен 0, изображение отображаться не будет.
Flags (дополн.)
Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'):
  #PB_Image_Border: Отображать утопленную рамку вокруг изображения.
  #PB_Image_Raised: Отображать приподнятую рамку вокруг изображения.

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

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

Комментарии

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

Функция - SetGadgetState() позволяет заменить текущее изображение Гаджета на изображение с указанным ImageID. Если ImageID будет равен 0, изображение не будет отображаться в Гаджете.
Корректный 'ImageID' изображения можно получить с помощью функции ImageID().
Корректный 'ImageID' текущего изображения из CanvasGadget(), может быть получен с помощью функции GetGadgetAttribute с флагом #PB_Canvas_Image.
Функция - GetGadgetState(): возвращает идентификатор ImageID изображения отображаемого в этом Гаджете в данный момент.

Через EventType() поддерживаются следующие события:
#PB_EventType_LeftClick : Пользователь кликнул на элементе левой кнопкой мыши. #PB_EventType_RightClick : Пользователь кликнул на элементе правой кнопкой мыши. #PB_EventType_LeftDoubleClick : Пользователь сделал двойной клик на элементе левой кнопкой мыши. #PB_EventType_RightDoubleClick : Пользователь сделал двойной клик на элементе правой кнопкой мыши. #PB_EventType_DragStart : Пользователь попытался начать перетаскивание (Drag & Drop).
После события #PB_EventType_DragStart библиотека Drag & Drop может использоваться для запуска операции Drag & Drop (Перетаскивание мышью).

Если требуется поддержка большего количества типов событий или двойной буферизации для регулярного обновления содержимого изображения, то обратите внимание на CanvasGadget().

Пример

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

См. также

GetGadgetState(), SetGadgetState(), ButtonImageGadget(), ImageID(), CanvasGadget()

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

Все

<- IPAddressGadget() - Оглавление Gadget - IsGadget()->

#Gadget	Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height	Позиция и размеры нового Гаджета. Гаджет корректирует свою ширину и высоту в соответствии с отображаемым изображением. Указанная ширина и высота используются только тогда, когда нет отображаемого изображения.
ImageID	Идентификатор изображения, которое требуется отобразить в данном Гаджете. Корректный идентификатор 'ImageID' можно получить с помощью функции ImageID(). Если этот параметр равен 0, изображение отображаться не будет.
Flags (дополн.)	Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '\|'): #PB_Image_Border: Отображать утопленную рамку вокруг изображения. #PB_Image_Raised: Отображать приподнятую рамку вокруг изображения.