| Пакет | spark.layouts |
| Класс | public class HorizontalLayout |
| Наследование | HorizontalLayout  LayoutBase OnDemandEventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Горизонтальная позиция элементов определяется путем их упорядочения в последовательность по горизонтали, слева направо, учитывая заполнение перед первым элементом и промежутки между элементами.
Вертикальная позиция элементов определяется свойством verticalAlign макета.
При выполнении метода measure() вычисляется стандартный размер контейнера путем суммирования предпочтительных размеров элементов, включая интервалы и заполнение. Если свойство requestedColumnCount установлено на значение, отличное от -1, выполняется измерение пространства только для нескольких элементов, начиная с первого.
При выполнении метода updateDisplayList() вычисляется ширина каждого элемента в соответствии со следующими правилами, перечисленными согласно их приоритетам (при этом всегда учитывается минимальная и максимальная ширина элемента):
- Если
variableColumnWidthимеет значениеfalse, в качестве ширины элемента устанавливается значение свойстваcolumnWidth. - Если для элемента установлено значение
percentWidthто ширина элемента вычисляется путем распределения доступной ширины контейнера между всеми элементами с параметромpercentWidth. Доступная ширина контейнера равняется ширине контейнера минус промежутки, заполнения и пространство, занимаемого остальными элементами. При виртуализации макета свойствоprecentWidthэлемента игнорируется. - Установите ширину элемента в соответствии с его предпочтительной шириной.
Высота каждого элемента вычисляется согласно следующим правилам, перечисленным в порядке их приоритетов (при этом всегда учитывается минимальная и максимальная высота элемента).
- Если свойство
verticalAlignимеет значениеjustify, то высота элемента соответствует высоте контейнера. - Если свойство
verticalAlignимеет значениеcontentJustify, то высота элемента соответствует максимальному значению из высоты контейнера и значений предпочтительной высоты всех элементов. - Если для элемента установлено свойство
percentHeightто высота этого элемента соответствует процентному выражению высоты контейнера. - Установите высоту элемента в соответствии с его предпочтительной высотой.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:HorizontalLayout> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:HorizontalLayout
Properties
columnWidth="calculated"
gap="6"
paddingBottom="0"
paddingLeft="0"
paddingRight="0"
paddingTop="0"
requestedColumnCount="-1"
requestedMaxColumnCount="-1"
requestedMinColumnCount="-1"
variableColumnWidth="true"
verticalAlign="top"
/>
| Свойство | Определено | ||
|---|---|---|---|
 | clipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра. | LayoutBase | |
| columnCount : int [только для чтения]
Возвращает текущее количество элементов, отображаемых в представлении. | HorizontalLayout | ||
| columnWidth : Number
Если свойство variableColumnWidth имеет значение false, то это свойство указывает фактическую ширину каждого элемента макета в пикселях. | HorizontalLayout | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| dropIndicator : DisplayObject
DisplayObject, который этот макет использует для индикатора перетаскивания во время операции перетаскивания. | LayoutBase | |
| firstIndexInView : int [только для чтения]
Индекс первого столбца, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. | HorizontalLayout | ||
| gap : int
Промежуток по горизонтали между элементами макета в пикселях. | HorizontalLayout | ||
| horizontalAlign : String
Горизонтальное выравнивание содержимого по отношению к ширине контейнера. | HorizontalLayout | ||
| horizontalScrollPosition : Number
Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase | |
| lastIndexInView : int [только для чтения]
Индекс последнего столбца, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. | HorizontalLayout | ||
| paddingBottom : Number
Минимальное число пикселей между нижним краем контейнера и нижней границей всех элементов макета в контейнере. | HorizontalLayout | ||
| paddingLeft : Number
Число пикселей между левым краем контейнера и левым краем первого элемента макета. | HorizontalLayout | ||
| paddingRight : Number
Число пикселей между правым краем контейнера и правым краем последнего элемента макета. | HorizontalLayout | ||
| paddingTop : Number
Число пикселей между верхним краем контейнера и верхней границей всех элементов макета в контейнере. | HorizontalLayout | ||
| requestedColumnCount : int
Измеренный размер этого макета является достаточно широким для отображения первых элементов макета requestedColumnCount. | HorizontalLayout | ||
| requestedMaxColumnCount : int
Измеренная ширина этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxColumnCount. | HorizontalLayout | ||
| requestedMinColumnCount : int
Измеренная ширина этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinColumnCount. | HorizontalLayout | ||
| target : GroupBase
Контейнер GroupBase, элементы которого измеряются, получают размер и располагаются с использованием этого макета. | LayoutBase | |
| typicalLayoutElement : ILayoutElement
Используется макетами в тех случаях, когда необходимы фиксированные размеры строк/столбцов, но при этом определенные размеры не указаны. | LayoutBase | |
| useVirtualLayout : Boolean
В контейнере может находиться любое число нижестоящих элементов. | LayoutBase | |
| variableColumnWidth : Boolean
Если установлено значение true, указывает на необходимость присвоения элементам макета соответствующих значений предпочтительной ширины. | HorizontalLayout | ||
| verticalAlign : String
Выравнивание элементов макета по вертикали. | HorizontalLayout | ||
| verticalScrollPosition : Number
Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase | |
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | HorizontalLayout | ||
| 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, которое указывает на процент частично видимого индекса. | HorizontalLayout | ||
|
Возвращает границы макета указанного элемента в виде элемента 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 | |
columnCount | свойство |
columnCount:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает текущее количество элементов, отображаемых в представлении.
Значением по умолчанию является -1.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange .
Реализация
public function get columnCount():intcolumnWidth | свойство |
columnWidth:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Если свойство variableColumnWidth имеет значение false, то это свойство указывает фактическую ширину каждого элемента макета в пикселях.
Если свойство variableColumnWidth имеет значение true, заданное по умолчанию, установка этого свойства не приведет к выполнению каких-либо действий.
Значение по умолчанию этого свойства является предпочтительной шириной элемента, определенного свойством typicalLayoutElement.
Реализация
public function get columnWidth():Number public function set columnWidth(value:Number):voidfirstIndexInView | свойство |
firstIndexInView:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Индекс первого столбца, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. Следует отметить, что столбец может находиться в видимой области только частично.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие indexInViewChanged .
Реализация
public function get firstIndexInView():intСвязанные элементы API
fractionOfElementInView
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 контейнера.
Это свойство не оказывает никакого эффекта, если clipAndEnableScrolling имеет значение true и contentWidth превышает ширину контейнера.
Это свойство не влияет на измеренный размер макета.
Значением по умолчанию является "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, если отображение еще отсутствует. Следует отметить, что столбец может находиться в видимой области только частично.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие 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):voidrequestedColumnCount | свойство |
requestedColumnCount:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Измеренный размер этого макета является достаточно широким для отображения первых элементов макета requestedColumnCount. Если requestedColumnCount имеет значение -1, то измеренный размер будет достаточным для отображения всех элементов макета.
Если реальный размер контейнера, использующего этот макет, был установлен явно, то это свойство не используется.
Значением по умолчанию является -1.
Реализация
public function get requestedColumnCount():int public function set requestedColumnCount(value:int):voidСвязанные элементы API
requestedMaxColumnCount | свойство |
requestedMaxColumnCount:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Измеренная ширина этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxColumnCount.
Если requestedColumnCount установлено, то это свойство не имеет никакого эффекта.
Если реальный размер контейнера, использующего этот макет, был установлен явно, то это свойство не используется.
Значением по умолчанию является -1.
Реализация
public function get requestedMaxColumnCount():int public function set requestedMaxColumnCount(value:int):voidСвязанные элементы API
requestedMinColumnCount | свойство |
requestedMinColumnCount:int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Измеренная ширина этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinColumnCount.
Если requestedColumnCount установлено, то это свойство не имеет никакого эффекта.
Если реальный размер контейнера, использующего этот макет, был установлен явно, то это свойство не используется.
Значением по умолчанию является -1.
Реализация
public function get requestedMinColumnCount():int public function set requestedMinColumnCount(value:int):voidСвязанные элементы API
variableColumnWidth | свойство |
variableColumnWidth:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Если установлено значение true, указывает на необходимость присвоения элементам макета соответствующих значений предпочтительной ширины.
Установка для этого свойства значения false указывает на столбцы фиксированной ширины. Фактическая ширина каждого элемента макета является значением свойства columnWidth, и макет игнорирует свойство percentWidth элементов макета.
Значением по умолчанию является true.
Реализация
public function get variableColumnWidth():Boolean public function set variableColumnWidth(value:Boolean):voidverticalAlign | свойство |
verticalAlign:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Выравнивание элементов макета по вертикали.
Если значение – bottom, middle или top, то элементы макета выравниваются относительно свойства contentHeight контейнера.
Если значение – contentJustify, то фактическая высота данного элемента макета устанавливается на значение свойства contentHeight контейнера. Высота содержимого контейнера определяет высоту самого большого элемента макета. Если все элементы макета меньше высоты контейнера, следует установить высоту всех элементов макета на значение высоты контейнера.
Если значение – justify, то фактическая высота элементов макета устанавливается на значение высоты контейнера.
Если указано значение baseline, то текст элементов выравнивается с учетом максимального значения выносных текстовых объектов элементов.
Значением по умолчанию является "top".
Реализация
public function get verticalAlign():String public function set verticalAlign(value:String):voidHorizontalLayout | () | Конструктор |
public function HorizontalLayout()| Язык версии: | 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