| Пакет | spark.layouts |
| Класс | public class VerticalLayout |
| Наследование | VerticalLayout  LayoutBase OnDemandEventDispatcher Object |
| Подклассы | FormLayout |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вертикальная позиция элементов определяется путем их упорядочения в последовательность по вертикали, сверху вниз, учитывая заполнение перед первым элементом и промежутки между элементами.
Горизонтальная позиция элементов определяется свойством horizontalAlign макета.
При выполнении метода measure() вычисляется стандартный размер контейнера путем суммирования предпочтительных размеров элементов, включая интервалы и заполнение. Если установлен requestedRowCount будет измерено только пространство для определяемого этим количеством элементов, начиная с первого элемента.
При выполнении метода updateDisplayList() вычисляется высота каждого элемента в соответствии со следующими правилами, перечисленными согласно их приоритетам (при этом всегда учитывается минимальная и максимальная высота элемента):
- Если
variableRowHeightимеет значениеfalse, в качестве высоты элемента устанавливается значение свойстваrowHeight. - Если для элемента установлено значение
percentHeightто высота элемента вычисляется путем распределения доступной высоты контейнера между всеми элементами с параметромpercentHeight. Доступная высота контейнера равняется высоте контейнера минус промежутки, заполнения и пространство, занимаемое остальными элементами. При виртуализации макета свойствоprecentHeightэлемента игнорируется. - Установите высоту элемента в соответствии с его предпочтительной высотой.
Ширина каждого элемента вычисляется согласно следующим правилам, перечисленным в порядке их приоритетов (при этом всегда учитывается минимальная и максимальная ширина элемента):
- Если
horizontalAlignимеет значениеjustify, то ширина элемента соответствует ширине контейнера. - Если
horizontalAlignимеет значениеcontentJustify, то ширина элемента соответствует максимальному значению из ширины контейнера и значений предпочтительной ширины всех элементов. - Если для элемента установлено значение
percentWidth, то ширина этого элемента соответствует процентному выражению ширины контейнера. - Установите ширину элемента в соответствии с его предпочтительной шириной.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:VerticalLayout> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:VerticalLayout
Properties
gap="6"
horizontalAlign="left"
paddingBottom="0"
paddingLeft="0"
paddingRight="0"
paddingTop="0"
requestedMaxRowCount="-1"
requestedMinRowCount="-1"
requestedRowCount="-1"
rowHeight="calculated"
variableRowHeight="true"
verticalAlign="top"
/>
| Свойство | Определено | ||
|---|---|---|---|
 | clipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра. | LayoutBase | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| dropIndicator : DisplayObject
DisplayObject, который этот макет использует для индикатора перетаскивания во время операции перетаскивания. | LayoutBase | |
| firstIndexInView : int [только для чтения]
Индекс первого элемента макета, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. | VerticalLayout | ||
| gap : int
Промежуток по вертикали между элементами макета в пикселях. | VerticalLayout | ||
| horizontalAlign : String
Выравнивание элементов макета по горизонтали. | VerticalLayout | ||
| horizontalScrollPosition : Number
Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase | |
| lastIndexInView : int [только для чтения]
Индекс последней строки, являющейся частью макета и расположенной в пределах прямоугольника прокрутки контейнера; либо -1, если отображение еще отсутствует. | VerticalLayout | ||
| paddingBottom : Number
Число пикселей между нижним краем контейнера и нижним краем последнего элемента макета. | VerticalLayout | ||
| paddingLeft : Number
Минимальное число пикселей между левым краем контейнера и левым краем элемента макета. | VerticalLayout | ||
| paddingRight : Number
Минимальное число пикселей между правым краем контейнера и правым краем элемента макета. | VerticalLayout | ||
| paddingTop : Number
Число пикселей между верхним краем контейнера и верхним краем первого элемента макета. | VerticalLayout | ||
| requestedMaxRowCount : int
Измеренная высота этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxRowCount. | VerticalLayout | ||
| requestedMinRowCount : int
Измеренная высота этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinRowCount. | VerticalLayout | ||
| requestedRowCount : int
Измеренный размер этого макета достаточно большой в высоту, чтобы отобразить первые requestedRowCount элементов макета. | VerticalLayout | ||
| rowCount : int [только для чтения]
Текущее количество видимых элементов. | VerticalLayout | ||
| rowHeight : Number
Если variableRowHeight имеет значение false, то это свойство указывает фактическую высоту каждого нижестоящего элемента в пикселях. | VerticalLayout | ||
| target : GroupBase
Контейнер GroupBase, элементы которого измеряются, получают размер и располагаются с использованием этого макета. | LayoutBase | |
| typicalLayoutElement : ILayoutElement
Используется макетами в тех случаях, когда необходимы фиксированные размеры строк/столбцов, но при этом определенные размеры не указаны. | LayoutBase | |
| useVirtualLayout : Boolean
В контейнере может находиться любое число нижестоящих элементов. | LayoutBase | |
| variableRowHeight : Boolean
Определяет, распределены ли элементы макета с учетом их предпочтительной высоты. | VerticalLayout | ||
| verticalAlign : String
Вертикальное выравнивание содержимого по отношению к высоте контейнера. | VerticalLayout | ||
| verticalScrollPosition : Number
Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase | |
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | VerticalLayout | ||
| 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 | |
Возвращает 1.0, если указанный индекс полностью находится в поле зрения; 0.0, если это не так; или значение между 0.0 и 1.0, которое указывает на процент частично видимого индекса. | VerticalLayout | ||
|
Возвращает границы макета указанного элемента в виде элемента 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 | |
firstIndexInView | свойство |
firstIndexInView:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Индекс первого элемента макета, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует.
«Часть макета» означает, что элемент не является null, и его свойство includeInLayout имеет значение true.
Следует отметить, что элемент макета может находиться в поле зрения только частично.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие indexInViewChanged .
Реализация
public function get firstIndexInView():intСвязанные элементы API
gap | свойство |
gap:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Промежуток по вертикали между элементами макета в пикселях. Следует отметить, что этот интервал определяет только расстояние между элементами макета, таким образом, при наличии единственного элемента, интервал не оказывает влияния на макет.
Значением по умолчанию является 6.
Реализация
public function get gap():int public function set gap(value:int):voidhorizontalAlign | свойство |
horizontalAlign:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Выравнивание элементов макета по горизонтали. Если значение – left, right или center, то элемент макета выравнивается относительно свойства contentWidth контейнера.
Если значением является contentJustify, то в качестве фактической ширины элемента макета используется contentWidth контейнера. contentWidth контейнера является шириной наибольшего элемента макета. Если все элементы макета меньше ширины контейнера, следует установить ширину всех элементов макета на значение ширины контейнера.
Если значение является justify, то в качестве фактической ширины элемента макета используется ширина контейнера.
Это свойство не влияет на измеренный размер макета.
Значением по умолчанию является "left".
Реализация
public function get horizontalAlign():String public function set horizontalAlign(value:String):voidlastIndexInView | свойство |
lastIndexInView:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Индекс последней строки, являющейся частью макета и расположенной в пределах прямоугольника прокрутки контейнера; либо -1, если отображение еще отсутствует.
«Часть макета» означает, что нижестоящий элемент не является null, и его свойство includeInLayout имеет значение true.
Следует отметить, что строка может находиться в поле зрения частично.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие indexInViewChanged .
Реализация
public function get lastIndexInView():intСвязанные элементы API
fractionOfElementInView
paddingBottom | свойство |
paddingBottom:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Число пикселей между нижним краем контейнера и нижним краем последнего элемента макета.
Значением по умолчанию является 0.
Реализация
public function get paddingBottom():Number public function set paddingBottom(value:Number):voidpaddingLeft | свойство |
paddingLeft:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Минимальное число пикселей между левым краем контейнера и левым краем элемента макета.
Значением по умолчанию является 0.
Реализация
public function get paddingLeft():Number public function set paddingLeft(value:Number):voidpaddingRight | свойство |
paddingRight:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Минимальное число пикселей между правым краем контейнера и правым краем элемента макета.
Значением по умолчанию является 0.
Реализация
public function get paddingRight():Number public function set paddingRight(value:Number):voidpaddingTop | свойство |
paddingTop:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Число пикселей между верхним краем контейнера и верхним краем первого элемента макета.
Значением по умолчанию является 0.
Реализация
public function get paddingTop():Number public function set paddingTop(value:Number):voidrequestedMaxRowCount | свойство |
requestedMaxRowCount:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Измеренная высота этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxRowCount.
Если requestedRowCount установлено, то это свойство не имеет никакого эффекта.
Если реальный размер контейнера был установлен явно, то это свойство не используется.
Значением по умолчанию является -1.
Реализация
public function get requestedMaxRowCount():int public function set requestedMaxRowCount(value:int):voidСвязанные элементы API
requestedMinRowCount | свойство |
requestedMinRowCount:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Измеренная высота этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinRowCount.
Если requestedRowCount установлено, то это свойство не имеет никакого эффекта.
Если реальный размер контейнера был установлен явно, то это свойство не используется.
Значением по умолчанию является -1.
Реализация
public function get requestedMinRowCount():int public function set requestedMinRowCount(value:int):voidСвязанные элементы API
requestedRowCount | свойство |
requestedRowCount:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Измеренный размер этого макета достаточно большой в высоту, чтобы отобразить первые requestedRowCount элементов макета.
Если requestedRowCount имеет значение -1, то измеренный размер будет достаточным для отображения всех элементов макета.
Если реальный размер контейнера был установлен явно, то это свойство не используется.
Значением по умолчанию является -1.
Реализация
public function get requestedRowCount():int public function set requestedRowCount(value:int):voidСвязанные элементы API
rowCount | свойство |
rowCount:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Текущее количество видимых элементов.
Значением по умолчанию является -1.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .
Реализация
public function get rowCount():introwHeight | свойство |
rowHeight:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Если variableRowHeight имеет значение false, то это свойство указывает фактическую высоту каждого нижестоящего элемента в пикселях.
Если variableRowHeight имеет значение true, заданное по умолчанию, установка этого свойства не приведет к выполнению каких-либо действий.
Значением этого свойства по умолчанию является предпочтительная высота typicalLayoutElement.
Реализация
public function get rowHeight():Number public function set rowHeight(value:Number):voidvariableRowHeight | свойство |
variableRowHeight:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет, распределены ли элементы макета с учетом их предпочтительной высоты. Установка этого свойства на false указывает на строки фиксированной высоты.
В случае значения false фактическая высота каждого элемента макета соответствует значению rowHeight. Установка этого свойства на false приводит к игнорированию макетом значений свойства percentHeight элемента макета.
Значением по умолчанию является true.
Реализация
public function get variableRowHeight():Boolean public function set variableRowHeight(value:Boolean):voidverticalAlign | свойство |
verticalAlign:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вертикальное выравнивание содержимого по отношению к высоте контейнера.
Если значение – bottom, middle или top, то элементы макета выравниваются относительно свойства contentHeight контейнера.
Это свойство не оказывает никакого эффекта, если clipAndEnableScrolling имеет значение true и contentHeight превышает высоту контейнера.
Это свойство не влияет на измеренный размер макета.
Значением по умолчанию является "top".
Реализация
public function get verticalAlign():String public function set verticalAlign(value:String):voidVerticalLayout | () | Конструктор |
public function VerticalLayout()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
fractionOfElementInView | () | метод |
public function fractionOfElementInView(index:int):Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает 1.0, если указанный индекс полностью находится в поле зрения; 0.0, если это не так; или значение между 0.0 и 1.0, которое указывает на процент частично видимого индекса.
Индекс отображается в представлении, если соответствующий ненулевой элемент макета находится внутри вертикальных пределов scrollRect контейнера и включен в макет.
Если указанная позиция индекса находится в пределах видимости частично, возвращаемое значение – это процентная доля видимой части соответствующего элемента макета.
Параметры
index:int — Индекс строки.
|
Number — Процентное значение указанного элемента, находящегося в видимой области. Возвращает 0.0, если указанная позиция индекса является недопустимой или соответствует элементу null, либо ILayoutElement, для которого значением свойства includeInLayout является false.
|
Tue Jun 12 2018, 11:34 AM Z