Пакет | spark.layouts |
Класс | public class TileLayout |
Наследование | TileLayout LayoutBase OnDemandEventDispatcher Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Для каждого элемента поддерживаются такие ограничения, как percentWidth
и percentHeight
. Минимальные и максимальные размеры элемента учитываются во всех возможных случаях, размер элемента не должен превосходить размер ячейки.
Если свойство columnWidth
не установлено явно, его значение совпадает с максимальной предпочтительной шириной границ всех элементов, и значение свойства columnHeight
совпадает с максимальной предпочтительной высотой границ всех элементов.
Если свойства columnCount
и rowCount
не установлены явно, их значения вычисляются на основе любых явных установок ширины и высоты для целевого объекта макета, а также columnWidth
и columnHeight
. Если указано значение none, значения columnCount
и rowCount
определяются таким образом, чтобы требуемая область в пикселях по возможности имела форму квадрата.
Измеренный размер вычисляется на основе значений свойств columnCount
, rowCount
, columnWidth
, rowHeight
и размеров интервала.
Если свойства явно не установлены, измеренный размер по умолчанию соответствует области, по возможности имеющей форму квадрата, и достаточно большой для размещения всех элементов.
В других случаях измеренный размер может оказаться недостаточно большим для размещения всех элементов. Например, если для columnCount
и rowCount
явно установлены такие значения, что произведение columnCount
на rowCount
меньше количества элементов.
Минимальный измеренный размер вычисляется тем же самым способом, что и измеренный размер, но в этом случае обеспечивается охват достаточного количества строк и столбцов по второстепенной оси для размещения всех элементов.
Синтаксис MXMLСкрыть синтаксис MXMLThe <s:TileLayout>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:TileLayout Properties columnAlign="left" columnWidth="NaN" horizontalAlign="justify" horizontalGap="6" orientation="rows" requestedColumnCount="-1" requestedRowCount="-1" rowAlign="top" rowCount="-1" rowHeight="NaN" verticalAlign="justify" verticalGap="6" />
Свойство | Определено | ||
---|---|---|---|
clipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра. | LayoutBase | ||
columnAlign : String
Указывает способ выравнивания полностью видимых столбцов по ширине контейнера. | TileLayout | ||
columnCount : int [только для чтения]
Содержит фактическое количество столбцов. | TileLayout | ||
columnWidth : Number
Содержит действительную ширину столбца в пикселях. | TileLayout | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
dropIndicator : DisplayObject
DisplayObject, который этот макет использует для индикатора перетаскивания во время операции перетаскивания. | LayoutBase | ||
horizontalAlign : String
Указывает способ горизонтального выравнивания элементов в ячейках. | TileLayout | ||
horizontalGap : Number
Промежуток по горизонтали между столбцами в пикселях. | TileLayout | ||
horizontalScrollPosition : Number
Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase | ||
orientation : String
Указывает, упорядочены ли элементы по строкам или по столбцам. | TileLayout | ||
paddingBottom : Number
Число пикселей между нижним краем контейнера и нижним краем последнего элемента макета. | TileLayout | ||
paddingLeft : Number
Минимальное число пикселей между левым краем контейнера и левым краем элемента макета. | TileLayout | ||
paddingRight : Number
Минимальное число пикселей между правым краем контейнера и правым краем элемента макета. | TileLayout | ||
paddingTop : Number
Число пикселей между верхним краем контейнера и верхним краем первого элемента макета. | TileLayout | ||
requestedColumnCount : int
Число отображаемых столбцов. | TileLayout | ||
requestedRowCount : int
Число отображаемых строк. | TileLayout | ||
rowAlign : String
Указывает способ выравнивания полностью видимых строк по высоте контейнера. | TileLayout | ||
rowCount : int [только для чтения]
Количество строк. | TileLayout | ||
rowHeight : Number
Высота строки в пикселях. | TileLayout | ||
target : GroupBase
Контейнер GroupBase, элементы которого измеряются, получают размер и располагаются с использованием этого макета. | LayoutBase | ||
typicalLayoutElement : ILayoutElement
Используется макетами в тех случаях, когда необходимы фиксированные размеры строк/столбцов, но при этом определенные размеры не указаны. | LayoutBase | ||
useVirtualLayout : Boolean
В контейнере может находиться любое число нижестоящих элементов. | LayoutBase | ||
verticalAlign : String
Указывает способ вертикального выравнивания элементов в ячейках. | TileLayout | ||
verticalGap : Number
Промежуток по вертикали между строками в пикселях. | TileLayout | ||
verticalScrollPosition : Number
Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. | LayoutBase |
Метод | Определено | ||
---|---|---|---|
Конструктор. | TileLayout | ||
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 | ||
[переопределить]
Возвращает индекс, указывающий на то, где должен быть вставлен новый элемент, когда пользователь отпускает кнопку мыши в указанных координатах при завершении операции перетаскивания. | TileLayout | ||
[переопределить]
Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания. | TileLayout | ||
Возвращает границы первого элемента макета, охватывающего верхний край scrollRect или находящегося над ним. | LayoutBase | ||
Возвращает границы первого элемента макета, охватывающего нижний край scrollRect или находящегося ниже края. | LayoutBase | ||
Возвращает границы первого элемента макета, охватывающего левый край scrollRect или находящегося слева от него. | LayoutBase | ||
Возвращает границы первого элемента макета, охватывающего правый край scrollRect или находящегося справа от нее. | LayoutBase | ||
Возвращает границы прямоугольника прокрутки целевого объекта в координатах макета. | LayoutBase | ||
Вызывается при изменении свойств verticalScrollPosition или horizontalScrollPosition. | LayoutBase |
columnAlign | свойство |
columnAlign:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает способ выравнивания полностью видимых столбцов по ширине контейнера. Допустимы следующие значения ActionScript: ColumnAlign.LEFT
, ColumnAlign.JUSTIFY_USING_GAP
и ColumnAlign.JUSTIFY_USING_WIDTH
. Возможными значениями MXML могут являться left
, justifyUsingGap
и justifyUsingWidth
.
При установке на ColumnAlign.LEFT
выравнивание столбца отключается. Между последним столбцом и правым краем контейнера могут находиться частично видимые столбцы или пробел. Это значение является значением по умолчанию.
Если установлено значение ColumnAlign.JUSTIFY_USING_GAP
фактическое значение horizontalGap
увеличивается таким образом, что правый край последнего полностью видимого столбца выравнивается по правому краю контейнера. При наличии единственного полностью видимого столбца фактическое значение horizontalGap
увеличивается таким образом, что любой частично видимый столбец перемещается за пределы правого края контейнера. Обратите внимание, что явная установка свойства horizontalGap
не отключает выравнивание. Она только определяет начальное значение интервала. Выравнивание может увеличить его.
Если установлено значение ColumnAlign.JUSTIFY_USING_WIDTH
, фактическое значение columnWidth
увеличивается таким образом, что правый край последнего полностью видимого столбца выравнивается по правому краю контейнера. Обратите внимание, что явная установка свойства columnWidth
не отключает выравнивание. Она только определяет начальное значение ширины столбца. Выравнивание может увеличить его.
Значением по умолчанию является ColumnAlign.LEFT.
Реализация
public function get columnAlign():String
public function set columnAlign(value:String):void
Связанные элементы API
columnCount | свойство |
columnCount:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Содержит фактическое количество столбцов.
Значением по умолчанию является -1.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange
.
Реализация
public function get columnCount():int
Связанные элементы API
columnWidth | свойство |
columnWidth:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Содержит действительную ширину столбца в пикселях.
Если явно не установлено, ширина столбца определяется на основании ширины самого широкого элемента.
Если свойство columnAlign
устанавливаются на justifyUsingWidth
, ширина столбца увеличивается до ширины контейнера для выравнивания полностью видимых столбцов.
Значением по умолчанию является NaN.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange
.
Реализация
public function get columnWidth():Number
public function set columnWidth(value:Number):void
Связанные элементы API
horizontalAlign | свойство |
horizontalAlign:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает способ горизонтального выравнивания элементов в ячейках. Поддерживаются следующие значения: HorizontalAlign.LEFT
, HorizontalAlign.CENTER
, HorizontalAlign.RIGHT
, HorizontalAlign.JUSTIFY
.
Если установлено значение HorizontalAlign.JUSTIFY
, ширина каждого элемента соответствует columnWidth
.
Значением по умолчанию является HorizontalAlign.JUSTIFY
.
Реализация
public function get horizontalAlign():String
public function set horizontalAlign(value:String):void
horizontalGap | свойство |
horizontalGap:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Промежуток по горизонтали между столбцами в пикселях.
Значением по умолчанию является 6.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange
.
Реализация
public function get horizontalGap():Number
public function set horizontalGap(value:Number):void
Связанные элементы API
orientation | свойство |
orientation:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает, упорядочены ли элементы по строкам или по столбцам. Допустимы следующие значения ActionScript: TileOrientation.ROWS
и TileOrientation.COLUMNS
. Возможными значениями MXML могут являться rows
и columns
.
Значением по умолчанию является TileOrientation.ROWS.
Реализация
public function get orientation():String
public function set orientation(value:String):void
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):void
paddingLeft | свойство |
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):void
paddingRight | свойство |
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):void
paddingTop | свойство |
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):void
requestedColumnCount | свойство |
requestedColumnCount:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Число отображаемых столбцов.
Значение -1 используется для предоставления TileLayout возможности автоматического определения количества столбцов.
Если свойство orientation
устанавливается на TileOrientation.ROWS
, то установка этого свойства не оказывает никакого влияния. В этом случае явно устанавливается rowCount
, а также явно устанавливается ширина контейнера.
Значением по умолчанию является -1.
Реализация
public function get requestedColumnCount():int
public function set requestedColumnCount(value:int):void
Связанные элементы API
requestedRowCount | свойство |
requestedRowCount:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Число отображаемых строк.
Значение -1 устанавливается в целях удаления явного переопределения и предоставления TileLayout возможности автоматического определения счетчика строк.
Если свойство orientation
устанавливается на TileOrientation.COLUMNS
, то установка этого свойства не оказывает никакого влияния. В этом случае явно устанавливается columnCount
, а также явно устанавливается высота контейнера.
Значением по умолчанию является -1.
Реализация
public function get requestedRowCount():int
public function set requestedRowCount(value:int):void
Связанные элементы API
rowAlign | свойство |
rowAlign:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает способ выравнивания полностью видимых строк по высоте контейнера. Допустимы следующие значения ActionScript: RowAlign.TOP
, RowAlign.JUSTIFY_USING_GAP
и RowAlign.JUSTIFY_USING_HEIGHT
. Возможными значениями MXML могут являться top
, justifyUsingGap
и justifyUsingHeight
.
При установке на RowAlign.TOP
выравнивание столбца отключается. Между последней строкой и нижним краем контейнера могут находиться частично видимые строки или пробел. Это значение является значением по умолчанию.
Если установлено значение RowAlign.JUSTIFY_USING_GAP
, фактическое значение verticalGap
увеличивается таким образом, что нижний край последней полностью видимой строки выравнивается с нижним краем контейнера. При наличии единственной полностью видимой строки значение verticalGap
увеличивается таким образом, что любая частично видимая строка перемещается за пределы нижнего края контейнера. Обратите внимание, что явная установка verticalGap
не отключает выравнивание, а только определяет начальное значение интервала. При этом выравнивание может увеличить его.
Если установлено значение RowAlign.JUSTIFY_USING_HEIGHT
, фактическое значение rowHeight
увеличивается таким образом, что нижний край последней полностью видимой строки выравнивается по нижнему краю контейнера. Обратите внимание, что явная установка rowHeight
не отключает выравнивание, а определяет начальное значение высоты строки. При этом выравнивание может увеличить его.
Значением по умолчанию является RowAlign.TOP.
Реализация
public function get rowAlign():String
public function set rowAlign(value:String):void
Связанные элементы API
rowCount | свойство |
rowCount:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Количество строк.
Значением по умолчанию является -1.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange
.
Реализация
public function get rowCount():int
Связанные элементы API
rowHeight | свойство |
rowHeight:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Высота строки в пикселях.
Если свойство явно не установлено, высота строки определяется на основе максимального значения высоты элементов.
Если дляrowAlign
установлено значение justifyUsingHeight, то фактическая высота строки увеличивается для обеспечения выравнивания полностью видимых строк относительно высоты контейнера.
Значением по умолчанию является NaN.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange
.
Реализация
public function get rowHeight():Number
public function set rowHeight(value:Number):void
Связанные элементы API
verticalAlign | свойство |
verticalAlign:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Указывает способ вертикального выравнивания элементов в ячейках. Поддерживаются следующие значения: VerticalAlign.TOP
, VerticalAlign.MIDDLE
, VerticalAlign.BOTTOM
, VerticalAlign.JUSTIFY
.
Если установлено значение VerticalAlign.JUSTIFY
, высота каждого элемента соответствует rowHeight
.
Значением по умолчанию является VerticalAlign.JUSTIFY
.
Реализация
public function get verticalAlign():String
public function set verticalAlign(value:String):void
verticalGap | свойство |
verticalGap:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Промежуток по вертикали между строками в пикселях.
Значением по умолчанию является 6.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие propertyChange
.
Реализация
public function get verticalGap():Number
public function set verticalGap(value:Number):void
Связанные элементы API
TileLayout | () | Конструктор |
public function TileLayout()
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
calculateDropIndex | () | метод |
override 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, если операция перетаскивания не доступна для указанных координат.
|
calculateDropIndicatorBounds | () | метод |
override protected function calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания. Вызывается методом showDropIndicator()
.
Параметры
dropLocation:DropLocation — Допустимый объект DropLocation, ранее возвращенный методом calculateDropLocation() .
|
Rectangle — Границы для индикатора перетаскивания или значение null.
|
Tue Jun 12 2018, 11:34 AM Z