Главная / Action Script 3
Пакетfl.controls
Классpublic class DataGrid
НаследованиеDataGrid Inheritance SelectableList Inheritance BaseScrollPane Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Реализует IFocusManagerComponent

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Класс DataGrid — компонент на основе списка, представляющий собой сетку из строк и столбцов. Можно указать необязательную строку заголовка в верхней части компонента, в которой будут показаны все имена свойств. Каждая строка состоит из одного или нескольких столбцов, каждый из которых представляет свойство, которое принадлежит указанному объекту данных. Компонент DataGrid используется для просмотра данных; он не предназначен для использования в качестве инструмента для создания макетов как таблица HTML.

Компонент DataGrid хорошо подходит для показа объектов, содержащих несколько свойств. Данные, показываемые компонентом DataGrid могут содержаться в объекте DataProvider или в массиве объектов. Столбцы компонента DataGrid могут быть представлены в виде списка объектов DataGridColumn, каждый из которых содержит информацию, относящуюся к столбцу.

Компонент DataGrid располагает следующими функциями:

Компонент DataGrid состоит из субкомпонентов, включая компоненты ScrollBar, HeaderRenderer, CellRenderer, DataGridCellEditor ColumnDivider, к которым можно применить обложку во время разработки или выполнения.

Компонент DataGrid использует следующие классы, которые находятся в пакете dataGridClasses:

Посмотреть примеры

См. также

DataGridCellEditor
DataGridColumn
HeaderRenderer
CellRenderer
DataGridEvent


Общедоступные свойства
 СвойствоОпределено
 InheritedaccessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта.
DisplayObject
 InheritedallowMultipleSelection : Boolean
Определяет логическое значение, указывающее, можно ли одновременно выбрать несколько элементов списка.
SelectableList
 Inheritedalpha : Number
Указывает значение альфа-прозрачности заданного объекта.
DisplayObject
 InheritedblendMode : String
Значение класса BlendMode, задающее режим наложения.
DisplayObject
 InheritedblendShader : Shader
[только для записи] Задает затенение, используемое при наложении переднего плана на фон.
DisplayObject
 InheritedbuttonMode : Boolean
Задает режим кнопки данного спрайта.
Sprite
 InheritedcacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта.
DisplayObject
  columns : Array
Определяет или задает массив объектов DataGridColumn, содержащий по одному элементу на каждый отображаемый столбец.
DataGrid
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcontextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом.
InteractiveObject
 InheriteddataProvider : DataProvider
Определяет или задает модель данных для списка просматриваемых элементов.
SelectableList
 InheriteddoubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[только для чтения] Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен.
Sprite
  editable : Boolean = false
Определяет, может ли пользователь редактировать элементы, предоставляемые этим поставщиком данных.
DataGrid
  editedItemPosition : Object
Определяет или задает индексы столбца и строки средства визуализации элементов для элемента текущего поставщика данных, который редактируется в настоящее время.
DataGrid
  editedItemRenderer : ICellRenderer
[только для чтения] Определяет ссылку на средство визуализации элементов в компоненте DataGrid, элемент которого редактируется в настоящий момент.
DataGrid
 Inheritedenabled : Boolean
Определяет или задает значение, указывающее, поддерживает ли компонент взаимодействие с пользователем.
UIComponent
 Inheritedfilters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом.
DisplayObject
 InheritedfocusEnabled : Boolean
Определяет или задает логическое значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedfocusManager : IFocusManager
Определяет или задает объект FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии.
UIComponent
 InheritedfocusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта.
InteractiveObject
 Inheritedgraphics : Graphics
[только для чтения] Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.
Sprite
  headerHeight : Number
Определяет или задает высоту заголовка объекта DataGrid (в пикселах).
DataGrid
 Inheritedheight : Number
Определяет или задает высоту компонента (в пикселах).
UIComponent
 InheritedhitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта.
Sprite
 InheritedhorizontalLineScrollSize : Number
Определяет или задает значение, показывающее протяженность прокрутки по горизонтали при щелчке стрелки прокрутки.
BaseScrollPane
 InheritedhorizontalPageScrollSize : Number
Определяет или задает число пикселов, на которое перемещается бегунок горизонтальной полосы прокрутки при нажатии на рабочую часть полосы прокрутки.
BaseScrollPane
 InheritedhorizontalScrollBar : ScrollBar
[только для чтения] Определяет ссылку на горизонтальную полосу прокрутки.
BaseScrollPane
  horizontalScrollPolicy : String
Определяет или задает логическое значение, указывающее, видна ли полоса прокрутки постоянно.
DataGrid
 InheritedhorizontalScrollPosition : Number
Определяет или задает значение, показывающее положение горизонтальной полосы прокрутки на панели прокрутки (в пикселах).
BaseScrollPane
  imeMode : String
Определяет или задает режим редактора методов ввода (IME).
DataGrid
  itemEditorInstance : Object
Ссылка на активный в настоящий момент экземпляр редактора элементов, если таковой существует.
DataGrid
  labelFunction : Function
Определяет или задает функцию, определяющую, какие поля каждого из элементов используются в качестве текста метки.
DataGrid
 Inheritedlength : uint
[только для чтения] Определяет число элементов, предоставляемых поставщиком данных.
SelectableList
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
 InheritedmaxHorizontalScrollPosition : Number
Определяет или задает величину, на которую список прокручивается вправо, если свойство horizontalScrollPolicy имеет значение ScrollPolicy.ON (в пикселах).
SelectableList
 InheritedmaxVerticalScrollPosition : Number
[только для чтения] Определяет максимальное положение по вертикали при прокрутке текущего содержимого (в пикселах).
BaseScrollPane
  minColumnWidth : Number
Определяет или задает минимальную ширину столбца объекта DataGrid (в пикселах).
DataGrid
 InheritedmouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedmouseX : Number
[только для чтения] Указывает координату x положения курсора мыши (в пикселах).
DisplayObject
 InheritedmouseY : Number
[только для чтения] Указывает координату y положения курсора мыши (в пикселах).
DisplayObject
 Inheritedname : String
Указывает имя экземпляра DisplayObject.
DisplayObject
 InheritednumChildren : int
[только для чтения] Возвращает число потомков данного объекта.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.
DisplayObject
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  resizableColumns : Boolean = true
Определяет, может ли пользователь изменять размеры столбцов.
DataGrid
 Inheritedroot : DisplayObject
[только для чтения] В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом.
DisplayObject
 Inheritedrotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах).
DisplayObject
 InheritedrotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
  rowCount : uint
Определяет или задает число строк, видимых в списке хотя бы частично.
DataGrid
  rowHeight : Number
Определяет или задает высоту (в пикселах) каждой строки в компоненте DataGrid.
DataGrid
 Inheritedscale9Grid : Rectangle
Текущая активная сетка масштабирования.
DisplayObject
 InheritedscaleX : Number
Умножает текущую ширину компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleY : Number
Умножает текущую высоту компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта.
DisplayObject
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
 Inheritedselectable : Boolean
Определяет или задает логическое значение, указывающее, можно ли выбирать элементы списка.
SelectableList
 InheritedselectedIndex : int
Определяет или задает индекс выбранного элемента в списке, допускающем выбор одного элемента.
SelectableList
 InheritedselectedIndices : Array
Определяет или задает массив, содержащий элементы, которые выбраны из списка, допускающего выбор нескольких элементов.
SelectableList
 InheritedselectedItem : Object
Определяет или задает элемент, выбранный в списке, допускающем выбор одного элемента.
SelectableList
 InheritedselectedItems : Array
Определяет или задает массив, содержащий объекты для элементов, которые выбраны из списка, допускающего выбор нескольких элементов.
SelectableList
  showHeaders : Boolean
Определяет или задает логическое значение, которое управляет отображением заголовков столбцов в компоненте DataGrid.
DataGrid
  sortableColumns : Boolean = true
Определяет, может ли пользователь сортировать элементы, предоставляемые поставщиком данных, щелкая заголовки столбцов.
DataGrid
  sortDescending : Boolean
[только для чтения] Определяет порядок сортировки столбца при щелчке по его заголовку.
DataGrid
  sortIndex : int
[только для чтения] Определяет индекс сортируемого столбца.
DataGrid
 InheritedsoundTransform : SoundTransform
Управляет звуком в данном спрайте.
Sprite
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
 InheritedtabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab.
InteractiveObject
 InheritedtabIndex : int
Задает последовательность перехода между объектами в SWF-файле.
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inheritedtransform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.
DisplayObject
 InheriteduseBitmapScrolling : Boolean
При значении true свойству cacheAsBitmap для прокручиваемого содержимого устанавливается значение true. При значении false данное значение отключается.
BaseScrollPane
 InheriteduseHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true.
Sprite
 Inheritedversion : String = "3.0.0.16"
Номер версии компонентов.
UIComponent
 InheritedverticalLineScrollSize : Number
Определяет или задает значение, показывающее число пикселов, на которое производится прокрутка по вертикали при щелчке стрелки прокрутки.
BaseScrollPane
 InheritedverticalPageScrollSize : Number
Определяет или задает число пикселов, на которое перемещается бегунок вертикальной полосы прокрутки при нажатии на рабочую часть полосы прокрутки.
BaseScrollPane
 InheritedverticalScrollBar : ScrollBar
[только для чтения] Определяет ссылку на вертикальную полосу прокрутки.
BaseScrollPane
 InheritedverticalScrollPolicy : String
Определяет или задает значение, показывающее состояние вертикальной полосы прокрутки.
BaseScrollPane
 InheritedverticalScrollPosition : Number
Определяет или задает значение, показывающее положение вертикальной полосы прокрутки на панели прокрутки (в пикселах).
BaseScrollPane
 Inheritedvisible : Boolean
Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента.
UIComponent
 Inheritedwidth : Number
Определяет или задает ширину компонента (в пикселах).
UIComponent
 Inheritedx : Number
Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера.
UIComponent
 Inheritedy : Number
Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера.
UIComponent
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
Создает новый экземпляр компонента DataGrid.
DataGrid
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
  
Добавляет столбец в конец массива столбцов.
DataGrid
  
Вставляет столбец в массив столбцов по указанному индексу.
DataGrid
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
 Inherited
Добавляет элемент в конец списка элементов.
SelectableList
 Inherited
addItemAt(item:Object, index:uint):void
Вставляет элемент в положении списка, заданном индексом.
SelectableList
 Inherited
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой.
DisplayObjectContainer
 Inherited
clearRendererStyle(name:String, column:int = -1):void
Удаляет стиль, установленный для средств визуализации списка.
SelectableList
 Inherited
Удаляет элемент, выбранный в списке в настоящий момент, и устанавливает свойство selectedIndex в значение -1.
SelectableList
 Inherited
Удаляет свойство style для экземпляра компонента.
UIComponent
 Inherited
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром.
DisplayObjectContainer
  
createItemEditor(colIndex:uint, rowIndex:uint):void
Использует редактор, заданный свойством itemEditor, для создания редактора элементов, который применяется средством визуализации элементов в столбце и строке, индексы которых заданы свойством editedItemPosition.
DataGrid
  
Закрывает редактор элементов, который открыт в настоящее время средством визуализации элементов.
DataGrid
 Inherited
Передает событие в поток событий.
EventDispatcher
 Inherited
Отображает или скрывает индикатор фокуса этого компонента.
UIComponent
 Inherited
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow).
UIComponent
  
editField(index:uint, dataField:String, data:Object):void
Изменяет заданное поле или свойство в компоненте DataGrid.
DataGrid
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
  
Возвращает экземпляр средства визуализации ячеек в указанном положении в компоненте DataGrid.
DataGrid
 Inherited
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
DisplayObjectContainer
 Inherited
Возвращает экземпляр дочернего экранного объекта с заданным именем.
DisplayObjectContainer
 Inherited
Возвращает позицию индекса для дочернего экземпляра DisplayObject.
DisplayObjectContainer
  
Возвращает столбец с указанным индексом в массиве столбцов.
DataGrid
  
Получает число столбцов в компоненте DataGrid.
DataGrid
  
Возвращает индекс столбца с указанным именем либо значение -1, если столбец с таким именем не найден.
DataGrid
 Inherited
Возвращает объект, который в настоящее время имеет фокус.
UIComponent
 Inherited
Возвращает элемент в положении, заданном индексом.
SelectableList
 Inherited
getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):int
Возвращает индекс следующего элемента в объекте dataProvider, где первый символ метки совпадает с указанным символом строки.
SelectableList
 Inherited
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.
DisplayObject
 Inherited
getRendererStyle(name:String, column:int = -1):Object
Возвращает стиль, установленный для средств визуализации списка.
SelectableList
 Inherited
Возвращает свойство style, установленное в последовательности для поиска стилей компонента.
UIComponent
  
[статические] Возвращает карту стилей по умолчанию для текущего компонента.
DataGrid
 Inherited
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные).
DisplayObject
 Inherited
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные).
DisplayObject
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное.
UIComponent
 Inherited
Аннулирует указанное средство визуализации элементов.
SelectableList
 Inherited
Аннулирует средство визуализации для элемента в заданном положении индекса.
SelectableList
 Inherited
Аннулирует весь список и инициирует обновление всех элементов списка.
SelectableList
 Inherited
Проверяет, выбран ли указанный элемент списка.
SelectableList
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Компонент DataGrid содержит несколько ячеек для любых элементов, поэтому метод itemToCellRenderer всегда возвращает значение NULL.
DataGrid
 Inherited
Извлекает строку, которую средство визуализации отображает для указанного объекта данных на основе свойств подписи объекта.
SelectableList
 Inherited
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными).
DisplayObject
 Inherited
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
 Inherited
[статические] Объединяет стили из нескольких классов в одном объекте.
UIComponent
 Inherited
Перемещает компонент в указанное положение в пределах его родительского компонента.
UIComponent
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Удаляет все элементы из списка.
SelectableList
  
Удаляет все столбцы из компонента DataGrid.
DataGrid
 Inherited
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer.
DisplayObjectContainer
  
Удаляет столбец с указанным индексом из массива столбцов.
DataGrid
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Удаляет указанный элемент из списка.
SelectableList
 Inherited
Удаляет элемент в заданном положении индекса.
SelectableList
 Inherited
Заменяет элемент в положении, заданном индексом, другим элементом.
SelectableList
  
scrollToIndex(newCaretIndex:int):void
Прокручивает список до элемента с указанным индексом.
DataGrid
 Inherited
Прокручивает список до элемента, индекс которого определяется текущим значением свойства selectedIndex.
SelectableList
 Inherited
Изменяет положение существующего потомка в DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Задает фокус на этот компонент.
UIComponent
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
setRendererStyle(name:String, style:Object, column:uint = 0):void
Задает стиль средств визуализации списка.
SelectableList
 Inherited
setSize(width:Number, height:Number):void
Задает указанную высоту и ширину компонента.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Задает свойство style для экземпляра компонента.
UIComponent
 Inherited
sortItems(... sortArgs):*
Сортирует элементы, предоставляемые текущим поставщиком данных.
SelectableList
 Inherited
sortItemsOn(field:String, options:Object = null):*
Сортирует элементы, предоставляемые текущим поставщиком данных, по одному или нескольким полям.
SelectableList
  
Устанавливает одинаковую ширину для всех видимых столбцов.
DataGrid
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану).
Sprite
 Inherited
Завершает метод startDrag().
Sprite
 Inherited
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков.
DisplayObjectContainer
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости.
UIComponent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
Возвращает указанный стиль для компонента, учитывая все стили, заданные на глобальном уровне, уровне компонентов и уровне экземпляров.
UIComponent
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
 InheritedОтправляется, когда в списке выбирается другой элемент.SelectableList
 InheritedОтправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject.InteractiveObject
  Отправляется, когда пользователь увеличивает ширину столбца.DataGrid
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
 InheritedОтправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.DisplayObject
 InheritedОтправляется, когда экранный объект перемещается в фокус.InteractiveObject
 InheritedОтправляется, когда экранный объект покидает фокус.InteractiveObject
 Inherited[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.DisplayObject
  Отправляется, когда пользователь щелкает ячейку заголовка.DataGrid
 InheritedОтправляется, когда видимый компонент становится невидимым.UIComponent
 InheritedОтправляется при щелчке элемента в компоненте.SelectableList
 InheritedОтправляется при двойном щелчке элемента в компоненте.SelectableList
  Отправляется, когда установлено свойство editedItemPosition, и элемент доступен для редактирования.DataGrid
  Отправляется, когда пользователь подготавливает элемент к редактированию, например, отпустив над ним кнопку мыши.DataGrid
  Отправляется, когда по какой-либо причине завершается сеанс редактирования элемента.DataGrid
  Отправляется, когда элемент получает фокус.DataGrid
  Отправляется, когда элемент теряет фокус.DataGrid
 InheritedОтправляется, когда пользователь убирает указатель мыши с одного из элементов данного компонента.SelectableList
 InheritedОтправляется, когда пользователь наводит указатель мыши на один из элементов данного компонента.SelectableList
 InheritedОтправляется, когда пользователь нажимает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью клавиатуры.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройству на экземпляр InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь вращает колесико мыши над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется при перемещении компонента.UIComponent
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню.InteractiveObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.DisplayObject
 InheritedОтправляется при изменении размеров компонента.UIComponent
 InheritedОтправляется при перемещении курсора мыши за пределы компонента.SelectableList
 InheritedОтправляется при наведении курсора мыши на компонент.SelectableList
 InheritedОтправляется, когда пользователь выполняет горизонтальную или вертикальную прокрутку.SelectableList
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда невидимый компонент становится видимым.UIComponent
 InheritedОтправляется, когда изменяется значение свойства tabChildren объекта.InteractiveObject
 InheritedОтправляется при изменении флага tabEnabled объекта.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabIndex объекта.InteractiveObject
Стили
 Стиль Описание Определено
 InheritedТип: Class
Класс, который предоставляет средство визуализации для каждого элемента компонента.
SelectableList
  
columnDividerSkin
Тип: Class
Имя класса, предоставляющего разделитель, показываемый между столбцами. Значение по умолчанию DataGrid_columnDividerSkin.
DataGrid
  
columnStretchCursorSkin
Тип: Class
Имя класса, предоставляющего курсор, который используется, когда он находится между двумя заголовками столбцов, а свойству resizableColumns присвоено значение true. Значение по умолчанию DataGrid_columnStretchCursorSkin.
DataGrid
 InheritedТип: Number Формат: Length
Размер заполнителя, отделяющего границу списка от его содержимого, в пикселах.
SelectableList
 InheritedТип: Number
Значение альфа-канала, которое присваивается списку, когда свойство enabled имеет значение false.
SelectableList
 InheritedТип: flash.text.TextFormat
Объект TextFormat, который используется для визуализации метки компонента, когда кнопка отключена.
UIComponent
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда она отключена.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда пользователь нажимает на кнопку.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки, когда курсор находится над кнопкой.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вниз на полосе прокрутки.
BaseScrollPane
 InheritedТип: Number Формат: Length
Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах.
UIComponent
 InheritedТип: Class
Обложка, используемая для показа индикаторов фокуса.
UIComponent
  
headerDisabledSkin
Тип: Class
Имя класса, предоставляющего фон для заголовка каждого столбца, когда компонент отключен. Значение по умолчанию HeaderRenderer_disabledSkin.
DataGrid
  
headerDisabledTextFormat
Тип: flash.text.TextFormat
Формат, который надо применить к тексту, содержащемуся в заголовке каждого столбца при отключении компонента. Значение по умолчанию null.
DataGrid
  
headerDownSkin
Тип: Class
Имя класса, предоставляющего фон для заголовка каждого столбца, когда кнопка мыши нажата. Значение по умолчанию HeaderRenderer_downSkin.
DataGrid
  
headerOverSkin
Тип: Class
Имя класса, предоставляющего фон для заголовка каждого столбца, когда курсор находится над ним. Значение по умолчанию HeaderRenderer_overSkin.
DataGrid
  
headerRenderer
Тип: Class
Имя класса, содержащего заголовки для каждого столбца. Значение по умолчанию fl.controls.dataGridClasses.HeaderRenderer.
DataGrid
  
headerSortArrowAscSkin
Тип: Class
Имя класса, предоставляющего стрелку сортировки, когда столбец сортируется в восходящем порядке. Значение по умолчанию HeaderSortArrow_ascIcon.
DataGrid
  
headerSortArrowDescSkin
Тип: Class
Имя класса, предоставляющего стрелку сортировки, когда столбец сортируется в нисходящем порядке. Значение по умолчанию HeaderSortArrow_descIcon.
DataGrid
  
headerTextFormat
Тип: flash.text.TextFormat
Формат, применяемый к тексту, содержащемуся в заголовке каждого столбца. Значение по умолчанию null.
DataGrid
  
headerTextPadding
Тип: Number Формат: Length
Заполнитель, отделяющий границу заголовка столбца от текста заголовка столбца, в пикселах. Значение по умолчанию 5.
DataGrid
  
headerUpSkin
Тип: Class
Имя класса, предоставляющего фон для заголовка каждого столбца. Значение по умолчанию HeaderRenderer_upSkin.
DataGrid
 InheritedТип: Number Формат: Time
Количество миллисекунд ожидания, которое проходит после того, как событие buttonDown впервые отправляется перед отправкой второго события buttonDown.
BaseScrollPane
 InheritedТип: Number Формат: Time
Интервал в миллисекундах между событиями buttonDown, которые отправляются после задержки, указанной с помощью стиля repeatDelay.
BaseScrollPane
 InheritedТип: Class
Класс, обеспечивающий обложку для фона компонента.
SelectableList
 InheritedТип: flash.text.TextFormat
Объект TextFormat, используемый для визуализации метки компонента.
UIComponent
 InheritedТип: Class
Обложка, используемая для указания отключенного состояния бегунка.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для бегунка полосы прокрутки при нажатии на бегунок.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве значка для бегунка полосы прокрутки.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для бегунка полосы прокрутки, когда курсор находится над бегунком.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для бегунка полосы прокрутки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для указания отключенной дорожки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для того, чтобы указать состояние нажатой кнопки мыши для отключенной обложки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для того, чтобы указать состояние курсора, находящегося над дорожкой прокрутки.
BaseScrollPane
 InheritedТип: Class
Обложка, используемая для того, чтобы указать состояние ненажатой кнопки мыши для дорожки прокрутки.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда она отключена.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда пользователь нажимает ее.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки, когда курсор находится над кнопкой со стрелкой.
BaseScrollPane
 InheritedТип: Class
Имя класса, используемого в качестве обложки для кнопки со стрелкой вверх на полосе прокрутки.
BaseScrollPane
Сведения о свойстве
columnsсвойство
columns:Array  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает массив объектов DataGridColumn, содержащий по одному элементу на каждый отображаемый столбец. Если порядок не задан явным образом, компонент DataGrid выполняет изучение первого элемента в поставщике данных, находит его свойства, а затем показывает их в алфавитном порядке.

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

Значение по умолчанию []



Реализация
    public function get columns():Array
    public function set columns(value:Array):void

Пример
В следующем примере новые столбцы добавляются в сетку данных с помощью массива columns:

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200, 300);
dg.columns = ["col1", "col2", "col3"];
dg.dataProvider = dp;
addChild(dg);

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}
В следующем примере заполняется новый компонент DataGrid, а число столбцов возвращается с помощью массива columns и метода getColumnCount():

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200, 300);
dg.columns = ["col1", "col2", "col3"];
dg.dataProvider = dp;
addChild(dg);

trace("columns.length:", dg.columns.length); // 3
trace("getColumnCount():", dg.getColumnCount()); // 3

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}
editableсвойство 
public var editable:Boolean = false

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

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

Редактирование отдельных столбцов компонента DataGrid можно отключить с помощью свойства DataGridColumn.editable, либо путем обработки событий itemEditBeginning и itemEditBegin.

Значение по умолчанию false

См. также

editedItemPositionсвойство 
editedItemPosition:Object  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

В этом объекте есть два поля.

Например: { columnIndex:2, rowIndex:3 }

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

Значение по умолчанию null



Реализация
    public function get editedItemPosition():Object
    public function set editedItemPosition(value:Object):void

См. также


Пример
В следующем примере приводятся поля для ввода, в которых пользователь может указать ряд и столбец, который необходимо отредактировать в столбце данных. Компоненты DataGrid, Button, Label и TextInput должны присутствовать в библиотеке FLA-файла, которая публикуется, чтобы этот пример правильно выполнялся:
import fl.data.DataProvider;
import fl.controls.*;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i=0; i<totalEntries; i++) {
    dp.addItem( {     col1:"CellName",
                    col2:"CellName",
                    col3:"CellName" } );            
}

var dg:DataGrid = new DataGrid();
dg.columns = [ "col1", "col2", "col3" ];
dg.editable = true;
dg.dataProvider = dp;
dg.move(200,10);
dg.setSize(200,300);
addChild(dg);

var rowIntro:Label = new Label();
rowIntro.text = "Row to edit:";
rowIntro.move(10,10);

var colIntro:Label = new Label();
colIntro.text = "Column to edit:";
colIntro.move(10,30);

var rowInputField:TextInput = new TextInput();
rowInputField.move(100,10);
rowInputField.setSize(30,20);

var colInputField:TextInput = new TextInput();
colInputField.move(100,30);
colInputField.setSize(30,20);

var editButton:Button = new Button();
editButton.move(10,60);
editButton.label = "Edit";
editButton.addEventListener(MouseEvent.CLICK,editGrid);

addChild(rowIntro);
addChild(colIntro);
addChild(rowInputField);
addChild(colInputField);
addChild(editButton);

function editGrid(e:MouseEvent):void {
    dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) };
}
editedItemRendererсвойство 
editedItemRenderer:ICellRenderer  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет ссылку на средство визуализации элементов в компоненте DataGrid, элемент которого редактируется в настоящий момент. Если ни один элемент не редактируется, это свойство содержит значение null.

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

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



Реализация
    public function get editedItemRenderer():ICellRenderer

См. также


Пример
В следующем примере приводятся поля для ввода, в которых пользователь может указать ряд и столбец, который необходимо отредактировать в столбце данных. Компоненты DataGrid, Button, Label и TextInput должны присутствовать в библиотеке FLA-файла, которая публикуется, чтобы этот пример правильно выполнялся:
import fl.data.DataProvider;
import fl.controls.*;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i=0; i<totalEntries; i++) {
    dp.addItem( {     col1:"CellName",
                    col2:"CellName",
                    col3:"CellName" } );            
}

var dg:DataGrid = new DataGrid();
dg.columns = [ "col1", "col2", "col3" ];
dg.editable = true;
dg.dataProvider = dp;
dg.move(200,10);
dg.setSize(200,300);
addChild(dg);

var rowIntro:Label = new Label();
rowIntro.text = "Row to edit:";
rowIntro.move(10,10);

var colIntro:Label = new Label();
colIntro.text = "Column to edit:";
colIntro.move(10,30);

var rowInputField:TextInput = new TextInput();
rowInputField.move(100,10);
rowInputField.setSize(30,20);

var colInputField:TextInput = new TextInput();
colInputField.move(100,30);
colInputField.setSize(30,20);

var editButton:Button = new Button();
editButton.move(10,60);
editButton.label = "Edit";
editButton.addEventListener(MouseEvent.CLICK,editGrid);

addChild(rowIntro);
addChild(colIntro);
addChild(rowInputField);
addChild(colInputField);
addChild(editButton);

function editGrid(e:MouseEvent):void {
    dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) };
}
headerHeightсвойство 
headerHeight:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает высоту заголовка объекта DataGrid (в пикселах).

Значение по умолчанию 25



Реализация
    public function get headerHeight():Number
    public function set headerHeight(value:Number):void

См. также


Пример
В следующем примере для изменения свойства headerHeight, относящегося к экземпляру компонента DataGrid, используется ползунок:

import fl.controls.DataGrid;
import fl.controls.Slider;
import fl.events.SliderEvent;

var headerHeightSlider:Slider = new Slider();
headerHeightSlider.minimum = 20;
headerHeightSlider.maximum = 40;
headerHeightSlider.snapInterval = 2;
headerHeightSlider.tickInterval = 4;
headerHeightSlider.liveDragging = true;
headerHeightSlider.move(10, 10);
headerHeightSlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(headerHeightSlider);

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.headerHeight = headerHeightSlider.value;
myDataGrid.addColumn("name");
myDataGrid.addColumn("value");
myDataGrid.addItem({name:"Person A", value:0.85});
myDataGrid.addItem({name:"Person B", value:0.87});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 30);
addChild(myDataGrid);

function changeHandler(event:SliderEvent):void {
    myDataGrid.headerHeight = event.value;
    myDataGrid.rowCount = myDataGrid.length;
}
horizontalScrollPolicyсвойство 
horizontalScrollPolicy:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

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

Значение по умолчанию ScrollPolicy.OFF



Реализация
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void

См. также


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

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 42;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber(), col5:getRandomNumber(), col6:getRandomNumber(), col7:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200,300);
dg.addColumn("col1");
dg.addColumn("col2");
dg.addColumn("col3");
dg.addColumn("col4");
dg.addColumn("col5");
dg.addColumn("col6");
dg.addColumn("col7");
dg.dataProvider = dp;
dg.horizontalScrollPolicy = ScrollPolicy.ON;
addChild(dg);

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}
imeModeсвойство 
imeMode:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Программа Flash переводит IME в указанный режим, когда компонент оказывается в фокусе, и восстанавливает исходное значение после того, как он выходит из фокуса.

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



Реализация
    public function get imeMode():String
    public function set imeMode(value:String):void

См. также

itemEditorInstanceсвойство 
public var itemEditorInstance:Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Ссылка на активный в настоящий момент экземпляр редактора элементов, если таковой существует.

Чтобы открыть доступ к экземпляру редактора элементов и новому значению элемента во время редактирования, воспользуйтесь свойством itemEditorInstance. Свойство itemEditorInstance учитывается только после выполнения прослушивателя событий для события itemEditBegin. По этой причине доступ к свойству itemEditorInstance обычно выполняется из прослушивателя событий для события itemEditEnd.

Свойство DataGridColumn.itemEditor определяет класс редактора элементов, а следовательно и тип данных для экземпляра редактора элементов.

См. также


Пример
В следующем примере выполняется доступ к свойству itemEditorInstance сетки данных, чтобы определить текст ячейки после редактирования:
import fl.data.DataProvider;
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridCellEditor;
import fl.controls.listClasses.ListData;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i=0; i<totalEntries; i++) {
    dp.addItem( {     col1:"CellName",
                    col2:"CellName",
                    col3:"CellName" } );            
}

var dg:DataGrid = new DataGrid();
dg.addEventListener(DataGridEvent.ITEM_EDIT_END,onItemEditEnd);
dg.dataProvider = dp;
dg.editable = true;
dg.setSize(300,200);
addChild(dg);

function onItemEditEnd(e:DataGridEvent):void {
    var cellEditor:DataGridCellEditor = dg.itemEditorInstance as DataGridCellEditor;
    var listData:ListData = cellEditor.listData;
    trace("After Edit: " + cellEditor.text);
}
labelFunctionсвойство 
labelFunction:Function  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Значение по умолчанию null



Реализация
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void

Пример
В следующем примере к каждому столбцу сетки данных применяется функция метки:

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var c1:DataGridColumn = new DataGridColumn("col1");
c1.sortOptions = Array.NUMERIC;
var c2:DataGridColumn = new DataGridColumn("col2");
c2.sortOptions = Array.NUMERIC;
var c3:DataGridColumn = new DataGridColumn("col3");
c3.sortOptions = Array.NUMERIC;

var dg:DataGrid = new DataGrid();
dg.addColumn(c1);
dg.addColumn(c2);
dg.addColumn(c3);
dg.dataProvider = dp;
dg.labelFunction = currencyFormatter;
dg.move(10, 10);
dg.setSize(200, 300);
addChild(dg);

function getRandomNumber():Number {
    return Math.random() * 100;
}

function currencyFormatter(data:Object, column:DataGridColumn):String {
    return "$" + data[column.dataField].toFixed(2);
}
minColumnWidthсвойство 
minColumnWidth:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает минимальную ширину столбца объекта DataGrid (в пикселах). Если это значение равно NaN, минимальную ширину столбца можно установить по отдельности для каждого столбца в компоненте DataGrid.

Значение по умолчанию NaN



Реализация
    public function get minColumnWidth():Number
    public function set minColumnWidth(value:Number):void

Пример
В следующем примере включается горизонтальная прокрутка сетки данных, а минимальная ширина столбца приравнивается 185. Этого достаточно, чтобы в нем уместился образец строки.
import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 42;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getString(), col2:getString(), col3:getString(), col4:getString(), col5:getString(), col6:getString(), col7:getString()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(450,300);
dg.addColumn("col1");
dg.addColumn("col2");
dg.addColumn("col3");
dg.addColumn("col4");
dg.addColumn("col5");
dg.addColumn("col6");
dg.addColumn("col7");
dg.dataProvider = dp;
dg.horizontalScrollPolicy = ScrollPolicy.ON;
dg.minColumnWidth = 185;
addChild(dg);

function getString():String {
    return "This string requires a wide column";
}
resizableColumnsсвойство 
public var resizableColumns:Boolean = true

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет, может ли пользователь изменять размеры столбцов. Значение true указывает на то, что пользователь может изменить размер столбца; значение false говорит о том, что размер столбца фиксирован.

Если выбрано значение true, пользователь может растянуть или сузить столбцы компонента DataGrid, перетащив линии сетки, которые расположены между ячейками заголовка. Кроме того, если выбрано значение true, пользователь может изменить размер столбцов, если свойствам resizeable отдельных столбцов присвоено значение false.

Значение по умолчанию true

См. также


Пример
В следующем примере создается экземпляр компонента DataGrid, а его свойствам resizableColumns и sortableColumns присваивается значение false:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;

var nameCol:DataGridColumn = new DataGridColumn("name");
nameCol.headerText = "NAME:";
nameCol.width = 120;

var valueCol:DataGridColumn = new DataGridColumn("value");
valueCol.headerText = "VALUE:";
valueCol.width = 80;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(nameCol);
myDataGrid.addColumn(valueCol);
myDataGrid.addItem({name:"Name A", value:"Value A"});
myDataGrid.addItem({name:"Name B", value:"Value B"});
myDataGrid.addItem({name:"Name C", value:"Value C"});
myDataGrid.resizableColumns = false;
myDataGrid.sortableColumns = false;
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
addChild(myDataGrid);
rowCountсвойство 
rowCount:uint  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает число строк, видимых в списке хотя бы частично.



Реализация
    public function get rowCount():uint
    public function set rowCount(value:uint):void

См. также


Пример
В следующем примере создается экземпляр компонента DataGrid, а размер сетки данных изменяется с помощью свойства rowCount:

import fl.controls.DataGrid;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.move(10, 10);
myDataGrid.setSize(300, 200);
addChild(myDataGrid);

var fixedHeight:uint = Math.min(myDataGrid.rowCount, myDataGrid.length);
myDataGrid.rowCount = fixedHeight;

trace(myDataGrid.width, myDataGrid.height); // 300 105
rowHeightсвойство 
rowHeight:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает высоту (в пикселах) каждой строки в компоненте DataGrid.

Значение по умолчанию 20



Реализация
    public function get rowHeight():Number
    public function set rowHeight(value:Number):void

См. также


Пример
В следующем примере корректируется высота строк в сетке данных, а размер текста во всех компонентах в рабочей области уменьшается:
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.managers.StyleManager;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i = 0; i < totalEntries; i++) {
    dp.addItem( { col1:Math.random(), col2:Math.random(), col3:Math.random() } );           
}

var smallText:TextFormat = new TextFormat();
smallText.size = 9;
smallText.font = "Verdana";

var dg:DataGrid = new DataGrid();
dg.columns = ["col1", "col2", "col3"];
dg.rowHeight = 14;
dg.move(10, 10);
dg.setSize(400, 300);
dg.dataProvider = dp;
dg.setStyle("textFormat", smallText);
addChild(dg);

StyleManager.setStyle("textFormat", smallText);
showHeadersсвойство 
showHeaders:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает логическое значение, которое управляет отображением заголовков столбцов в компоненте DataGrid. Значение true указывает, что в компоненте DataGrid показаны заголовки столбцов; значение false говорит о том, что его они не отображаются.

Значение по умолчанию true



Реализация
    public function get showHeaders():Boolean
    public function set showHeaders(value:Boolean):void

Пример
В следующем примере создаются две сетки данных. Одна из них содержит заголовки столбцов, а другая — нет.
import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 42;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:Math.random(), col2:Math.random()});
}

var dg1:DataGrid = new DataGrid();
dg1.move(10,10);
dg1.setSize(200,300);
dg1.dataProvider = dp;
addChild(dg1);

var dg2:DataGrid = new DataGrid();
dg2.move(250,10);
dg2.setSize(200,300);
dg2.dataProvider = dp;
dg2.showHeaders = false;
addChild(dg2);
sortableColumnsсвойство 
public var sortableColumns:Boolean = true

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

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

Полем сортировки столбца является свойство dataField или sortCompareFunction компонента DataGridColumn. Если пользователь нажмет столбец несколько раз, операция сортировки может проводиться в восходящем или нисходящем порядке.

Если этому свойству и свойству sortable столбца присвоено значение true, компонент DataGrid отправляет событие headerRelease после того, как пользователь отпускает кнопку мыши вслед за нажатием ячейки заголовка столбца. Если метод preventDefault() не вызывается из метода обработчика события headerRelease, компонент DataGrid выполняет сортировку, исходя из значений свойства dataField или sortCompareFunction.

Значение по умолчанию true

См. также


Пример
В следующем примере создается экземпляр компонента DataGrid, а свойству sortableColumns присваивается значение false, чтобы исключить возможность сортировки списка пользователем:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var data:XML = <dataProvider>
        <data col1="Person A" col2="11.383" />
        <data col1="Person B" col2="3.399" />
        <data col1="Person C" col2="25.624" />
    </dataProvider>

var dp:DataProvider = new DataProvider(data);

var c1:DataGridColumn = new DataGridColumn("col1");
var c2:DataGridColumn = new DataGridColumn("col2");

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(c1);
myDataGrid.addColumn(c2);
myDataGrid.dataProvider = dp;
myDataGrid.move(10, 10);
myDataGrid.setSize(160, 120);
myDataGrid.sortableColumns = false;
addChild(myDataGrid);
sortDescendingсвойство 
sortDescending:Boolean  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Свойство sortDescending не влияет на то, как метод сортировки завершает операцию сортировки. По умолчанию операция сортировки включает сортировку строк, которая чувствительна к регистру. Чтобы изменить это поведение, модифицируйте свойства sortOptions и sortCompareFunction класса DataGridColumn.

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

Значение по умолчанию false



Реализация
    public function get sortDescending():Boolean

См. также


Пример
В следующем примере создается экземпляр компонента DataGrid, а также выполняется прослушивание свойства headerRelease и отслеживание свойств sortDescending, sortIndex и dataField:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dataXML:XML = <dataProvider>
        <data col1="Person A" col2="11.383" />
        <data col1="Person B" col2="3.399" />
        <data col1="Person C" col2="25.624" />
    </dataProvider>

var dp:DataProvider = new DataProvider(dataXML);

var c1:DataGridColumn = new DataGridColumn("col1");
var c2:DataGridColumn = new DataGridColumn("col2");
c2.sortOptions = Array.NUMERIC;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(c1);
myDataGrid.addColumn(c2);
myDataGrid.dataProvider = dp;
myDataGrid.width = 160;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler);
addChild(myDataGrid);

function headerReleaseHandler(event:DataGridEvent):void {
    var myDG:DataGrid = event.currentTarget as DataGrid;
    var whichColumn:DataGridColumn = myDG.getColumnAt(event.columnIndex);
    trace("sortDescending:", myDG.sortDescending);
    trace("sortIndex:", myDG.sortIndex);
    trace("dataField:", whichColumn.dataField);
    trace("");
}
sortIndexсвойство 
sortIndex:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет индекс сортируемого столбца.

Значение по умолчанию -1



Реализация
    public function get sortIndex():int

См. также

Сведения о конструкторе
DataGrid()Конструктор
public function DataGrid()

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Создает новый экземпляр компонента DataGrid.

Сведения о методе
addColumn()метод
public function addColumn(column:*):DataGridColumn

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Добавляет столбец в конец массива columns.

Параметры

column:* — Объект String или DataGridColumn.

Возвращает
DataGridColumn — Добавленный объект DataGridColumn.

См. также


Пример

В следующем примере создается экземпляр компонента DataGrid и добавляются два столбца путем передачи строки методу addColumn():

import fl.controls.DataGrid;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("name");
myDataGrid.addColumn("value");
myDataGrid.addItem({name:"Name 1", value:"Value 1"});
myDataGrid.addItem({name:"Name 2", value:"Value 2"});
myDataGrid.addItem({name:"Name 3", value:"Value 3"});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
addChild(myDataGrid);

В следующем примере создается экземпляр компонента DataGrid и добавляются два столбца путем передачи объекта DataGridColumn методу addColumn():

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;

var nameCol:DataGridColumn = new DataGridColumn("name");
var valueCol:DataGridColumn = new DataGridColumn("value");

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(nameCol);
myDataGrid.addColumn(valueCol);
myDataGrid.addItem({name:"Name 1", value:"Value 1"});
myDataGrid.addItem({name:"Name 2", value:"Value 2"});
myDataGrid.addItem({name:"Name 3", value:"Value 3"});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
addChild(myDataGrid);

В следующем примере порядок и размер его столбцов указывается путем добавления их вручную перед выбором поставщика данных для массива:
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { stateName:"California", stateAbbreviation:"CA" } );
dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } );

var dg:DataGrid = new DataGrid();
var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation"));                                            
var nameColumn:DataGridColumn = dg.addColumn("stateName");
abbreviationColumn.width = 100;
nameColumn.width = 200;

dg.move(10,10);
dg.width = 300;
dg.rowCount = 2;
dg.dataProvider = dp;
addChild(dg);
addColumnAt()метод 
public function addColumnAt(column:*, index:uint):DataGridColumn

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Вставляет столбец в массив columns по указанному индексу.

Параметры

column:* — Строка или объект DataGridColumn, который представляет вставляемый столбец.
 
index:uint — Индекс массива, определяющий местоположение вставки столбца.

Возвращает
DataGridColumn — Объект DataGridColumn, вставленный в массив столбцов.

См. также


Пример

В следующем примере порядок и размер его столбцов указывается путем добавления их вручную перед выбором поставщика данных для массива:
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { stateName:"California", stateAbbreviation:"CA" } );
dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } );

var dg:DataGrid = new DataGrid();
var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation"));                                            
var nameColumn:DataGridColumn = dg.addColumn("stateName");
abbreviationColumn.width = 100;
nameColumn.width = 200;

dg.move(10,10);
dg.width = 300;
dg.rowCount = 2;
dg.dataProvider = dp;
addChild(dg);
createItemEditor()метод 
public function createItemEditor(colIndex:uint, rowIndex:uint):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Использует редактор, заданный свойством itemEditor, для создания редактора элементов, который применяется средством визуализации элементов в столбце и строке, индексы которых заданы свойством editedItemPosition.

Этот метод задает в качестве экземпляра редактора свойство itemEditorInstance.

Этот метод можно вызвать из прослушивателя событий для события itemEditBegin. Чтобы создать редактор на основе другого кода, настройте свойство editedItemPosition, выбрав генерацию события itemEditBegin.

Параметры

colIndex:uint — Индекс столбца изменяемого элемента в поставщике данных.
 
rowIndex:uint — Индекс строки изменяемого элемента в поставщике данных.

destroyItemEditor()метод 
public function destroyItemEditor():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Закрывает редактор элементов, который открыт в настоящее время средством визуализации элементов. Этот метод обычно вызывается из прослушивателя событий для события itemEditEnd после вызова метода preventDefault(), запрещающего выполнение прослушивателя событий по умолчанию.

editField()метод 
public function editField(index:uint, dataField:String, data:Object):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Изменяет заданное поле или свойство в компоненте DataGrid.

Параметры

index:uint — Изменяемый индекс поставщика данных.
 
dataField:String — Имя поля или свойства в изменяемом элементе поставщика данных.
 
data:Object — Новое значение.


Выдает
RangeError — Указанный индекс меньше 0, либо больше или равен длине поставщика данных.
getCellRendererAt()метод 
public function getCellRendererAt(row:uint, column:uint):ICellRenderer

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Возвращает экземпляр средства визуализации ячеек в указанном положении в компоненте DataGrid.

Примечание. Этот метод возвращает значение null для невидимых положений (которые находятся за пределами экрана из-за прокрутки).

Параметры

row:uint — Индекс строки.
 
column:uint — Индекс столбца.

Возвращает
ICellRenderer — Объект ICellRenderer в указанном положении или значение null, если средства визуализации ячеек нет в этом положении.
getColumnAt()метод 
public function getColumnAt(index:uint):DataGridColumn

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Возвращает столбец с указанным индексом в массиве columns.

Параметры

index:uint — Индекс определяемого столбца, либо значениеnull, если столбец не найден.

Возвращает
DataGridColumn — Объект DataGridColumn, найденный по указанному индексу.

См. также

getColumnCount()метод 
public function getColumnCount():uint

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Получает число столбцов в компоненте DataGrid.

Возвращает
uint — Число столбцов в компоненте DataGrid.

См. также


Пример

В следующем примере заполняется новый компонент DataGrid, а число столбцов возвращается с помощью массива columns и метода getColumnCount():

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200, 300);
dg.columns = ["col1", "col2", "col3"];
dg.dataProvider = dp;
addChild(dg);

trace("columns.length:", dg.columns.length); // 3
trace("getColumnCount():", dg.getColumnCount()); // 3

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}

В следующем примере создается компонент DataGrid и каждый раз при отправке события columnStretch отслеживается ширина каждого столбца сетки данных:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.events.DataGridEvent;

var nameCol:DataGridColumn = new DataGridColumn("name");
var valueCol:DataGridColumn = new DataGridColumn("value");

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(nameCol);
myDataGrid.addColumn(valueCol);
myDataGrid.addItem({name:"Name 1", value:"Value 1"});
myDataGrid.addItem({name:"Name 2", value:"Value 2"});
myDataGrid.addItem({name:"Name 3", value:"Value 3"});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler);
addChild(myDataGrid);

function columnStretchHandler(event:DataGridEvent):void {
    var col:DataGridColumn;
    for each (col in myDataGrid.columns) {
        trace(col.dataField + ":", col.width + "px")
    }
    trace("");
}
getColumnIndex()метод 
public function getColumnIndex(name:String):int

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Возвращает индекс столбца с указанным именем либо значение -1, если столбец с таким именем не найден.

Параметры

name:String — Поле данных искомого столбца.

Возвращает
int — Индекс местонахождения столбца с указанным именем.

См. также

getStyleDefinition()метод 
public static function getStyleDefinition():Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat содержит значение null или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle() по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat, выбранный по умолчанию для указанного компонента:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Возвращает
Object — Объект стилей по умолчанию.

См. также


Пример

В следующем примере создается обозреватель стилей для нескольких классов компонентов:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
itemToCellRenderer()метод 
override public function itemToCellRenderer(item:Object):ICellRenderer

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Параметры

item:Object — Элемент в поставщике данных.

Возвращает
ICellRenderernull.
removeAllColumns()метод 
public function removeAllColumns():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Удаляет все столбцы из компонента DataGrid.

См. также

removeColumnAt()метод 
public function removeColumnAt(index:uint):DataGridColumn

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Удаляет столбец с указанным индексом из массива columns.

Параметры

index:uint — Индекс удаляемого столбца.

Возвращает
DataGridColumn — Удаленный объект DataGridColumn. Этот метод возвращает null, если столбец не найден по указанному индексу.

См. также

scrollToIndex()метод 
override public function scrollToIndex(newCaretIndex:int):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Параметры

newCaretIndex:int — Положение индекса, до которого выполняется прокрутка.

spaceColumnsEqually()метод 
public function spaceColumnsEqually():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Устанавливает одинаковую ширину для всех видимых столбцов.

Сведения о событии
columnStretch Событие
Тип объекта события: fl.events.DataGridEvent
свойство DataGridEvent.type = fl.events.DataGridEvent.COLUMN_STRETCH

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется, когда пользователь увеличивает ширину столбца.

Константа DataGridEvent.COLUMN_STRETCH определяет значение свойства type объекта события columnStretch.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererСредство визуализации заголовка растянутого столбца.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

Пример

В следующем примере создается компонент DataGrid и выполняется прослушивание его события columnStretch:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.setSize(300, 200);
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler);
addChild(myDataGrid);

function columnStretchHandler(event:DataGridEvent):void {
    var dg:DataGrid = event.target as DataGrid;
    var column:DataGridColumn;
    var columnArray:Array = dg.columns;
    var dgColWidth:String;
    trace("resized column:", event.dataField);
    trace("columnIndex:", event.columnIndex);
    for each (column in columnArray) {
        dgColWidth = Number(column.width / dg.width * 100).toFixed(1);
        trace(column.dataField + ".width:", column.width + " pixels (" + dgColWidth + "%)");
    }
    trace("----------");
}
headerRelease Событие  
Тип объекта события: fl.events.DataGridEvent
свойство DataGridEvent.type = fl.events.DataGridEvent.HEADER_RELEASE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется, когда пользователь щелкает ячейку заголовка.

Константа DataGridEvent.HEADER_RELEASE определяет значение свойства type объекта события headerRelease.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererНажатое средство визуализации заголовка.
reasonnull
rowIndex-1
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

Пример

В следующем примере создается компонент DataGrid и выполняется прослушивание его события headerRelease:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.setSize(300, 200);
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler);
addChild(myDataGrid);

function headerReleaseHandler(event:DataGridEvent):void {
    var dg:DataGrid = event.target as DataGrid;
    trace("dataField:", event.dataField, "(columnIndex:" + event.columnIndex + ")");
    trace("sortIndex:", dg.sortIndex);
    trace("sortDescending:", dg.sortDescending);
    trace("----------");
}
itemEditBegin Событие  
Тип объекта события: fl.events.DataGridEvent
свойство DataGridEvent.type = fl.events.DataGridEvent.ITEM_EDIT_BEGIN

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется, когда установлено свойство editedItemPosition, и элемент доступен для редактирования.

Константа DataGridEvent.ITEM_EDIT_BEGIN определяет значение свойства type объекта события itemEditBegin.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldnull
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

itemEditBeginning Событие  
Тип объекта события: fl.events.DataGridEvent
свойство DataGridEvent.type = fl.events.DataGridEvent.ITEM_EDIT_BEGINNING

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Константа DataGridEvent.ITEM__EDIT_BEGINNING определяет значение свойства type объекта события itemEditBeginning.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

itemEditEnd Событие  
Тип объекта события: fl.events.DataGridEvent
свойство DataGridEvent.type = fl.events.DataGridEvent.ITEM_EDIT_END

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется, когда по какой-либо причине завершается сеанс редактирования элемента.

Константа DataGridEvent.ITEM_EDIT_END определяет значение свойства type объекта события itemEditEnd.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererСредство визуализации редактируемого элемента.
reasonКонстанта, определяющая причину события. Это значение должно принадлежать классу DataGridEventReason.
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

itemFocusIn Событие  
Тип объекта события: fl.events.DataGridEvent
свойство DataGridEvent.type = fl.events.DataGridEvent.ITEM_FOCUS_IN

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется, когда элемент получает фокус.

Константа DataGridEvent.ITEM_FOCUS_IN определяет значение свойства type объекта события itemFocusIn.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldnull
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

itemFocusOut Событие  
Тип объекта события: fl.events.DataGridEvent
свойство DataGridEvent.type = fl.events.DataGridEvent.ITEM_FOCUS_OUT

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется, когда элемент теряет фокус.

Константа DataGridEvent.ITEM_FOCUS_OUT определяет значение свойства type объекта события itemFocusOut.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldnull
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

Примеры Как пользоваться примерами
DataGridExample.as

В этом примере приводится способ динамического создания компонента DataGrid и прослушивания его событий.
  1. Добавьте компонент DataGrid в библиотеку.
  2. Сохраните этот код под именем DataGridExample.as в том же каталоге, где и FLA-файл.
  3. Присвойте параметру DocumentClass в FLA-файле значение DataGridExample.
package 
{
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.text.TextField;
    import fl.controls.DataGrid;
    
    public class DataGridExample extends Sprite
    {
        var sampleItem1:Object = { Name:"John Alpha",     Number:"555-123-0101", Email:"jalpha@fictitious.com" };
        var sampleItem2:Object = { Name:"Mary Bravo",     Number:"555-372-3322", Email:"mbravo@fictitious.com" };
        var sampleItem3:Object = { Name:"Trevor Gamma", Number:"555-485-1212", Email:"tgamma@fictitious.com" };
        var sampleItem4:Object = { Name:"Susan Delta",     Number:"555-987-3434", Email:"sdelta@fictitious.com" };        
        
        var dg:DataGrid;
        var tf1:TextField;
        var tf2:TextField;
        var tf3:TextField;
        
        public function DataGridExample() {
            createDataGrid();
            createTextFields();
        }
        private function createDataGrid():void {
            dg = new DataGrid();
            dg.move(10,10);
            dg.setSize(500,125);
            dg.columns = ["Name","Number","Email"];
            dg.addItem(sampleItem1);
            dg.addItem(sampleItem2);
            dg.addItem(sampleItem3);
            dg.addItem(sampleItem4);
            
            dg.addEventListener("change",gridItemSelected);
            dg.minColumnWidth = dg.width / 3;
            addChild(dg);
        }
        private function createTextFields():void {
            tf1 = new TextField();
            tf2 = new TextField();
            tf3 = new TextField();
            tf1.x = 
            tf2.x = 
            tf3.x = 10;
            tf1.autoSize =
            tf2.autoSize =
            tf3.autoSize = "left";
            tf1.y = 150;
            tf2.y = 175;
            tf3.y = 200;
            
            addChild(tf1);
            addChild(tf2);
            addChild(tf3);            
        }
        private function gridItemSelected(e:Event):void {
            tf1.text = "Name: " + e.target.selectedItem.Name;
            tf2.text = "Number: " + e.target.selectedItem.Number;
            tf3.text = "Email: " + e.target.selectedItem.Email;            
        }
    }
}