Slider  - AS3 Flex

Если установлено значение false, каждый ползунок может перемещаться только до границы смежного ползунка. Если установлено значение true, каждый ползунок может перемещаться в любую позицию на полосе прокрутки.

Значением по умолчанию является false.

Указывает, приводит ли щелчок по дорожке к перемещению ползунка.

Значением по умолчанию является true.

Функция обратного вызова, используемая для форматирования текста всплывающей подсказки текущего значения. Функция принимает одно число в качестве аргумента и возвращает отформатированную строку.

Функция имеет следующую подпись:

      funcName(value:Number):String
      

В следующем примере к тексту всплывающей подсказки текущего значения добавляется символ доллара, а затем текст форматируется с использованием свойства dataTipPrecision элемента управления прокруткой с именем slide:

      import mx.formatters.NumberBase;
      function myDataTipFormatter(value:Number):String { 
          var dataFormatter:NumberBase = new NumberBase(".", ",", ".", ""); 
          return   "$ " + dataFormatter.formatPrecision(String(value), slide.getStyle("dataTipPrecision")); 
      }
      

Значением по умолчанию является undefined.

Ориентация элемента управления-ползунка. Допустимыми значениями в MXML являются horizontal или vertical.

В ActionScript для установки значений этого свойства используются следующие константы: SliderDirection.VERTICAL и SliderDirection.HORIZONTAL.

Значением по умолчанию является SliderDirection.HORIZONTAL.

Связанные элементы API

Массив строк, используемый для меток ползунка. Flex устанавливает метки в начале и в конце полосы прокрутки, а также через равные интервалы между ее началом и концом.

Например, если массив содержит три элемента, первый элемент устанавливается в начале, второй элемент – в середине, а последний элемент – в конце полосы прокрутки.

Если указана единственная метка, она устанавливается в начале полосы прокрутки. По умолчанию метки размещаются над делениями (при их наличии) или над полосой прокрутки. Для выравнивания меток относительно делений следует убедиться, что количество делений совпадает с количеством меток.

Значением по умолчанию является undefined.

Определяет допустимость «живой» прокрутки для ползунка. Если задано значение false, Flex устанавливает свойства value и values и отправляет событие change в момент, когда пользователь прекращает выполнять «живую» прокрутку ползунка Если задано значение true, Flex устанавливает свойства value и values и непрерывно отправляет событие change, пока пользователь перемещает ползунок.

Значением по умолчанию является false.

Наибольшее допустимое значение для ползунка.

Значением по умолчанию является 10.

Наименьшее допустимое значение для ползунка.

Значением по умолчанию является 0.

Если задано значение true, в процессе действий пользователя отображается всплывающая подсказка текущего значения, содержащая значение ползунка.

Значением по умолчанию является true.

Ссылка на класс, используемая для всплывающей подсказки текущего значения.

Значением по умолчанию является SliderDataTip.

Ссылка на класс, используемая для каждого ползунка.

Значением по умолчанию является SliderThumb.

Указывает значение приращения для ползунка при перемещении ползунка пользователем. Например, если snapInterval имеет значение 2, значение minimum равно 0, а значение maximum равно 10, ползунок перемещается между значениями 0, 2, 4, 6, 8 и 10. Нулевое значение соответствует непрерывному перемещению ползунка между значениями minimum и maximum.

Значением по умолчанию является 0.

Количество ползунков, допустимое для элемента управления-ползунка. Возможные значения: 1 или 2. Если задано значение 1, то свойство value содержит текущее значение ползунка. Если задано значение 2, то свойство values содержит массив значений, включающий значение для каждого ползунка.

Значением по умолчанию является 1.

Набор стилей для перехода от элемента управления-ползунка к ползункам.

Связанные элементы API

Интервал между делениями относительно значения maximum элемента управления. Flex отображает деления, если для свойства tickInterval установлено значение, отличное от нуля.

Например, если tickInterval равно 1, и значение maximum равно 10, то деления размещаются вдоль ползунка с интервалом 1/10. При нулевом значении деления на ползунке не отображаются. Если в качестве значения свойства tickValues установлен непустой массив, это свойство игнорируется.

Значением по умолчанию является 0.

Позиции делений на ползунке. Эти позиции соответствуют значениям на ползунке и находятся между значениями minimum и maximum. Например, если свойство tickValues имеет набор значений [0, 2.5, 7.5, 10], и maximum равно 10, деления размещаются вдоль ползунка в следующих позициях: начало ползунка, 1/4 расстояния слева направо, 3/4 расстояния слева направо и конец ползунка.

Если в качестве значения этого свойства установлен непустой массив, то свойство tickInterval игнорируется.

Значением по умолчанию является undefined.

Это свойство содержит позицию ползунка и является числом в диапазоне между свойствами minimum и maximum. Если значение thumbCount равно 1, используется свойство value. Если значение thumbCount больше 1, используется свойство values. Значение по умолчанию равно значению свойства minimum.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие valueCommit .

Массив значений для каждого ползунка, если значение thumbCount больше 1.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Конструктор.

Возвращает объект ползунка в указанном индексе. Этот метод применим для определения стиля и настройки отдельных ползунков в элементе управления прокруткой.

Параметры

Вычисляет размер пространства, занимаемый компонентом. Горизонтальный элемент управления прокруткой вычисляет высоту на основе позиций соответствующих меток, делений и ползунков относительно полосы прокрутки. Высота элемента управления определяется в результате вычитания значения позиции нижней части самого нижнего элемента из значения позиции верхней части самого верхнего элемента. Ширина горизонтального элемента управления прокруткой по умолчанию составляет 250 пикселей. Для вертикального элемента управления прокруткой измерения ширины и длины инвертируются.

Этот метод позволяет определять значение ползунка и обновлять его отображение.

Параметры

Позиционирует элементы управления. Этот метод позволяет устанавливать полосу прокрутки, ползунки, метки и деления, а также задавать их размер. Размер полосы прокрутки определяется на основе длины меток и полей полосы прокрутки. Если указано значение trackMargin, то размер полосы прокрутки определяется путем вычитания из значения доступной ширины значенияtrackMargin, умноженного на 2.

Деления располагаются вдоль полосы прокрутки через равные промежутки с начала полосы прокрутки. Дополнительное деление помещается в конце полосы прокрутки в том случае, если оно еще не существует (если интервал деления не является фактором максимального значения). Координата деления по оси Y зависит от значения tickOffset. При нулевом смещении нижняя часть деления располагается в верхней части полосы прокрутки. Отрицательные смещения используются для перемещения делений вверх, в то время как положительные смещения – для перемещения делений вниз относительно полосы прокрутки.

Метки устанавливаются вдоль полосы прокрутки через равные промежутки. Если значение trackMargin не является слишком маленьким, метки всегда располагаются точно по центру над соответствующими интервалами. Если указано значение trackMargin, то положение первой и последней меток совпадает с левой и правой границей элемента управления соответственно. При наложении метки не отсекаются и не изменяют свои размеры, поэтому следует убедиться в том, что на полосе прокрутки имеется необходимое для их размещения пространство. Координата по оси Y определяется на основе значения свойства labelOffset. При нулевом смещении нижняя часть метки располагается в верхней части полосы прокрутки. В отличие от делений, метки не могут размещаться с наложением на полосу прокрутки. Если смещение является положительным числом, то верхняя часть метки размещается под нижней частью полосы прокрутки.

Ползунки размещаются с наложением на полосу прокрутки. Положение ползунков на оси Х определяется их значением. Положение на оси Y зависит от значения свойства thumbOffset. При нулевом смещении центр ползунка размещается точно в центре полосы прокрутки. При отрицательном смещении ползунки перемещаются вверх, а при положительном смещении – вниз.

Размещение делений, меток и ползунков является взаимно независимым. В случае их наложения повторные попытки размещения не осуществляются.

В отношении вертикального элемента управления прокруткой применяются те же самые правила. В приведенном выше описании следует заменить высоту шириной, ширину – высотой, левую позицию – верхней, правую часть – нижней частью, координату по оси Х – координатой по оси Y и координату по оси Y – координатой по оси Х.

Параметры

Вызывается при изменении значения ползунка с использованием мыши или клавиатуры.

Если свойство liveDragging имеет значение true, событие отправляется непрерывно, поскольку пользователь перемещает ползунок. Если liveDragging имеет значение false, событие отправляется, когда пользователь освобождает ползунок.

Свойства объекта события имеют следующие значения:

Вызывается при нажатии ползунка и его перемещении при помощи мыши. Этому событию всегда предшествует событие thumbPress.

Свойства объекта события имеют следующие значения:

Отправляется при нажатии ползунка (когда пользователь нажимает кнопку мыши при наведении на ползунок).

Свойства объекта события имеют следующие значения:

Отправляется при освобождении ползунка (когда пользователь отпускает кнопку мыши после выполнения события thumbPress).

Свойства объекта события имеют следующие значения: