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

BasicLayout  - AS3 Flex

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

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

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

Примечание. Элементы управления Spark на основе списка (элемент управления Spark List и его подклассы, такие как ButtonBar, ComboBox, DropDownList и TabBar) не поддерживают класс BasicLayout. Не следует использовать BasicLayout с элементами управления Spark на основе списка.

Для каждого элемента поддерживаются такие ограничения, как left, right, top, bottom, horizontalCenter, verticalCenter, baseline, percentWidth и percentHeight. При этом всегда учитываются минимальные и максимальные размеры элемента.

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

Вот несколько примеров вычисления измеренного размера:

  • Если контейнер содержит единственный элемент, для которого указано ограничение left, то измеренная ширина контейнера будет равна сумме предпочтительной ширины элемента плюс значение ограничения left.
  • Если контейнер содержит единственный элемент, для которого указано значение свойства percentWidth, то измеренная ширина контейнера будет равна предпочтительной ширине элемента. Даже если percentWidth элемента непосредственно не разложен на множители при вычислении, он будет учитываться во время вызова метода updateDisplayList().
  • Если контейнер содержит единственный элемент, для которого указано ограничение baseline, то измеренная высота контейнера будет равна сумме предпочтительной высоты элемента и baseline за вычетом значения свойства baselinePosition элемента.
  • Если контейнер содержит единственный элемент, для которого указано ограничение verticalCenter, то измеренная высота контейнера будет равна сумме предпочтительной высоты элемента и значения ограничения verticalCenter, умноженного на два.

При выполнении метода updateDisplayList() вычисляется размер элемента в соответствии с правилами, перечисленными согласно следующим приоритетам (при этом всегда учитывается минимальный и максимальный размер элемента):

  • Если для элемента установлено значение percentWidth или percentHeight, то его размер вычисляется как процентное значение от размера контейнера за вычетом всех ограничений: left, right, top или bottom.
  • Если элемент имеет и ограничение left, и ограничение right, его ширина определяется как ширина контейнера за вычетом ограничений left и right.
  • Если элемент имеет и ограничение top, и ограничение bottom, его высота определяется как высота контейнера за вычетом ограничений top и bottom.
  • Размер элемента устанавливается в соответствии с его предпочтительной шириной и/или высотой.

Класс BasicLayout вычисляет свой минимальный размер как максимальное значение минимальных размеров нижестоящих элементов:

  1. Для каждого нижестоящего элемента в контейнере следует определить минимальный размер, до которого можно сжать нижестоящий элемент:
    • Если границы нижестоящего элемента определены по высоте или ширине вышестоящего элемента, то этот нижестоящий элемент можно сжать до соответствующих минимальных размеров высоты и ширины. Используйте минимальный размер нижестоящего элемента.
    • Если пропорции нижестоящего элемента не ограничены размерами вышестоящего элемента, то для него сохраняется предпочтительный размер. Используйте предпочтительный размер нижестоящего элемента.
  2. Найдите максимальное значение размеров из шага 1.

Таким образом, если нижестоящий элемент ограничен размерами вышестоящего элемента, в макете используется минимальный размер нижестоящего элемента. В ином случае для вычисления минимального размера контейнера используется предпочтительный размер нижестоящего элемента.

Позиция элемента определяется согласно правилам с учетом следующих приоритетов:

  • Ограничения horizontalCenter или verticalCenter указывают расстояние между центром контейнера и центром элемента. Установите ограничения horizontalCenter или verticalCenter на нулевое значение, чтобы разместить элемент по центру контейнера по горизонтали или вертикали.
  • Если для элемента указано ограничение baseline, то элемент позиционируется в вертикальном направлении таким образом, что его baselinePosition (как правило, базовая линия первой линии текста) выравнивается по ограничению baseline.
  • Если для элемента указаны ограничения top или left, то элемент позиционируется таким образом, что верхний левый угол границ макета элемента смещается от верхнего левого угла контейнера в соответствии с указанными значениями.
  • Если для элемента указаны ограничения bottom или right, то элемент позиционируется таким образом, что правый нижний угол границ макета элемента смещается от правого нижнего угла контейнера в соответствии с указанными значениями.
  • Если ограничения относительно позиции в горизонтальном или вертикальном направлении не определены, то элемент размещается в соответствии с его координатами x и y.

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

Синтаксис MXMLexpandedСкрыть синтаксис MXML

The <s:BasicLayout> tag inherits all of the tag attributes of its superclass and adds no additional tag attributes:

  <s:BasicLayout/>
  


Общедоступные свойства
 СвойствоОпределено
 InheritedclipAndEnableScrolling : Boolean
Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра.
LayoutBase
 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
Общедоступные методы
 МетодОпределено
  
Конструктор.
BasicLayout
 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
 Inherited
Вызывается при изменении свойств verticalScrollPosition или horizontalScrollPosition.
LayoutBase
Сведения о конструкторе

BasicLayout

()Конструктор
public function BasicLayout()

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

Конструктор.





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

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