| Пакет | spark.layouts.supportClasses |
| Класс | public class LayoutBase |
| Наследование | LayoutBase  OnDemandEventDispatcher Object |
| Подклассы | BasicLayout, ButtonBarHorizontalLayout, ConstraintLayout, HorizontalLayout, MosaicLayoutBase, TabbedViewNavigatorTabBarHorizontalLayout, TileLayout, VerticalLayout, ViewMenuLayout |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
LayoutBase или один из его подклассов.
Как минимум, подклассы должны обеспечивать реализацию метода updateDisplayList(), обеспечивающего позиционирование и изменение размеров target элементов GroupBase, а также метода measure(), вычисляющего размер target по умолчанию.
Подклассы могут переопределять такие методы, как getElementBoundsAboveScrollRect() и getElementBoundsBelowScrollRect() для настройки поведения целевого объекта при подключении к полосам прокрутки.
Подклассы, поддерживающие виртуализацию, должны учитывать свойство useVirtualLayout и извлекать только элементы макета в scrollRect (значение getScrollRect()) с использованием getVirtualElementAt() из updateDisplayList().
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:LayoutBase> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:LayoutBase
Properties
clipAndEnableScrolling="false"
dropIndicator="defined by the skin class"
horizontalScrollPosition="0"
target="null"
typicalLayoutElement="null"
useVirtualLayout="false"
verticalScrollPosition="0"
/>
| Свойство | Определено | ||
|---|---|---|---|
| clipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра. | LayoutBase | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| dropIndicator : DisplayObject
DisplayObject, который этот макет использует для индикатора перетаскивания во время операции перетаскивания. | LayoutBase | ||
| horizontalScrollPosition : Number
Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase | ||
| target : GroupBase
Контейнер GroupBase, элементы которого измеряются, получают размер и располагаются с использованием этого макета. | LayoutBase | ||
| typicalLayoutElement : ILayoutElement
Используется макетами в тех случаях, когда необходимы фиксированные размеры строк/столбцов, но при этом определенные размеры не указаны. | LayoutBase | ||
| useVirtualLayout : Boolean
В контейнере может находиться любое число нижестоящих элементов. | LayoutBase | ||
| verticalScrollPosition : Number
Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | LayoutBase | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | OnDemandEventDispatcher | |
Вычисляет местоположение перетаскивания в поставщике данных целевого объекта перетаскивания для указанного dragEvent. | LayoutBase | ||
Если useVirtualLayout имеет значение true, этот метод может использоваться целевым объектом макета для очистки кэшированной информации о макете в случае изменения целевого объекта. | LayoutBase | ||
|
Посылает событие в поток событий. | OnDemandEventDispatcher | |
Вызывается целевым объектом после добавления элемента макета и до того, как размер целевого объекта и список отображения будут проверены. | LayoutBase | ||
Этот метод должен вызываться целевым объектом после удаления элемента макета и до того, как размер целевого объекта и список отображения будут проверены. | LayoutBase | ||
Возвращает границы макета указанного элемента в виде элемента Rectangle или значения null, если индекс недействителен, соответствующий элемент имеет значение null, includeInLayout=false или значением свойства target этого макета является null. | LayoutBase | ||
Возвращает изменение горизонтального положения прокрутки для работы с различными параметрами прокрутки. | LayoutBase | ||
getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
Метод делегирования, определяющий, к какому элементу необходимо перейти на основе текущего элемента в фокусе и данных, вводимых пользователем в виде константы NavigationUnit. | LayoutBase | ||
Вычисляет дельты verticalScrollPosition и horizontalScrollPosition, необходимые для прокрутки элемента под заданным индексом в видимую область. | LayoutBase | ||
Возвращает изменение вертикального положения прокрутки для работы с различными параметрами прокрутки. | LayoutBase | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | OnDemandEventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
Скрывает показанный ранее индикатор перетаскивания, созданный методом showDropIndicator(), удаляет его из списка отображения и также останавливает прокрутку перетаскивания. | LayoutBase | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Обеспечивает измерение размера целевого объекта по умолчанию на основе его содержимого и дополнительно измеряет минимальный размер целевого объекта по умолчанию. | LayoutBase | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | OnDemandEventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
Размеры, положение и вышестоящие объекты индикатора перетаскивания, основанные на указанном местоположении перетаскивания. | LayoutBase | ||
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
Размеры и местоположения элементов целевого объекта. | LayoutBase | ||
Вызывается целевым объектом в конце updateDisplayList для обновления scrollRect макета. | LayoutBase | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | OnDemandEventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
Вычисляет значение прокрутки для указанного dropLocation во время операции перетаскивания. | LayoutBase | ||
Возвращает индекс, указывающий на то, где должен быть вставлен новый элемент, когда пользователь отпускает кнопку мыши в указанных координатах при завершении операции перетаскивания. | LayoutBase | ||
Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания. | LayoutBase | ||
Возвращает границы первого элемента макета, охватывающего верхний край scrollRect или находящегося над ним. | LayoutBase | ||
Возвращает границы первого элемента макета, охватывающего нижний край scrollRect или находящегося ниже края. | LayoutBase | ||
Возвращает границы первого элемента макета, охватывающего левый край scrollRect или находящегося слева от него. | LayoutBase | ||
Возвращает границы первого элемента макета, охватывающего правый край scrollRect или находящегося справа от нее. | LayoutBase | ||
Возвращает границы прямоугольника прокрутки целевого объекта в координатах макета. | LayoutBase | ||
Вызывается при изменении свойств verticalScrollPosition или horizontalScrollPosition. | LayoutBase | ||
clipAndEnableScrolling | свойство |
clipAndEnableScrolling:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра. В случае значения false нижестоящие элементы контейнера могут выходить за границы контейнера независимо от указанного размера компонента.
Значением по умолчанию является false.
Реализация
public function get clipAndEnableScrolling():Boolean public function set clipAndEnableScrolling(value:Boolean):voiddropIndicator | свойство |
dropIndicator:DisplayObject| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
DisplayObject, который этот макет использует для индикатора перетаскивания во время операции перетаскивания. Как правило, это свойство не устанавливается напрямую, вместо этого определяется элемент темы оформления dropIndicator в классе темы оформления объекта перетаскивания.
Элемент управления List назначает это свойство в ответ на событие DragEvent.DRAG_ENTER. List инициализирует это свойство с помощью экземпляра его компонента темы оформления dropIndicator. List устанавливает это свойство в ответ на событие DragEvent.DRAG_EXIT.
Реализация
public function get dropIndicator():DisplayObject public function set dropIndicator(value:DisplayObject):voidhorizontalScrollPosition | свойство |
horizontalScrollPosition:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. Если clipAndEnableScrolling имеет значение true, установка этого свойства, как правило, приводит к следующей настройке области просмотра:
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)
Реализации этого свойства должны обладать свойством Bindable и генерировать события типа propertyChange.
Значением по умолчанию является 0.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .
Реализация
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidtarget | свойство |
target:GroupBase| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Контейнер GroupBase, элементы которого измеряются, получают размер и располагаются с использованием этого макета.
Подклассы могут обеспечить повторное определение этого установщика для выполнения операций, специфичных для целевого объекта. Например, трехмерным макетом здесь может быть установлено свойство maintainProjectionCenter целевого объекта.
Значением по умолчанию является null.
Реализация
public function get target():GroupBase public function set target(value:GroupBase):voidСвязанные элементы API
typicalLayoutElement | свойство |
typicalLayoutElement:ILayoutElement| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Используется макетами в тех случаях, когда необходимы фиксированные размеры строк/столбцов, но при этом определенные размеры не указаны. Используется виртуальными макетами для оценки размера элементов макета, которые не были прокручены с переводом в видимую область.
Это свойство ссылается на компонент, который Flex использует для определения высоты всех нижестоящих элементов контейнера, как показано в следующем примере:
<s:Group>
<s:layout>
<s:VerticalLayout variableRowHeight="false"
typicalLayoutElement="{b3}"/>
</s:layout>
<s:Button id="b1" label="Button 1"/>
<s:Button id="b2" label="Button 2"/>
<s:Button id="b3" label="Button 3" fontSize="36"/>
<s:Button id="b4" label="Button 4" fontSize="24"/>
</s:Group>
Если это свойство не было установлено и целевому объекту не соответствует значение null, кэшируется и возвращается первый элемент макета.
Значением по умолчанию является первый элемент макета целевого объекта.
Значением по умолчанию является null.
Реализация
public function get typicalLayoutElement():ILayoutElement public function set typicalLayoutElement(value:ILayoutElement):voidСвязанные элементы API
useVirtualLayout | свойство |
useVirtualLayout:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
В контейнере может находиться любое число нижестоящих элементов. Однако каждому нижестоящему элементу требуется экземпляр средства визуализации. Если контейнер содержит много нижестоящих элементов, возможно уменьшение производительности при последующем добавлении дополнительных нижестоящих элементов в контейнер.
Вместо создания средства визуализации для каждого нижестоящего элемента можно настроить контейнер для использования виртуального макета. При работе с виртуальным макетом контейнер повторно использует средства визуализации элементов, создавая, таким образом, средства визуализации только для текущих нижестоящих элементов контейнера. Когда нижестоящий элемент перемещается за пределы экрана, например при прокрутке контейнера, его средство визуализации может использоваться новым нижестоящим элементом, который появляется на экране при прокрутке.
Для настройки контейнера с целью использования виртуального макета необходимо установить свойство useVirtualLayout на значение true для макета, ассоциированного с данным контейнером. Виртуальный макет поддерживается только DataGroup или SkinnableDataContainer с макетом, для которого установлено значение VerticalLayout, HorizontalLayout или TileLayout. Не поддерживающие виртуализацию подклассы макета должны предотвращать изменение этого свойства.
Примечание: Класс BasicLayout создает ошибку во время выполнения программы, если Вы устанавливаете useVirtualLayout к true.
При значении true поддерживающие виртуализацию макеты должны использовать метод target.getVirtualElementAt(), а не getElementAt(), а также должны получать только элементы, ожидаемые ими, которые будут видимы при выдаче значения getScrollRect().
При значении true, класс Layout должен обеспечивать вычисление индексов элементов макета, которые перекрывают scrollRect в его методе updateDisplayList(), основанного исключительно на кэшируемой информации, а не путем получения элементов макета и определения их границ.
Как правило, виртуальные макеты обновляют кэшируемую информацию через метод updateDisplayList()на основе размеров и местоположений, вычисленных для элементов в представлении.
Подобным образом, в методе measure() виртуальные макеты должны не измерять элементы, а обновить свойства измеренного размера целевого объекта, основанные на typicalLayoutElement и другой кэшируемой информации макета.
Контейнеры обмениваются данными с макетами, имеющими useVirtualLayout = true, путем повторного использования средств визуализации элементов, которые были созданы ранее, но более не используются. Элемент считается неиспользуемым, если его индекс находится вне диапазона индексов getVirtualElementAt() запрашиваемых в процессе самого последнего вызова updateDisplayList() контейнера.
Значением по умолчанию является false.
Реализация
public function get useVirtualLayout():Boolean public function set useVirtualLayout(value:Boolean):voidСвязанные элементы API
verticalScrollPosition | свойство |
verticalScrollPosition:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. Если clipAndEnableScrolling имеет значение true, установка этого свойства, как правило, приводит к следующей настройке области просмотра:
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)
Реализации этого свойства должны обладать свойством Bindable и генерировать события типа propertyChange.
Значением по умолчанию является 0.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .
Реализация
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidLayoutBase | () | Конструктор |
public function LayoutBase()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
calculateDragScrollDelta | () | метод |
protected function calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вычисляет значение прокрутки для указанного dropLocation во время операции перетаскивания. Вызывается методом showDropIndicator() для вычисления прокрутки во время прокрутки перетаскивания.
Параметры
dropLocation:DropLocation — Допустимый объект DropLocation, ранее полученный при вызове метода calculateDropLocation().
| |
elapsedTime:Number — Продолжительность в миллисекундах с начала прокрутки перетаскивания.
|
Point — Значение для прокрутки при перетаскивании или значение null, если прокрутка при перетаскивании не требуется.
|
Связанные элементы API
calculateDropIndex | () | метод |
protected function calculateDropIndex(x:Number, y:Number):int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает индекс, указывающий на то, где должен быть вставлен новый элемент, когда пользователь отпускает кнопку мыши в указанных координатах при завершении операции перетаскивания. Вызывается методом calculatedDropLocation().
Параметры
x:Number — Координата x операции перетаскивания в локальных координатах.
| |
y:Number — Координата y операции перетаскивания в локальных координатах целевого объекта перетаскивания.
|
int — Индекс перетаскивания или -1, если операция перетаскивания не доступна для указанных координат.
|
Связанные элементы API
calculateDropIndicatorBounds | () | метод |
protected function calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания. Вызывается методом showDropIndicator().
Параметры
dropLocation:DropLocation — Допустимый объект DropLocation, ранее возвращенный методом calculateDropLocation().
|
Rectangle — Границы для индикатора перетаскивания или значение null.
|
Связанные элементы API
calculateDropLocation | () | метод |
public function calculateDropLocation(dragEvent:DragEvent):DropLocation| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вычисляет местоположение перетаскивания в поставщике данных целевого объекта перетаскивания для указанного dragEvent.
Параметры
dragEvent:DragEvent — Событие перетаскивания, отправленное DragManager.
|
DropLocation — Возвращает местоположение перетаскивания для этого события или значение null, если операция перетаскивания недоступна.
|
Связанные элементы API
clearVirtualLayoutCache | () | метод |
public function clearVirtualLayoutCache():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Если useVirtualLayout имеет значение true, этот метод может использоваться целевым объектом макета для очистки кэшированной информации о макете в случае изменения целевого объекта.
Например, при изменении свойств dataProvider или itemRenderer DataGroup кэшированные размеры элементов станут недействительными.
При изменении значения свойства useVirtualLayout на false этот метод вызывается автоматически.
Подклассы, поддерживающие useVirtualLayout = true, должны перезаписывать этот метод.
elementAdded | () | метод |
public function elementAdded(index:int):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вызывается целевым объектом после добавления элемента макета и до того, как размер целевого объекта и список отображения будут проверены. Макеты, кэширующие состояние для каждого элемента, такие как виртуальные макеты, могут переопределить этот метод для обновления собственного кэша.
При вызове метода целевым объектом гарантируется только то, что элемент макета будет существовать в указанной позиции индекса в момент выполнения updateDisplayList(). Так, например, элемент DataGroup с виртуальным макетом обеспечит вызов этого метода после добавления элемента к dataProvider целевого объекта.
По умолчанию данный метод не выполняет никаких действий.
Параметры
index:int — Индекс добавленного элемента.
|
Связанные элементы API
elementRemoved | () | метод |
public function elementRemoved(index:int):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Этот метод должен вызываться целевым объектом после удаления элемента макета и до того, как размер целевого объекта и список отображения будут проверены. Макеты, кэширующие состояние для каждого элемента, такие как виртуальные макеты, могут переопределить этот метод для обновления собственного кэша.
При вызове метода целевым объектом гарантируется только то, что элемент макета не будет существовать в указанной позиции индекса в момент выполнения updateDisplayList(). Например, DataGroup с виртуальным макетом вызывает этот метод, когда элемент добавляется к свойству dataProvider.
По умолчанию данный метод не выполняет никаких действий.
Параметры
index:int — Индекс добавленного элемента.
|
Связанные элементы API
getElementBounds | () | метод |
public function getElementBounds(index:int):Rectangle| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает границы макета указанного элемента в виде элемента Rectangle или значения null, если индекс недействителен, соответствующий элемент имеет значение null, includeInLayout=false или значением свойства target этого макета является null.
Подклассы макета, поддерживающие соотношение useVirtualLayout=true, должны обеспечить переопределение этого метода для вычисления возможного приблизительного значения элементов, отсутствующих в области отображения.
Параметры
index:int — Индекс элемента макета.
|
Rectangle — Границы макета указанного элемента.
|
Связанные элементы API
getElementBoundsAboveScrollRect | () | метод |
protected function getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает границы первого элемента макета, охватывающего верхний край scrollRect или находящегося над ним.
Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta()по умолчанию. Подклассы, зависящие от реализации getVerticalScrollPositionDelta() по умолчанию, должны обеспечить изменение этого метода для предоставления точного ограничивающего прямоугольника, имеющего допустимые значения свойств top и bottom .
По умолчанию этот метод возвращает Rectangle со значениями width=0, height=1, верхний край которого меньше верхнего края scrollRect, и left=0.
Подклассы должны обеспечить переопределение этого метода для предоставления точного ограничивающего прямоугольника, имеющего допустимые значения свойств top и bottom.
Параметры
scrollRect:Rectangle — ScrollRect целевого объекта.
|
Rectangle — Границы первого элемента, который охватывает верхний край scrollRect или находится над ним.
|
Связанные элементы API
getElementBoundsBelowScrollRect | () | метод |
protected function getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает границы первого элемента макета, охватывающего нижний край scrollRect или находящегося ниже края.
Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta()по умолчанию. Подклассы, зависящие от реализации getVerticalScrollPositionDelta() по умолчанию, должны обеспечить изменение этого метода для предоставления точного ограничивающего прямоугольника, имеющего допустимые значения свойств top и bottom .
По умолчанию этот метод возвращает Rectangle со значениями width=0, height=1, нижний край которого больше нижнего края scrollRect, и left=0.
Параметры
scrollRect:Rectangle — ScrollRect целевого объекта.
|
Rectangle — Границы первого элемента, который охватывает нижний край scrollRect или находится под ним.
|
Связанные элементы API
getElementBoundsLeftOfScrollRect | () | метод |
protected function getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает границы первого элемента макета, охватывающего левый край scrollRect или находящегося слева от него.
Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta() по умолчанию. Подклассы, зависящие от реализации getHorizontalScrollPositionDelta() по умолчанию должны обеспечить изменение этого метода для предоставления точной ограничивающего прямоугольника, имеющего допустимые свойства left и right.
По умолчанию этот метод возвращает Rectangle со значениями width=1, height=0, левый край которого меньше левого края scrollRect, и top=0.
Параметры
scrollRect:Rectangle — ScrollRect целевого объекта.
|
Rectangle — Границы первого элемента, который охватывает левый край scrollRect или находится слева от него.
|
Связанные элементы API
getElementBoundsRightOfScrollRect | () | метод |
protected function getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает границы первого элемента макета, охватывающего правый край scrollRect или находящегося справа от нее.
Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta() по умолчанию. Подклассы, зависящие от реализации getHorizontalScrollPositionDelta() по умолчанию должны обеспечить изменение этого метода для предоставления точной ограничивающего прямоугольника, имеющего допустимые свойства left и right.
По умолчанию этот метод возвращает Rectangle со значениями width=1, height=0, правый край которого больше правого края scrollRect, и top=0.
Параметры
scrollRect:Rectangle — ScrollRect целевого объекта.
|
Rectangle — Границы первого элемента, который охватывает правый край scrollRect или находится справа от него.
|
Связанные элементы API
getHorizontalScrollPositionDelta | () | метод |
public function getHorizontalScrollPositionDelta(navigationUnit:uint):Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает изменение горизонтального положения прокрутки для работы с различными параметрами прокрутки. Эти параметры определяются классом NavigationUnit: END, HOME, LEFT, PAGE_LEFT, PAGE_RIGHT и RIGHT.
Параметры
navigationUnit:uint — Принимает следующие значения:
Реализация вызывает методы |
Number — Изменение горизонтального положения прокрутки.
|
Связанные элементы API
getNavigationDestinationIndex | () | метод |
public function getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Метод делегирования, определяющий, к какому элементу необходимо перейти на основе текущего элемента в фокусе и данных, вводимых пользователем в виде константы NavigationUnit. Этот метод используется подклассами ListBase для обработки навигации с помощью клавиатуры. ListBase обеспечивает сопоставление данных, введенных пользователем, с константами NavigationUnit.
Подклассы позволяют изменить этот метод для вычисления других значений на основе текущего индекса и выявленных нажатий клавиш.
Параметры
currentIndex:int — Текущий индекс элемента, находящегося в фокусе.
| |
navigationUnit:uint — Константа NavigationUnit, определяющая следующий элемент, к которому необходимо перейти.
| |
arrowKeysWrapFocus:Boolean — Если значение true, навигация с помощью клавиш стрелок внутри компонента приведет к переносу при достижении любого из концов.
|
int — Индекс следующего элемента, к которому необходимо перейти. Возвращает -1, если константа navigationUnit не распознается макетом.
|
getScrollPositionDeltaToElement | () | метод |
public function getScrollPositionDeltaToElement(index:int):Point| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вычисляет дельты verticalScrollPosition и horizontalScrollPosition, необходимые для прокрутки элемента под заданным индексом в видимую область.
Этот метод обеспечивает попытку минимизации изменений verticalScrollPosition и horizontalScrollPosition.
Если clipAndEnableScrolling имеет значение true и элемент в указанной позиции индекса не полностью видим относительно прямоугольника прокрутки целевого объекта, необходимо вернуть значение дельты, которое должно быть добавлено к свойствам horizontalScrollPosition и verticalScrollPosition обеспечивающим полную прокрутку элемента в пределах границ прямоугольника прокрутки.
Параметры
index:int — Индекс элемента, который должен быть прокручен с переводом в видимую область.
|
Point — Объект Point, содержащий смещения для horizontalScrollPosition и verticalScrollPosition, обеспечивающие прокрутку определенного элемента с его переводом в видимую область, или значение null, если изменения не требуются. Если указанный элемент является частично видимым и больше прямоугольника прокрутки, и при этом он уже является единственным видимым элементом, возвращается значение null. Если указанный индекс недействителен или целевому объекту соответствует значение null, возвращается значение null. Если элемент в указанном индексе имеет значение null или значением свойства includeInLayout является false, возвращается null.
|
Связанные элементы API
getScrollRect | () | метод |
protected function getScrollRect():Rectangle| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает границы прямоугольника прокрутки целевого объекта в координатах макета. Методы макета не должны обеспечивать непосредственное получение прямоугольника прокрутки целевого объекта.
ВозвращаетRectangle — Границы scrollRect целевого объекта в координатах макета; null, если целевому объекту или clipAndEnableScrolling соответствует значение false.
|
getVerticalScrollPositionDelta | () | метод |
public function getVerticalScrollPositionDelta(navigationUnit:uint):Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает изменение вертикального положения прокрутки для работы с различными параметрами прокрутки. Эти параметры определяются классом NavigationUnit: DOWN, END, HOME, PAGE_DOWN, PAGE_UP и UP.
Параметры
navigationUnit:uint — Принимает следующие значения:
PAGE_UPРеализация вызывает методы |
Number — Изменение вертикального положения прокрутки.
|
Связанные элементы API
hideDropIndicator | () | метод |
public function hideDropIndicator():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Скрывает показанный ранее индикатор перетаскивания, созданный методом showDropIndicator(), удаляет его из списка отображения и также останавливает прокрутку перетаскивания.
Связанные элементы API
measure | () | метод |
public function measure():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Обеспечивает измерение размера целевого объекта по умолчанию на основе его содержимого и дополнительно измеряет минимальный размер целевого объекта по умолчанию.
Это один из тех методов, которые должны быть переопределены при создании подкласса LayoutBase. Другим методом является updateDisplayList(). Вызов этих методов напрямую не требуется. Этот метод вызывается в среде Flex при передаче макета. Передача макета включает в себя три этапа.
Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода commitProperties для целевого объекта.
Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода validateSize() для целевого объекта. Метод целевого объекта validateSize() в свою очередь вызовет метод макета measure() для вычисления размера целевого объекта по умолчанию, если он не был явным образом задан с помощью свойств explicitWidth и explicitHeight целевого объекта. При изменении размера по умолчанию список отображения целевого объекта в среде Flex будет признан недействительным.
На последнем этапе, если список отображения целевого объекта является недействительным, LayoutManager обеспечит вызов метода validateDisplayList для целевого объекта. Метод validateDisplayList, в свою очередь, вызовет метод макета updateDisplayList для изменения размера и позиционирования элементов целевого объекта.
При реализации данного метода необходимо установить свойства measuredWidth и measuredHeight для определения размера целевого объекта по умолчанию. Свойства measuredMinWidth и measuredMinHeight можно дополнительно настроить для определения минимального размера по умолчанию. Типичная реализация обеспечивает итерации для элементов целевого объекта и использование методов, определенных ILayoutElement, для накопления предпочтительных и/или минимальных размеров элементов и последующей установки свойств measuredWidth, measuredHeight, measuredMinWidth и measuredMinHeight целевых объектов.
Связанные элементы API
scrollPositionChanged | () | метод |
protected function scrollPositionChanged():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вызывается при изменении свойств verticalScrollPosition или horizontalScrollPosition.
Реализация по умолчанию обеспечивает обновление свойства scrollRect целевого объекта путем вызова updateScrollRect(). Этот метод может быть переопределен подклассами для вычисления других значений, основанных на текущих значениях scrollPosition или scrollRect.
Связанные элементы API
showDropIndicator | () | метод |
public function showDropIndicator(dropLocation:DropLocation):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Размеры, положение и вышестоящие объекты индикатора перетаскивания, основанные на указанном местоположении перетаскивания. Метод calculateDropLocation() используется для получения объекта DropLocation.
Начинает/останавливает прокрутку при перетаскивании при соблюдении соответствующих условий.
Параметры
dropLocation:DropLocation — Определяет местоположение для отображения индикатора перетаскивания. Местоположение перетаскивания определяется методом computeDropLocation().
|
Связанные элементы API
updateDisplayList | () | метод |
public function updateDisplayList(width:Number, height:Number):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Размеры и местоположения элементов целевого объекта.
Это один из тех методов, которые должны быть переопределены при создании подкласса LayoutBase. Другим методом является measure(). Вызов этих методов напрямую не требуется. Этот метод вызывается в среде Flex при передаче макета. Передача макета включает в себя три этапа.
Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода commitProperties для целевого объекта.
Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода validateSize() для целевого объекта. Метод целевого объекта validateSize() в свою очередь вызовет метод макета measure() для вычисления размера целевого объекта по умолчанию, если он не был явным образом задан с помощью свойств explicitWidth и explicitHeight целевого объекта. При изменении размера по умолчанию список отображения целевого объекта в среде Flex будет признан недействительным.
На последнем этапе, если список отображения целевого объекта является недействительным, LayoutManager обеспечит вызов метода validateDisplayList для целевого объекта. Метод validateDisplayList, в свою очередь, вызовет метод макета updateDisplayList для изменения размера и позиционирования элементов целевого объекта.
Типичная реализация обеспечивает выполнение итераций для элементов целевого объекта и использование методов, определенных ILayoutElement для позиционирования и изменения размера элементов. После этого макет также должен обеспечивать вычисление и установку значений свойств contentWidth и contentHeightдля определения области прокрутки целевого объекта.
Параметры
width:Number — Указывает ширину целевого объекта в пикселях по его координатам.
| |
height:Number — Указывает высоту компонента в пикселях по координатам целевого объекта.
|
Связанные элементы API
updateScrollRect | () | метод |
public function updateScrollRect(w:Number, h:Number):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вызывается целевым объектом в конце updateDisplayList для обновления свойства scrollRect макета.
Если clipAndEnableScrolling имеет значение true, реализация по умолчанию используется для установки происхождения scrollRect целевого объекта на verticalScrollPosition, horizontalScrollPosition. Устанавливает свой размер в параметрах width, height (немасштабированная ширина и высота целевого объекта).
Если clipAndEnableScrolling имеет значение false, реализация по умолчанию обеспечивает установку значения null для свойства scrollRect.
Параметры
w:Number — Ширина целевого объекта.
| |
h:Number — Высота целевого объекта.
|
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z