mx.containersCanvas Контейнер макетов Halo Canvas определяет прямоугольную область, в которой размещаются нижестоящие контейнеры и элементы управления. The <mx:Canvas> tag inherits all the tag attributes of its superclass. Use the following syntax:

  <mx:Canvas>
    ...
      child tags
    ...
  </mx:Canvas>

]]>mx.containers.utilityClasses:IConstraintLayoutmx.core:Container Контейнер макетов Halo Canvas определяет прямоугольную область, в которой размещаются нижестоящие контейнеры и элементы управления. Это единственный контейнер, который позволяет явно указать местоположение нижестоящих элементов внутри контейнера с помощью свойств x и y каждого нижестоящего элемента.

Примечание. Adobe рекомендует вместо контейнеров Halo Canvas использовать по возможности контейнеры Spark с BasicLayout.

Flex устанавливает нижестоящие элементы контейнера макетов Canvas с предпочтительной шириной и предпочтительной высотой. Значение для предпочтительной ширины нижестоящего элемента можно отменить путем установки для свойства width фиксированного значения в пикселях или процентной доли от размера контейнера. Аналогичным образом можно установить предпочтительную высоту.

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

Контейнер Canvas имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Достаточно большой для включения всех нижестоящих элементов с размерами по умолчанию Заполнение по умолчанию 0 пикселей для значений нижнего, верхнего, левого и правого края

mx.core.Container

Canvas Конструктор. Конструктор. measure Вычисляет предпочтительный минимальный и предпочтительный максимальный размеры контейнера Canvas. Вычисляет предпочтительный минимальный и предпочтительный максимальный размеры контейнера Canvas.

Значение measuredWidth контейнера Canvas является достаточно большим для отображения всех нижестоящих элементов с предпочтительной шириной без отсечения. Метод measure() вычисляет позицию самого правого нижестоящего элемента и расположение его правого края, а затем добавляет пространство в соответствии с толщиной границы контейнера Canvas и заполнения справа. Значение measuredHeight вычисляется аналогично.

Значения свойств контейнера Canvas minWidth и minHeight не вычисляются. Таким образом, Flex использует значение по умолчанию, равное 0.

Значения свойств контейнера Canvas maxWidth и maxHeight не вычисляются. Предполагается, что максимальная высота и ширина контейнера являются бесконечными величинами.

Все описанные выше значения являются измеренными значениями ширины и высоты контейнера Canvas. Пользователь может отменить измеренные значения путем явного предоставления значений для следующих свойств:

ширина
height
minWidth
minHeight
maxWidth
maxHeight

Этот метод не вызывается напрямую. Он вызывается в соответствующий момент посредством Flex LayoutManager. При запуске приложения Flex LayoutManager перед установкой окончательных размеров выполняет попытку измерить все компоненты от нижестоящих до вышестоящих.

Этот расширенный метод рекомендуется использовать при обработке подклассов. При отмене этого метода реализация должна выполнить вызов метода super.measure() или установить значения для свойств measuredHeight и measuredWidth. Также можно дополнительно установить значения для следующих свойств:

measuredMinWidth
measuredMinHeight

Эти свойства соответствуют описанным выше свойствам макетов, поэтому их отдельное описание не приводится.

updateDisplayList Устанавливает размер каждого нижестоящего элемента для контейнера.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Устанавливает размер каждого нижестоящего элемента для контейнера.

Контейнер Canvas не изменяет позиции своих нижестоящих элементов. Каждый нижестоящий элемент размещается в соответствии со значениями свойств x и y.

Контейнер Canvas устанавливает ширину и высоту каждого нижестоящего элемента в соответствии со значениями свойств measuredWidth и measuredHeight этого элемента, если значения width и height не предоставляются. Нижестоящий элемент может также иметь изменяемый размер. Для этого значения свойств width и/или height устанавливаются в процентах. Нижестоящие элементы с изменяемым размером привязаны к правому нижнему краю контейнера Canvas. В этом случае значения свойств minWidth, minHeight, maxWidth и maxHeight не игнорируются.

Этот метод не вызывается напрямую. Он вызывается в соответствующий момент посредством Flex LayoutManager. При запуске приложения Flex LayoutManager выполняет вызов метода updateDisplayList() в каждом компоненте, начиная с объекта Application и далее в нисходящем направлении.

Этот расширенный метод рекомендуется использовать при обработке подклассов. При отмене этого метода реализация должна выполнить вызов методов super.updateDisplayList(), move() и setActualSize() в каждом нижестоящем элементе. При создании макета необходимо получить размер этого контейнера на основе значений свойств unscaledWidth и unscaledHeight, а не свойств width и height. Свойства width и height не учитывают значения свойств scaleX и scaleY для этого контейнера.

constraintColumns constraintRows FormItemDirection Класс FormItemDirection определяет значения констант для свойства direction класса FormItem.Object Класс FormItemDirection определяет значения констант для свойства direction класса FormItem.

mx.containers.FormItem

HORIZONTAL Указывает, что нижестоящие элементы контейнера FormItem располагаются горизонтально.horizontal Указывает, что нижестоящие элементы контейнера FormItem располагаются горизонтально. VERTICAL Указывает, что нижестоящие элементы контейнера FormItem располагаются вертикально.vertical Указывает, что нижестоящие элементы контейнера FormItem располагаются вертикально. DividedBox Контейнер DividedBox измеряет и располагает свои нижестоящие элементы горизонтально или вертикально, аналогично контейнеру Box, но при этом вставляет в промежутки между нижестоящими элементами перетаскиваемые разделители.The <mx:DividedBox> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:DividedBox
    Properties
    liveDragging="false|true"
    resizeToContent="false|true"
  
    Styles
    dividerAffordance="6"
    dividerAlpha="0.75"
    dividerColor="0x6F7777"
    dividerSkin="'mx.skins.BoxDividerSkin' symbol in Assets.swf"
    dividerThickness="3"
    horizontalDividerCursor="'mx.skins.cursor.HBoxDivider' symbol in Assets.swf"
    verticalDividerCursor="'mx.skins.cursor.VBoxDivider' symbol in Assets.swf"
 
    Events
    dividerPress="No default"
    dividerDrag="No default"
    dividerRelease="No default"
    >
      ...
      child tags
      ...
  </mx:DividedBox>

]]>mx.containers:Box Контейнер DividedBox измеряет и располагает свои нижестоящие элементы горизонтально или вертикально, аналогично контейнеру Box, но при этом вставляет в промежутки между нижестоящими элементами перетаскиваемые разделители. Пользователи могут перетащить любой разделитель для изменения размеров нижестоящих элементов с каждой стороны.

Класс DividedBox является базовым классом для более часто используемых классов HDividedBox и VDividedBox.

Свойство direction контейнера DividedBox, унаследованное от контейнера Box, определяет горизонтальный или вертикальный макет.

Контейнеры DividedBox, HDividedBox или VDividedBox имеют следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Вертикальный DividedBox Высота является достаточной для включения всех нижестоящих элементов с высотой по умолчанию или явной высотой, любых вертикальных промежутков между нижестоящими элементами, а также заполнения контейнера снизу и сверху. Ширина соответствует сумме ширины по умолчанию или явной ширины наиболее широкого нижестоящего элемента и заполнения контейнера слева и справа. Горизонтальный DividedBox Ширина является достаточной для включения всех нижестоящих элементов с шириной по умолчанию или явной шириной, любого горизонтального промежутка между нижестоящими элементами, а также заполнения контейнера слева и справа. Высота соответствует сумме высоты по умолчанию или явной высоты наиболее высокого нижестоящего элемента и заполнения контейнера сверху и снизу. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева. Промежуток по умолчанию 10 пикселей для горизонтальных и вертикальных промежутков.

mx.containers.HDividedBoxmx.containers.VDividedBox

dividerRelease Передается в момент, когда пользователь отпускает разделитель.mx.events.DividerEvent.DIVIDER_RELEASEmx.events.DividerEvent Передается в момент, когда пользователь отпускает разделитель. Событие dividerRelease передается после события dividerDrag, но до изменения нижестоящих элементов контейнера. Свойства разделителя x и y не обновляются до инициирования этого события. В результате при вызове hDividerBox.getDividerAt(0).x возвращается значение исходной позиции x для первого разделителя. Если требуется установить позицию разделителя после перемещения, можно получить доступ к этому значению после инициирования события updateComplete для DividerBox. dividerPress Передается при нажатии пользователем любого разделителя в этом контейнере.mx.events.DividerEvent.DIVIDER_PRESSmx.events.DividerEvent Передается при нажатии пользователем любого разделителя в этом контейнере. Событие dividerPress передается до любого события dividerDrag. dividerDrag Передается несколько раз при перетаскивании пользователем любого разделителя.mx.events.DividerEvent.DIVIDER_DRAGmx.events.DividerEvent Передается несколько раз при перетаскивании пользователем любого разделителя. Событие dividerDrag передается после события dividerPress и до события dividerRelease. DividedBox Конструктор. Конструктор. getDividerAt Возвращает ссылку на указанный объект BoxDivider в данном контейнере DividedBox.Объект BoxDivider. mx.containers.dividedBoxClasses:BoxDivideriОтсчитываемый от нуля индекс разделителя: слева направо для горизонтального DividedBox или сверху вниз для вертикального DividedBox. Возвращает ссылку на указанный объект BoxDivider в данном контейнере DividedBox. moveDivider Перемещает определенный разделитель на указанное количество пикселей.iОтсчитываемый от нуля индекс разделителя: слева направо для горизонтального DividedBox или сверху вниз для вертикального DividedBox. amtКоличество пикселей, на которое требуется переместить разделитель. Для перемещения разделителя вверх или влево можно указать отрицательное количество. При этом перемещение разделителя ограничено, как и при его перемещении пользователем. Перемещает определенный разделитель на указанное количество пикселей. dividerClass Класс для разделителя между нижестоящими элементами.mx.containers.dividedBoxClasses.BoxDivider Класс для разделителя между нижестоящими элементами. liveDragging Если значение равно true, смежные с разделителем нижестоящие элементы непрерывно изменяют свой размер при перетаскивании пользователем.falsefalse Если значение равно true, смежные с разделителем нижестоящие элементы непрерывно изменяют свой размер при перетаскивании пользователем. Если значение равно false, они не изменяются до тех пор, пока пользователь не отпустит разделитель. numDividers Количество разделителей. Количество разделителей. Количество всегда соответствует значению numChildren -1. resizeToContent Если значение равно true, DividedBox автоматически изменяет свой размер в соответствии с размером нижестоящих элементов.false Если значение равно true, DividedBox автоматически изменяет свой размер в соответствии с размером нижестоящих элементов. ApplicationControlBar В контейнере ApplicationControlBar содержатся компоненты, которые обеспечивают глобальную навигацию и команды приложения для контейнера Halo Application. В Flex 4 компонент ApplicationControlBar больше не требуется. Используйте свойство controlBarContent класса Spark Application для определения набора компонентов, включаемых в область панели управления. Используйте свойство controlBarLayout класса Spark Application для определения шаблона области панели управления. The <mx:ApplicationControlBar> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes. Unlike the ControlBar container, it is possible to set the backgroundColor style for an ApplicationControlBar container.

  <mx:ApplicationControlBar
    Properties
    dock="false|true"
  
    Styles
    fillAlphas="[0, 0]"
    fillColors="[0xFFFFFF, 0xFFFFFF]"
    >
    ...
      child tags
    ...
  </mx:ApplicationControlBar>

]]>mx.containers:ControlBar В контейнере ApplicationControlBar содержатся компоненты, которые обеспечивают глобальную навигацию и команды приложения для контейнера Halo Application. Например, ApplicationControlBar для редактора может включать элементы управления Button (для настройки плотности шрифта), ComboBox (для выбора шрифта) и MenuBar (для выбора режима редактирования). Как правило, контейнер ApplicationControlBar помещается в верхней области контейнера Halo Application.

Примечание. Контейнер Spark Application не поддерживает контейнер ApplicationControlBar. Для добавления этой функции измените тему оформления контейнера Spark Application.

Контейнер ApplicationControlBar может находиться в любом из следующих режимов:

Прикрепленный режим: панель всегда находится в верхней области рисования и становится частью стиля оформления приложения. Линейки прокрутки на уровне приложения для компонента не применяются, поэтому он всегда располагается в верхней части видимой области, а панель растягивается на ширину приложения. Для создания прикрепленной панели установите для свойства dock значение true.
Обычный режим: панель можно поместить в любое место окна приложения, установив ее размеры и позиции аналогично любому другому компоненту. При этом при прокрутке панель будет прокручиваться вместе с окном приложения. Для создания стандартной панели установите для свойства dock значение false (по умолчанию).

Для контейнера ApplicationControlBar по умолчанию установлены следующие характеристики размеров:

ХарактеристикаОписание Размер по умолчанию Высота соответствует сумме высоты по умолчанию или явной высоты наиболее высокого нижестоящего элемента и заполнения контейнера сверху и снизу. В обычном режиме ширина является достаточной для включения всех нижестоящих элементов с высотой по умолчанию или явной высотой нижестоящих элементов, любого горизонтального промежутка между нижестоящими элементами, а также для заполнения контейнера справа и слева. В прикрепленном режиме ширина равна ширине приложения. Если ширина приложения не позволяет вместить все элементы управления в контейнере ApplicationControlBar, панель отсекается. Заполнение по умолчанию 5 пикселей для значения верхнего края. 4 пикселей для значения нижнего края. 8 пикселей для значений левого и правого краев.

mx.core.Application

ApplicationControlBar Конструктор. Конструктор. dock Если значение равно true, ApplicationControlBar должен быть прикреплен в верхней области приложения.false Если значение равно true, ApplicationControlBar должен быть прикреплен в верхней области приложения. Если значение равно false, размер и позиция ApplicationControlBar определяются так же, как и для любого другого компонента. Это свойство поддерживается в случае, если для приложения установлен тип Application. В противном случае значение dock какого-либо воздействия не имеет. HDividedBox В контейнере HDividedBox нижестоящие элементы располагаются так же, как и в контейнере HBox, но при этом в промежуток между каждым нижестоящим элементом вставляется перетаскиваемый разделитель.The <mx:HDividedBox> tag inherits all of the tag attributes of its superclass except direction and adds no new tag attributes.

]]>mx.containers:DividedBox В контейнере HDividedBox нижестоящие элементы располагаются так же, как и в контейнере HBox, но при этом в промежуток между каждым нижестоящим элементом вставляется перетаскиваемый разделитель. Пользователь может перетащить разделитель для изменения размеров области, выделенной для каждого нижестоящего элемента. Тег <mx:HDividedBox/> идентичен <mx:DividedBox direction="horizontal"/>.

Контейнер HDividedBox имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Ширина является достаточной для включения всех нижестоящих элементов с шириной по умолчанию или явной шириной, любого горизонтального промежутка между нижестоящими элементами, а также для заполнения контейнера слева и справа. Высота соответствует сумме высоты по умолчанию или явной высоты наиболее высокого нижестоящего элемента и заполнения контейнера сверху и снизу. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева. Промежуток по умолчанию 10 пикселей для горизонтальных и вертикальных промежутков.

mx.containers.DividedBoxmx.containers.VDividedBox

HDividedBox Конструктор. Конструктор. Grid Контейнер Grid позволяет размещать нижестоящие элементы в виде строк и столбцов ячеек, аналогично таблице HTML.The <mx:Grid> tag inherits all of the tag attributes of its superclass, except the Box.direction property, and adds the following tag attributes:

  <mx:Grid
    Styles
    horizontalGap="8"
    verticalGap="6"
    >
      ...
    These child tags are examples only:
       <mx:GridRow id="row1">
        <mx:GridItem
          rowSpan="1"
          colSpan="1">
            <mx:Button label="Button 1"/>
        </mx:GridItem>
        ...
       </mx:GridRow>
    ...
  </mx:Grid>

]]>mx.containers:Box Контейнер Grid позволяет размещать нижестоящие элементы в виде строк и столбцов ячеек, аналогично таблице HTML. Контейнер Grid содержит одну или несколько строк. Каждая строка может содержать одну или несколько ячеек/элементов. Для определения элементов управления Grid используются следующие теги:

Тег <mx:Grid> определяет контейнер Grid.
Тег <mx:GridRow> определяет строку сетки с одной или несколькими ячейками. Строка сетки должна являться нижестоящим элементом тега <Grid>.
Тег <mx:GridItem> определяет ячейку сетки и должен являться нижестоящим элементом тега <GridRow>. Тег <mx:GridItem> может содержать любое количество нижестоящих элементов.

Все ячейки в одной строке имеют одинаковую высоту, но высота каждой строки может быть различной. Все ячейки в одной строке имеют одинаковую ширину, но каждый столбец может иметь различную ширину. Для каждой строки или каждого столбца контейнера Grid можно определить разное количество ячеек. Кроме того, ячейка может включать несколько столбцов или строк контейнера.

Контейнеры Grid, GridRow и GridItem имеют следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Высота сетки Сумма высот по умолчанию или явных высот всех строк и промежутков между строками. Ширина сетки Сумма значений ширины по умолчанию или явной ширины всех столбцов и промежутков между столбцами. Высота каждой строки и каждой ячейки. Высота по умолчанию или явная высота наиболее высокого элемента в строке. Если контейнер GridItem не имеет явного размера, его высота по умолчанию соответствует высоте по умолчанию или явной высоте нижестоящего элемента в ячейке. Ширина каждого столбца и каждой ячейки. Ширина по умолчанию или явная ширина по умолчанию наиболее широкого элемента в столбце. Если контейнер GridItem не имеет явной ширины, ширина по умолчанию соответствует ширине по умолчанию или явной ширине нижестоящего элемента в ячейке. Промежуток между строками и столбцами. Определяется стилями horizontalGap и verticalGap класса Grid. Значением по умолчанию для обоих промежутков является 6 пикселей. Заполнение по умолчанию 0 пикселей для значений верхнего, нижнего, правого и левого края всех трех контейнерных классов.

mx.containers.GridRowmx.containers.GridItem

Grid Конструктор. Конструктор. measure Вычисляет предпочтительный, минимальный и максимальный размеры контейнера Grid. Вычисляет предпочтительный, минимальный и максимальный размеры контейнера Grid.

Этот метод не вызывается напрямую; он является расширенным методом для использования в подклассах. Вызов метода measure() выполняется в соответствующий момент посредством LayoutManger Flex. При запуске приложения Flex LayoutManager перед установкой окончательных размеров выполняет попытку измерить все компоненты от нижестоящих до вышестоящих.

Для получения представления о вычислении измерений контейнером Grid предположим, что в каждом контейнере GridItem для свойств rowSpan и colSpan установлено значение 1. Измеренная ширина первого столбца контейнера Grid равна максимальному значению из измеренных значений ширины всех контейнеров GridItem в первом столбце. Аналогично, измеренная ширина второго столбца равна максимальному значению из значений ширины всех контейнеров GridItem во втором столбце и т. д. Значение measuredWidth для всего контейнера Grid представляет собой сумму значений измеренной ширины всех столбцов, толщины границы, заполнения слева и справа и горизонтального промежутка между смежными ячейками сетки.

Значения свойств measuredHeight, minWidth, minHeight, maxWidth и maxHeight вычисляются аналогичным способом путем сложения значений свойств контейнеров GridItem measuredHeight, свойств minWidth и т. д.

Если для контейнера GridItem свойство colSpan имеет значение 3, то контейнер GridItem measuredWidth будет поделен на 3 столбца. Если measuredWidth делится на равные части, каждый из трех столбцов вычисляет свою измеренную ширину так, как если бы контейнер GridItem находился только в этом столбце, а ширина measuredWidth для контейнера GridItem составляла одну треть от фактического значения.

Однако свойство measuredWidth контейнера GridItem не всегда делится на равные части для всех включенных столбцов. Если для некоторых столбцов значение свойства width установлено в процентах, свойствоmeasuredWidth контейнера GridItem делится соответственно для предоставления каждому столбцу запрашиваемого процента от объема контейнера Grid.

Все описанные выше значения представляют собой измеренные значения ширины и высоты контейнера Grid. Пользователь может отменить измеренные значения путем явного ввода значений для следующих свойств:

minHeight
minWidth
maxHeight
maxWidth
height
ширина

При отмене этого метода реализация должна выполнить вызов метода super.measure() или установить значения для свойств measuredHeight и measuredWidth. Также можно дополнительно установить значения для следующих свойств:

measuredMinWidth
measuredMinHeight

Эти свойства соответствуют описанным выше свойствам макетов, поэтому их отдельное описание не приводится.

updateDisplayList Устанавливает размер и позицию каждого нижестоящего элемента для контейнера Grid.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Устанавливает размер и позицию каждого нижестоящего элемента для контейнера Grid.

Этот метод не вызывается напрямую; он является расширенным методом для использования в подклассах. Вызов метода updateDisplayList выполняется в соответствующий момент посредством Flex LayoutManager. При запуске приложения Flex LayoutManager выполняет вызов метода updateDisplayList() в каждом компоненте, начиная с корня и далее в нисходящем направлении.

Для контейнера Grid выполняются те же правила создания макетов, что и для контейнера VBox. Позиции и размеры контейнеров GridRow определяются так же, как позиции и размеры нижестоящих элементов контейнера VBox. Аналогично, контейнер GridRow размещает свои контейнеры GridItem с использованием подобного алгоритма создания макетов контейнера HBox.

Единственным различием является то, что контейнеры GridRow связаны друг с другом и, таким образом, они все выбирают одни и те же позиции и размеры для своих нижестоящих элементов (для выравнивания столбцов контейнера Grid).

При отмене этого метода реализация должна выполнить вызов методов super.updateDisplayList(), move() и setActualSize() в каждом нижестоящем элементе. При создании макета необходимо получить размер этого контейнера на основе значений свойств unscaledWidth и unscaledHeight, а не свойств width и height. Свойства width и height не учитывают значения свойств scaleX и scaleY для этого контейнера.

TabNavigator Контейнер MX TabNavigator расширяет контейнер MX ViewStack путем включения контейнера TabBar для перемещения между его нижестоящими элементами.The <mx:TabNavigator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:TabNavigator
    Styles
    firstTabStyleName="Value of the tabStyleName property"
    focusAlpha="0.4"
    focusRoundedCorners="tl tr bl br"
    horizontalAlign="left|center|right"
    horizontalGap="-1"
    lastTabStyleName="Value of the tabStyleName property"
    selectedTabTextStyleName="undefined"
    tabHeight="undefined"
    tabOffset="0"
    tabStyleName="Name of CSS style declaration that specifies styles for the tabs"
    tabWidth="undefined"
    >
      ...
      child tags
      ...
  </mx:TabNavigator>

]]>mx.managers:IFocusManagerComponentmx.containers:ViewStack Контейнер MX TabNavigator расширяет контейнер MX ViewStack путем включения контейнера TabBar для перемещения между его нижестоящими элементами.

Примечание. Прямые нижестоящие элементы контейнера навигатора MX должны быть контейнерами MX (контейнерами макета MX или навигатора MX) или контейнером Spark NavigatorContent. В навигатор невозможно вложить элемент управления или контейнер Spark, не являющийся контейнером Spark NavigatorContent, напрямую. Вложения должны быть нижестоящими элементами нижестоящего контейнера MX.

Аналогично контейнеру ViewStack, контейнер TabNavigator имеет коллекцию нижестоящих контейнеров, в которых в конкретный момент отображается только один нижестоящий элемент. Flex автоматически создает контейнер TabBar в верхней области контейнера TabNavigator, при этом каждому нижестоящему контейнеру соответствует своя вкладка. Каждая вкладка может иметь собственную метку и значок. При выборе вкладки пользователем соответствующий нижестоящий контейнер становится видимым и отображается как выбранный нижестоящий элемент из контейнера TabNavigator.

При изменении видимого в данный момент нижестоящего контейнера можно использовать свойство hideEffect скрытого контейнера и свойство showEffect последнего отображенного нижестоящего контейнера для применения эффекта в нижестоящих контейнерах. Перед отображением нового нижестоящего контейнера контейнер TabNavigator ожидает завершения скрытия нижестоящего контейнера hideEffect. Применение эффекта можно остановить в процессе путем изменения свойства selectedIndex контейнера TabNavigator.

Для определения внешнего вида вкладок в TabNavigator используются свойства стиля в селекторе типа вкладки Tab, как показано в примере:

  <fx:Style>
    @namespace mx "library://ns.adobe.com/flex/mx"
    mx|Tab {
       fillColors: #006699, #cccc66;
       upSkin: ClassReference("CustomSkinClass");
       overSkin: ClassReference("CustomSkinClass");
       downSkin: ClassReference("CustomSkinClass");
    }  
  </fx:Style>

Селектор типа Tab определяет значения в скрытом классе mx.controls.tabBarClasses.Tab. Значения по умолчанию для селектора типа Tab определены в файле defaults.css.

С помощью свойства стиля tabStyleName можно также определить стили в селекторе класса, например:

  <fx:Style>
    @namespace mx "library://ns.adobe.com/flex/mx"
    mx|TabNavigator {
       tabStyleName:myTabStyle;
    }
 
    .myTabStyle {
       fillColors: #006699, #cccc66;
       upSkin: ClassReference("CustomSkinClass");
       overSkin: ClassReference("CustomSkinClass");
       downSkin: ClassReference("CustomSkinClass");
    }
  </fx:Style>

Контейнер TabNavigator имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Суммы ширины и высоты по умолчанию или явной ширины и высоты первого активного нижестоящего элемента, и высоты и ширины по умолчанию или явной высоты и ширины вкладки. Высота вкладок по умолчанию определяется шрифтом, стилем и темой оформления, применяемыми для контейнера TabNavigator. Правила изменения размеров контейнеров По умолчанию размер контейнеров TabNavigator устанавливается только один раз в соответствии с размером первого нижестоящего контейнера. Он не изменяется при перемещении к другим нижестоящим контейнерам. Для принудительного изменения размеров контейнеров TabNavigator при переходе к другому нижестоящему контейнеру установите для свойства resizeToContent значение true. Правила создания макетов для нижестоящих элементов Если размер нижестоящего элемента превышает размер контейнера TabNavigator, этот элемент отсекается. Если размер нижестоящего элемента меньше размера контейнера TabNavigator, то этот элемент выравнивается по верхнему левому углу контейнера TabNavigator. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева.

mx.containers.ViewStackmx.controls.TabBar

TabNavigator Конструктор. Конструктор. getTabAt Возвращает вкладку элемента управления TabBar навигатора с указанным индексом.Вкладка с указанным индексом. mx.controls:ButtonindexИндекс в элементе управления TabBar навигатора. Возвращает вкладку элемента управления TabBar навигатора с указанным индексом. measure Вычисляет размеры по умолчанию, а также минимальное и максимальное значения для данного контейнера TabNavigator. Вычисляет размеры по умолчанию, а также минимальное и максимальное значения для данного контейнера TabNavigator. Для получения дополнительной информации о методе measure() см. описание метода UIComponent.measure().

Контейнер TabNavigator использует ту же логику измерения, что и контейнер ViewStack с двумя отличиями: во-первых, для размещения вкладок увеличивается значение свойствmeasuredHeight и measuredMinHeight. Во-вторых, для обеспечения минимальной ширины каждой вкладки в 30 пикселей увеличивается значение свойства measuredWidth.

mx.core.UIComponent.measure()mx.containers.ViewStack.measure()

updateDisplayList Реагирует на изменения размера путем установления позиций и размеров вкладок данного контейнера и его нижестоящих элементов.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Реагирует на изменения размера путем установления позиций и размеров вкладок данного контейнера и его нижестоящих элементов. Для получения дополнительной информации о методе updateDisplayList() см. описание метода UIComponent.updateDisplayList().

Контейнер TabNavigator размещает контейнер TabBar в своей верхней области. Ширина TabBar устанавливается по ширине TabNavigator, а высота TabBar определяется на основе значения свойства tabHeight.

Контейнер TabNavigator определяет для своих нижестоящих элементов позиции и размеры под TabBar с использованием той же логики, что и в контейнере ViewStack.

mx.core.UIComponent.updateDisplayList()

tabBar Ссылка на TabBar в данном TabNavigator.mx.controls:TabBar Ссылка на TabBar в данном TabNavigator. tabBarStyleFilters Набор стилей для передачи из TabNavigator в tabBar. Набор стилей для передачи из TabNavigator в tabBar.

mx.styles.StyleProxy

TileDirection Класс TileDirection определяет значения констант для свойства direction контейнера Tile.Object Класс TileDirection определяет значения констант для свойства direction контейнера Tile.

mx.containers.Tile

HORIZONTAL Указывает, что нижестоящие элементы контейнера Tile располагаются горизонтально; т. е. начиная с первой строки.horizontal Указывает, что нижестоящие элементы контейнера Tile располагаются горизонтально; т. е. начиная с первой строки. VERTICAL Указывает, что нижестоящие элементы контейнера Tile располагаются вертикально; т. е. начиная с первого столбца.vertical Указывает, что нижестоящие элементы контейнера Tile располагаются вертикально; т. е. начиная с первого столбца. HBox Контейнер Halo HBox размещает свои нижестоящие элементы в отдельной горизонтальной строке. The <mx:HBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>mx.containers:Box Контейнер Halo HBox размещает свои нижестоящие элементы в отдельной горизонтальной строке. Тег <mx:HBox> используется вместо тега <mx:Box> в качестве ярлыка, что позволяет избежать необходимости установки для свойства direction значения horizontal.

Примечание. Adobe рекомендует по возможности использовать с HorizontalLayout контейнеры Spark, а не контейнер HBox.

Контейнер HBox имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Ширина является достаточной для включения всех нижестоящих элементов с шириной по умолчанию или явной шириной, любого горизонтального промежутка между нижестоящими элементами, а также для заполнения контейнера слева и справа. Высота соответствует сумме высоты по умолчанию или явной высоты наиболее высокого нижестоящего элемента и заполнения для контейнера сверху и снизу. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева.

mx.core.Containermx.containers.Boxmx.containers.VBox

HBox Конструктор. Конструктор. VBox Контейнер Halo VBox располагает свои нижестоящие элементы в одном вертикальном столбце. The <mx:VBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>mx.containers:Box Контейнер Halo VBox располагает свои нижестоящие элементы в одном вертикальном столбце. Тег <mx:VBox> используется вместо тега <mx:Box> в качестве ярлыка, что позволяет избежать необходимости установки для свойства direction значения vertical.

Примечание. Adobe рекомендует по возможности использовать с VerticalLayout контейнеры Spark, а не контейнер Halo VBox.

Контейнер VBox имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Высота является достаточной для включения всех нижестоящих элементов с высотой по умолчанию или явной высотой, любых вертикальных промежутков между нижестоящими элементами, а также заполнения контейнера сверху и снизу. Ширина соответствует сумме ширины по умолчанию или явной ширины наиболее широкого нижестоящего элемента и заполнения контейнера слева и справа. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева.

mx.core.Containermx.containers.Boxmx.containers.HBox

VBox Конструктор. Конструктор. TitleWindow Контейнер макетов TitleWindow содержит строку заголовка, подпись, границу и область содержимого для нижестоящего элемента. The <mx:TitleWindow> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:TitleWindow
   Properties
   showCloseButton="false|true"
 
   Styles
   closeButtonDisabledSkin="'CloseButtonDisabled' symbol in Assets.swf"
   closeButtonDownSkin="'CloseButtonDown' symbol in Assets.swf"
   closeButtonOverSkin="'CloseButtonOver' symbol in Assets.swf"
   closeButtonUpSkin="'CloseButtonUp' symbol in Assets.swf"
  
   Events
   close="No default"
   >
    ...
      child tags
    ...
  />

]]>mx.containers:Panel Контейнер макетов TitleWindow содержит строку заголовка, подпись, границу и область содержимого для нижестоящего элемента. Как правило, для включения изолированных модулей приложения используются контейнеры TitleWindow. Например, можно включить форму в контейнер TitleWindow. При заполнении формы пользователем контейнер TitleWindow можно закрыть программным способом или разрешить пользователю закрыть его с помощью кнопки закрытия.

Контейнер TitleWindow имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Высота является достаточной для включения всех нижестоящих элементов в область содержимого с высотой по умолчанию или явной высотой, строки заголовка и границы, любого вертикального промежутка между нижестоящими элементами, а также для заполнения контейнера сверху и снизу. Ширина соответствует сумме наибольшего значения ширины по умолчанию или явного значения наиболее широкого нижестоящего элемента и заполнения правой и левой границ контейнера или ширины текста заголовка. границы 10 пикселей для значений левого и правого краев. 2 пикселя для значения верхнего края. 0 пикселей для значения нижнего края. заполнение 4 пикселя для значений заполнения сверху, снизу, справа и слева.

mx.core.Applicationmx.managers.PopUpManagermx.containers.Panel

close Передается при нажатии пользователем кнопки закрытия.3985 mx.events.CloseEvent.CLOSEmx.events.CloseEventсобытие close Передается при нажатии пользователем кнопки закрытия. TitleWindow Конструктор. Конструктор. showCloseButton Требуется ли отображать кнопку закрытия в контейнере TitleWindow.3986 false Если значение равно true, кнопка закрытия отображается. Требуется ли отображать кнопку закрытия в контейнере TitleWindow. Значение по умолчанию false. Для отображения кнопки закрытия установите значение true. При нажатии кнопки закрытия создается событие close, но контейнер TitleWindow не закрывается. Необходимо написать программу обработки для события close и закрыть с ее помощью TitleWindow. FormHeading Контейнер FormHeading используется для отображения заголовка группы элементов управления в контейнере Form. The <mx:FormHeading> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:FormHeading
    Properties
    label=""
  
    Styles
    color="0x0B333C"
    disabledColor="0xAAB3B3"
    fontAntiAliasType="advanced|normal"
    fontFamily="Verdana"
    fontGridFitType="pixel|subpixel|none"
    fontSharpness="0"
    fontSize="12"
    fontStyle="normal|italic"
    fontThickness="0"
    fontWeight="normal|bold"
    indicatorGap="14"
    labelWidth="Calculated"
    leading="2"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
    textAlign="Calculated"
    textDecoration="none|underline"
    textIndent="0"
  />

]]>mx.core:UIComponent Контейнер FormHeading используется для отображения заголовка группы элементов управления в контейнере Form. Левый край заголовка выравнивается по левому краю элементов управления в форме. В один контейнер Form можно включить несколько контейнеров FormHeading.

mx.containers.Formmx.containers.FormItem

FormHeading Конструктор. Конструктор. label Текст заголовка формы. Текст заголовка формы. Accordion Контейнер навигатора MX Accordion имеет коллекцию нижестоящих контейнеров MX или контейнеров Spark NavigatorContent. При этом в каждый конкретный момент видимым является только один нижестоящий элемент.The <mx:Accordion> tag inherits all of the tag attributes of its superclass, with the exception of scrolling-related attributes, and adds the following tag attributes:

  <mx:Accordion
    Properties
    headerRenderer="IFactory"
    historyManagementEnabled="true|false"
    resizeToContent="false|true"
    selectedChild"A reference to the first child"
    selectedIndex="undefined"
  
    Styles
    headerHeight="depends on header font styles"
    headerStyleName="No default"
    horizontalGap="8"
    openDuration="250"
    openEasingFunction="undefined"
    paddingBottom="-1"
    paddingTop="-1"
    textRollOverColor="0xB333C"
    textSelectedColor="0xB333C"
    verticalGap="-1"
  
    Events
    change="No default"
    >
      ...
      child tags
      ...
  </mx:Accordion>

]]>Контейнер Accordion позволяет осуществлять навигацию между различными нижестоящими ракурсами. mx.managers:IHistoryManagerClientmx.managers:IFocusManagerComponentmx.core:Container Контейнер навигатора MX Accordion имеет коллекцию нижестоящих контейнеров MX или контейнеров Spark NavigatorContent. При этом в каждый конкретный момент видимым является только один нижестоящий элемент. Он создает и осуществляет управление кнопками навигатора (заголовками Accordion), которые используются для перемещения между нижестоящими элементами. С каждым нижестоящим контейнером связана отдельная кнопка навигатора. Каждая кнопка навигатора принадлежит контейнеру Accordion, а не нижестоящему элементу. При нажатии пользователем кнопки навигатора отображается связанный нижестоящий контейнер. При переходе к новому нижестоящему элементу пользователю будет показано с помощью анимации, что один нижестоящий элемент исчезает, а другой появляется.

Контейнер Accordion не расширяет контейнер ViewStack, но реализует все свойства, методы, стили и события контейнера ViewStack, например selectedIndex и selectedChild.

Контейнер Accordion имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Ширина и высота нижестоящего элемента, активного в настоящий момент. Правила изменения размеров контейнеров Размер контейнеров Accordion устанавливается только один раз в соответствии с размером первого нижестоящего контейнера по умолчанию. Он не изменяется при переходе к другим нижестоящим контейнерам по умолчанию. Для принудительного изменения размера контейнера Accordion при переходе к другому нижестоящему контейнеру установите для свойства resizeToContent значение true. Правила установки размеров нижестоящих элементов Размер нижестоящего элемента устанавливается в соответствии с размером по умолчанию. Нижестоящий элемент отсекается, если его размер превышает размер контейнера Accordion. Если размер нижестоящего элемента меньше размера контейнера Accordion, он выравнивается по верхнему левому углу контейнера Accordion. Заполнение по умолчанию -1 пиксель для значений заполнения сверху, снизу, слева и справа.

mx.containers.accordionClasses.AccordionHeader

change Передается при изменении выбранного нижестоящего контейнера.3012 mx.events.IndexChangedEvent.CHANGEmx.events.IndexChangedEventсобытие change. Передается при изменении выбранного нижестоящего контейнера. Accordion Конструктор. Конструктор. getHeaderAt Возвращает ссылку на кнопку навигатора для нижестоящего контейнера.Объект кнопки, представляющий кнопку навигатора. mx.controls:ButtonindexИндекс нижестоящего элемента, отсчитываемый от нуля. Возвращает ссылку на кнопку навигатора для нижестоящего контейнера. loadState state saveState contentHeight Высота области, в которой отображается содержимое, в пикселях. Высота области, в которой отображается содержимое, в пикселях. Этот получатель можно отменить, если содержимое не занимает всю область контейнера. contentWidth Ширина области, в которой отображается содержимое, в пикселях. Ширина области, в которой отображается содержимое, в пикселях. Этот получатель можно отменить, если содержимое не занимает всю область контейнера. headerRenderer Фабрика для создания кнопок навигации для каждого нижестоящего элемента. Фабрика для создания кнопок навигации для каждого нижестоящего элемента. Значением по умолчанию является фабрика, которая создает mx.containers.accordionClasses.AccordionHeader. Создаваемый объект должен являться подчиненным классом Button и реализовывать интерфейс mx.core.IDataRenderer. Значение свойства data устанавливается в соответствии с содержимым, связанным с заголовком.

mx.containers.accordionClasses.AccordionHeader

historyManagementEnabled Если установлено значение true, это свойство разрешает управление историей в данном контейнере Accordion.true Если установлено значение true, это свойство разрешает управление историей в данном контейнере Accordion. При переходе пользователем от одного нижестоящего элемента к другому браузер запоминает посещенные нижестоящие элементы. Пользователь может осуществлять навигацию, учитывающую данную историю, с помощью кнопок браузера «Назад» и «Вперед».

mx.managers.HistoryManager

resizeToContent Если установлено значение true, размер этого контейнера Accordion автоматически изменяется в соответствии с размером текущего нижестоящего элемента.false Если установлено значение true, размер этого контейнера Accordion автоматически изменяется в соответствии с размером текущего нижестоящего элемента. selectedChild Ссылка на видимый в данный момент нижестоящий контейнер.3401 Указывает нижестоящий ракурс, отображаемый в данный момент. Ссылка на видимый в данный момент нижестоящий контейнер. Значением по умолчанию является ссылка на первый нижестоящий элемент. При отсутствии нижестоящих элементов для этого свойства устанавливается значение null.

Примечание. Значение для этого свойства можно установить только в операторе ActionScript, не в MXML.

selectedIndex Отсчитываемый от нуля индекс для видимого в настоящий момент нижестоящего контейнера.3402 0 Указывает индекс нижестоящего ракурса, отображаемого в настоящий момент. Отсчитываемый от нуля индекс для видимого в настоящий момент нижестоящего контейнера. Индексы нижестоящих элементов находятся в диапазоне 0, 1, 2 ..., n - 1, где n является количеством нижестоящих элементов. Значением по умолчанию является 0, что соответствует первому нижестоящему элементу. При отсутствии нижестоящих элементов для этого свойства устанавливается значение -1. ControlBar Контейнер ControlBar позволяет размещать элементы управления в нижней области контейнера Halo Panel или Halo TitleWindow. В Flex 4 компонент ControlBar больше не требуется. Используйте свойство controlBarContent класса Spark Panel для определения набора компонентов, включаемых в область панели управления. Используйте свойство controlBarLayout класса Spark Panel для определения шаблона области панели управления. The <mx:ControlBar> tag inherits all the tag attributes but adds no additional attributes:

  <mx:ControlBar>
    ...
      child tags
    ...
  </mx:ControlBar>

]]>mx.containers:Box Контейнер ControlBar позволяет размещать элементы управления в нижней области контейнера Halo Panel или Halo TitleWindow. Тег <mx:ControlBar> должен являться последним нижестоящим тегом для тега с вложением контейнера Halo Panel или Halo TitleWindow.

Примечание. Контейнер Spark Panel не поддерживает контейнер ControlBar. Для добавления этой функции измените тему оформления контейнера Spark Panel.

ControlBar представляет собой окно со свойствами фона и стиля по умолчанию.

Контейнер ControlBar имеет следующие характеристики размеров по умолчанию:

mx.containers.Panel

ControlBar Конструктор. Конструктор. GridItem Контейнер GridItem определяет ячейку сетки в контейнере GridRow.The <mx:GridItem> tag must be a child of the <GridRow> tag, which defines a grid row. The <mx:GridItem> container inherits the tag attributes of its superclass, and adds the following tag attributes.

  <mx:Grid>
    <mx:GridRow>
      <mx:GridItem
        rowSpan="1"
        colSpan="1">
          child components
      </mx:GridItem>
      ...
    </mx:GridRow>
    ...
  </mx:Grid>

]]>mx.containers:HBox Контейнер GridItem определяет ячейку сетки в контейнере GridRow. (Контейнер GridRow, в свою очередь, определяет строку в контейнере Grid.) Контейнер GridItem может содержать любое количество нижестоящих элементов, расположенных аналогично элементам в контейнере HBox. Если макет HBox использовать не требуется, создайте контейнер, например VBox, в качестве нижестоящего элемента управления GridItem, и поместите в этот нижестоящий контейнер другие компоненты.

Контейнеры GridItem имеют следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Высота каждой строки и каждой ячейки. Высота по умолчанию или явная высота наиболее высокого элемента в строке. Если контейнер GridItem не имеет явного размера, его высота по умолчанию соответствует высоте по умолчанию или явной высоте нижестоящего элемента в ячейке. Ширина каждого столбца и каждой ячейки. Ширина по умолчанию или явная ширина по умолчанию наиболее широкого элемента в столбце. Если контейнер GridItem не имеет явной ширины, его шириной по умолчанию будет являться ширина по умолчанию или явная ширина нижестоящего элемента в ячейке. Промежуток между строками и столбцами. Определяется свойствами horizontalGap и verticalGap класса Grid. Значением по умолчанию для обоих промежутков является 6 пикселей. Заполнение по умолчанию 0 пикселей для значений верхнего, нижнего, правого и левого края всех трех контейнерных классов.

mx.containers.Gridmx.containers.GridRow

GridItem Конструктор. Конструктор. colSpan Количество столбцов контейнера Grid, включенных в одну ячейку.1 Количество столбцов контейнера Grid, включенных в одну ячейку. rowSpan Количество строк контейнера Grid, включенных в одну ячейку.1 Количество строк контейнера Grid, включенных в одну ячейку. Расширить ячейку сверх числа строк в контейнере Grid невозможно. Panel Контейнер Halo Panel состоит из строки заголовка, подписи, границы и области содержимого для нижестоящих элементов. Указывает эффект, который будет воспроизведен перед изменением размера. Для деактивации эффекта растворения (Dissolve) по умолчанию для мгновенного скрытия нижестоящих элементов установите для свойства resizeStartEffect значение none. "Dissolve" Flash 9 AIR 1.1 3.0 Flex 3 Указывает эффект, который требуется воспроизвести после завершения эффекта изменения размера. Для деактивации эффекта Dissolve по умолчанию установите для мгновенного скрытия нижестоящих элементов для свойства resizeEndEffect значение none. "Dissolve" Flash 9 AIR 1.1 3.0 Flex 3 The <mx:Panel> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <mx:Panel
   Properties
   layout="vertical|horizontal|absolute"
   status=""
   title=""
   titleIcon="null"
  
   Styles
   borderAlpha="0.4"
   borderThicknessBottom="NaN"
   borderThicknessLeft="10"
   borderThicknessRight="10"
   borderThicknessTop="2"
   controlBarStyleName="null"
   cornerRadius="4"
   dropShadowEnabled="true|false"
   footerColors="null"
   headerColors="null"
   headerHeight="Based on style of title"
   highlightAlphas="[0.3,0]"
   horizontalAlign="left|center|right"
   horizontalGap="8"
   modalTransparency="0.5"
   modalTransparencyBlur="3"
   modalTransparencyColor="#DDDDDD"
   modalTransparencyDuration="100"
   paddingBottom="0"
   paddingTop="0"
   roundedBottomCorners="false|true"
   shadowDirection="center|left|right"
   shadowDistance="2"
   statusStyleName="windowStatus"
   titleBackgroundSkin="TitleBackground"
   titleStyleName="windowStyles"
   verticalAlign="top|middle|bottom"
   verticalGap="6"
  
   Effects
   resizeEndEffect="Dissolve"
   resizeStartEffect="Dissolve"
   >
      ...
      child tags
      ...
  </mx:Panel>

]]>mx.containers.utilityClasses:IConstraintLayoutmx.core:IFontContextComponentmx.core:Container Контейнер Halo Panel состоит из строки заголовка, подписи, границы и области содержимого для нижестоящих элементов. Как правило, контейнеры Panel используются для включения модулей приложений верхнего уровня. Например, в контейнер Panel можно включить корзину покупок.

Примечание. Adobe рекомендует по возможности использовать контейнер Spark Panel, а не Halo Panel.

Контейнер Panel имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Высота является достаточной для включения всех нижестоящих элементов с высотой по умолчанию, любых вертикальных промежутков между нижестоящими элементами, заполнения сверху и снизу, верхней и нижней границ, а также строки заголовка. Ширина соответствует сумме наибольшего значения ширины по умолчанию самого широкого нижестоящего элемента, заполнения контейнера слева и справа или ширины текста заголовка, и границы. Заполнение 4 пикселя для значений заполнения сверху, снизу, справа и слева.

spark.components.Panelmx.containers.ControlBarmx.containers.VBox

Panel Конструктор. Конструктор. getHeaderHeight Возвращает высоту заголовка.Высота заголовка в пикселях. Возвращает высоту заголовка. measure Вычисляет минимальный и максимальный размеры по умолчанию для контейнера Panel. Вычисляет минимальный и максимальный размеры по умолчанию для контейнера Panel. Для получения дополнительной информации о методе measure() см. описание метода UIComponent.measure().

Метод measure() сначала вызывает метод VBox.measure(), а затем проверяет, что свойства measuredWidth и measuredMinWidth предоставляют достаточную ширину для отображения заголовка и ControlBar.

mx.core.UIComponent.measure()

startDragging Вызывается при начале перетаскивания пользователем контейнера Panel, раскрытого с помощью PopUpManager.eventMouseEvent, отправляемый при щелчке мыши по контейнеру. Вызывается при начале перетаскивания пользователем контейнера Panel, раскрытого с помощью PopUpManager. stopDragging Вызывается при завершении перетаскивания пользователем контейнера Panel, раскрытого с помощью PopUpManager. Вызывается при завершении перетаскивания пользователем контейнера Panel, раскрытого с помощью PopUpManager. controlBar Ссылка на данную панель управления контейнера Panel, если имеется. Ссылка на данную панель управления контейнера Panel, если имеется. statusTextField Подчиненный элемент управления UITextField, который отображает статус. Подчиненный элемент управления UITextField, который отображает статус. Поле статуса является нижестоящим элементом для подчиненного элемента управления titleBar.

titleBar

titleBar Подчиненный элемент управления TitleBar, отображающий строку заголовка контейнера Panel. Подчиненный элемент управления TitleBar, отображающий строку заголовка контейнера Panel. titleTextField Подчиненный элемент управления UITextField, отображающий заголовок. Подчиненный элемент управления UITextField, отображающий заголовок. Поле заголовка является нижестоящим элементом для подчиненного элемента управления titleBar.

titleBar

closeButtonStyleFilters Набор стилей для передачи от контейнера Panel кнопке закрытия. Набор стилей для передачи от контейнера Panel кнопке закрытия.

mx.styles.StyleProxy

constraintColumns constraintRows fontContext layout Указывает механизм создания макета для данного контейнера."vertical" Указывает механизм создания макета для данного контейнера. Контейнеры Panel могут использовать для размещения элементов значения vertical, horizontal или absolute. При вертикальном размещении нижестоящие компоненты располагаются вертикально от верхней к нижней части контейнера в указанном порядке. При горизонтальном размещении нижестоящие компоненты располагаются в контейнере горизонтально слева направо в указанном порядке. При абсолютном размещении автоматический макет не применяется. Пользователь должен явно определить местоположение каждого нижестоящего элемента. status Текст в области статуса строки заголовка."" Текст в области статуса строки заголовка. titleIcon Значок, отображаемый в строке заголовка.null Значок, отображаемый в строке заголовка. title Заголовок или подпись в строке заголовка.3991 "" Получает или устанавливает заголовок/подпись, отображаемые в строке заголовка Заголовок или подпись в строке заголовка. Tile В контейнере Halo Tile нижестоящие элементы расположены в сетке из равных по размеру ячеек. Специфичные для макета компоненты контейнера в Flex 3 были заменены более общим компонентом Group, принимающим общий макет. Для получения аналогичного варианта поведения нового компонента Group установите для свойства layout значение TileLayout или используйте контейнер TileGroup. The <mx:Tile> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Tile
    Properties
    direction="horizontal|vertical"
    tileHeight="NaN"
    tileWidth="NaN"
 
    Sttles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalAlign="top|middle|bottom"
    verticalGap="6"
    >
      ...
      child tags
     ...
  </mx:Tile>

]]>mx.core:Container В контейнере Halo Tile нижестоящие элементы расположены в сетке из равных по размеру ячеек. Размер ячеек можно указать с помощью свойств tileWidth и tileHeight, либо разрешить контейнеру Tile определять размер ячейки на основе размера наибольшего нижестоящего элемента. Свойство direction контейнера Tile определяет, как располагаются ячейки: горизонтально или вертикально, начиная с верхнего левого угла контейнера Tile.

Примечание. Adobe рекомендует по возможности использовать с TileLayout контейнеры Spark, а не контейнер Halo Tile.

Контейнер Tile имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Направление горизонтально Размер по умолчанию всех ячеек Высота соответствует высоте по умолчанию или явной высоте наиболее высокого нижестоящего элемента. Ширина соответствует ширине по умолчанию или явной ширине наиболее широкого нижестоящего элемента. Все ячейки имеют одинаковый размер по умолчанию. Размер по умолчанию контейнера Tile Flex вычисляет квадратный корень из числа нижестоящих элементов и округляет его до ближайшего целого числа. Например, имеется 26 нижестоящих элементов, квадратный корень равен 5,1, округляется до 6. После вычисления Flex располагает контейнер Tile в сетке размером 6 на 6. Высота по умолчанию контейнера Tile (высота ячейки по умолчанию) равна сумме x (округленный квадратный корень числа нижестоящих элементов), любых промежутков между нижестоящими элементами и всех значений заполнения. Ширина по умолчанию (ширина ячейки по умолчанию) равна сумме x (округленный квадратный корень числа нижестоящих элементов), любых промежутков между нижестоящими элементами и всех значений заполнения. Минимальный размер контейнера Tile Размер по умолчанию одной ячейки. Flex всегда выделяет достаточно места для отображения, по крайней мере, одной ячейки. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева.

mx.core.Container

Tile Конструктор. Конструктор. measure Вычисляет минимальный и максимальный размеры по умолчанию для контейнера Tile. Вычисляет минимальный и максимальный размеры по умолчанию для контейнера Tile. Для получения дополнительной информации о методе measure() см. описание метода UIComponent.measure().

Этот метод сначала вычисляет размер каждой ячейки. Для получения описания способа определения размера ячейки см. описание свойств tileWidth и tileHeight.

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

Если горизонтальный контейнер Tile имеет явную ширину, то это значение определяет число ячеек, которые можно расположить по горизонтали. Высота, необходимая для включения всех нижестоящих элементов, вычисляется путем построения сетки M на N.
Если вертикальный контейнер Tile имеет явную высоту, то это значение определяет число ячеек, которые можно разместить по вертикали. Ширина, необходимая для включения всех нижестоящих элементов, вычисляется путем построения сетки N на M.

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

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

mx.core.UIComponent.measure()

updateDisplayList Устанавливает позиции и размеры нижестоящих элементов этого контейнера.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Устанавливает позиции и размеры нижестоящих элементов этого контейнера. Для получения дополнительной информации о методе updateDisplayList() см. описание метода UIComponent.updateDisplayList().

Этот метод располагает нижестоящие элементы в шахматном порядке в сетке с ячейками равного размера в области содержимого контейнера Tile (т. е. в области внутри ее заполнения). Для получения описания способа определения размера ячейки см. описание свойств tileWidth и tileHeight.

Разделение между ячейками определяется стилями horizontalGap и verticalGap. Размещение каждого нижестоящего элемента в ячейке определяется стилями horizontalAlign и verticalAlign.

Поток нижестоящих элементов определяется значением свойства direction. Первая ячейка всегда помещается в верхней левой части области содержимого. Если для свойства direction установлено значение horizontal, ячейки помещаются слева направо в самой верхней строке, затем слева направо во второй строке сверху и т. д. Если для свойства direction установлено значение vertical, ячейки помещаются сверху вниз в крайнем левом столбце, затем сверху вниз во втором столбце слева и т. д.

Если для нижестоящего элемента определено значение percentWidth или percentHeight, он изменяется в указанном направлении для заполнения определенного процента от объема ячейки.

mx.core.UIComponent.updateDisplayList()

direction Определяет способ размещения нижестоящих элементов в контейнере."horizontal" Определяет способ размещения нижестоящих элементов в контейнере. Возможными значениями MXML являются horizontal и vertical. В ActionScript направление устанавливается с помощью значения TileDirection.HORIZONTAL или TileDirection.VERTICAL. Значением по умолчанию является horizontal. (Если контейнер является контейнером Legend, который представляет собой подкласс Tile, в качестве значения по умолчанию используется vertical.)

Первый нижестоящий элемент всегда помещается в верхнем левом углу контейнера Tile. Если для свойства direction установлено значение horizontal, нижестоящие элементы помещаются слева направо в самой верхней строке, затем слева направо во второй сверху строке и т. д. Если установлено значение vertical, нижестоящие элементы помещаются сверху вниз в крайнем левом столбце, затем сверху вниз во втором слева столбце и т. д.

TileDirection

tileHeight Высота каждой ячейки мозаики в пикселях.NaN Высота каждой ячейки мозаики в пикселях. Если для этого свойства установлено значение NaN, то по умолчанию высота каждой ячейки определяется по высоте наиболее высокого нижестоящего элемента. Если значение для этого свойства установлено, указанное значение отменяет данное вычисление. tileWidth Ширина каждой ячейки мозаики в пикселях.NaN Ширина каждой ячейки мозаики в пикселях. Если для этого свойства установлено значение NaN, то по умолчанию ширина каждой ячейки определяется по ширине наиболее широкого нижестоящего элемента. Если значение для этого свойства установлено, указанное значение отменяет данное вычисление. VDividedBox Контейнер VDividedBox располагает нижестоящие элементы вертикально, аналогично способу расположения элементов в контейнере VBox, но при этом в промежуток между каждым нижестоящим элементом вставляет перетаскиваемый разделитель.The <mx:VDividedBox> tag inherits all of the tag attributes of its superclass, except direction, and adds no new tag attributes.

]]>mx.containers:DividedBox Контейнер VDividedBox располагает нижестоящие элементы вертикально, аналогично способу расположения элементов в контейнере VBox, но при этом в промежуток между каждым нижестоящим элементом вставляет перетаскиваемый разделитель. Пользователь может перетащить разделитель для изменения размеров области, выделенной для каждого нижестоящего элемента. Тег <mx:VDividedBox/> аналогичен тегу <mx:DividedBox direction="vertical"/>.

Контейнер VDividedBox имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Высота является достаточной для включения всех нижестоящих элементов с высотой по умолчанию или явной высотой, любых вертикальных промежутков между нижестоящими элементами, а также заполнения контейнера снизу и сверху. Ширина соответствует сумме ширины по умолчанию или явной ширины наиболее широкого нижестоящего элемента и заполнения справа и слева для контейнера. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева. Промежуток по умолчанию 10 пикселей для горизонтальных и вертикальных промежутков.

mx.containers.DividedBoxmx.containers.HDividedBox

VDividedBox Конструктор. Конструктор. BoxDirection Класс BoxDirection указывает значения констант для свойства direction контейнера Box.Object Класс BoxDirection указывает значения констант для свойства direction контейнера Box.

mx.containers.Box

HORIZONTAL Указывает, что нижестоящие элементы контейнера Box располагаются горизонтально.horizontal Указывает, что нижестоящие элементы контейнера Box располагаются горизонтально. VERTICAL Указывает, что нижестоящие элементы контейнера Box располагаются вертикально.vertical Указывает, что нижестоящие элементы контейнера Box располагаются вертикально. Form Контейнер Form позволяет осуществлять управление макетом формы, отмечать поля формы как обязательные или дополнительные, обрабатывать сообщения об ошибках и связывать данные формы с моделью данных Flex для выполнения проверки данных и проверки правильности. The <mx:Form> tag inherits all the tag attributes of its superclass and adds the following tag attributes:

  <mx:Form
    Styles
    horizontalGap="8"
    indicatorGap="14"
    labelWidth="Calculated"
    paddingBottom="16"
    paddingTop="16"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:Form>

]]>mx.core:Container Контейнер Form позволяет осуществлять управление макетом формы, отмечать поля формы как обязательные или дополнительные, обрабатывать сообщения об ошибках и связывать данные формы с моделью данных Flex для выполнения проверки данных и проверки правильности. Кроме того, для конфигурирования внешнего вида форм можно использовать таблицы стилей.

В таблице представлены компоненты, используемые для создания форм в Flex:

КомпонентТегОписание Форма <mx:Form> Определяет контейнер для всей формы, включая общий макет формы. Элемент управления FormHeading и контейнер FormItem используются для определения содержимого. В контейнер Form можно также вставить другие типы компонентов. FormHeading <mx:FormHeading> Определяет заголовок в форме. В одном контейнере Form может находиться несколько элементов управления FormHeading. FormItem <mx:FormItem> Содержит один или несколько нижестоящих элементов формы, расположенных по горизонтали или вертикали. Нижестоящие элементы могут являться элементами управления или другими контейнерами. Один контейнер Form может включать несколько контейнеров FormItem.

mx.containers.FormHeadingmx.containers.FormItem

Form Конструктор. Конструктор. measure Вычисляет предпочтительный, минимальный и максимальный размер контейнера Form. Вычисляет предпочтительный, минимальный и максимальный размер контейнера Form. Для получения дополнительной информации о методе measure см. описание метода UIComponent.measure().

Метод Form.measure() устанавливает для свойства measuredWidth значение, равное сумме ширины наибольшего нижестоящего элемента, значения свойств стиля paddingLeft и paddingRight, и ширины границы.

Значение свойства measuredHeight соответствует сумме значений measuredHeight всех нижестоящих элементов и пробела verticalGap между каждым нижестоящим элементом. Кроме того, добавляются свойства стиля paddingTop и paddingBottom, а также высота границы.

В качестве значения для свойства measuredMinWidth устанавливается наибольшая минимальная ширина нижестоящих элементов. Если значение свойства width для нижестоящего элемента выражено в процентах, то используется свойство minWidth, в противном случае используется свойство measuredWidth. Кроме того, добавляются значения свойств стиля paddingLeft и paddingRight, а также ширина границы.

Для свойства measuredMinHeight устанавливается то же значение, что и для свойства measuredHeight.

updateDisplayList Реагирует на изменение размеров посредством установки позиций и размеров нижестоящих элементов данного контейнера.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Реагирует на изменение размеров посредством установки позиций и размеров нижестоящих элементов данного контейнера. Для получения дополнительной информации о методе updateDisplayList() см. описание метода UIComponent.updateDisplayList().

Метод Form.updateDisplayList() располагает нижестоящие элементы в вертикальном столбце с разделением свойством стиля verticalGap. Применяются свойства стиля paddingLeft, paddingRight, paddingTop и paddingBottom.

Если ширина нижестоящего элемента выражена в процентах, он растягивается горизонтально в пределах контейнера Form, в соответствии с указанным процентным значением; в противном случае ширина устанавливается в соответствии со свойством measuredWidth. Для каждого нижестоящего элемента устанавливается свое значение свойства measuredHeight.

Перед выполнением дополнительных операций этот метод вызывает метод super.updateDisplayList().

maxLabelWidth Максимальная ширина в пикселях меток контейнеров FormItems в одном контейнере Form. Максимальная ширина в пикселях меток контейнеров FormItems в одном контейнере Form. ViewStack Контейнер навигатора MX ViewStack состоит из коллекции нижестоящих контейнеров, помещенных в стек в верхней части друг друга. При этом в каждый конкретный момент видимым является только один нижестоящий элемент.The <mx:ViewStack> tag inherits the tag attributes of its superclass, with the exception of scrolling-related attributes, and adds the following tag attributes:

  <mx:ViewStack
    Properties
    historyManagementEnabled="false|true"
    resizeToContent="false|true"
    selectedIndex="0"
    
    Styles
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalGap="6"
    
    Events
    change="No default"
    >
      ...
      child tags
      ...
  </mx:ViewStack>

]]>mx.managers:IHistoryManagerClientmx.core:ISelectableListmx.core:Container Контейнер навигатора MX ViewStack состоит из коллекции нижестоящих контейнеров, помещенных в стек в верхней части друг друга. При этом в каждый конкретный момент видимым является только один нижестоящий элемент. При выборе другого нижестоящего контейнера он зрительно заменяет предыдущий контейнер, поскольку отображается в том же местоположении. При этом предыдущий нижестоящий контейнер по-прежнему существует; просто перестает быть видимым.

Контейнер ViewStack не предоставляет пользовательский интерфейс для выбора видимого в данный момент нижестоящего контейнера. Как правило, в ActionScript в ответ на определенное действие пользователя устанавливается значение для свойства selectedIndex или selectedChild. Также для предоставления интерфейса навигации можно связаться с элементом управления MX LinkBar, TabBar, ButtonBar, ToggleButtonBar или с элементом управления Spark ButtonBar с контейнером ViewStack. Для этого укажите контейнер ViewStack в качестве значения для свойства dataProvider контейнера LinkBar, TabBar или ToggleButtonBar.

Можно использовать более сложный контейнер навигатора, чем контейнер ViewStack, например контейнер TabNavigator или Accordion. Помимо коллекции нижестоящих контейнеров эти контейнеры предоставляют собственные элементы управления пользовательского интерфейса для перемещения между нижестоящими элементами.

При изменении видимого в данный момент нижестоящего контейнера можно использовать свойство hideEffect скрытого контейнера и свойство showEffect последнего отображенного нижестоящего контейнера для применения эффекта в нижестоящих контейнерах. Перед отображением нового нижестоящего контейнера контейнер ViewStack ожидает скрытия нижестоящего контейнера hideEffect. Воспроизводимый в данный момент эффект можно прервать путем изменения значения для свойства selectedIndex контейнера ViewStack во время воспроизведения эффекта.

Контейнер ViewStack имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Ширина и высота начального активного нижестоящего элемента. Правила изменения размеров контейнеров По умолчанию размер контейнеров ViewStack устанавливается только один раз в соответствии с размером первого нижестоящего контейнера. Он не изменяется при перемещении к другим нижестоящим контейнерам. Для принудительного изменения размера контейнера ViewStack при переходе к другому нижестоящему контейнеру установите для свойства resizeToContent значение true. Правила установки размеров нижестоящих элементов Размер нижестоящего элемента устанавливается в соответствии с размером по умолчанию. Если размер нижестоящего элемента превышает размер контейнера ViewStack, нижестоящий элемент отсекается. Если размер нижестоящего элемента меньше размера контейнера ViewStack, нижестоящий элемент выравнивается по верхнему левому углу контейнера ViewStack. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, слева и справа.

mx.controls.LinkBarmx.controls.ButtonBarmx.controls.TabBarmx.controls.ToggleButtonBarspark.components.ButtonBarmx.managers.HistoryManagermx.managers.LayoutManager

change Передается при изменении выбранного нижестоящего контейнера.mx.events.IndexChangedEvent.CHANGEmx.events.IndexChangedEvent Передается при изменении выбранного нижестоящего контейнера. ViewStack Конструктор. Конструктор. commitSelectedIndex Передает выбранный индекс.newIndexВыбранный индекс. Передает выбранный индекс. Эта функция вызывается в течение фазы передачи свойств при изменении свойства selectedIndex или selectedItem. loadState state measure Вычисляет размеры по умолчанию, а также минимальное и максимальное значения контейнера ViewStack. Вычисляет размеры по умолчанию, а также минимальное и максимальное значения контейнера ViewStack. Для получения дополнительной информации о методе measure() см. описание метода UIComponent.measure().

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

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

Этот метод не изменяет максимальный размер контейнера ViewStack, он остается неограниченным.

mx.core.UIComponent.measure()

saveState updateDisplayList Реагирует на изменение размеров посредством установки позиций и размеров нижестоящих элементов данного контейнера.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Реагирует на изменение размеров посредством установки позиций и размеров нижестоящих элементов данного контейнера. Для получения дополнительной информации о методе updateDisplayList() см. описание метода UIComponent.updateDisplayList().

Только один из нижестоящих элементов является видимым в конкретный момент, поэтому контейнер ViewStack определяет позицию и размер только для этого нижестоящего элемента.

Выбранный нижестоящий элемент размещается в верхнем левом углу контейнера ViewStack, позволяя также разместить заполнение и границы контейнера ViewStack.

Если выбранный нижестоящий элемент имеет процентное значение для свойств width или height, его размеры изменяются в соответствующем направлении для заполнения указанного объема области содержимого контейнера ViewStack (т. е. области внутри заполнения).

mx.core.UIComponent.updateDisplayList()

contentHeight Высота области, в которой отображается содержимое, в пикселях. Высота области, в которой отображается содержимое, в пикселях. Этот получатель можно отменить, если содержимое не занимает всю область контейнера ViewStack. contentWidth Ширина области, в которой отображается содержимое, в пикселях. Ширина области, в которой отображается содержимое, в пикселях. Этот получатель можно отменить, если содержимое не занимает всю область контейнера ViewStack. contentX Координата x области контейнера ViewStack, в которой отображается содержимое, в пикселях. Координата x области контейнера ViewStack, в которой отображается содержимое, в пикселях. Значение по умолчанию совпадает со значением свойства стиля paddingLeft, значение по умолчанию для которого равно 0. Если макет содержимого должен начинаться в точке x = 0, отмените метод get(). contentY Координата y области контейнера ViewStack, в которой отображается содержимое, в пикселях. Координата y области контейнера ViewStack, в которой отображается содержимое, в пикселях. Значение по умолчанию совпадает со значением свойства стиля paddingTop, значение по умолчанию для которого равно 0. Если макет содержимого должен начинаться в точке y = 0, отмените метод get(). historyManagementEnabled Если значение равно true, управление историей в данном контейнере ViewStack активируется.false Если значение равно true, управление историей в данном контейнере ViewStack активируется. При переходе пользователем от одного нижестоящего элемента к другому браузер запоминает посещенные нижестоящие элементы. Пользователь может осуществлять навигацию, учитывающую данную историю, с помощью кнопок браузера «Назад» и «Вперед».

mx.managers.HistoryManager

resizeToContent Если значение равно true, контейнер ViewStack автоматически изменяет свой размер на размер текущего нижестоящего элемента.false Если значение равно true, контейнер ViewStack автоматически изменяет свой размер на размер текущего нижестоящего элемента. selectedChild Ссылка на видимый в данный момент нижестоящий контейнер. Ссылка на видимый в данный момент нижестоящий контейнер. Значением по умолчанию является ссылка на первый нижестоящий элемент. При отсутствии нижестоящих элементов для этого свойства устанавливается значение null.

Примечание. Значение для этого свойства можно установить только в операторе ActionScript, не в MXML.

selectedIndex Отсчитываемый от нуля индекс для видимого в настоящий момент нижестоящего контейнера. Отсчитываемый от нуля индекс для видимого в настоящий момент нижестоящего контейнера. Индексы нижестоящих элементов находятся в диапазоне 0, 1, 2 ..., n - 1, где n является количеством нижестоящих элементов. Значением по умолчанию является 0, что соответствует первому нижестоящему элементу. При отсутствии нижестоящих элементов это свойство имеет значение -1.

Примечание. При добавлении нового нижестоящего элемента к контейнеру ViewStack свойство selectedIndex при необходимости автоматически регулируется. При этом нижестоящий элемент остается выбранным.

GridRow Контейнер GridRow определяет строку в контейнере Grid и содержит контейнеры GridCell.The <mx:GridRow> must be a child of the <mx:Grid> tag, and has one or more child <mx:GridItem> tags that define the grid cells.

The <mx:GridRow> container inherits the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Grid>
    <mx:GridRow
    Styles
      horizontalAlign="left|center|right"
      verticalAlign="top|middle|bottom"
    >
      <mx:GridItem
        child components
      </mx:GridItem>
      ...
    </mx:GridRow>
    ...
  </mx:Grid>

]]>mx.containers:HBox Контейнер GridRow определяет строку в контейнере Grid и содержит контейнеры GridCell.

Контейнеры GridRow имеют следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Высота каждой строки и каждой ячейки. Высота по умолчанию или явная высота наиболее высокого элемента в строке. Если контейнер GridItem не имеет явного размера, его высота по умолчанию соответствует высоте по умолчанию или явной высоте нижестоящего элемента в ячейке. Ширина каждого столбца и каждой ячейки. Ширина по умолчанию или явная ширина по умолчанию наиболее широкого элемента в столбце. Если контейнер GridItem не имеет явной ширины, ширина по умолчанию соответствует ширине по умолчанию или явной ширине нижестоящего элемента в ячейке. Промежуток между строками и столбцами. Определяется свойствами horizontalGap и verticalGap класса Grid. Значением по умолчанию для обоих промежутков является 6 пикселей. Заполнение по умолчанию 0 пикселей для значений верхнего, нижнего, правого и левого края всех трех контейнерных классов.

mx.containers.Gridmx.containers.GridItem

GridRow Конструктор. Конструктор. updateDisplayList Устанавливает размер и позицию для каждого нижестоящего элемента контейнера GridRow.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Устанавливает размер и позицию для каждого нижестоящего элемента контейнера GridRow. Для получения дополнительной информации об алгоритме создания макетов Grid см. описание метода Grid.updateDisplayList().

Этот метод не вызывается напрямую. Он вызывается в соответствующий момент посредством Flex LayoutManager. При запуске приложения Flex LayoutManager выполняет вызов метода updateDisplayList() в каждом компоненте, начиная с корня и далее в нисходящем направлении.

Box Контейнер Halo Box располагает нижестоящие элементы в одном вертикальном столбце или одной горизонтальной строке. The <mx:Box> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:Box
    Properties
    direction="vertical|horizontal"
    Styles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    paddingBottom="0"
    paddingTop="0"
    verticalAlign="top|middle|bottom"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:Box>

]]>mx.core:Container Контейнер Halo Box располагает нижестоящие элементы в одном вертикальном столбце или одной горизонтальной строке. Свойство direction определяет, требуется ли использовать вертикальный (по умолчанию) или горизонтальный макет.

Примечание. Adobe рекомендует по возможности использовать с HorizontalLayout или VerticalLayout контейнеры Spark, а не Halo Box.

Класс Box является базовым для классов VBox и HBox. Для определения контейнеров Box используются теги <mx:Box>, <mx:VBox> и <mx:HBox>.

Контейнер Box имеет следующие характеристики размеров по умолчанию:

ХарактеристикаОписание Размер по умолчанию Вертикальное поле Высота является достаточной для включения всех нижестоящих элементов с высотой по умолчанию или с явной высотой, любого вертикального промежутка между нижестоящими элементами, а также для заполнения сверху и снизу для контейнера. Ширина соответствует сумме ширины по умолчанию или явной ширины наиболее широкого нижестоящего элемента и заполнения контейнера слева и справа. Горизонтальное поле Ширина является достаточной для включения всех нижестоящих элементов с шириной по умолчанию, любого горизонтального промежутка между нижестоящими элементами, а также для заполнение слева и справа для контейнера. Высота соответствует сумме высоты по умолчанию или явной высоты наиболее высокого нижестоящего элемента и заполнения для контейнера сверху и снизу. Заполнение по умолчанию 0 пикселей для значений заполнения сверху, снизу, справа и слева.

mx.core.Containermx.containers.HBoxmx.containers.VBox

Box Конструктор. Конструктор. measure Вычисляет размеры по умолчанию, а также минимальное и максимальное значения контейнера Box. Вычисляет размеры по умолчанию, а также минимальное и максимальное значения контейнера Box.

Если для свойства direction контейнера Box установлено значение BoxDirection.HORIZONTAL, значение свойства measuredWidth соответствует сумме значений ширины по умолчанию всех нижестоящих элементов, толщины границ, заполнения слева и справа, а также горизонтального промежутка между каждым нижестоящим элементом. Значение свойства measuredHeight соответствует сумме максимальной высоты всех значений по умолчанию для нижестоящих элементов и пространства для границ и заполнения. Если для свойства direction контейнера Box установлено значение BoxDirection.VERTICAL, эти два значения отменяются.

Свойства minWidth и minHeight контейнера Box вычисляются аналогично путем сложения минимальных значений высоты и ширины для нижестоящих элементов. Если для нижестоящего элемента значение свойства width выражено в процентах, минимальная ширина контейнера Box будет равна значению свойства minWidth для этого нижестоящего элемента. Если значение для свойства width нижестоящего элемента не установлено, либо является фиксированным, нижестоящий элемент не будет растягиваться или сжиматься. Поэтому минимальная ширина контейнера Box будет равна значению свойства explicitWidth для этого нижестоящего элемента. Минимальная высота нижестоящего элемента вычисляется аналогично.

Значения свойств maxWidth и maxHeight контейнера Box не вычисляются. Предполагается, что максимальная высота и ширина контейнера Box являются бесконечными величинами.

Все описанные выше значения являются измеренными значениями ширины и высоты контейнера Box. Пользователь может отменить измеренные значения путем явного ввода значений для следующих свойств:

ширина
height
minWidth
minHeight
maxWidth
maxHeight

Выполнять вызов метода measure() напрямую не требуется. Он вызывается в соответствующий момент посредством Flex LayoutManager. При запуске приложения Flex LayoutManager перед установкой окончательных размеров выполняет попытку измерить все компоненты от нижестоящих до вышестоящих.

measuredMinWidth
measuredMinHeight

Эти свойства соответствуют описанным выше свойствам макета, поэтому отдельно они не рассматриваются.

pixelsToPercent Метод, используемый для преобразования числа пикселей в процентный объем содержимого этого контейнера.Процентное значение, эквивалентное значению pxl при текущих условиях создания макета для данного контейнера. Отрицательное значение указывает, что для получения запрашиваемого размера контейнер необходимо увеличить. pxlЧисло пикселей, для которых требуется определить процентное значение. Метод, используемый для преобразования числа пикселей в процентный объем содержимого этого контейнера.

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

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

updateDisplayList Устанавливает размер и позицию каждого нижестоящего элемента для контейнера Box.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Устанавливает размер и позицию каждого нижестоящего элемента для контейнера Box.

Для изучения алгоритма создания макета контейнера Box предположим, что контейнер Box расположен в горизонтальном направлении.

Все нижестоящие элементы контейнера Box расположены друг за другом в одной горизонтальной строке. Между каждой парой смежных нижестоящих элементов установлено расстояние в horizontalGap пикселей. Первоначально ширина нижестоящих элементов без явного значения ширины установлена равной значению свойства measuredWidth.

Если сумма значений свойства measuredWidth для нижестоящих элементов больше или меньше ширины контейнера Box, и если для некоторых нижестоящих элементов установлено процентное значение свойства width, размеры таких нижестоящих элементов будут изменяться в соответствии с размерами контейнера Box. Однако ни один из нижестоящих элементов не может иметь размер, меньший, чем значение свойства minWidth или больший, чем значение свойства maxWidth. Помимо увеличения (или уменьшения) размера нижестоящих элементов пропорционально значению свойства percentWidth добавляется (или удаляется) дополнительное пространство. Например, нижестоящий элемент со значением свойстваpercentWidth, равным 40%, будет увеличен в два раза по сравнению с элементом, для которого свойство percentWidth имеет значение 20%, до заполнения всего доступного пространства или достижения требуемых размеров.

После увеличения или уменьшения всех нижестоящих элементов Flex проверяет, соответствует ли сумма значений ширины нижестоящих элементов ширине контейнера Box. Если это не так, все нижестоящие элементы смещаются в соответствии со значением свойства horizontalAlign контейнера Box. Таким образом, нижестоящие элементы выравниваются по левому краю, правому краю или по центру контейнера Box.

Для определения высоты каждого нижестоящего элемента Flex анализирует значение свойства height нижестоящего элемента. Если свойство height не установлено, высота нижестоящего элемента устанавливается равной значению measuredHeight. Если для свойства height установлено значение в пикселях, то используется это значение. Если значение свойства height выражено в процентах, высота нижестоящего элемента увеличивается или уменьшается в соответствии с указанным процентом от высоты контейнера Box до тех пор, пока он не достигнет значения свойства minHeight или maxHeight.

Вертикальное расположение каждого нижестоящего элемента определяется свойством verticalAlign контейнера Box. Каждый нижестоящий элемент смещается с выравниванием по верхнему краю, нижнему краю или по центру контейнера Box.

Если для свойства direction контейнера Box установлено значение vertical, применяются аналогичные правила, за исключением того, что значения ширины и высоты меняются местами. Нижестоящие элементы размещаются в одном вертикальном столбце.

Этот метод не вызывается напрямую. Он вызывается в соответствующий момент посредством Flex LayoutManager. При запуске приложения Flex LayoutManager вызывает метод updateDisplayList() в каждом компоненте, начиная с объекта Application и далее по нисходящей.

direction Направление, в котором контейнер Box размещает свои нижестоящие элементы.BoxDirection.VERTICAL Направление, в котором контейнер Box размещает свои нижестоящие элементы. Возможными значениями MXML являются horizontal и vertical. Возможными значениями в ActionScript являются BoxDirection.HORIZONTAL и BoxDirection.VERTICAL. FormItem Контейнер FormItem определяет метку, а также один или несколько нижестоящих элементов, размещаемых горизонтально или вертикально. The <mx:FormItem> tag inherits all of the tag attributes of its superclass, except paddingLeft, and adds the following tag attributes:

  <mx:FormItem
    Properties
    direction="vertical|horizontal"
    label=""
    required="false|true"
  
    Styles
    horizontalAlign="left|center|right"
    horizontalGap="8"
    indicatorGap="14"
    indicatorSkin="'mx.containers.FormItem.Required' symbol in Assets.swf"
    labelStyleName=""
    labelWidth="Calculated"
    paddingBottom="0"
    paddingRight="0"
    paddingTop="0"
    verticalGap="6"
    >
    ...
      child tags
    ...
  </mx:FormItem>

]]>mx.core:Container Контейнер FormItem определяет метку, а также один или несколько нижестоящих элементов, размещаемых горизонтально или вертикально. Нижестоящие элементы могут являться элементами управления или другими контейнерами. Один контейнер Form может включать несколько контейнеров FormItem.

mx.containers.Formmx.containers.FormItemDirectionmx.containers.FormHeadingmx.controls.FormItemLabel

FormItem Конструктор. Конструктор. measure Вычисляет предпочтительный, минимальный и максимальный размеры FormItem. Вычисляет предпочтительный, минимальный и максимальный размеры FormItem. Для получения дополнительной информации о методе measure() см. описание метода UIComponent.measure().

Метод FormItem.measure() сначала определяет требуемое количество столбцов. Если для свойства direction установлено значение FormItemDirection.HORIZONTAL, все элементы управления будут по возможности помещены в одну строку. Если поместить все элементы управления в одну строку невозможно, они размещаются в двух столбцах. Если это оказывается неэффективным, используется один столбец. Если для свойства direction установлено значение FormItemDirection.VERTICAL, элементы управления помещаются в один столбец (как VBox).

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

Ширина области метки определяется свойством стиля labelWidth. Если для этого свойства установлено значение undefined (по умолчанию), используется ширина наибольшей метки в вышестоящем контейнере Form.

Если все нижестоящие элементы находятся в одной строке, ширина области управления определяется как сумма значений ширины всех нижестоящих элементов и пробела horizontalGap между этими элементами.

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

Если нижестоящие элементы находятся в нескольких строках и столбцах, ширина самого широкого элемента будет соответствовать ширине столбца, а ширина области управления будет определяться как ширина столбца, умноженная на сумму количества столбцов и пробелов horizontalGap между каждым столбцом.

Для measuredWidth устанавливается значение, равное сумме ширины области метки, ширины области управления и значения свойства стиля indicatorGap. Кроме того, добавляются значения свойств стиля paddingLeft и paddingRight, а также ширина границы.

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

Для measuredMinWidth устанавливается значение, равное сумме ширины области метки, минимальной ширины области управления и значения свойства стиля indicatorGap. Кроме того, добавляются значения свойств стиля paddingLeft и paddingRight, а также ширина границы.

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

Для получения дополнительной информации о способе размещения элементов управления FormItem см. описание метода FormItem.measure().

Метка выравнивается в области метки в соответствии со значением свойства стиля textAlign. Все метки в форме выровнены относительно друг друга.

Если для свойства required установлено значение true, между меткой и элементами управления помещается символ, указывающий, что данное поле является обязательным.

Элементы управления располагаются в столбцах, как описано в документации для метода measure(). Свойство стиля horizontalAlign определяет, требуется ли расположить элементы управления горизонтально.

Если для свойства direction установлено значение vertical, любой нижестоящий элемент, для которого не определено значение width, использует значение measuredWidth, округленное до 1/4 ширины области управления. Целью этого является предотвращение образования неровного правого края у элементов управления.

Перед выполнением дополнительных операций этот метод вызывает метод super.updateDisplayList().

direction Направление подчиненных компонентов FormItem.FormItemDirection.VERTICAL Направление подчиненных компонентов FormItem. Возможными значениями MXML являются vertical или horizontal. Значением MXML по умолчанию является vertical. Возможными значениями ActionScript являются FormItemDirection.VERTICAL или FormItemDirection.HORIZONTAL.

Если для свойства direction установлено значение vertical, нижестоящие элементы FormItem располагаются в стеке вертикально справа от метки FormItem. Если для свойства direction установлено значение horizontal, нижестоящие элементы помещаются в одну строку (по возможности) или в два столбца одинакового размера.

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

mx.containers.FormItemDirection

itemLabel Доступная только для чтения ссылка на подчиненный компонент FormItemLabel, отображающий метку FormItem.mx.controls:Label Доступная только для чтения ссылка на подчиненный компонент FormItemLabel, отображающий метку FormItem. label Текстовая метка для FormItem."" Текстовая метка для FormItem. Эта метка отображается слева от нижестоящих компонентов элемента формы. Позиция метки определяется значением свойства стиля textAlign. required Если значение равно true, отображается индикатор, который указывает, что для нижестоящих элементов FormItem требуется ввод информации пользователем.false Если значение равно true, отображается индикатор, который указывает, что для нижестоящих элементов FormItem требуется ввод информации пользователем. Если значение равно false, индикатор не отображается.

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