PureBasic

SpinGadget()

Синтаксис

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

Описание


Создает Гаджет "Диск Значений" (Spin Gadget) в текущем списке Гаджетов (GadgetList).

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height Позиция и размеры нового Гаджета.
Minimum, Maximum Минимальные и максимальные значения, которые может принимать "Диск Значений".
Flags (дополн.) Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть комбинацией следующих значение (с помощью оператора '|'): 
  #PB_Spin_ReadOnly : SpinGadget будет не доступен для редактирования, число можно изменять только стрелками (Недоступно в Linux).
  #PB_Spin_Numeric  : SpinGadget будет автоматически обновлять текст от стрелок, функция SetGadgetText() для этого не нужна.

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

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

Комментарии

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

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

GetGadgetState(): Возвращает текущее выбранное значение этого Гаджета
SetGadgetState(): Изменяет текущее значение Гаджета. Для отображения нового значения Вы все равно должны использовать функцию SetGadgetText()!
GetGadgetText(): Возвращает содержащийся в Гаджете текст. Обычно это отображаемое в Гаджете значение.
SetGadgetText(): Изменяет содержащийся в Гаджете текст. Обычно это отображаемое в Гаджете значение.
GetGadgetAttribute(): С одним из следующих атрибутов: 
  #PB_Spin_Minimum   : Возвращает минимальное значение.
  #PB_Spin_Maximum   : Возвращает максимальное значение.
SetGadgetAttribute(): С одним из следующих атрибутов: 
  #PB_Spin_Minimum   : Изменяет минимальное значение.
  #PB_Spin_Maximum   : Изменяет максимальное значение.
Через EventType() поддерживаются следующие события: 
  #PB_EventType_Change: Текст в области редактирования был изменен пользователем.
  #PB_EventType_Up    : Нажата кнопка 'Вверх'.
  #PB_EventType_Down  : Нажата кнопка 'Вниз'.
Этот Гаджет поддерживает функции SetGadgetColor() и GetGadgetColor() со следующими значениями для параметра 'ColorType': 
  #PB_Gadget_FrontColor: Цвет текста
  #PB_Gadget_BackColor : Цвет фона

Пример

If OpenWindow(0, 0, 0, 200, 70, "Диск Значений", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    SpinGadget(0, 20, 20, 150, 25, 0, 1000)
    SetGadgetState(0, 5) : SetGadgetText(0, "5") ; задать начальное значение
    Repeat
        Event = WaitWindowEvent()
        If Event = #PB_Event_Gadget
            If EventGadget() = 0
                SetGadgetText(0, Str(GetGadgetState(0)))
            EndIf
        EndIf
    Until Event = #PB_Event_CloseWindow
EndIf


См. также

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

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

Все

<- ShortcutGadget() - Оглавление Gadget - SplitterGadget()->