LayoutBase  - AS3 Flex

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

Значением по умолчанию является false.

DisplayObject, который этот макет использует для индикатора перетаскивания во время операции перетаскивания. Как правило, это свойство не устанавливается напрямую, вместо этого определяется элемент темы оформления dropIndicator в классе темы оформления объекта перетаскивания.

Элемент управления List назначает это свойство в ответ на событие DragEvent.DRAG_ENTER. List инициализирует это свойство с помощью экземпляра его компонента темы оформления dropIndicator. List устанавливает это свойство в ответ на событие DragEvent.DRAG_EXIT.

Координата Х исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. Если clipAndEnableScrolling имеет значение true, установка этого свойства, как правило, приводит к следующей настройке области просмотра:

      new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)
      

Значением по умолчанию является 0.

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

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

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

Значением по умолчанию является null.

Связанные элементы API

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

Это свойство ссылается на компонент, который Flex использует для определения высоты всех нижестоящих элементов контейнера, как показано в следующем примере:

      <s:Group>
        <s:layout>
          <s:VerticalLayout variableRowHeight="false"
              typicalLayoutElement="{b3}"/> 
        </s:layout>
        <s:Button id="b1" label="Button 1"/>
        <s:Button id="b2" label="Button 2"/>
        <s:Button id="b3" label="Button 3" fontSize="36"/>
        <s:Button id="b4" label="Button 4" fontSize="24"/>
      </s:Group>

Если это свойство не было установлено и целевому объекту не соответствует значение null, кэшируется и возвращается первый элемент макета.

Значением по умолчанию является первый элемент макета целевого объекта.

Значением по умолчанию является null.

Связанные элементы API

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

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

Для настройки контейнера с целью использования виртуального макета необходимо установить свойство useVirtualLayout на значение true для макета, ассоциированного с данным контейнером. Виртуальный макет поддерживается только DataGroup или SkinnableDataContainer с макетом, для которого установлено значение VerticalLayout, HorizontalLayout или TileLayout. Не поддерживающие виртуализацию подклассы макета должны предотвращать изменение этого свойства.

Примечание: Класс BasicLayout создает ошибку во время выполнения программы, если Вы устанавливаете useVirtualLayout к true.

При значении true поддерживающие виртуализацию макеты должны использовать метод target.getVirtualElementAt(), а не getElementAt(), а также должны получать только элементы, ожидаемые ими, которые будут видимы при выдаче значения getScrollRect().

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

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

Подобным образом, в методе measure() виртуальные макеты должны не измерять элементы, а обновить свойства измеренного размера целевого объекта, основанные на typicalLayoutElement и другой кэшируемой информации макета.

Контейнеры обмениваются данными с макетами, имеющими useVirtualLayout = true, путем повторного использования средств визуализации элементов, которые были созданы ранее, но более не используются. Элемент считается неиспользуемым, если его индекс находится вне диапазона индексов getVirtualElementAt() запрашиваемых в процессе самого последнего вызова updateDisplayList() контейнера.

Значением по умолчанию является false.

Связанные элементы API

Координата Y исходной точки поля зрения в системе координат компонента, где значением по умолчанию является (0,0), что соответствует левому верхнему углу области компонента. Если clipAndEnableScrolling имеет значение true, установка этого свойства, как правило, приводит к следующей настройке области просмотра:

      new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)
      

Значением по умолчанию является 0.

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

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

Вычисляет значение прокрутки для указанного dropLocation во время операции перетаскивания. Вызывается методом showDropIndicator() для вычисления прокрутки во время прокрутки перетаскивания.

Параметры

Связанные элементы API

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

Параметры

Связанные элементы API

Вычисляет границы для индикатора перетаскивания с целью визуального представления точки вставки элементов при завершении операции перетаскивания. Вызывается методом showDropIndicator().

Параметры

Связанные элементы API

Вычисляет местоположение перетаскивания в поставщике данных целевого объекта перетаскивания для указанного dragEvent.

Параметры

Связанные элементы API

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

Например, при изменении свойств dataProvider или itemRenderer DataGroup кэшированные размеры элементов станут недействительными.

При изменении значения свойства useVirtualLayout на false этот метод вызывается автоматически.

Подклассы, поддерживающие useVirtualLayout = true, должны перезаписывать этот метод.

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

При вызове метода целевым объектом гарантируется только то, что элемент макета будет существовать в указанной позиции индекса в момент выполнения updateDisplayList(). Так, например, элемент DataGroup с виртуальным макетом обеспечит вызов этого метода после добавления элемента к dataProvider целевого объекта.

По умолчанию данный метод не выполняет никаких действий.

Параметры

Связанные элементы API

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

При вызове метода целевым объектом гарантируется только то, что элемент макета не будет существовать в указанной позиции индекса в момент выполнения updateDisplayList(). Например, DataGroup с виртуальным макетом вызывает этот метод, когда элемент добавляется к свойству dataProvider.

По умолчанию данный метод не выполняет никаких действий.

Параметры

Связанные элементы API

Возвращает границы макета указанного элемента в виде элемента Rectangle или значения null, если индекс недействителен, соответствующий элемент имеет значение null, includeInLayout=false или значением свойства target этого макета является null.

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

Параметры

Связанные элементы API

Возвращает границы первого элемента макета, охватывающего верхний край scrollRect или находящегося над ним.

Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta()по умолчанию. Подклассы, зависящие от реализации getVerticalScrollPositionDelta() по умолчанию, должны обеспечить изменение этого метода для предоставления точного ограничивающего прямоугольника, имеющего допустимые значения свойств top и bottom .

По умолчанию этот метод возвращает Rectangle со значениями width=0, height=1, верхний край которого меньше верхнего края scrollRect, и left=0.

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

Параметры

Связанные элементы API

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

Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta()по умолчанию. Подклассы, зависящие от реализации getVerticalScrollPositionDelta() по умолчанию, должны обеспечить изменение этого метода для предоставления точного ограничивающего прямоугольника, имеющего допустимые значения свойств top и bottom .

По умолчанию этот метод возвращает Rectangle со значениями width=0, height=1, нижний край которого больше нижнего края scrollRect, и left=0.

Параметры

Связанные элементы API

Возвращает границы первого элемента макета, охватывающего левый край scrollRect или находящегося слева от него.

Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta() по умолчанию. Подклассы, зависящие от реализации getHorizontalScrollPositionDelta() по умолчанию должны обеспечить изменение этого метода для предоставления точной ограничивающего прямоугольника, имеющего допустимые свойства left и right.

По умолчанию этот метод возвращает Rectangle со значениями width=1, height=0, левый край которого меньше левого края scrollRect, и top=0.

Параметры

Связанные элементы API

Возвращает границы первого элемента макета, охватывающего правый край scrollRect или находящегося справа от нее.

Это стандартный метод, используемый реализацией метода getHorizontalScrollPositionDelta() по умолчанию. Подклассы, зависящие от реализации getHorizontalScrollPositionDelta() по умолчанию должны обеспечить изменение этого метода для предоставления точной ограничивающего прямоугольника, имеющего допустимые свойства left и right.

По умолчанию этот метод возвращает Rectangle со значениями width=1, height=0, правый край которого больше правого края scrollRect, и top=0.

Параметры

Связанные элементы API

Возвращает изменение горизонтального положения прокрутки для работы с различными параметрами прокрутки. Эти параметры определяются классом NavigationUnit: END, HOME, LEFT, PAGE_LEFT, PAGE_RIGHT и RIGHT.

Параметры

Связанные элементы API

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

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

Параметры

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

Этот метод обеспечивает попытку минимизации изменений verticalScrollPosition и horizontalScrollPosition.

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

Параметры

Связанные элементы API

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

Возвращает изменение вертикального положения прокрутки для работы с различными параметрами прокрутки. Эти параметры определяются классом NavigationUnit: DOWN, END, HOME, PAGE_DOWN, PAGE_UP и UP.

Параметры

Связанные элементы API

Скрывает показанный ранее индикатор перетаскивания, созданный методом showDropIndicator(), удаляет его из списка отображения и также останавливает прокрутку перетаскивания.

Связанные элементы API

Обеспечивает измерение размера целевого объекта по умолчанию на основе его содержимого и дополнительно измеряет минимальный размер целевого объекта по умолчанию.

Это один из тех методов, которые должны быть переопределены при создании подкласса LayoutBase. Другим методом является updateDisplayList(). Вызов этих методов напрямую не требуется. Этот метод вызывается в среде Flex при передаче макета. Передача макета включает в себя три этапа.

Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода commitProperties для целевого объекта.

Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода validateSize() для целевого объекта. Метод целевого объекта validateSize() в свою очередь вызовет метод макета measure() для вычисления размера целевого объекта по умолчанию, если он не был явным образом задан с помощью свойств explicitWidth и explicitHeight целевого объекта. При изменении размера по умолчанию список отображения целевого объекта в среде Flex будет признан недействительным.

На последнем этапе, если список отображения целевого объекта является недействительным, LayoutManager обеспечит вызов метода validateDisplayList для целевого объекта. Метод validateDisplayList, в свою очередь, вызовет метод макета updateDisplayList для изменения размера и позиционирования элементов целевого объекта.

При реализации данного метода необходимо установить свойства measuredWidth и measuredHeight для определения размера целевого объекта по умолчанию. Свойства measuredMinWidth и measuredMinHeight можно дополнительно настроить для определения минимального размера по умолчанию. Типичная реализация обеспечивает итерации для элементов целевого объекта и использование методов, определенных ILayoutElement, для накопления предпочтительных и/или минимальных размеров элементов и последующей установки свойств measuredWidth, measuredHeight, measuredMinWidth и measuredMinHeight целевых объектов.

Связанные элементы API

Вызывается при изменении свойств verticalScrollPosition или horizontalScrollPosition.

Реализация по умолчанию обеспечивает обновление свойства scrollRect целевого объекта путем вызова updateScrollRect(). Этот метод может быть переопределен подклассами для вычисления других значений, основанных на текущих значениях scrollPosition или scrollRect.

Связанные элементы API

Размеры, положение и вышестоящие объекты индикатора перетаскивания, основанные на указанном местоположении перетаскивания. Метод calculateDropLocation() используется для получения объекта DropLocation.

Начинает/останавливает прокрутку при перетаскивании при соблюдении соответствующих условий.

Параметры

Связанные элементы API

Размеры и местоположения элементов целевого объекта.

Это один из тех методов, которые должны быть переопределены при создании подкласса LayoutBase. Другим методом является measure(). Вызов этих методов напрямую не требуется. Этот метод вызывается в среде Flex при передаче макета. Передача макета включает в себя три этапа.

Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода commitProperties для целевого объекта.

Сначала, если свойства целевого объекта являются недопустимыми, LayoutManager обеспечивает вызов метода validateSize() для целевого объекта. Метод целевого объекта validateSize() в свою очередь вызовет метод макета measure() для вычисления размера целевого объекта по умолчанию, если он не был явным образом задан с помощью свойств explicitWidth и explicitHeight целевого объекта. При изменении размера по умолчанию список отображения целевого объекта в среде Flex будет признан недействительным.

На последнем этапе, если список отображения целевого объекта является недействительным, LayoutManager обеспечит вызов метода validateDisplayList для целевого объекта. Метод validateDisplayList, в свою очередь, вызовет метод макета updateDisplayList для изменения размера и позиционирования элементов целевого объекта.

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

Параметры

Связанные элементы API

Вызывается целевым объектом в конце updateDisplayList для обновления свойства scrollRect макета.

Если clipAndEnableScrolling имеет значение true, реализация по умолчанию используется для установки происхождения scrollRect целевого объекта на verticalScrollPosition, horizontalScrollPosition. Устанавливает свой размер в параметрах width, height (немасштабированная ширина и высота целевого объекта).

Если clipAndEnableScrolling имеет значение false, реализация по умолчанию обеспечивает установку значения null для свойства scrollRect.

Параметры

Связанные элементы API