spark.layoutsVerticalAlign Класс VerticalAlign определяет возможные значения для свойства verticalAlign класса HorizontalLayout.Object Класс VerticalAlign определяет возможные значения для свойства verticalAlign класса HorizontalLayout. HorizontalLayout.verticalAlignBASELINE Вертикальное размещение нижестоящих элементов позволяет выровнять текст по базовой линии контейнера.baseline Вертикальное размещение нижестоящих элементов позволяет выровнять текст по базовой линии контейнера. BOTTOM Вертикальное выравнивание нижестоящих элементов относительно нижнего края контейнера.bottom Вертикальное выравнивание нижестоящих элементов относительно нижнего края контейнера. CONTENT_JUSTIFY Выравнивание содержимого нижестоящих элементов относительно контейнера.contentJustify Выравнивание содержимого нижестоящих элементов относительно контейнера. Таким образом, выполняется единообразная установка размеров всех нижестоящих элементов в соответствии с высотой содержимого контейнера. Высота содержимого контейнера определяет размер самого большого нижестоящего элемента. Если все нижестоящие элементы меньше высоты контейнера, то размеры всех этих нижестоящих элементов устанавливаются в соответствии с высотой контейнера. JUSTIFY Выравнивание нижестоящих элементов относительно контейнера.justify Выравнивание нижестоящих элементов относительно контейнера. Таким образом, выполняется единообразная установка размеров всех нижестоящих элементов в соответствии с высотой контейнера. MIDDLE Вертикальное выравнивание нижестоящих элементов относительно центра контейнера.middle Вертикальное выравнивание нижестоящих элементов относительно центра контейнера. TOP Вертикальное выравнивание нижестоящих элементов относительно верхнего края контейнера.top Вертикальное выравнивание нижестоящих элементов относительно верхнего края контейнера. ColumnAlign Класс ColumnAlign определяет возможные значения для свойства columnAlign класса TileLayout.Object Класс ColumnAlign определяет возможные значения для свойства columnAlign класса TileLayout. TileLayout.columnAlignJUSTIFY_USING_GAP Выравнивает строки путем увеличения вертикального интервала.justifyUsingGap Выравнивает строки путем увеличения вертикального интервала. JUSTIFY_USING_WIDTH Выравнивает строки путем увеличения высоты строки.justifyUsingWidth Выравнивает строки путем увеличения высоты строки. LEFT Выравнивание строк не выполняется.left Выравнивание строк не выполняется. FormLayout Класс FormLayout определяет макет по умолчанию для тем оформления Spark Form.spark.layouts:VerticalLayout Класс FormLayout определяет макет по умолчанию для тем оформления Spark Form. FormLayout предоставляет вертикальный макет для нижестоящих контейнеров FormItem в Form. Если любой из нижестоящих контейнеров использует FormItemLayout, то FormLayout выровняет ConstraintColumns каждого нижестоящего элемента. Количество столбцов в нижестоящих элементах должно быть одинаковым, и для столбцов должен быть указан один тип параметра ширины. Например, если ширина второго столбца первого нижестоящего элемента установлена в процентах, то и ширина второго столбца второго нижестоящего элемента должна быть установлена в процентах.

Примечание. Используйте класс FormLayout только с контейнером Spark Form. Не используйте его для отображения содержимого какого-либо другого контейнера.

spark.components.Formspark.components.FormHeadingspark.components.FormItemspark.layouts.FormItemLayoutFormLayout Конструктор. Конструктор.
FormItemLayout FormItemLayout используется FormItems для предоставления макета на основе ограничений.spark.layouts:ConstraintLayout FormItemLayout используется FormItems для предоставления макета на основе ограничений. Элементы, использующие FormItemLayout в FormLayout, выравниваются по столбцам. FormItemLayout Конструктор. Конструктор. ConstraintLayout Класс ConstraintLayout упорядочивает элементы макета в соответствии с их индивидуальными настройками и набором областей ограничений, определенных столбцами ограничения и строками ограничения.spark.layouts.supportClasses:LayoutBase Класс ConstraintLayout упорядочивает элементы макета в соответствии с их индивидуальными настройками и набором областей ограничений, определенных столбцами ограничения и строками ограничения. Хотя возможно использовать все свойства и ограничения из BasicLayout для изменения позиции или размеров элементов, ConstraintLayout предоставляет средства для создания макетов относительно родственных элементов путем ограничения элементов с учетом указанных столбцов и строк.

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

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

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

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

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

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

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

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

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

ConstraintLayout Конструктор. Конструктор. layoutContent Располагает элементы целевого объекта макета с учетом текущей ширины и высоты столбцов и строк.unscaledWidthУказывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleX компонента. unscaledHeightУказывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства scaleY компонента. Располагает элементы целевого объекта макета с учетом текущей ширины и высоты столбцов и строк. Используется FormItemLayout после установки новых показателей ширины столбца для размещения элементов, использующих эти новые показатели ширины. measureAndPositionColumnsAndRows Используется FormItemLayout для определения и установки новых показателей ширины столбца и высоты строки перед размещением элементов.constrainedWidthunknownПолная ширина, доступная для столбцов, чтобы растянуться или уменьшить их столбцы ширины процента. Если NaN, столбцы ширины процента добровольны и пригодны к их содержимому. constrainedHeightunknownПолная высота, доступная для строк, чтобы растянуться или уменьшить их строки высоты процента. Если NaN, строки высоты процента добровольны и пригодны к их содержимому. Используется FormItemLayout для определения и установки новых показателей ширины столбца и высоты строки перед размещением элементов. constraintColumns Вектор экземпляров ConstraintColumn, разделяющих целевой контейнер. Вектор экземпляров ConstraintColumn, разделяющих целевой контейнер. Экземпляр ConstraintColumn в индексе 0 представляет собой крайний левый столбец; индексы увеличиваются слева направо. constraintRows Вектор экземпляров ConstraintRow, разделяющих целевой контейнер. Вектор экземпляров ConstraintRow, разделяющих целевой контейнер. Экземпляр ConstraintRow в индексе 0 представляет собой самый верхний столбец; индексы увеличиваются сверху вниз.
TileLayout Класс TileLayout упорядочивает элементы макета в столбцах и строках ячеек одинакового размера.The <s:TileLayout> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:TileLayout 
    Properties
    columnAlign="left"
    columnWidth="NaN"
    horizontalAlign="justify"
    horizontalGap="6"
    orientation="rows"
    requestedColumnCount="-1"
    requestedRowCount="-1"
    rowAlign="top"
    rowCount="-1"
    rowHeight="NaN"
    verticalAlign="justify"
    verticalGap="6"
  />
  
]]>
spark.layouts.supportClasses:LayoutBase Класс TileLayout упорядочивает элементы макета в столбцах и строках ячеек одинакового размера. Класс TileLayout использует ряд свойств, управляющих ориентацией, количеством, размером, интервалом и выравниванием столбцов и строк, а также выравниванием элемента в пределах ячеек.

Для каждого элемента поддерживаются такие ограничения, как percentWidth и percentHeight. Минимальные и максимальные размеры элемента учитываются во всех возможных случаях, размер элемента не должен превосходить размер ячейки.

Если свойство columnWidth не установлено явно, его значение совпадает с максимальной предпочтительной шириной границ всех элементов, и значение свойства columnHeight совпадает с максимальной предпочтительной высотой границ всех элементов.

Если свойства columnCount и rowCount не установлены явно, их значения вычисляются на основе любых явных установок ширины и высоты для целевого объекта макета, а также columnWidth и columnHeight. Если указано значение none, значения columnCount и rowCount определяются таким образом, чтобы требуемая область в пикселях по возможности имела форму квадрата.

Измеренный размер вычисляется на основе значений свойств columnCount, rowCount, columnWidth, rowHeight и размеров интервала.

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

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

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

TileLayout Конструктор. Конструктор. calculateDropIndex Возвращает индекс, указывающий на то, где должен быть вставлен новый элемент, когда пользователь отпускает кнопку мыши в указанных координатах при завершении операции перетаскивания.Индекс перетаскивания или -1, если операция перетаскивания не доступна для указанных координат. xКоордината x операции перетаскивания в локальных координатах. yКоордината y операции перетаскивания в локальных координатах целевого объекта перетаскивания. Возвращает индекс, указывающий на то, где должен быть вставлен новый элемент, когда пользователь отпускает кнопку мыши в указанных координатах при завершении операции перетаскивания. Вызывается методом calculatedDropLocation(). calculateDropIndicatorBounds Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания.Границы для индикатора перетаскивания или значение null. dropLocationspark.layouts.supportClasses:DropLocationДопустимый объект DropLocation, ранее возвращенный методом calculateDropLocation(). Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания. Вызывается методом showDropIndicator(). columnAlign Указывает способ выравнивания полностью видимых столбцов по ширине контейнера.ColumnAlign.LEFT Указывает способ выравнивания полностью видимых столбцов по ширине контейнера. Допустимы следующие значения ActionScript: ColumnAlign.LEFT, ColumnAlign.JUSTIFY_USING_GAP и ColumnAlign.JUSTIFY_USING_WIDTH. Возможными значениями MXML могут являться left, justifyUsingGap и justifyUsingWidth.

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

Если установлено значение ColumnAlign.JUSTIFY_USING_GAP фактическое значение horizontalGap увеличивается таким образом, что правый край последнего полностью видимого столбца выравнивается по правому краю контейнера. При наличии единственного полностью видимого столбца фактическое значение horizontalGap увеличивается таким образом, что любой частично видимый столбец перемещается за пределы правого края контейнера. Обратите внимание, что явная установка свойства horizontalGap не отключает выравнивание. Она только определяет начальное значение интервала. Выравнивание может увеличить его.

Если установлено значение ColumnAlign.JUSTIFY_USING_WIDTH, фактическое значение columnWidth увеличивается таким образом, что правый край последнего полностью видимого столбца выравнивается по правому краю контейнера. Обратите внимание, что явная установка свойства columnWidth не отключает выравнивание. Она только определяет начальное значение ширины столбца. Выравнивание может увеличить его.

horizontalGapcolumnWidthrowAlign
columnCount Содержит фактическое количество столбцов.-1 Содержит фактическое количество столбцов. rowCountcolumnAligncolumnWidth Содержит действительную ширину столбца в пикселях.NaN Содержит действительную ширину столбца в пикселях.

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

Если свойство columnAlign устанавливаются на justifyUsingWidth, ширина столбца увеличивается до ширины контейнера для выравнивания полностью видимых столбцов.

rowHeightcolumnAlign
horizontalAlign Указывает способ горизонтального выравнивания элементов в ячейках.<code>HorizontalAlign.JUSTIFY</code> Указывает способ горизонтального выравнивания элементов в ячейках. Поддерживаются следующие значения: HorizontalAlign.LEFT, HorizontalAlign.CENTER, HorizontalAlign.RIGHT, HorizontalAlign.JUSTIFY.

Если установлено значение HorizontalAlign.JUSTIFY, ширина каждого элемента соответствует columnWidth.

horizontalGap Промежуток по горизонтали между столбцами в пикселях.6 Промежуток по горизонтали между столбцами в пикселях. verticalGapcolumnAlignorientation Указывает, упорядочены ли элементы по строкам или по столбцам.TileOrientation.ROWS Указывает, упорядочены ли элементы по строкам или по столбцам. Допустимы следующие значения ActionScript: TileOrientation.ROWS и TileOrientation.COLUMNS. Возможными значениями MXML могут являться rows и columns. paddingBottom Число пикселей между нижним краем контейнера и нижним краем последнего элемента макета.0 Число пикселей между нижним краем контейнера и нижним краем последнего элемента макета. paddingLeft Минимальное число пикселей между левым краем контейнера и левым краем элемента макета.0 Минимальное число пикселей между левым краем контейнера и левым краем элемента макета. paddingRight Минимальное число пикселей между правым краем контейнера и правым краем элемента макета.0 Минимальное число пикселей между правым краем контейнера и правым краем элемента макета. paddingTop Число пикселей между верхним краем контейнера и верхним краем первого элемента макета.0 Число пикселей между верхним краем контейнера и верхним краем первого элемента макета. requestedColumnCount Число отображаемых столбцов.-1 Число отображаемых столбцов.

Значение -1 используется для предоставления TileLayout возможности автоматического определения количества столбцов.

Если свойство orientation устанавливается на TileOrientation.ROWS, то установка этого свойства не оказывает никакого влияния. В этом случае явно устанавливается rowCount, а также явно устанавливается ширина контейнера.

columnCountcolumnAlign
requestedRowCount Число отображаемых строк.-1 Число отображаемых строк.

Значение -1 устанавливается в целях удаления явного переопределения и предоставления TileLayout возможности автоматического определения счетчика строк.

Если свойство orientation устанавливается на TileOrientation.COLUMNS, то установка этого свойства не оказывает никакого влияния. В этом случае явно устанавливается columnCount, а также явно устанавливается высота контейнера.

rowCountrowAlign
rowAlign Указывает способ выравнивания полностью видимых строк по высоте контейнера.RowAlign.TOP Указывает способ выравнивания полностью видимых строк по высоте контейнера. Допустимы следующие значения ActionScript: RowAlign.TOP, RowAlign.JUSTIFY_USING_GAP и RowAlign.JUSTIFY_USING_HEIGHT. Возможными значениями MXML могут являться top, justifyUsingGap и justifyUsingHeight.

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

Если установлено значение RowAlign.JUSTIFY_USING_GAP, фактическое значение verticalGap увеличивается таким образом, что нижний край последней полностью видимой строки выравнивается с нижним краем контейнера. При наличии единственной полностью видимой строки значение verticalGap увеличивается таким образом, что любая частично видимая строка перемещается за пределы нижнего края контейнера. Обратите внимание, что явная установка verticalGap не отключает выравнивание, а только определяет начальное значение интервала. При этом выравнивание может увеличить его.

Если установлено значение RowAlign.JUSTIFY_USING_HEIGHT, фактическое значение rowHeight увеличивается таким образом, что нижний край последней полностью видимой строки выравнивается по нижнему краю контейнера. Обратите внимание, что явная установка rowHeight не отключает выравнивание, а определяет начальное значение высоты строки. При этом выравнивание может увеличить его.

verticalGaprowHeightcolumnAlign
rowCount Количество строк.-1 Количество строк. requestedRowCountcolumnCountrowHeight Высота строки в пикселях.NaN Высота строки в пикселях.

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

Если для rowAlign установлено значение justifyUsingHeight, то фактическая высота строки увеличивается для обеспечения выравнивания полностью видимых строк относительно высоты контейнера.
columnWidthrowAlign
verticalAlign Указывает способ вертикального выравнивания элементов в ячейках.<code>VerticalAlign.JUSTIFY</code> Указывает способ вертикального выравнивания элементов в ячейках. Поддерживаются следующие значения: VerticalAlign.TOP, VerticalAlign.MIDDLE, VerticalAlign.BOTTOM, VerticalAlign.JUSTIFY.

Если установлено значение VerticalAlign.JUSTIFY, высота каждого элемента соответствует rowHeight.

verticalGap Промежуток по вертикали между строками в пикселях.6 Промежуток по вертикали между строками в пикселях. horizontalGaprowAlign
VerticalLayout Класс VerticalLayout упорядочивает элементы макета в последовательность по вертикали, сверху вниз, с необязательными интервалами между элементами и необязательным заполнением вокруг последовательности элементов.The <s:VerticalLayout> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:VerticalLayout 
    Properties
    gap="6"
    horizontalAlign="left"
    paddingBottom="0"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
    requestedMaxRowCount="-1"
    requestedMinRowCount="-1"
    requestedRowCount="-1"
    rowHeight="calculated"
    variableRowHeight="true"
    verticalAlign="top"
  />
  
]]>
spark.layouts.supportClasses:LayoutBase Класс VerticalLayout упорядочивает элементы макета в последовательность по вертикали, сверху вниз, с необязательными интервалами между элементами и необязательным заполнением вокруг последовательности элементов.

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

Горизонтальная позиция элементов определяется свойством horizontalAlign макета.

При выполнении метода measure() вычисляется стандартный размер контейнера путем суммирования предпочтительных размеров элементов, включая интервалы и заполнение. Если установлен requestedRowCount будет измерено только пространство для определяемого этим количеством элементов, начиная с первого элемента.

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

  • Если variableRowHeight имеет значение false, в качестве высоты элемента устанавливается значение свойства rowHeight.
  • Если для элемента установлено значение percentHeight то высота элемента вычисляется путем распределения доступной высоты контейнера между всеми элементами с параметром percentHeight. Доступная высота контейнера равняется высоте контейнера минус промежутки, заполнения и пространство, занимаемое остальными элементами. При виртуализации макета свойство precentHeight элемента игнорируется.
  • Установите высоту элемента в соответствии с его предпочтительной высотой.

Ширина каждого элемента вычисляется согласно следующим правилам, перечисленным в порядке их приоритетов (при этом всегда учитывается минимальная и максимальная ширина элемента):

  • Если horizontalAlign имеет значение justify, то ширина элемента соответствует ширине контейнера.
  • Если horizontalAlign имеет значение contentJustify, то ширина элемента соответствует максимальному значению из ширины контейнера и значений предпочтительной ширины всех элементов.
  • Если для элемента установлено значение percentWidth, то ширина этого элемента соответствует процентному выражению ширины контейнера.
  • Установите ширину элемента в соответствии с его предпочтительной шириной.
VerticalLayout Конструктор. Конструктор. fractionOfElementInView Возвращает 1.0, если указанный индекс полностью находится в поле зрения; 0.0, если это не так; или значение между 0.0 и 1.0, которое указывает на процент частично видимого индекса.Процентное значение указанного элемента, находящегося в видимой области. Возвращает 0.0, если указанная позиция индекса является недопустимой или соответствует элементу null, либо ILayoutElement, для которого значением свойства includeInLayout является false. indexИндекс строки. Возвращает 1.0, если указанный индекс полностью находится в поле зрения; 0.0, если это не так; или значение между 0.0 и 1.0, которое указывает на процент частично видимого индекса.

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

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

firstIndexInView Индекс первого элемента макета, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. Индекс первого элемента макета, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует.

«Часть макета» означает, что элемент не является null, и его свойство includeInLayout имеет значение true.

Следует отметить, что элемент макета может находиться в поле зрения только частично.

fractionOfElementInView()
gap Промежуток по вертикали между элементами макета в пикселях.6 Промежуток по вертикали между элементами макета в пикселях. Следует отметить, что этот интервал определяет только расстояние между элементами макета, таким образом, при наличии единственного элемента, интервал не оказывает влияния на макет. horizontalAlign Выравнивание элементов макета по горизонтали."left" Выравнивание элементов макета по горизонтали. Если значение – left, right или center, то элемент макета выравнивается относительно свойства contentWidth контейнера.

Если значением является contentJustify, то в качестве фактической ширины элемента макета используется contentWidth контейнера. contentWidth контейнера является шириной наибольшего элемента макета. Если все элементы макета меньше ширины контейнера, следует установить ширину всех элементов макета на значение ширины контейнера.

Если значение является justify, то в качестве фактической ширины элемента макета используется ширина контейнера.

Это свойство не влияет на измеренный размер макета.

lastIndexInView Индекс последней строки, являющейся частью макета и расположенной в пределах прямоугольника прокрутки контейнера; либо -1, если отображение еще отсутствует. Индекс последней строки, являющейся частью макета и расположенной в пределах прямоугольника прокрутки контейнера; либо -1, если отображение еще отсутствует.

«Часть макета» означает, что нижестоящий элемент не является null, и его свойство includeInLayout имеет значение true.

Следует отметить, что строка может находиться в поле зрения частично.

firstIndexInViewfractionOfElementInView
paddingBottom Число пикселей между нижним краем контейнера и нижним краем последнего элемента макета.0 Число пикселей между нижним краем контейнера и нижним краем последнего элемента макета. paddingLeft Минимальное число пикселей между левым краем контейнера и левым краем элемента макета.0 Минимальное число пикселей между левым краем контейнера и левым краем элемента макета. paddingRight Минимальное число пикселей между правым краем контейнера и правым краем элемента макета.0 Минимальное число пикселей между правым краем контейнера и правым краем элемента макета. paddingTop Число пикселей между верхним краем контейнера и верхним краем первого элемента макета.0 Число пикселей между верхним краем контейнера и верхним краем первого элемента макета. requestedMaxRowCount Измеренная высота этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxRowCount.-1 Измеренная высота этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxRowCount.

Если requestedRowCount установлено, то это свойство не имеет никакого эффекта.

Если реальный размер контейнера был установлен явно, то это свойство не используется.

requestedRowCountrequestedMinRowCount
requestedMinRowCount Измеренная высота этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinRowCount.-1 Измеренная высота этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinRowCount.

Если requestedRowCount установлено, то это свойство не имеет никакого эффекта.

Если реальный размер контейнера был установлен явно, то это свойство не используется.

requestedRowCountrequestedMaxRowCount
requestedRowCount Измеренный размер этого макета достаточно большой в высоту, чтобы отобразить первые requestedRowCount элементов макета.-1 Измеренный размер этого макета достаточно большой в высоту, чтобы отобразить первые requestedRowCount элементов макета.

Если requestedRowCount имеет значение -1, то измеренный размер будет достаточным для отображения всех элементов макета.

Если реальный размер контейнера был установлен явно, то это свойство не используется.

requestedMinRowCountrequestedMaxRowCount
rowCount Текущее количество видимых элементов.-1 Текущее количество видимых элементов. rowHeight Если variableRowHeight имеет значение false, то это свойство указывает фактическую высоту каждого нижестоящего элемента в пикселях. Если variableRowHeight имеет значение false, то это свойство указывает фактическую высоту каждого нижестоящего элемента в пикселях.

Если variableRowHeight имеет значение true, заданное по умолчанию, установка этого свойства не приведет к выполнению каких-либо действий.

Значением этого свойства по умолчанию является предпочтительная высота typicalLayoutElement.

variableRowHeight Определяет, распределены ли элементы макета с учетом их предпочтительной высоты.true Определяет, распределены ли элементы макета с учетом их предпочтительной высоты. Установка этого свойства на false указывает на строки фиксированной высоты.

В случае значения false фактическая высота каждого элемента макета соответствует значению rowHeight. Установка этого свойства на false приводит к игнорированию макетом значений свойства percentHeight элемента макета.

verticalAlign Вертикальное выравнивание содержимого по отношению к высоте контейнера."top" Вертикальное выравнивание содержимого по отношению к высоте контейнера.

Если значение – bottom, middle или top, то элементы макета выравниваются относительно свойства contentHeight контейнера.

Это свойство не оказывает никакого эффекта, если clipAndEnableScrolling имеет значение true и contentHeight превышает высоту контейнера.

Это свойство не влияет на измеренный размер макета.

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

  <s:HorizontalLayout 
    Properties
    columnWidth="calculated"
    gap="6"
    paddingBottom="0"
    paddingLeft="0"
    paddingRight="0"
    paddingTop="0"
    requestedColumnCount="-1"
    requestedMaxColumnCount="-1"
    requestedMinColumnCount="-1"
    variableColumnWidth="true"
    verticalAlign="top"
  />
  
]]>
spark.layouts.supportClasses:LayoutBase Класс HorizontalLayout упорядочивает элементы макета в последовательности по горизонтали, слева направо, с необязательными интервалами между элементами и необязательным заполнением вокруг элементов.

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

Вертикальная позиция элементов определяется свойством verticalAlign макета.

При выполнении метода measure() вычисляется стандартный размер контейнера путем суммирования предпочтительных размеров элементов, включая интервалы и заполнение. Если свойство requestedColumnCount установлено на значение, отличное от -1, выполняется измерение пространства только для нескольких элементов, начиная с первого.

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

  • Если variableColumnWidth имеет значение false, в качестве ширины элемента устанавливается значение свойства columnWidth.
  • Если для элемента установлено значение percentWidth то ширина элемента вычисляется путем распределения доступной ширины контейнера между всеми элементами с параметром percentWidth. Доступная ширина контейнера равняется ширине контейнера минус промежутки, заполнения и пространство, занимаемого остальными элементами. При виртуализации макета свойство precentWidth элемента игнорируется.
  • Установите ширину элемента в соответствии с его предпочтительной шириной.

Высота каждого элемента вычисляется согласно следующим правилам, перечисленным в порядке их приоритетов (при этом всегда учитывается минимальная и максимальная высота элемента).

  • Если свойство verticalAlign имеет значение justify, то высота элемента соответствует высоте контейнера.
  • Если свойство verticalAlign имеет значение contentJustify, то высота элемента соответствует максимальному значению из высоты контейнера и значений предпочтительной высоты всех элементов.
  • Если для элемента установлено свойство percentHeight то высота этого элемента соответствует процентному выражению высоты контейнера.
  • Установите высоту элемента в соответствии с его предпочтительной высотой.
HorizontalLayout Конструктор. Конструктор. fractionOfElementInView Возвращает 1.0, если указанный индекс полностью находится в поле зрения; 0.0, если это не так; или значение между 0.0 и 1.0, которое указывает на процент частично видимого индекса.Процентное значение указанного элемента, находящегося в видимой области. Возвращает 0.0, если указанная позиция индекса является недопустимой или соответствует элементу null, либо ILayoutElement, для которого значением свойства includeInLayout является false. indexИндекс столбца. Возвращает 1.0, если указанный индекс полностью находится в поле зрения; 0.0, если это не так; или значение между 0.0 и 1.0, которое указывает на процент частично видимого индекса.

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

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

columnCount Возвращает текущее количество элементов, отображаемых в представлении.-1 Возвращает текущее количество элементов, отображаемых в представлении. columnWidth Если свойство variableColumnWidth имеет значение false, то это свойство указывает фактическую ширину каждого элемента макета в пикселях. Если свойство variableColumnWidth имеет значение false, то это свойство указывает фактическую ширину каждого элемента макета в пикселях.

Если свойство variableColumnWidth имеет значение true, заданное по умолчанию, установка этого свойства не приведет к выполнению каких-либо действий.

Значение по умолчанию этого свойства является предпочтительной шириной элемента, определенного свойством typicalLayoutElement.

firstIndexInView Индекс первого столбца, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. Индекс первого столбца, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. Следует отметить, что столбец может находиться в видимой области только частично. lastIndexInViewfractionOfElementInViewgap Промежуток по горизонтали между элементами макета в пикселях.6 Промежуток по горизонтали между элементами макета в пикселях. Следует отметить, что этот интервал определяет только расстояние между элементами макета, таким образом, при наличии единственного элемента, интервал не оказывает влияния на макет. horizontalAlign Горизонтальное выравнивание содержимого по отношению к ширине контейнера."left" Горизонтальное выравнивание содержимого по отношению к ширине контейнера. Если значение – left, right или center, то элемент макета выравнивается относительно свойства contentWidth контейнера.

Это свойство не оказывает никакого эффекта, если clipAndEnableScrolling имеет значение true и contentWidth превышает ширину контейнера.

Это свойство не влияет на измеренный размер макета.

lastIndexInView Индекс последнего столбца, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. Индекс последнего столбца, который является частью макета и расположен в пределах прямоугольника прокрутки целевого объекта макета; либо -1, если отображение еще отсутствует. Следует отметить, что столбец может находиться в видимой области только частично. firstIndexInViewfractionOfElementInViewpaddingBottom Минимальное число пикселей между нижним краем контейнера и нижней границей всех элементов макета в контейнере.0 Минимальное число пикселей между нижним краем контейнера и нижней границей всех элементов макета в контейнере. paddingLeft Число пикселей между левым краем контейнера и левым краем первого элемента макета.0 Число пикселей между левым краем контейнера и левым краем первого элемента макета. paddingRight Число пикселей между правым краем контейнера и правым краем последнего элемента макета.0 Число пикселей между правым краем контейнера и правым краем последнего элемента макета. paddingTop Число пикселей между верхним краем контейнера и верхней границей всех элементов макета в контейнере.0 Число пикселей между верхним краем контейнера и верхней границей всех элементов макета в контейнере. requestedColumnCount Измеренный размер этого макета является достаточно широким для отображения первых элементов макета requestedColumnCount.-1 Измеренный размер этого макета является достаточно широким для отображения первых элементов макета requestedColumnCount. Если requestedColumnCount имеет значение -1, то измеренный размер будет достаточным для отображения всех элементов макета.

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

requestedMinColumnCountrequestedMaxColumnCount
requestedMaxColumnCount Измеренная ширина этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxColumnCount.-1 Измеренная ширина этого макета является достаточно большой, чтобы максимально отобразить элементы макета requestedMaxColumnCount.

Если requestedColumnCount установлено, то это свойство не имеет никакого эффекта.

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

requestedColumnCountrequestedMinColumnCount
requestedMinColumnCount Измеренная ширина этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinColumnCount.-1 Измеренная ширина этого макета является достаточно большой, чтобы отобразить по крайней мере элементы макета requestedMinColumnCount.

Если requestedColumnCount установлено, то это свойство не имеет никакого эффекта.

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

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

Установка для этого свойства значения false указывает на столбцы фиксированной ширины. Фактическая ширина каждого элемента макета является значением свойства columnWidth, и макет игнорирует свойство percentWidth элементов макета.

verticalAlign Выравнивание элементов макета по вертикали."top" Выравнивание элементов макета по вертикали.

Если значение – bottom, middle или top, то элементы макета выравниваются относительно свойства contentHeight контейнера.

Если значение – contentJustify, то фактическая высота данного элемента макета устанавливается на значение свойства contentHeight контейнера. Высота содержимого контейнера определяет высоту самого большого элемента макета. Если все элементы макета меньше высоты контейнера, следует установить высоту всех элементов макета на значение высоты контейнера.

Если значение – justify, то фактическая высота элементов макета устанавливается на значение высоты контейнера.

Если указано значение baseline, то текст элементов выравнивается с учетом максимального значения выносных текстовых объектов элементов.

TileOrientation Класс TileOrientation определяет возможные значения для свойства orientation класса TileLayout.Object Класс TileOrientation определяет возможные значения для свойства orientation класса TileLayout. TileLayout.orientationCOLUMNS Упорядочивает элементы по столбцам.columns Упорядочивает элементы по столбцам. ROWS Упорядочивает элементы по строкам.rows Упорядочивает элементы по строкам. RowAlign Класс RowAlign определяет возможные значения для свойства rowAlign класса TileLayout.Object Класс RowAlign определяет возможные значения для свойства rowAlign класса TileLayout. TileLayout.rowAlignJUSTIFY_USING_GAP Выравнивает строки путем увеличения вертикального интервала.justifyUsingGap Выравнивает строки путем увеличения вертикального интервала. JUSTIFY_USING_HEIGHT Выравнивает строки путем увеличения высоты строки.justifyUsingHeight Выравнивает строки путем увеличения высоты строки. TOP Выравнивание строк не выполняется.top Выравнивание строк не выполняется. HorizontalAlign Класс HorizontalAlign определяет возможные значения для свойства horizontalAlign класса VerticalLayout.Object Класс HorizontalAlign определяет возможные значения для свойства horizontalAlign класса VerticalLayout. VerticalLayout.horizontalAlignCENTER Выравнивание нижестоящих элементов относительно центра контейнера.center Выравнивание нижестоящих элементов относительно центра контейнера. CONTENT_JUSTIFY Выравнивание содержимого нижестоящих элементов относительно контейнера.contentJustify Выравнивание содержимого нижестоящих элементов относительно контейнера. Таким образом, выполняется единообразная установка размеров всех нижестоящих элементов в соответствии с шириной содержимого контейнера. Ширина содержимого контейнера определяет размер самого большого нижестоящего элемента. Если все нижестоящие элементы меньше ширины контейнера, то размеры всех этих нижестоящих элементов устанавливаются в соответствии с шириной контейнера. JUSTIFY Выравнивание нижестоящих элементов относительно контейнера.justify Выравнивание нижестоящих элементов относительно контейнера. Таким образом, выполняется единообразная установка размеров всех нижестоящих элементов в соответствии с шириной контейнера. LEFT Выравнивание нижестоящих элементов относительно левого края контейнера.left Выравнивание нижестоящих элементов относительно левого края контейнера. RIGHT Выравнивание нижестоящих элементов относительно правого края контейнера.right Выравнивание нижестоящих элементов относительно правого края контейнера. BasicLayout Класс BasicLayout упорядочивает элементы макета в соответствии с их индивидуальными параметрами вне зависимости друг от друга.The <s:BasicLayout> tag inherits all of the tag attributes of its superclass and adds no additional tag attributes:

  <s:BasicLayout/>
  
]]>
spark.layouts.supportClasses:LayoutBase Класс BasicLayout упорядочивает элементы макета в соответствии с их индивидуальными параметрами вне зависимости друг от друга. BasicLayout, также называемый абсолютным макетом, требует явного позиционирования каждого нижестоящего элемента контейнера. Для позиционирования нижестоящих элементов используются свойства x и y каждого нижестоящего элемента или ограничения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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