ScrollControlBase  - AS3 Flex

Объект границы.

Возвращает объект EdgeMetrics, имеющий четыре свойства: left, top, right и bottom. Значение каждого свойства равно толщине одной из сторон границы в пикселях.

Горизонтальная полоса прокрутки. Это свойство имеет значение null, если в настоящий момент не отображается горизонтальная полоса прокрутки. Доступ к этому свойству напрямую обычно не осуществляется. Изменение свойств horizontalScrollPolicy и horizontalScrollPosition позволяет полностью управлять полосой прокрутки.

Свойство, указывающее на то, что горизонтальная полоса прокрутки всегда включена, всегда отключена или изменяется автоматически в зависимости от параметров, переданных методу setScrollBarProperties(). Возможны следующие значения: ScrollPolicy.ON, ScrollPolicy.OFF и ScrollPolicy.AUTO. Значения MXML могут равняться on, off и auto.

Установка этого свойства в значение ScrollPolicy.OFF для подклассов ListBase не повлияет на свойство horizontalScrollPosition. Возможность прокрутки содержимого программным образом сохраняется.

Обратите внимание на то, что такая политика может повлиять на измеренный размер компонента. Если политика равна ScrollPolicy.AUTO, то полоса прокрутки не масштабируется в измеренном размере. Это позволяет предотвратить перерасчет макета при появлении полосы прокрутки. При предполагаемом наличии достаточного количества данных для полос прокрутки следует установить политику в значение ScrollPolicy.ON. Если количество данных неизвестно, следует установить явное значение для ширины или высоты компонента, чтобы отобразить полосы прокрутки позже.

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

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

Смещение от левой границы внутрь содержимого. Смещение измеряется в пикселях для некоторых подклассов или в других единицах (например, числом столбцов в элементе управления DataGrid или числом элементов в элементах управления HorizontalList или TileList).

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

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

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

Маска. Это свойство может быть не определено, если не отображается ни одной полосы прокрутки, а также в некоторых подклассах, которые имеют другой механизм маскирования. Маска определяла видимую область отображаемого объекта. Таким образом, эта маска используется для скрытия частей содержимого, которые не видимы в настоящее время. Доступ к этому свойству напрямую обычно не осуществляется. Изменение свойств horizontalScrollPolicy, verticalScrollPolicy, horizontalScrollPosition, и verticalScrollPosition обеспечивает достаточный контроль над маской.

Максимальное значение для свойства horizontalScrollPosition. Обратите внимание на то, что это не ширина содержимого, так как свойство maxHorizontalScrollPosition равно ширине содержимого за вычетом ширины отображаемой области.

В большинстве компонентов значение свойства maxHorizontalScrollPosition вычисляется на основе данных и размера компонента и не требует установки в коде приложения.

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

Максимальное значение для свойства verticalScrollPosition. Обратите внимание на то, что это не высота содержимого, так как свойство maxVerticalScrollPosition равно высоте содержимого за вычетом высоты отображаемой области.

Значение свойства maxVerticalScrollPosition вычисляется на основе данных и размера компонента и не требует установки в коде приложения.

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

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

Функция, вычисляющая строку, которая отображается в качестве элемента ScrollTip. Вызов этой функции осуществляется, если свойство showScrollTips имеет значение true при перетаскивании ползунка полосы прокрутки. Функция должна возвращать строку, использованную в качестве ScrollTip. Функции передается два параметра. Первым параметром является направление полосы прокрутки direction. Вторым параметром является позиция прокрутки scrollPosition, как показано в следующем примере:

      function scrollTipFunction(direction:String, position:Number):String 
      {
        if (direction == "vertical") return myToolTips[position];
        else return "";
      }

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

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

Вертикальная полоса прокрутки. Это свойство имеет значение null, если в настоящий момент вертикальная полоса прокрутки не отображается. Доступ к этому свойству напрямую обычно не осуществляется. Изменение свойств verticalScrollPolicy и verticalScrollPosition обеспечивает достаточный контроль над полосой прокрутки.

Свойство, указывающее на то, что вертикальная полоса прокрутки всегда включена, всегда отключена или меняется автоматически в зависимости от параметров, переданных методу setScrollBarProperties(). Возможны следующие значения: ScrollPolicy.ON, ScrollPolicy.OFF и ScrollPolicy.AUTO. Значения MXML могут равняться on, off и auto.

Установка этого свойства в значение ScrollPolicy.OFF для подклассов ListBase не влияет на свойство verticalScrollPosition. Возможность прокрутки содержимого программным образом сохраняется.

Обратите внимание на то, что такая политика может повлиять на измеренный размер компонента. Если политика равна ScrollPolicy.AUTO, то полоса прокрутки не масштабируется в измеренном размере. Это позволяет предотвратить перерасчет макета при появлении полосы прокрутки. При предполагаемом наличии достаточного количества данных для полос прокрутки следует установить политику в значение ScrollPolicy.ON. Если количество данных неизвестно, следует установить явное значение для ширины или высоты компонента, чтобы отобразить полосы прокрутки позже.

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

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

Смещение от верхней границы внутрь содержимого. Смещение измеряется в пикселях для некоторых подклассов или в других единицах (например, число строк в элементе управления List или число фрагментов в элементе управления TileList).

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

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

Объект EdgeMetrics, учитывающий полосы прокрутки (если они отображаются).

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

Создает границу для этого компонента. Как правило, граница определяется стилями borderStyle и borderSkin. Должен устанавливать свойство border для экземпляра границы.

Создает объекты, которые являются подчиненными для элемента ScrollControlBase – в этом случае границу и маску. Flex вызывает этот метод при первом создании ScrollControlBase. Если подкласс переопределяет этот метод, то он должен вызвать метод super.createChildren(), чтобы выполнить логику метода ScrollControlBase.createChildren().

Реагирует на изменения размеров, устанавливая позиции и размеры границ элемента управления

Метод ScrollControlBase.layoutChrome() устанавливает положение и размер границы ScrollControlBase. В каждом подклассе ScrollControlBase методlayoutChrome() подкласса должен выполнить вызов метода super.layoutChrome() для правильного установления границы.

Параметры

Обработчик событий для события прокрутки колеса мыши.

Параметры

Определяет наличие достаточного пространства в этом компоненте для отображения указанной полосы прокрутки.

Параметры

Обработчик события scroll по умолчанию.

Параметры

Вызывает отображение или скрытие полос прокрутки в ScrollControlBase в зависимости от переданных параметров. Если область TextArea может отобразить только 100 пикселей по горизонтали и 5 строк текста, но отображаемый текст имеет ширину в 200 пикселей и высоту в 30 строк, то метод setScrollBarProperties() вызывается в виде setScrollBarProperties(200, 100, 30, 5).

Параметры

Отправляется во время прокрутки содержимого.

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