mx.controls.sliderClassesSlider Класс Slider является базовым классом для элементов управления-ползунков Flex.The Slider class cannot be used as an MXML tag. Use the <mx:HSlider> and <mx:VSlider> tags instead. However, the Slider class does define tag attributes used by the <mx:HSlider> and <mx:VSlider> tags.

The Slider class inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:tagname
    Properties
    allowThumbOverlap="false|true"
    allowTrackClick="true|false"
    dataTipFormatFunction="undefined"
    direction="horizontal|vertical"
    labels="undefined"
    liveDragging="false|true"
    maximum="10"
    minimum="0"
    showDataTip="true|false"
    sliderDataTipClass="sliderDataTip"
    sliderThumbClass="SliderThumb"
    snapInterval="0"
    thumbCount="1"
    tickInterval="0"
    tickValues="undefined"
    value="The value of the minimum property."
 
    Styles
    borderColor="0x919999"
    dataTipOffset="16"
    dataTipPrecision="2"
    dataTipStyleName="undefined"
    fillAlphas="[0.6, 0.4, 0.75, 0.65]"
    fillColors="[0xFFFFFF, 0xCCCCCC, 0xFFFFFF, 0xEEEEEE;]"
    labelOffset="-10"
    labelStyleName="undefined"
    showTrackHighlight="false"
    slideDuration="300"
    slideEasingFunction="undefined"
    thumbDisabledSkin="SliderThumbSkin"
    thumbDownSkin="SliderThumbSkin"
    thumbOffset="0"
    thumbOverSkin="SliderThumbSkin"
    thumbUpSkin="SliderThumbSkin"
    tickColor="0x6F7777"
    tickLength="3"
    tickOffset="-6"
    tickThickness="1"
    trackColors="[ 0xEEEEEE, 0xFFFFFF ]"
    tracHighlightSkin="SliderHighlightSkin"
    trackMargin="undefined"
    trackSkin="SliderTrackSkin"
  
    Events
    change="No default"
    thumbDrag="No default"
    thumbPress="No default"
    thumbRelease="No default"
  />
  
]]>
mx.core:UIComponent Класс Slider является базовым классом для элементов управления-ползунков Flex. Элементы управления прокруткой позволяют пользователям выбирать значения путем перемещения ползунка между конечными точками полосы прокрутки. Текущее значение ползунка определяется относительным местоположением ползунка между конечными точками, соответствующими минимальному и максимальному значениям ползунка. Класс Slider подразделяется на подчиненные классы HSlider и VSlider. thumbRelease Отправляется при освобождении ползунка (когда пользователь отпускает кнопку мыши после выполнения события thumbPress).mx.events.SliderEvent.THUMB_RELEASEmx.events.SliderEvent Отправляется при освобождении ползунка (когда пользователь отпускает кнопку мыши после выполнения события thumbPress). thumbPress Отправляется при нажатии ползунка (когда пользователь нажимает кнопку мыши при наведении на ползунок).mx.events.SliderEvent.THUMB_PRESSmx.events.SliderEvent Отправляется при нажатии ползунка (когда пользователь нажимает кнопку мыши при наведении на ползунок). thumbDrag Вызывается при нажатии ползунка и его перемещении при помощи мыши.mx.events.SliderEvent.THUMB_DRAGmx.events.SliderEvent Вызывается при нажатии ползунка и его перемещении при помощи мыши. Этому событию всегда предшествует событие thumbPress. change Вызывается при изменении значения ползунка с использованием мыши или клавиатуры.mx.events.SliderEvent.CHANGEmx.events.SliderEvent Вызывается при изменении значения ползунка с использованием мыши или клавиатуры.

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

Slider Конструктор. Конструктор. getThumbAt Возвращает объект ползунка в указанном индексе.Ссылка на объект SliderThumb. mx.controls.sliderClasses:SliderThumbindexНомер индекса ползунка, отсчитываемый от нуля. Возвращает объект ползунка в указанном индексе. Этот метод применим для определения стиля и настройки отдельных ползунков в элементе управления прокруткой. measure Вычисляет размер пространства, занимаемый компонентом. Вычисляет размер пространства, занимаемый компонентом. Горизонтальный элемент управления прокруткой вычисляет высоту на основе позиций соответствующих меток, делений и ползунков относительно полосы прокрутки. Высота элемента управления определяется в результате вычитания значения позиции нижней части самого нижнего элемента из значения позиции верхней части самого верхнего элемента. Ширина горизонтального элемента управления прокруткой по умолчанию составляет 250 пикселей. Для вертикального элемента управления прокруткой измерения ширины и длины инвертируются. setThumbValueAt Этот метод позволяет определять значение ползунка и обновлять его отображение.indexНомер индекса ползунка, отсчитываемый от нуля, для определения его значения, где нулевое значение соответствует первому ползунку. valueЗначение, присваиваемое ползунку Этот метод позволяет определять значение ползунка и обновлять его отображение. updateDisplayList Позиционирует элементы управления.unscaledWidthУказывает ширину компонента в координатах компонента (в пикселях) вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в координатах компонента (в пикселях) вне зависимости от значения свойства scaleY компонента. Позиционирует элементы управления. Это метод позволяет устанавливать полосу прокрутки, ползунки, метки и деления, а также задавать их размер. Размер полосы прокрутки определяется на основе длины меток и полей полосы прокрутки. Если указано значение trackMargin, то размер полосы прокрутки определяется путем вычитания из значения доступной ширины значенияtrackMargin, умноженного на 2.

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

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

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

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

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

allowThumbOverlap Если установлено значение false, каждый ползунок может перемещаться только до границы смежного ползунка.falsefalse Если установлено значение false, каждый ползунок может перемещаться только до границы смежного ползунка. Если установлено значение true, каждый ползунок может перемещаться в любую позицию на полосе прокрутки. allowTrackClick Указывает, приводит ли щелчок по дорожке к перемещению ползунка.truetrue Указывает, приводит ли щелчок по дорожке к перемещению ползунка. liveDragging Определяет допустимость «живой» прокрутки для ползунка.falsefalse Определяет допустимость «живой» прокрутки для ползунка. Если задано значение false, Flex устанавливает свойства value и values и отправляет событие change в момент, когда пользователь прекращает выполнять «живую» прокрутку ползунка Если задано значение true, Flex устанавливает свойства value и values и непрерывно отправляет событие change, пока пользователь перемещает ползунок. showDataTip Если задано значение true, в процессе действий пользователя отображается всплывающая подсказка текущего значения, содержащая значение ползунка.truetrue Если задано значение true, в процессе действий пользователя отображается всплывающая подсказка текущего значения, содержащая значение ползунка. dataTipFormatFunction Функция обратного вызова, используемая для форматирования текста всплывающей подсказки текущего значения.undefined Функция обратного вызова, используемая для форматирования текста всплывающей подсказки текущего значения. Функция принимает одно число в качестве аргумента и возвращает отформатированную строку.

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

      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")); 
      }
      
direction Ориентация элемента управления-ползунка.SliderDirection.HORIZONTAL Ориентация элемента управления-ползунка. Допустимыми значениями в MXML являются horizontal или vertical.

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

Это свойство для элементов управления HSlider и VSlider устанавливается автоматически, поэтому при использовании этих элементов управления настройка данного свойства не требуется.
mx.controls.sliderClasses.SliderDirection
labels Массив строк, используемый для меток ползунка.undefined Массив строк, используемый для меток ползунка. Flex устанавливает метки в начале и в конце полосы прокрутки, а также через равные интервалы между ее началом и концом.

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

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

maximum Наибольшее допустимое значение для ползунка.10 Наибольшее допустимое значение для ползунка. minimum Наименьшее допустимое значение для ползунка.0 Наименьшее допустимое значение для ползунка. sliderDataTipClass Ссылка на класс, используемая для всплывающей подсказки текущего значения.SliderDataTip Ссылка на класс, используемая для всплывающей подсказки текущего значения. sliderThumbClass Ссылка на класс, используемая для каждого ползунка.SliderThumb Ссылка на класс, используемая для каждого ползунка. snapInterval Указывает значение приращения для ползунка при перемещении ползунка пользователем.0 Указывает значение приращения для ползунка при перемещении ползунка пользователем. Например, если snapInterval имеет значение 2, значение minimum равно 0, а значение maximum равно 10, ползунок перемещается между значениями 0, 2, 4, 6, 8 и 10. Нулевое значение соответствует непрерывному перемещению ползунка между значениями minimum и maximum. thumbCount Количество ползунков, допустимое для элемента управления-ползунка.1 Количество ползунков, допустимое для элемента управления-ползунка. Возможные значения: 1 или 2. Если задано значение 1, то свойство value содержит текущее значение ползунка. Если задано значение 2, то свойство values содержит массив значений, включающий значение для каждого ползунка. thumbStyleFilters Набор стилей для перехода от элемента управления-ползунка к ползункам. Набор стилей для перехода от элемента управления-ползунка к ползункам. mx.styles.StyleProxytickInterval Интервал между делениями относительно значения maximum элемента управления.0 Интервал между делениями относительно значения maximum элемента управления. Flex отображает деления, если для свойства tickInterval установлено значение, отличное от нуля.

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

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

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

value Это свойство содержит позицию ползунка и является числом в диапазоне между свойствами minimum и maximum. Это свойство содержит позицию ползунка и является числом в диапазоне между свойствами minimum и maximum. Если значение thumbCount равно 1, используется свойство value. Если значение thumbCount больше 1, используется свойство values. Значение по умолчанию равно значению свойства minimum. values Массив значений для каждого ползунка, если значение thumbCount больше 1. Массив значений для каждого ползунка, если значение thumbCount больше 1.
SliderDirection Класс SliderDirection определяет значения констант для свойства direction класса Slider.Object Класс SliderDirection определяет значения констант для свойства direction класса Slider. mx.controls.sliderClasses.SliderHORIZONTAL Определяет необходимость отображения горизонтального ползунка.horizontal Определяет необходимость отображения горизонтального ползунка. Эта константа используется элементом управления HSlider. VERTICAL Определяет необходимость отображения вертикального ползунка.vertical Определяет необходимость отображения вертикального ползунка. Эта константа используется элементом управления VSlider. SliderDataTip Класс SliderDataTip определяет всплывающую подсказку, используемую в элементе управления mx.controls.Slider.mx.controls:ToolTip Класс SliderDataTip определяет всплывающую подсказку, используемую в элементе управления mx.controls.Slider. Этот класс не добавляет дополнительные функциональные возможности в mx.controls.ToolTip. Он используется только для применения стиля селектора типа. mx.controls.HSlidermx.controls.VSlidermx.controls.sliderClasses.Slidermx.controls.sliderClasses.SliderLabelmx.controls.sliderClasses.SliderThumbSliderDataTip Конструктор. Конструктор. SliderLabel Класс SliderLabel определяет метку, используемую в компоненте mx.controls.Slider.mx.controls:Label Класс SliderLabel определяет метку, используемую в компоненте mx.controls.Slider. Этот класс не добавляет дополнительные функциональные возможности в mx.controls.Label. Он используется для применения стиля селектора типа. mx.controls.HSlidermx.controls.VSlidermx.controls.sliderClasses.Slidermx.controls.sliderClasses.SliderDataTipmx.controls.sliderClasses.SliderThumbSliderLabel Конструктор. Конструктор. SliderThumb Класс SliderThumb представляет ползунок элемента управления Slider.mx.controls:Button Класс SliderThumb представляет ползунок элемента управления Slider. Класс SliderThumb может использоваться только в пределах контекста элемента управления прокруткой. Можно создать подкласс класса SliderThumb и использовать его с элементом управления прокруткой путем настройки свойства sliderThumbClass элемента управления прокруткой для этого подкласса. mx.controls.HSlidermx.controls.VSlidermx.controls.sliderClasses.Slidermx.controls.sliderClasses.SliderDataTipmx.controls.sliderClasses.SliderLabelSliderThumb Конструктор. Конструктор. xPosition Указывает положение центра ползунка на оси X. Указывает положение центра ползунка на оси X.