PureBasic

ProgressBarGadget()

Синтаксис

Result = ProgressBarGadget(#Gadget , x , y , Width , Height , Minimum , Maximum [, Flags])

Описание


Создаёт Гаджет "Индикатор Прогресса" (Progress Bar) в текущем списке Гаджетов (GadgetList).

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height Позиция и размеры нового Гаджета.
Minimum, Maximum Минимальное и максимальное значения, которые может принимать индикатор прогресса. Значения должны быть между 0 и 65536 для совместимости со всеми ОС.
Flags (дополн.) Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'): 
  #PB_ProgressBar_Smooth   : Индикатор прогресса непрерывный, а не из прямоугольников
                             (Примечание: В Windows XP со включенными скинами этот флаг не действует).
  #PB_ProgressBar_Vertical : Индикатор прогресса в вертикальном режиме.

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

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

Комментарии

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

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

- SetGadgetState(): Изменяет значение индикатора прогресса. Можно использовать значение #PB_ProgressBar_Unknown, чтобы указать, что прогресс неизвестен.
- GetGadgetState(): Возвращает текущее значение индикатора прогресса.

- SetGadgetAttribute(): Со следующими атрибутами: 
  #PB_ProgressBar_Minimum   : Изменяет минимальное значение.
  #PB_ProgressBar_Maximum   : Изменяет максимальное значение.
- GetGadgetAttribute(): Со следующими атрибутами: 
  #PB_ProgressBar_Minimum   : Возвращает установленное минимальное значение.
  #PB_ProgressBar_Maximum   : Возвращает установленное максимальное значение.
Этот Гаджет поддерживает функции SetGadgetColor() и GetGadgetColor() со следующими значениями для параметра 'ColorType'. (Примечание: Только для Windows. В Windows XP со включенными скинами эти цвета не действуют.) 
  #PB_Gadget_FrontColor: Цвет индикатора прогресса
  #PB_Gadget_BackColor : Цвет фона

Пример

If OpenWindow(0, 0, 0, 370, 190, "Гаджет Индикатор Прогресса", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    TextGadget(3, 10, 10, 250, 20, "Индикатор Стандартный (50/100)", #PB_Text_Center)
    ProgressBarGadget(0, 10, 30, 250, 30, 0, 100)
    SetGadgetState(0, 50)  ;  установить 1-й индикатор прогресса (ID = 0) в 50 из 100
    TextGadget(4, 10, 70, 250, 20, "Индикатор Непрерывный (50/200)", #PB_Text_Center)
    ProgressBarGadget(1, 10, 90, 250, 30, 0, 200, #PB_ProgressBar_Smooth)
    SetGadgetState(1, 50)  ;  установить 2-й индикатор прогресса (ID = 1) в 50 из 200
    TextGadget(5, 100, 135, 250, 20, "Индикатор Вертикальный (100/300)", #PB_Text_Right)
    ProgressBarGadget(2, 290, 10, 30, 120, 0, 300, #PB_ProgressBar_Vertical)
    SetGadgetState(2, 100) ; установить 3-й индикатор прогресса (ID = 2) в 100 из 300
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
EndIf


См. также

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor()

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

Все

<- PanelGadget() - Оглавление Gadget - RemoveGadgetColumn()->