Пакет | spark.layouts |
Класс | public class ConstraintLayout |
Наследование | ConstraintLayout LayoutBase OnDemandEventDispatcher Object |
Подклассы | FormItemLayout |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Примечание. Элементы управления Spark на основе списка (элемент управления Spark List и его подклассы, такие как ButtonBar, ComboBox, DropDownList и TabBar) не поддерживают класс ConstraintLayout. Не следует использовать ConstraintLayout с элементами управления Spark на основе списка.
Ограничения, поддерживаемые для каждого элемента: left
, right
, top
, bottom
, baseline
, percentWidth
и percentHeight
. При этом всегда учитываются минимальные и максимальные размеры элемента.
Столбцы и строки могут иметь явный размер или размер содержимого (без явного размера). Явные области размера будут фиксированы с учетом указанного размера, в то время как области размера содержимого будут растянуты для согласования только с теми элементами, для которых указаны соответствующие ограничения. Если элемент содержит множественные области размеров содержимого, то это пространство будет разделено на равные участки в областях размеров содержимого.
Измеренный размер контейнера вычисляется на основе элементов, их ограничений, их предпочтительных размеров и размеров строк и столбцов. Размер каждой строки и столбца является достаточно большим, чтобы вместить все элементы, ограниченные этим размером, для которых сохранены предпочтительные размеры с учетом ограничений. Измеренный размер контейнера является достаточно большим, чтобы вместить все столбцы и строки, а также любые другие элементы, для которых сохранены предпочтительные размеры с учетом ограничений.
При выполнении метода updateDisplayList()
вычисляется размер элемента в соответствии с правилами, перечисленными согласно следующим приоритетам (при этом всегда учитывается минимальный и максимальный размер элемента):
- Если для элемента указаны параметры
percentWidth
илиpercentHeight
, то его размер вычисляется в виде процентного отношения доступного размера, в качестве которого используется размер области или контейнера за вычетом ограниченийleft
,right
,top
илиbottom
. - Если для элемента указаны ограничения left и right, то в качестве его ширины используется ширина области или контейнера за вычетом ограничений
left
иright
. - Если элемент имеет и ограничение
top
, и ограничениеbottom
, его высота определяется как высота контейнера за вычетом ограниченийtop
иbottom
. - Размер элемента устанавливается в соответствии с его предпочтительной шириной и/или высотой.
Позиция элемента определяется согласно правилам с учетом следующих приоритетов:
- Если для элемента указано ограничение baseline, то элемент позиционируется в вертикальном направлении таким образом, что его
baselinePosition
(как правило, базовая линия первой линии текста) выравнивается по ограничениюbaseline
. - Если для элемента указаны ограничения
top
илиleft
, то элемент позиционируется таким образом, что верхний левый угол границ макета элемента смещается от верхнего левого угла контейнера в соответствии с указанными значениями. - Если для элемента указаны ограничения
bottom
илиright
, то элемент позиционируется таким образом, что правый нижний угол границ макета элемента смещается от правого нижнего угла контейнера в соответствии с указанными значениями. - Если ограничения относительно позиции в горизонтальном или вертикальном направлении не определены, то элемент размещается в соответствии с его координатами x и y.
Размер содержимого контейнера вычисляется как максимальная из координат правого нижнего угла всех элементов макета и областей ограничений.
Свойство | Определено | ||
---|---|---|---|
clipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра. | LayoutBase | ||
constraintColumns : Vector.<ConstraintColumn>
Вектор экземпляров ConstraintColumn, разделяющих целевой контейнер. | ConstraintLayout | ||
constraintRows : Vector.<ConstraintRow>
Вектор экземпляров ConstraintRow, разделяющих целевой контейнер. | ConstraintLayout | ||
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 |
Метод | Определено | ||
---|---|---|---|
Конструктор. | ConstraintLayout | ||
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 | ||
Располагает элементы целевого объекта макета с учетом текущей ширины и высоты столбцов и строк. | ConstraintLayout | ||
measureAndPositionColumnsAndRows(constrainedWidth:Number = NaN, constrainedHeight:Number = NaN):void
Используется FormItemLayout для определения и установки новых показателей ширины столбца и высоты строки перед размещением элементов. | ConstraintLayout | ||
Вызывается при изменении свойств verticalScrollPosition или horizontalScrollPosition. | LayoutBase |
constraintColumns | свойство |
constraintColumns:Vector.<ConstraintColumn>
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вектор экземпляров ConstraintColumn, разделяющих целевой контейнер. Экземпляр ConstraintColumn в индексе 0 представляет собой крайний левый столбец; индексы увеличиваются слева направо.
Реализация
public function get constraintColumns():Vector.<ConstraintColumn>
public function set constraintColumns(value:Vector.<ConstraintColumn>):void
constraintRows | свойство |
constraintRows:Vector.<ConstraintRow>
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вектор экземпляров ConstraintRow, разделяющих целевой контейнер. Экземпляр ConstraintRow в индексе 0 представляет собой самый верхний столбец; индексы увеличиваются сверху вниз.
Реализация
public function get constraintRows():Vector.<ConstraintRow>
public function set constraintRows(value:Vector.<ConstraintRow>):void
ConstraintLayout | () | Конструктор |
public function ConstraintLayout()
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
layoutContent | () | метод |
protected function layoutContent(unscaledWidth:Number, unscaledHeight:Number):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Располагает элементы целевого объекта макета с учетом текущей ширины и высоты столбцов и строк. Используется FormItemLayout после установки новых показателей ширины столбца для размещения элементов, использующих эти новые показатели ширины.
Параметры
unscaledWidth:Number — Указывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента.
| |
unscaledHeight:Number — Указывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента.
|
measureAndPositionColumnsAndRows | () | метод |
protected function measureAndPositionColumnsAndRows(constrainedWidth:Number = NaN, constrainedHeight:Number = NaN):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4.5 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Используется FormItemLayout для определения и установки новых показателей ширины столбца и высоты строки перед размещением элементов.
Параметры
constrainedWidth:Number (default = NaN ) — Полная ширина, доступная для столбцов, чтобы растянуться или уменьшить их столбцы ширины процента. Если NaN, столбцы ширины процента добровольны и пригодны к их содержимому.
| |
constrainedHeight:Number (default = NaN ) — Полная высота, доступная для строк, чтобы растянуться или уменьшить их строки высоты процента. Если NaN, строки высоты процента добровольны и пригодны к их содержимому.
|
Tue Jun 12 2018, 11:34 AM Z