BasicLayout

Пакет	spark.layouts
Класс	public class BasicLayout
Наследование	BasicLayout LayoutBase OnDemandEventDispatcher 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.

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

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

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

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

Синтаксис MXML expanded

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

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

  <s:BasicLayout/>

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		clipAndEnableScrolling : Boolean Значение true определяет необходимость обрезки нижестоящих элементов в соответствии с границами области просмотра.	LayoutBase
		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

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		BasicLayout() Конструктор.	BasicLayout
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	OnDemandEventDispatcher
		calculateDropLocation(dragEvent:DragEvent):DropLocation Вычисляет местоположение перетаскивания в поставщике данных целевого объекта перетаскивания для указанного dragEvent.	LayoutBase
		clearVirtualLayoutCache():void Если useVirtualLayout имеет значение true, этот метод может использоваться целевым объектом макета для очистки кэшированной информации о макете в случае изменения целевого объекта.	LayoutBase
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	OnDemandEventDispatcher
		elementAdded(index:int):void Вызывается целевым объектом после добавления элемента макета и до того, как размер целевого объекта и список отображения будут проверены.	LayoutBase
		elementRemoved(index:int):void Этот метод должен вызываться целевым объектом после удаления элемента макета и до того, как размер целевого объекта и список отображения будут проверены.	LayoutBase
		getElementBounds(index:int):Rectangle Возвращает границы макета указанного элемента в виде элемента Rectangle или значения null, если индекс недействителен, соответствующий элемент имеет значение null, includeInLayout=false или значением свойства target этого макета является null.	LayoutBase
		getHorizontalScrollPositionDelta(navigationUnit:uint):Number Возвращает изменение горизонтального положения прокрутки для работы с различными параметрами прокрутки.	LayoutBase
		getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int Метод делегирования, определяющий, к какому элементу необходимо перейти на основе текущего элемента в фокусе и данных, вводимых пользователем в виде константы NavigationUnit.	LayoutBase
		getScrollPositionDeltaToElement(index:int):Point Вычисляет дельты verticalScrollPosition и horizontalScrollPosition, необходимые для прокрутки элемента под заданным индексом в видимую область.	LayoutBase
		getVerticalScrollPositionDelta(navigationUnit:uint):Number Возвращает изменение вертикального положения прокрутки для работы с различными параметрами прокрутки.	LayoutBase
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		hideDropIndicator():void Скрывает показанный ранее индикатор перетаскивания, созданный методом showDropIndicator(), удаляет его из списка отображения и также останавливает прокрутку перетаскивания.	LayoutBase
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		measure():void Обеспечивает измерение размера целевого объекта по умолчанию на основе его содержимого и дополнительно измеряет минимальный размер целевого объекта по умолчанию.	LayoutBase
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		showDropIndicator(dropLocation:DropLocation):void Размеры, положение и вышестоящие объекты индикатора перетаскивания, основанные на указанном местоположении перетаскивания.	LayoutBase
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		updateDisplayList(width:Number, height:Number):void Размеры и местоположения элементов целевого объекта.	LayoutBase
		updateScrollRect(w:Number, h:Number):void Вызывается целевым объектом в конце updateDisplayList для обновления scrollRect макета.	LayoutBase
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	OnDemandEventDispatcher

Защищенные методы

Скрыть унаследованные защищенные методы

Показать унаследованные защищенные методы

	Метод		Определено
		calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point Вычисляет значение прокрутки для указанного dropLocation во время операции перетаскивания.	LayoutBase
		calculateDropIndex(x:Number, y:Number):int Возвращает индекс, указывающий на то, где должен быть вставлен новый элемент, когда пользователь отпускает кнопку мыши в указанных координатах при завершении операции перетаскивания.	LayoutBase
		calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания.	LayoutBase
		getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle Возвращает границы первого элемента макета, охватывающего верхний край scrollRect или находящегося над ним.	LayoutBase
		getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle Возвращает границы первого элемента макета, охватывающего нижний край scrollRect или находящегося ниже края.	LayoutBase
		getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle Возвращает границы первого элемента макета, охватывающего левый край scrollRect или находящегося слева от него.	LayoutBase
		getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle Возвращает границы первого элемента макета, охватывающего правый край scrollRect или находящегося справа от нее.	LayoutBase
		getScrollRect():Rectangle Возвращает границы прямоугольника прокрутки целевого объекта в координатах макета.	LayoutBase
		scrollPositionChanged():void Вызывается при изменении свойств verticalScrollPosition или horizontalScrollPosition.	LayoutBase

Сведения о конструкторе

()

Конструктор

public function BasicLayout()

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 4

Версии среды выполнения:

Flash Player 10, AIR 1.5

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

Юридическая информация | Политика конфиденциальности онлайн

BasicLayout - AS3 Flex

Классы x

BasicLayout