Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
spark.layouts 

ConstraintLayout  - AS3 Flex

Пакетspark.layouts
Классpublic class ConstraintLayout
НаследованиеConstraintLayout Inheritance LayoutBase Inheritance OnDemandEventDispatcher Inheritance Object
Подклассы FormItemLayout

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10, AIR 1.5

Класс ConstraintLayout упорядочивает элементы макета в соответствии с их индивидуальными настройками и набором областей ограничений, определенных столбцами ограничения и строками ограничения. Хотя возможно использовать все свойства и ограничения из BasicLayout для изменения позиции или размеров элементов, ConstraintLayout предоставляет средства для создания макетов относительно родственных элементов путем ограничения элементов с учетом указанных столбцов и строк.

Примечание. Элементы управления 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.

Размер содержимого контейнера вычисляется как максимальная из координат правого нижнего угла всех элементов макета и областей ограничений.



Общедоступные свойства
 СвойствоОпределено
 InheritedclipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра.
LayoutBase
  constraintColumns : Vector.<ConstraintColumn>
Вектор экземпляров ConstraintColumn, разделяющих целевой контейнер.
ConstraintLayout
  constraintRows : Vector.<ConstraintRow>
Вектор экземпляров ConstraintRow, разделяющих целевой контейнер.
ConstraintLayout
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheriteddropIndicator : DisplayObject
DisplayObject, который этот макет использует для индикатора перетаскивания во время операции перетаскивания.
LayoutBase
 InheritedhorizontalScrollPosition : Number
Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента.
LayoutBase
 Inheritedtarget : GroupBase
Контейнер GroupBase, элементы которого измеряются, получают размер и располагаются с использованием этого макета.
LayoutBase
 InheritedtypicalLayoutElement : ILayoutElement
Используется макетами в тех случаях, когда необходимы фиксированные размеры строк/столбцов, но при этом определенные размеры не указаны.
LayoutBase
 InheriteduseVirtualLayout : Boolean
В контейнере может находиться любое число нижестоящих элементов.
LayoutBase
 InheritedverticalScrollPosition : Number
Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента.
LayoutBase
Общедоступные методы
 МетодОпределено
  
Конструктор.
ConstraintLayout
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
OnDemandEventDispatcher
 Inherited
Вычисляет местоположение перетаскивания в поставщике данных целевого объекта перетаскивания для указанного dragEvent.
LayoutBase
 Inherited
Если useVirtualLayout имеет значение true, этот метод может использоваться целевым объектом макета для очистки кэшированной информации о макете в случае изменения целевого объекта.
LayoutBase
 Inherited
Посылает событие в поток событий.
OnDemandEventDispatcher
 Inherited
Вызывается целевым объектом после добавления элемента макета и до того, как размер целевого объекта и список отображения будут проверены.
LayoutBase
 Inherited
Этот метод должен вызываться целевым объектом после удаления элемента макета и до того, как размер целевого объекта и список отображения будут проверены.
LayoutBase
 Inherited
Возвращает границы макета указанного элемента в виде элемента Rectangle или значения null, если индекс недействителен, соответствующий элемент имеет значение null, includeInLayout=false или значением свойства target этого макета является null.
LayoutBase
 Inherited
Возвращает изменение горизонтального положения прокрутки для работы с различными параметрами прокрутки.
LayoutBase
 Inherited
getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
Метод делегирования, определяющий, к какому элементу необходимо перейти на основе текущего элемента в фокусе и данных, вводимых пользователем в виде константы NavigationUnit.
LayoutBase
 Inherited
Вычисляет дельты verticalScrollPosition и horizontalScrollPosition, необходимые для прокрутки элемента под заданным индексом в видимую область.
LayoutBase
 Inherited
Возвращает изменение вертикального положения прокрутки для работы с различными параметрами прокрутки.
LayoutBase
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
OnDemandEventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Скрывает показанный ранее индикатор перетаскивания, созданный методом showDropIndicator(), удаляет его из списка отображения и также останавливает прокрутку перетаскивания.
LayoutBase
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Обеспечивает измерение размера целевого объекта по умолчанию на основе его содержимого и дополнительно измеряет минимальный размер целевого объекта по умолчанию.
LayoutBase
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
OnDemandEventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Размеры, положение и вышестоящие объекты индикатора перетаскивания, основанные на указанном местоположении перетаскивания.
LayoutBase
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Размеры и местоположения элементов целевого объекта.
LayoutBase
 Inherited
Вызывается целевым объектом в конце updateDisplayList для обновления scrollRect макета.
LayoutBase
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
OnDemandEventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
Вычисляет значение прокрутки для указанного dropLocation во время операции перетаскивания.
LayoutBase
 Inherited
Возвращает индекс, указывающий на то, где должен быть вставлен новый элемент, когда пользователь отпускает кнопку мыши в указанных координатах при завершении операции перетаскивания.
LayoutBase
 Inherited
Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания.
LayoutBase
 Inherited
Возвращает границы первого элемента макета, охватывающего верхний край scrollRect или находящегося над ним.
LayoutBase
 Inherited
Возвращает границы первого элемента макета, охватывающего нижний край scrollRect или находящегося ниже края.
LayoutBase
 Inherited
Возвращает границы первого элемента макета, охватывающего левый край scrollRect или находящегося слева от него.
LayoutBase
 Inherited
Возвращает границы первого элемента макета, охватывающего правый край scrollRect или находящегося справа от нее.
LayoutBase
 Inherited
Возвращает границы прямоугольника прокрутки целевого объекта в координатах макета.
LayoutBase
  
layoutContent(unscaledWidth:Number, unscaledHeight:Number):void
Располагает элементы целевого объекта макета с учетом текущей ширины и высоты столбцов и строк.
ConstraintLayout
  
measureAndPositionColumnsAndRows(constrainedWidth:Number = NaN, constrainedHeight:Number = NaN):void
Используется FormItemLayout для определения и установки новых показателей ширины столбца и высоты строки перед размещением элементов.
ConstraintLayout
 Inherited
Вызывается при изменении свойств 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, строки высоты процента добровольны и пригодны к их содержимому.





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.