ScrollBarGadget3D

ScrollBarGadget3D()

Синтаксис

Result = ScrollBarGadget3D(#Gadget3D , x , y , Width , Height , Minimum , Maximum , PageLength [, Flags])

Описание

Создаёт 3D-Гаджет "Полоса Прокрутки" (Scroll Bar Gadget3D) в текущем списке 3D-Гаджетов (GadgetList3D).

Параметры

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

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

Minimum, Maximum Диапазон значений, которые может принять Полоса Прокрутки. Эти значения должны быть от 0 до 10000, чтобы избежать ограничений для некоторых операционных систем.

PageLength Размер отображаемой области, которая является частью полного изображения, её так же называют - 'Страница'

Например, у Вас может быть картинка шириной 100 пикселей, а видите вы только 25 пикселей. То, что вы видите, называется 'страница', в этом примере размер страницы будет 25, параметр Mininum будет 0, а параметр Maximum будет 100. Курсор прокрутки будет в 4 раза меньше, чем планка по которой он движется, так как его размер пропорционален (размер = Maximum / PageLength).
Flags (дополн.)
Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть следующим значением:
  #PB_ScrollBar3D_Vertical : Полоса прокрутки будет вертикальной (вместо горизонтальной, которая по умолчанию).

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

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

Комментарии

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

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

- GetGadgetState3D() : Возвращает текущую позицию Курсора прокрутки, это значение в диапазоне между 'Minimum' и 'Maximum - PageLength + 1'.
- SetGadgetState3D() : Изменяет текущую позицию Курсора прокрутки.
- GetGadgetAttribute3D() : с одним из следующих атрибутов:
#PB_ScrollBar3D_Minimum : Возвращает установленную минимальную позицию прокрутки. #PB_ScrollBar3D_Maximum : Возвращает установленную максимальную позицию прокрутки. #PB_ScrollBar3D_PageLength: Возвращает размер страницы (PageLength).
- SetGadgetAttribute3D(): с одним из следующих атрибутов:
#PB_ScrollBar3D_Minimum : Изменяет минимальную позицию прокрутки. #PB_ScrollBar3D_Maximum : Изменяет максимальную позицию прокрутки. #PB_ScrollBar3D_PageLength: Изменяет размер страницы (PageLength).

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

Все

<- ScrollAreaGadget3D() - Gadget3D Index - SetActiveGadget3D() ->

#Gadget3D	Номер для идентификации нового 3D-Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height	Позиция и размеры нового 3D-Гаджета.
Minimum, Maximum	Диапазон значений, которые может принять Полоса Прокрутки. Эти значения должны быть от 0 до 10000, чтобы избежать ограничений для некоторых операционных систем.
PageLength	Размер отображаемой области, которая является частью полного изображения, её так же называют - 'Страница' Например, у Вас может быть картинка шириной 100 пикселей, а видите вы только 25 пикселей. То, что вы видите, называется 'страница', в этом примере размер страницы будет 25, параметр Mininum будет 0, а параметр Maximum будет 100. Курсор прокрутки будет в 4 раза меньше, чем планка по которой он движется, так как его размер пропорционален (размер = Maximum / PageLength).
Flags (дополн.)	Флаги, позволяющие изменить поведение Гаджета. Этот параметр может быть следующим значением: #PB_ScrollBar3D_Vertical : Полоса прокрутки будет вертикальной (вместо горизонтальной, которая по умолчанию).