spark.components.gridClassesGridColumn Класс GridColumn определяет столбец элемента управления сетки Spark, например Spark DataGrid или Grid.The <s:GridColumn> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GridColumn
    Properties
    dataField="null"
    dataTipField="null"
    dataTipFormatter="null"
    dataTipFunction="null"
    editable="true"
    formatter="null"
    headerRenderer="null"
    headerText="value of dataField"
    imeMode="null"
    itemEditor="null"
    itemRenderer="null"
    itemRendererFunction="null"
    labelFunction="null"
    maxWidth="NaN"
    minWidth="20"
    rendererIsEditable="false"
    resizeable="true"
    showDataTips="undefined"
    sortable="true"
    sortCompareFunction="null"
    sortDescending="false"
    visible="true"
    width="NaN"
  />
  
]]>
flash.events:EventDispatcher Класс GridColumn определяет столбец элемента управления сетки Spark, например Spark DataGrid или Grid. Каждый элемент поставщика данных для элемента управления соответствует одной строке сетки. Класс GridColumn указывает поле элемента поставщика данных, значение которого должно отобразиться в столбце. Он также указывает средство визуализации элементов, используемое для отображения этого значения, редактор элементов, используемый для изменения значения, и другие свойства столбца. spark.components.Gridspark.components.DataGridGridColumn Конструктор.columnNamenullИсходное значение свойств dataField и headerText. Конструктор. itemToDataTip Преобразование указанного элемента поставщика данных в зависящую от столбца строку datatip.Зависящая от столбца строка для указанного элемента поставщика данных или ERROR_TEXT. itemЗначение grid.dataProvider.getItemAt(rowIndex). Преобразование указанного элемента поставщика данных в зависящую от столбца строку datatip.

Этот метод использует значения dataTipField и dataTipFunction. Если для свойств указано значение null, он использует соответствующие свойства из связанного элемента управления сетки. Если для свойства dataTipField также указано значение null в элементе управления сетки, то следует использовать свойство dataField.

Если значение dataTipFunction и dataTipFormatter равно null, то значение этого метода аналогично item[dataTipField].toString(). Если указан dataTipFormatter, значение этого метода аналогично dataTipFormatter.format(item[dataTipField]). Если при обработке dataField элемента возникает ошибка, возвращается ERROR_TEXT.

Если свойства item и dataTipFunction имеют ненулевое значение, то этот метод возвращает dataTipFunction(item, this), где вторым аргументом является GridColumn.

itemToLabel Преобразование указанного элемента поставщика данных в зависящую от столбца строку.Зависящая от столбца строка для указанного элемента dataProvider или ERROR_TEXT. itemЗначение grid.dataProvider.getItemAt(rowIndex). Преобразование указанного элемента поставщика данных в зависящую от столбца строку. Этот метод используется для инициализации свойства label средства визуализации элементов.

Если для labelFunction указано значение null и dataField является строкой, не содержащей символы сепаратора имени поля, и форматтер - null, тогда этот метод эквивалентен:

item[dataField].toString()

Если форматтер был указан, то значение этого метода:

formatter.format(item[dataField])

Если dataField представлен отдельным путем ".", то этот метод выполняет поиск каждого последовательного элемента пути. Например, если ="foo.bar.baz", этот метод возвращает строку на основе значения item.foo.bar.baz. Если при обработке dataField элемента возникает ошибка, возвращается ERROR_TEXT.

Если item и labelFunction не являются null, то этот метод возвращает labelFunction(item, this), где вторым аргументом является этот GridColumn.

itemToRenderer Преобразование указанного элемента поставщика данных в зависящую от столбца фабрику средства визуализации элементов.Зависящая от столбца фабрика средства визуализации для указанного элемента dataProvider. itemЗначение grid.dataProvider.getItemAt(rowIndex). Преобразование указанного элемента поставщика данных в зависящую от столбца фабрику средства визуализации элементов. По умолчанию этот метод вызывает itemRendererFunction, если его значение не null, в противном случае он возвращает значение свойства itemRenderer столбца. ERROR_TEXT Возвращаемое значение метода itemToLabel() или itemToDataTip(), если не удается обработать соответствующее имя (путь) свойства.unknown Возвращаемое значение метода itemToLabel() или itemToDataTip(), если не удается обработать соответствующее имя (путь) свойства. Значение этой константы - строка с одиночным пробелом: " ". itemToLabelitemToDataTipcolumnIndex Позиция этого столбца в списке столбцов сетки или -1, если сетка этого столбца - null. Позиция этого столбца в списке столбцов сетки или -1, если сетка этого столбца - null. dataField Имя поля или свойства элемента поставщика данных, связанного со столбцом.null Имя поля или свойства элемента поставщика данных, связанного со столбцом. Данное свойство или свойство labelFunction необходимо установить для каждого GridColumn, чтобы вычислить отображаемый текст для средства визуализации элементов. Если установлено значение свойств dataField и labelFunction, данные отображаются с помощью labelFunction и сортируются с применением dataField.

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

Если в столбце или его сетке указано свойство labelFunction, то dataField не используется.

itemToLabellabelFunction
dataTipField Имя поля в поставщике данных для отображения в качестве всплывающей подсказки.null Имя поля в поставщике данных для отображения в качестве всплывающей подсказки. Если для showDataTips указано значение true, то связанный элемент управления сетки по умолчанию выполняет поиск свойства с именем label в каждом элементе поставщика данных и отображает его. Однако если поставщик данных не содержит свойство label, можно установить свойство dataTipField для определения другого имени свойства. Например, если пользователь просматривает группу имен лиц, извлеченных из базы данных, может быть установлено значение FullName.

GridColumn.dataTipField имеет приоритет над этим свойством.

Если в столбце или его сетке указано значение для свойства dataTipFunction, то свойство dataTipField игнорируется.

dataTipFunctionitemToDataTip
dataTipFormatter Указывает средство форматирования, используемое методом столбца itemToDataTip() для преобразования элементов поставщика данных в строки.null Указывает средство форматирования, используемое методом столбца itemToDataTip() для преобразования элементов поставщика данных в строки.

Если styleParent средства форматирования не указан, он устанавливается как сетка столбца и средство форматирования наследует стиль locale сетки.

itemToDataTipСредство форматирования
dataTipFunction Определяет функцию обратного вызова, выполняемую в каждом элементе поставщика данных для определения всплывающей подсказки.null Определяет функцию обратного вызова, выполняемую в каждом элементе поставщика данных для определения всплывающей подсказки. Это свойство используется методом itemToDataTip.

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

Например, существует поставщик данных, содержащий поля lastName и firstName, но в качестве всплывающей подсказки требуется отображение полных имен. Для свойства dataTipFunction можно определить функцию, возвращающую отдельную строку, содержащую значения обоих полей. Для обработки форматирования и локализации также можно использовать свойство dataTipFunction.

Для функции dataTipFunction необходимо определить следующую подпись:

dataTipFunction(item:Object, column:GridColumn):String
Параметр item является элементом поставщика данных для всей строки. Второй параметр представлен этим объектом столбца.

Типичная функция может связывать свойства firstName и lastName элемента или выполнять пользовательское форматирование в свойстве со значением Date.

itemToDataTipdataTipField
editable Определяет, являются ли элементы в столбце редактируемыми.true Определяет, являются ли элементы в столбце редактируемыми. Если установлено значение true и свойство editable связанной сетки также имеет значение true, элементы столбца доступны для редактирования и для их редактирования по отдельности необходимо выбрать требуемый элемент с помощью мыши или перейти к нему с использованием клавиши F2. formatter Указывает средство форматирования, используемое методом столбца itemToLabel() для преобразования элементов поставщика данных в строки.null Указывает средство форматирования, используемое методом столбца itemToLabel() для преобразования элементов поставщика данных в строки.

Если styleParent средства форматирования не указан, он устанавливается как сетка столбца и средство форматирования наследует стиль locale сетки.

itemToLabeldataTipFormatter
grid Объект Grid, связанный с этим столбцом.spark.components:Grid Объект Grid, связанный с этим столбцом. headerRenderer Фабрика для класса IGridItemRenderer, используемая в качестве заголовка столбца.null Фабрика для класса IGridItemRenderer, используемая в качестве заголовка столбца. При неопределенном значении компонент темы оформления columnHeaderGroup элемента управления DataGrid определяет стандартное средство визуализации заголовка. headerTextIGridItemRendererheaderText Текст заголовка данного столбца. Текст заголовка данного столбца. По умолчанию значение свойства dataField используется связанным элементом управления Grid в качестве текста заголовка. imeMode null flash.system.IMEConversionModeitemEditor Фабрика для класса IGridItemEditor, которая используется для редактирования отдельных ячеек сетки в столбце.null Фабрика для класса IGridItemEditor, которая используется для редактирования отдельных ячеек сетки в столбце. Если для свойства указано значение null и владелец сетки столбца представлен элементом управления DataGrid, то используется значение свойства itemEditor элемента управления DataGrid. Если редактор элементов не указан элементом управления DataGrid, следует использовать класс DefaultGridItemEditor.

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

spark.components.gridClasses.DefaultGridItemEditorspark.components.gridClasses.GridItemEditor
itemRendererFunction Если выбрано значение этого свойства, оно должно быть идемпотентной функцией, возвращающей IFactory средства визуализации элементов на основе объекта поставщика данных и параметром столбцов.null Если выбрано значение этого свойства, оно должно быть идемпотентной функцией, возвращающей IFactory средства визуализации элементов на основе объекта поставщика данных и параметром столбцов. При указании значения для свойства itemRendererFunction можно использовать более одного редактора элементов в этом столбце.

Функция, указанная для свойства itemRendererFunction, должна иметь следующую подпись:

itemRendererFunction(item:Object, column:GridColumn):IFactory

Параметр item является элементом поставщика данных для всей строки. Второй параметр представлен этим объектом столбца.

Ниже приведен пример функции редактора элементов:

      function myItemRendererFunction(item:Object, column:GridColumn):IFactory
      {
          return (item is Array) ? myArrayItemRenderer : myItemRenderer;
      }
      
itemRenderer Фабрика для класса IGridItemRenderer, используемая для отображения отдельных ячеек сетки. Фабрика для класса IGridItemRenderer, используемая для отображения отдельных ячеек сетки. Если значение не указано, используется значение свойства itemRenderer из связанного элемента управления сетки.

Средством визуализации элементов по умолчанию является класс DefaultGridItemRenderer, отображающий элемент данных в виде текста. Для создания пользовательских средств визуализации элементов используются подклассы класса GridItemRenderer. Пользовательское средство визуализации элементов может выполнять доступ к данным из всей строки сетки, чтобы определить расширенное визуальное представление сетки.

Значением по умолчанию является значение свойства itemRenderer из связанного элемента управления сетки или null.

dataFieldspark.skins.spark.DefaultGridItemRendererspark.components.gridClasses.GridItemRenderer
labelFunction Идемпотентная функция, преобразующая элемент поставщика данных в зависящую от столбца строку, используемую для инициализации свойства label средства визуализации.null Идемпотентная функция, преобразующая элемент поставщика данных в зависящую от столбца строку, используемую для инициализации свойства label средства визуализации.

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

Функция, указанная для свойства labelFunction, должна иметь следующую подпись:

labelFunction(item:Object, column:GridColumn):String

Параметр item является элементом поставщика данных для всей строки. Второй параметр представлен этим объектом столбца.

Типичная функция label может связывать свойства firstName и lastName элемента поставщика данных или выполнять пользовательское форматирование в свойстве со значением Date.

itemToLabeldataField
maxWidth Максимальная ширина столбца в пикселах.NaN Максимальная ширина столбца в пикселах. Если значение указано, макет сетки применяет меньшее из значений ширины typicalItem и maxWidth к ширине макета столбца. Если этот размер этого столбца может изменяться, то это свойство ограничивает ширину столбца, которую может указать пользователь. Установка этого свойства не изменит свойства width или minWidth. minWidth Минимальная ширина столбца в пикселах.20 Минимальная ширина столбца в пикселах. Если значение указано, макет сетки применяет большее из значений ширины typicalItem и minWidth к ширине макета столбца. Если этот размер этого столбца может изменяться, то это свойство ограничивает минимальный размер столбца, который может указать пользователь. Установка этого свойства не изменит свойства width или maxWidth. rendererIsEditable Определяет возможность редактирования элементов управления средства визуализации элементов.false Определяет возможность редактирования элементов управления средства визуализации элементов. Если столбец доступен для редактирования, фокусируемые элементы управления в средстве визуализации элементов получают фокус клавиатуры, когда пользователь начинает редактирование средства визуализации.

При установке для этого свойства значения true ячейка, в пределах которой пользователь щелкает кнопкой мыши, становится редактируемой. Поскольку ячейка доступна для редактирования, DataGrid отображает компонент темы оформления editorIndicator поверх компонента темы оформления selectionIndicator. Поэтому индикатор для выбора ячейки отображается только после завершения сеанса редактирования. В пользовательской теме оформления можно удалить или изменить компонент темы оформления editorIndicator, чтобы отобразить компонент selectionIndicator. Например, измените свойство alpha компонента editorIndicator для отображения selectionIndicator или установите размер editorIndicator меньше размера ячейки.

При установке для этого свойства значения true пользователь должен обеспечить проверку и сохранение введенных данных, которые собраны средством визуализации элементов. Если средство визуализации элементов содержит переопределение метода IGridItemRenderer.prepare(), необходимо удостовериться, что несохраненные изменения полей ввода не переопределены. Например, rendererIsEditable имеет значение true и средство визуализации содержит один элемент TextInput, который отображает значение data.myDataField. Если метод prepare() средства визуализации устанавливает свойство text элемента управления TextInput, то метод prepare() не должен устанавливать свойство text при наличии изменений в состоянии ожидания.

resizable Указывает, разрешено ли пользователю изменять ширину столбца.true Указывает, разрешено ли пользователю изменять ширину столбца. Если true и свойство resizableColumns связанной сетки также имеет значение true, пользователь может перетаскивать линии сетки между заголовками столбца для изменения размера столбца. showDataTips Определяет, отображаются ли всплывающие подсказки в столбце.undefined Определяет, отображаются ли всплывающие подсказки в столбце. Если установлено значение true, всплывающие подсказки для текста отображаются в строках. Datatips – это всплывающие подсказки, указывающие на то, что текст является слишком длинным для этой строки.

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

getShowDataTips
sortCompareFunction Функция, которая сравнивает два элемента во время сортировки элементов данных в столбце.null Функция, которая сравнивает два элемента во время сортировки элементов данных в столбце. Если указывается значение свойства labelFunction, обычно необходимо указать sortCompareFunction.

Подпись sortCompareFunction должна соответствовать следующему:

sortCompareFunction(obj1:Object, obj2:Object, column:GridColumn):int

Функция должна возвратить значение, полученное на основе сравнения объектов:

  • -1, если obj1 должен отображаться перед obj2 в порядке возрастания.
  • 0, если obj1 = obj2.
  • 1, если obj1 должен отображаться после obj2 в порядке возрастания.

Функция может использовать параметр столбца для записи общих функций сравнения.

Примечание. Параметры obj1 и obj2 являются едиными элементами поставщика данных, а не только данными элемента.

Если dataProvider не является ICollectionView, то это свойство не действует.

sortDescending Если true, для этого столбца выполняется сортировка по убыванию.false Если true, для этого столбца выполняется сортировка по убыванию. Например, если dataField столбца содержит числовое значение, то в первой строке будет указано наиболее высокое значение в этом столбце.

Установка этого свойства не инициирует начало сортировки; устанавливается лишь направление сортировки. Сортировка выполняется при вызове метода dataProvider.refresh().

Если поставщик данных не является ICollectionView, то это свойство не оказывает влияния.

sortField Возвращает SortField, используемый для сортировки коллекции по dataField столбца.spark.collections:SortField Возвращает SortField, используемый для сортировки коллекции по dataField столбца.

Если определено свойство sortCompareFunction, автоматически устанавливается compareFunction SortField.

Если свойство sortCompareFunction не указано и dataField представлен сложными данными, функция сравнения SortField присваивается закрытию в функции сравнения по умолчанию, которая обрабатывает сложный dataField.

Если свойства sortCompareFunction и dataField не указаны, но определено свойство labelFunction, то оно присваивает compareFunction закрытию, которое выполняет базовое сравнение строк в labelFunction, примененной к объектам данных.

spark.collections.SortField
sortable Если true и поставщик данных сетки представлен ICollectionView, а также если свойство sortableColumns связанной сетки имеет значение true, то этот столбец поддерживает интерактивную сортировку.true Если true и поставщик данных сетки представлен ICollectionView, а также если свойство sortableColumns связанной сетки имеет значение true, то этот столбец поддерживает интерактивную сортировку. Как правило, заголовок столбца обрабатывает нажатия кнопки мыши посредством установки свойства sort поставщика данных в объекте Sort, SortField которого представлен dataField этого столбца.

Если поставщик данных не является ICollectionView, то это свойство не оказывает влияния.

visible Если true, этот столбец будет отображен.true Если true, этот столбец отображается. Если false, место для этого столбца не назначается и он будет отсутствовать в макете. width Ширина столбца в пикселах.NaN Ширина столбца в пикселах. Если значение указано, макет сетки игнорирует свое свойство typicalItem и свойства minWidth и maxWidth этого столбца.
IGridVisualElement Этот интерфейс предоставляет метод, который могут использовать динамически созданные визуальные элементы для собственной настройки перед отображением. Этот интерфейс предоставляет метод, который могут использовать динамически созданные визуальные элементы для собственной настройки перед отображением. Он вызывается при необходимости, когда создается или повторно используется визуальный элемент, созданный в фабрике. Этот метод не предназначен для прямого вызова.

Это необязательный интерфейс для всех визуальных элементов, созданных в фабрике, кроме элементов itemRenderer: caretIndicator, hoverIndicator, editorIndicator, selectionIndicator, columnSeparator, rowSeparator, alternatingRowColorsBackground (см. DataGrid), sortIndicator (см. GridColumnHeaderGroup). Он обычно используется для настройки созданных визуальных элементов с использованием значений стиля DataGrid. Например, чтобы использовать значение стиля symbolColor в DataGrid для цвета заливки символа вставки, можно определить метод prepareGridVisualElement() следующим образом:

  public function prepareGridVisualElement(grid:Grid, rowIndex:int, columnIndex:int):void
  {
      caretStroke.color = grid.dataGrid.getStyle("caretColor");
  }
  

Параметры rowIndex и columnIndex указывают ячейку, которую заполнит визуальный элемент. Если columnIndex = -1, то визуальный элемент занимает строку сетки. Если rowIndex = -1, то визуальный элемент занимает столбец сетки.

Дополнительные примеры см. в описании DataGridSkin.mxml. Обратите внимание, что визуальные элементы пользовательской темы оформления DataGrid могут не использовать этот интерфейс, если дополнительные возможности не требуются.

prepareGridVisualElement Этот метод вызывается перед отображением визуального элемента сетки, чтобы этот элемент мог выполнить собственную настройку.gridspark.components:GridОбъект Grid, связанный с этим визуальным элементом. rowIndexКоордината строки ячейки, которую заполнит визуальный элемент, или -1. columnIndexКоордината столбца ячейки, которую заполнит визуальный элемент, или -1. Этот метод вызывается перед отображением визуального элемента сетки, чтобы этот элемент мог выполнить собственную настройку. Параметры метода указывают, какую ячейку, строку (если columnIndex = -1) или столбец (если rowIndex = -1) заполнит визуальный элемент.

Если визуальный элемент создан с использованием компонента темы оформления DataGrid на основе значений фабрики, например selectionIndicator или hoverIndicator, то grid.dataGrid будет представлять DataGrid, компонентом темы оформления которого является сетка.

CellPosition Класс CellPosition определяет структуру данных, используемую классами сетки данных Spark для представления выбранных ячеек в элементе управленияObject Класс CellPosition определяет структуру данных, используемую классами сетки данных Spark для представления выбранных ячеек в элементе управления Каждая выбранная ячейка представляется при помощи экземпляра данного класса. spark.components.DataGrid.selectedCellspark.components.DataGrid.selectedCellsspark.components.Grid.selectedCellspark.components.Grid.selectedCellsCellPosition Конструктор.rowIndex-1Отсчитываемый от 0 индекс строки ячейки. Значение -1 указывает, что это значение не установлено. columnIndex-1Отсчитываемый от 0 индекс столбца ячейки. Значение -1 указывает, что это значение не установлено. Конструктор. columnIndex Отсчитываемый от 0 индекс столбца ячейки.-1 Отсчитываемый от 0 индекс столбца ячейки. Значение -1 указывает, что это значение не установлено. rowIndex Отсчитываемый от 0 индекс строки ячейки.-1 Отсчитываемый от 0 индекс строки ячейки. Значение -1 указывает, что это значение не установлено. IDataGridElement Визуальные элементы средства управления Spark DataGrid, которые должны оставаться в синхронизации с макетом сетки, при этом положение прокрутки должно реализовывать этот интерфейс.mx.core:IVisualElementmx.managers:ILayoutManagerClientmx.core:IInvalidating Визуальные элементы средства управления Spark DataGrid, которые должны оставаться в синхронизации с макетом сетки, при этом положение прокрутки должно реализовывать этот интерфейс. При добавлении компонента темы оформления grid элемента управления DataGrid устанавливается свойство IDataGridElement.dataGrid. Ответом объекта IDataGridElements может являться добавление прослушивателей событий при изменении положения прокрутки. Если изменение элемента управления DataGrid влияет на макет его строки или столбца, все объекты IDataGridElements становятся недействительными. dataGrid Элемент управления DataGrid, связанный с этим элементом.spark.components:DataGrid Элемент управления DataGrid, связанный с этим элементом. DefaultGridItemEditorКласс DefaultGridItemEditor определяет средство визуализации элементов по умолчанию, используемое элементами управления сетки Spark, например DataGrid и Grid.spark.components.gridClasses:GridItemEditorКласс DefaultGridItemEditor определяет средство визуализации элементов по умолчанию, используемое элементами управления сетки Spark, например DataGrid и Grid. DefaultGridItemEditor отображает элемент управления текстовой области. Укажите новое значение ячейки в редакторе элементов.

Вместо использования DefaultGridItemEditor можно создать пользовательский редактор элементов. Редактор элементов должен обеспечивать реализацию интерфейса spark.components.gridClasses.IGridItemEditor. Обычно для создания редактора элементов используются подклассы класса spark.components.gridClasses.GridItemEditor.

spark.components.DataGridspark.components.Gridspark.components.gridClasses.IGridItemEditorspark.components.gridClasses.GridItemEditorspark.components.gridClasses.GridColumnDefaultGridItemEditorКонструктор.Конструктор.textAreaКомпонент TextArea редактора.spark.components:TextAreaКомпонент TextArea редактора.
GridSelectionMode Класс GridSelectionMode определяет допустимые значения констант для свойства selectionMode элементов управления Spark DataGrid и Grid.Object Класс GridSelectionMode определяет допустимые значения констант для свойства selectionMode элементов управления Spark DataGrid и Grid.

Использование констант в ActionsScript проиллюстрировано в следующем примере:

    myDG.selectionMode = GridSelectionMode.MULTIPLE_CELLS;
  

Использование значения String констант в MXML проиллюстрировано в следующем примере:

    <s:DataGrid id="myGrid" width="350" height="150"
        selectionMode="multipleCells"> 
        ...
    </s:DataGrid> 
  
spark.components.DataGrid.selectionModespark.components.Grid.selectionModeGridSelectionMode Конструктор. Конструктор. MULTIPLE_CELLS Указывает, что можно выбрать одну или несколько ячеек.multipleCells Указывает, что можно выбрать одну или несколько ячеек. MULTIPLE_ROWS Указывает, что можно выбрать одну или несколько строк.multipleRows Указывает, что можно выбрать одну или несколько строк. NONE Указывает, что выбор не допускается.none Указывает, что выбор не допускается. SINGLE_CELL Указывает, что можно выбрать одну ячейку.singleCell Указывает, что можно выбрать одну ячейку. SINGLE_ROW Указывает, что можно выбрать одну строку.singleRow Указывает, что можно выбрать одну строку.
CellRegion Класс CellRegion определяет структуру данных, используемую классами сетки данных Spark для представления прямоугольной области ячеек в элементе управления.Object Класс CellRegion определяет структуру данных, используемую классами сетки данных Spark для представления прямоугольной области ячеек в элементе управления. Начало координат области указывается в свойствах rowIndex и columnIndex. Расширение области указывается в свойствах rowCount и columnCount. spark.components.DataGridspark.components.GridCellRegion Конструктор.rowIndex-1Отсчитываемый от 0 индекс строки ячейки начала координат. Значение -1 указывает, что это значение не установлено. columnIndex-1Отсчитываемый от 0 индекс столбца ячейки начала координат. Значение -1 указывает, что это значение не установлено. rowCount0Количество строк в области ячейки. columnCount0Количество столбцов в области сетки. Конструктор. columnCount Количество столбцов в области сетки.0 Количество столбцов в области сетки. columnIndex Отсчитываемый от 0 индекс столбца начала координат области ячейки.-1 Отсчитываемый от 0 индекс столбца начала координат области ячейки. Значение -1 указывает, что это значение не установлено. rowCount Количество строк в области ячейки.0 Количество строк в области ячейки. rowIndex Отсчитываемый от 0 индекс строки начала координат области ячейки.-1 Отсчитываемый от 0 индекс строки начала координат области ячейки. Значение -1 указывает, что это значение не установлено. GridLayer Класс GridLayer определяет контейнер, используемый для слоев визуальных элементов средства управления Grid.spark.components:Group Класс GridLayer определяет контейнер, используемый для слоев визуальных элементов средства управления Grid. Элемент управления Grid создает визуальные элементы, добавляет их в свои слои при необходимости и управляет их макетом. spark.components.GridGridLayer Конструктор. Конструктор. GridItemRenderer Класс GridItemRenderer определяет базовый класс для пользовательских средств визуализации элементов для элементов управления сетки Spark, например DataGrid и Grid.spark.components.gridClasses:IGridItemRendererspark.components:Group Класс GridItemRenderer определяет базовый класс для пользовательских средств визуализации элементов для элементов управления сетки Spark, например DataGrid и Grid. Средства визуализации элементов сетки необходимы только для отображения зависящих от столбцов аспектов данных. Они не должны отображать индикаторы выбора или наведения, дополнительный цвет фона (при его наличии) или разделители строк и столбцов.

Средства визуализации элементов связаны с каждым столбцом сетки. Средство визуализации элементов устанавливается для столбца с помощью свойства GridColumn.itemRenderer.

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

Переходы в средствах визуализации элементов DataGrid не поддерживаются. В классе GridItemRenderer выключено свойство transitions, поэтому установка этого свойства не будет иметь эффект.

Рекомендации по повышению производительности

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

Если действия средства визуализации ограничены отображением одной или нескольких строк текста, разработчикам следует обратить внимание на класс DefaultItemRenderer, который выполняет эти действия более продуктивно. Использование класса UITextFieldGridItemRenderer вместо развертываемого в Windows приложения позволяет повысить производительность работы. Наиболее эффективным способом использования GridItemRenderer для отображения dataField элемента GridColumn в виде текста является присвоение элементу отображения текста GridItemRenderer значения id="labelDisplay". Компонент labelDisplay должен являться подклассом TextBase, например Label или RichText. Этот подход можно использовать вместо DefaultGridItemRenderer, если средство визуализации элементов содержит дополнительные элементы, которые не зависят от его данных, например границы или другие графические элементы.

Если средство визуализации элементов содержит несколько визуальных элементов, свойства которых зависят от его данных, для определения значений этих свойств можно использовать привязку данных. Этот подход возвращает удобный для чтения и использования код MXML, производительность которого может быть достаточно высокой при условии ограничения количества видимых средств визуализации элементов (см. свойства requestedRowCount и requestedColumnCount элемента DataGrid). Самым эффективным способом настройки такого типа средств визуализации элементов является внесение необходимых изменений в метод prepare(). Поскольку метод prepare() вызывается при каждом отображении средства визуализации элементов, очень важно, чтобы код этого метода был максимально эффективным. Если средство визуализации элементов сохраняет состояние, например кэширует внутренние значения, для удаления состояния используется метод discard(). Метод discard() вызывается при каждом перемещении средства визуализации элементов во внутренний свободный список DataGrid, откуда возможно его повторное использование.

Элементы GridItemRenderer должны быть максимально простыми. Для достижения максимальной производительности необходимо минимизировать количество компонентов и уменьшить глубину иерархии. Если допустимо, для определения макета вместо ограничений следует использовать явные позиции и размеры. Высокая производительность DataGrid обеспечивается значением по умолчанию variableRowHeight="false", а также значениями по умолчанию showDataTips="false" и clipAndEnableScrolling="false".

Описанные здесь примеры различных конфигураций GridItemRenderer доступны в разделе примеров.

spark.components.DataGridspark.components.Gridspark.components.gridClasses.GridColumnspark.components.gridClasses.GridColumn.itemRendererspark.skins.spark.DefaultGridItemRendererdataChange Передается при изменении свойства data.mx.events.FlexEvent.DATA_CHANGEmx.events.FlexEvent Передается при изменении свойстваdata. GridItemRenderer Конструктор. Конструктор. discard Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов, если определено, что это средство визуализации больше не является видимым.willBeRecycledtrue, если это средство визуализации будет добавлено к внутреннему свободному списку владельца для повторного использования. Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов, если определено, что это средство визуализации больше не является видимым. Если для параметра willBeRecycled устанавливается значение true, то владелец добавляет это средство визуализации к внутреннему свободному списку для повторного использования. Реализации могут использовать этот метод, чтобы удалить любые свойства средства визуализации, которые больше не являются необходимыми.

Этот метод не предназначен для прямого вызова. Он вызывается реализацией DataGrid.

getCurrentRendererState Возвращает имя состояния, которое должно быть применено к средству визуализации.String, указывающая имя состояния, которое должно быть применено к средству визуализации. Возвращает имя состояния, которое должно быть применено к средству визуализации. Например, основное средство визуализации элементов возвращает строки normal, hovered или selected для определения состояния средства визуализации. Если используются действия касания (или действия мыши при игнорировании выбора), также возвращаются значения down и downAndSelected.

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

Тремя основными состояниями в Flex 4.0 были "normal", "hovered" и "selected". В Flex 4.5 добавлены состояния "down" и "downAndSelected".

Ниже представлен полный набор поддерживаемых состояний (в порядке приоретности):

  • dragging
  • downAndSelected
  • selectedAndShowsCaret
  • hoveredAndShowsCaret
  • normalAndShowsCaret
  • down
  • selected
  • hovered
  • normal

prepare Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов после установки всех свойств этого средства визуализации.hasBeenRecycled true, если это средство визуализации используется повторно. Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов после установки всех свойств этого средства визуализации. Для параметра hasBeenRecycled устанавливается значение false, если это средство визуализации не использовалось ранее, т. е. используется впервые. Метод вызывается непосредственно перед тем, как средство визуализации станет видимым, и при каждом его отображении вследствие изменения свойства средства визуализации или явного запроса на повторное отображение.

Этот метод можно использовать для настройки всех визуальных элементов и свойств средства визуализации. Использование этого метода может быть более эффективным, чем привязка свойств data к свойствам визуальных элементов. Примечание. Поскольку метод prepare() вызывается достаточно часто, очень важно обеспечить эффективность его кода.

Метод prepare() может многократно вызываться перед вызовом метода discard().

Этот метод не предназначен для прямого вызова. Он вызывается реализацией DataGrid.

columnIndex Индекс столбца для ячейки этого средства визуализации элементов. Индекс столбца для ячейки этого средства визуализации элементов. Это значение аналогично column.columnIndex. column Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов.spark.components.gridClasses:GridColumnnull Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов. data Значение элемента поставщика данных для строки сетки, соответствующей средству визуализации элементов.null Значение элемента поставщика данных для строки сетки, соответствующей средству визуализации элементов. Это значение соответствует объекту, возвращенному после вызова метода dataProvider.getItemAt(rowIndex).

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

down Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана.false Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана. Для свойства down восстанавливается значение false, когда пользователь отпускает кнопку мыши или больше не касается сенсорного экрана, а также если курсор или точка касания выходит за пределы ячейки сетки.

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

dragging Содержит значение true, если перемещается средство визуализации элементов, обычно в рамках операции перетаскивания. Содержит значение true, если перемещается средство визуализации элементов, обычно в рамках операции перетаскивания. В настоящее время элемент управления Spark DataGrid не поддерживает перетаскивание. grid Возвращает сетку, связанную с этим средством визуализации элементов.spark.components:Grid Возвращает сетку, связанную с этим средством визуализации элементов. Это значение аналогично column.grid. hovered Содержит значение true, если на средство визуализации элементов наведен курсор мыши и selectionMode сетки имеет значение GridSelectionMode.SINGLE_CELL или GridSelectionMode.MULTIPLE_CELLS, а также если курсор мыши находится в пределах строки, к которой относится средство визуализации элементов, и для selectionMode сетки установлено значение GridSelectionMode.SINGLE_ROW или GridSelectionMode.MULTIPLE_ROWS.false Содержит значение true, если на средство визуализации элементов наведен курсор мыши и selectionMode сетки имеет значение GridSelectionMode.SINGLE_CELL или GridSelectionMode.MULTIPLE_CELLS, а также если курсор мыши находится в пределах строки, к которой относится средство визуализации элементов, и для selectionMode сетки установлено значение GridSelectionMode.SINGLE_ROW или GridSelectionMode.MULTIPLE_ROWS.

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

labelDisplay Дополнительный визуальный компонент в средстве визуализации элементов для отображения свойства label.spark.components.supportClasses:TextBasenull Дополнительный визуальный компонент в средстве визуализации элементов для отображения свойства label. Если это свойство используется для определения визуального компонента, то свойство text этого компонента синхронизируется со свойством label средства визуализации элементов. label "" rowIndex Отсчитываемый от нуля индекс строки визуализируемой ячейки.-1 Отсчитываемый от нуля индекс строки визуализируемой ячейки. selected Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора.false Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора.

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

showsCaret Содержит значение true, если ячейка средства визуализации элементов обозначается символом вставки.false Содержит значение true, если ячейка средства визуализации элементов обозначается символом вставки.

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

IGridItemEditor Интерфейс IGridItemEditor определяет интерфейс, который должны реализовать редакторы элементов для элементов управления Spark DataGrid и Spark Grid.mx.core:IDataRenderermx.core:IVisualElementmx.managers:IFocusManagerComponentmx.core:IIMESupport Интерфейс IGridItemEditor определяет интерфейс, который должны реализовать редакторы элементов для элементов управления Spark DataGrid и Spark Grid. Элементы управления DataGrid и Grid рассматриваются как владельцы средства визуализации элементов или как компоненты хоста редактора элементов.

Все свойства редактора элементов устанавливаются владельцем в начале сеанса редактирования. Свойство data устанавливается последним. При установке свойства data редактор элементов должен определить значение элементов управления редактора. Затем редактор вызывает метод prepare(). Реализации IGridItemEditor должны изменить метод prepare(), чтобы внести окончательные изменения в его свойства или любой аспект его визуальных элементов. При закрытии редактора вызывается метод discard().

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

spark.components.DataGridspark.components.Griddiscard Вызывается непосредственно перед закрытием редактора. Вызывается непосредственно перед закрытием редактора. Этот метод используется для любой окончательной очистки, например для очистки любых элементов, установленных в методе prepare().

Не вызывайте этот метод напрямую. Он должен вызываться только элементом управления, в котором содержится редактор элементов.

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

Не вызывайте этот метод напрямую. Он должен вызываться только элементом управления, в котором содержится редактор элементов.

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

Не вызывайте этот метод напрямую. Он должен вызываться только элементом управления, в котором содержится редактор элементов. Для сохранения и выхода из редактора вызовите метод endItemEditorSession() владельца средства визуализации элементов.

spark.components.DataGrid
columnIndex Отсчитываемый от нуля индекс редактируемого столбца. Отсчитываемый от нуля индекс редактируемого столбца. column Столбец редактируемой ячейки.spark.components.gridClasses:GridColumn Столбец редактируемой ячейки. dataGrid Элемент управления, которому принадлежит этот редактор элементов.spark.components:DataGrid Элемент управления, которому принадлежит этот редактор элементов. rowIndex Отсчитываемый от нуля индекс редактируемой ячейки. Отсчитываемый от нуля индекс редактируемой ячейки.
GridItemEditor Класс GridItemEditor определяет базовый класс для пользовательских редакторов элементов для элементов управления сетки Spark, например DataGrid и Grid.The <s:GridItemEditor> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GridItemEditor
    Properties
    column="null"
    data="null"
    imeMode="null"
    itemRenderer="null"
    rowIndex="0"
    value="null"
  />
  
]]>
spark.components.gridClasses:IGridItemEditorspark.components:Group Класс GridItemEditor определяет базовый класс для пользовательских редакторов элементов для элементов управления сетки Spark, например DataGrid и Grid. В редакторе элементов можно редактировать значение ячейки сетки и затем сохранить это значение в поставщике данных элемента управления.

Редакторы элементов связаны с каждым столбцом сетки. Редактор элементов устанавливается для столбца с помощью свойства GridColumn.itemEditor.

spark.components.DataGridspark.components.Gridspark.components.gridClasses.GridColumnspark.components.gridClasses.GridColumn.itemEditorGridItemEditor Конструктор. Конструктор. discard Вызывается непосредственно перед закрытием редактора. Вызывается непосредственно перед закрытием редактора. Этот метод используется для любой окончательной очистки, например для очистки любых элементов, установленных в методе prepare().

Не вызывайте этот метод напрямую. Он должен вызываться только элементом управления, в котором содержится редактор элементов.

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

Не вызывайте этот метод напрямую. Он должен вызываться только элементом управления, в котором содержится редактор элементов.

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

Не вызывайте этот метод напрямую. Он должен вызываться только элементом управления, в котором содержится редактор элементов. Для сохранения и выхода из редактора вызовите метод endItemEditorSession() владельца средства визуализации элементов.

validate Проверяет, является ли значение в редакторе допустимым и может ли быть сохранено.true, если значение в редакторе является допустимым. В противном случае возвращает false. Проверяет, является ли значение в редакторе допустимым и может ли быть сохранено. columnIndex Отсчитываемый от нуля индекс редактируемого столбца. Отсчитываемый от нуля индекс редактируемого столбца. column Столбец редактируемой ячейки.spark.components.gridClasses:GridColumnnull Столбец редактируемой ячейки. dataGrid Элемент управления, которому принадлежит этот редактор элементов.spark.components:DataGrid Элемент управления, которому принадлежит этот редактор элементов. data null enableIME Флаг, указывающий на необходимость активации IME при получении компонентом фокуса.true Флаг, указывающий на необходимость активации IME при получении компонентом фокуса. imeMode Указывает режим редактора методов ввода (IME).null Указывает режим редактора методов ввода (IME). IME позволяет пользователям вводить текст на китайском, японском и корейском языках. Режим IME устанавливается при перемещении фокуса на элемент управления и возвращается к предыдущему значению при потере фокуса этим элементом управления.

Класс flash.system.IMEConversionMode определяет константы для допустимых значений этого свойства. Можно также указать значение null и не указывать IME.

flash.system.IMEConversionMode
itemRenderer Средство визуализации элементов, связанное с редактируемой ячейкой.spark.components.gridClasses:IGridItemRenderernull Средство визуализации элементов, связанное с редактируемой ячейкой. rowIndex Отсчитываемый от нуля индекс редактируемой ячейки.0 Отсчитываемый от нуля индекс редактируемой ячейки. value По умолчанию это свойство инициализируется методом установщика свойства data.null По умолчанию это свойство инициализируется методом установщика свойства data. Значение по умолчанию этого свойства представлено данными ячейки из поставщика данных элемента управления сетки. Редактор элементов может использовать это свойство для инициализации визуальных элементов в редакторе элементов.

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

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

IGridItemRenderer Реализацию интерфейса IGridItemRenderer выполняют средства визуализации элементов DataGrid.mx.core:IDataRenderermx.core:IVisualElement Реализацию интерфейса IGridItemRenderer выполняют средства визуализации элементов DataGrid. DataGrid использует этот API, чтобы предоставить средству визуализации элементов информацию, необходимую для визуализации одного элемента cell сетки или заголовка.

Все свойства средства визуализации элементов устанавливаются во время выполнения метода updateDisplayList() его вышестоящего элемента. После установки свойств вызывается методprepare() средства визуализации элементов. Реализация IGridItemRenderer должна изменить метод prepare(), чтобы окончательно отредактировать его свойства или любой аспект его визуальных элементов. Как правило, метод prepare() используется для настройки визуальных элементов средства визуализации на основе свойства data.

Если средство визуализации элементов больше не требуется, так как оно будет добавлено к внутреннему свободному списку многократно используемых средств визуализации или больше не будет использоваться, вызывается метод discard() в IGridItemRenderer.

spark.components.DataGridspark.components.Griddiscard Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов, если определено, что это средство визуализации больше не является видимым.willBeRecycledtrue, если это средство визуализации будет добавлено к внутреннему свободному списку владельца для повторного использования. Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов, если определено, что это средство визуализации больше не является видимым. Если для параметра willBeRecycled устанавливается значение true, то владелец добавляет это средство визуализации к внутреннему свободному списку для повторного использования. Реализации могут использовать этот метод, чтобы удалить любые свойства средства визуализации, которые больше не являются необходимыми.

Этот метод не предназначен для прямого вызова. Он вызывается реализацией DataGrid.

prepare Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов после установки всех свойств этого средства визуализации.hasBeenRecycled true, если это средство визуализации используется повторно. Вызывается из метода updateDisplayList() вышестоящего элемента средства визуализации элементов после установки всех свойств этого средства визуализации. Для параметра hasBeenRecycled устанавливается значение false, если это средство визуализации не использовалось ранее, т. е. используется впервые. Метод вызывается непосредственно перед тем, как средство визуализации станет видимым, и при каждом его отображении вследствие изменения свойства средства визуализации или явного запроса на повторное отображение.

Этот метод можно использовать для настройки всех визуальных элементов и свойств средства визуализации. Использование этого метода может быть более эффективным, чем привязка свойств data к свойствам визуальных элементов. Примечание. Поскольку метод prepare() вызывается достаточно часто, очень важно обеспечить эффективность его кода.

Метод prepare() может многократно вызываться перед вызовом метода discard().

Этот метод не предназначен для прямого вызова. Он вызывается реализацией DataGrid.

columnIndex Индекс столбца для ячейки этого средства визуализации элементов. Индекс столбца для ячейки этого средства визуализации элементов. Это значение аналогично column.columnIndex. column Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов.spark.components.gridClasses:GridColumn Объект GridColumn, представляющий столбец, связанный с этим средством визуализации элементов. down Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана. Для этого свойства устанавливается значение true, если в ячейке сетки происходит одно из двух входящих действий: нажатие кнопки мыши или касание сенсорного экрана. Для свойства down восстанавливается значение false, когда пользователь отпускает кнопку мыши или больше не касается сенсорного экрана, а также если курсор или точка касания выходит за пределы ячейки сетки.

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

dragging Содержит значение true, если перемещается средство визуализации элементов, обычно в рамках операции перетаскивания. Содержит значение true, если перемещается средство визуализации элементов, обычно в рамках операции перетаскивания. В настоящее время элемент управления Spark DataGrid не поддерживает перетаскивание. grid Сетка, связанная с этим средством визуализации элементов; как правило, является значением column.grid.spark.components:Grid Сетка, связанная с этим средством визуализации элементов; как правило, является значением column.grid. hovered Содержит значение true, если на средство визуализации элементов наведен курсор мыши и selectionMode сетки имеет значение GridSelectionMode.SINGLE_CELL или GridSelectionMode.MULTIPLE_CELLS, а также если курсор мыши находится в пределах строки, к которой относится средство визуализации элементов, и для selectionMode сетки установлено значение GridSelectionMode.SINGLE_ROW или GridSelectionMode.MULTIPLE_ROWS. Содержит значение true, если на средство визуализации элементов наведен курсор мыши и selectionMode сетки имеет значение GridSelectionMode.SINGLE_CELL или GridSelectionMode.MULTIPLE_CELLS, а также если курсор мыши находится в пределах строки, к которой относится средство визуализации элементов, и для selectionMode сетки установлено значение GridSelectionMode.SINGLE_ROW или GridSelectionMode.MULTIPLE_ROWS.

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

label String для отображения в средстве визуализации. String для отображения в средстве визуализации.

Класс GridItemRenderer автоматически копирует значение этого свойства в свойство text своего элемента labelDisplay, если этот элемент был указан. Сетка устанавливает label для значения, возвращенного методом itemToLabel() столбца.

spark.components.gridClasses.GridItemRenderer
rowIndex Отсчитываемый от нуля индекс строки визуализируемой ячейки. Отсчитываемый от нуля индекс строки визуализируемой ячейки. selected Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора. Содержит значение true, если ячейка средства визуализации элементов является частью текущего выбора.

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

showsCaret Содержит значение true, если ячейка средства визуализации элементов обозначается символом вставки. Содержит значение true, если ячейка средства визуализации элементов обозначается символом вставки.

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

ComboBoxGridItemEditorКласс ComboBoxGridItemEditor определяет средство визуализации элементов для использования с элементами управления сетки Spark, например DataGrid и Grid.mx.binding:IBindingClientspark.components.gridClasses:GridItemEditorКласс ComboBoxGridItemEditor определяет средство визуализации элементов для использования с элементами управления сетки Spark, например DataGrid и Grid. ComboBoxGridItemEditor отображает раскрывающийся список значений ячейки. Выберите новое значение для ячейки.

Ниже представлен пример того, как GridColumn использует ComboBoxGridItemEditor в качестве редактора элементов:

        <s:GridColumn dataField="quant" 
            headerText="Qty">
                <s:itemEditor>
                    <fx:Component>
                        <s:ComboBoxGridItemEditor>
                            <s:dataProvider>
                                <s:ArrayList>
                                    <fx:int>0</fx:int>
                                    <fx:int>1</fx:int>
                                    <fx:int>2</fx:int>
                                    <fx:int>3</fx:int>
                                </s:ArrayList>
                            </s:dataProvider>
                        </s:ComboBoxGridItemEditor>
                    </fx:Component>
                </s:itemEditor>
        </s:GridColumn>
      
spark.components.DataGridspark.components.Gridspark.components.gridClasses.GridColumnComboBoxGridItemEditorКонструктор.Конструктор.comboBoxЭлемент управления ComboBox редактора элементов.spark.components:ComboBoxЭлемент управления ComboBox редактора элементов. dataProvider Поставщик данных для элемента ComboBox в редакторе элементов. Поставщик данных для элемента ComboBox в редакторе элементов.