Classes
AddedRemovedEvent
AlertElement
AnchorContainerElement
ArrowShape
ButtonElement
CanvasElement
CanvasManager
CheckboxElement
CheckboxSkinElement
CollectionChangedEvent
CollectionSort
ColorPickerButtonElement
ColorPickerElement
ContainerBaseElement
CursorDefinition
DataGridColumnDefinition
DataGridDataRenderer
DataGridElement
DataGridHeaderColumnDividerSkinElement
DataGridHeaderElement
DataGridHeaderItemRenderer
DataGridItemData
DataGridItemRendererBase
DataGridLabelItemRenderer
DataListData
DataListElement
DataRendererBaseElement
DataRendererLabelElement
DatePickerButtonElement
DatePickerElement
DispatcherEvent
DrawMetrics
DropdownArrowButtonSkinElement
DropdownBaseElement
DropdownElement
ElementEvent
ElementGridItemClickEvent
ElementKeyboardEvent
ElementListItemClickEvent
ElementMouseEvent
ElementMouseWheelEvent
EllipseShape
EventDispatcher
FillBase
GridContainerElement
GridContainerRowColumnDefinition
ImageElement
IpInputElement
LabelElement
LinearGradientFill
ListCollection
ListContainerElement
ProgressElement
RadioButtonElement
RadioButtonSkinElement
RoundedRectangleShape
ScrollBarElement
ScrollButtonSkinElement
ShapeBase
SkinnableElement
SolidFill
StyleableBase
StyleChangedEvent
StyleData
StyleDefinition
StyleProxy
TextAreaElement
TextElement
TextFieldElement
TextInputElement
TimeInputElement
ToggleButtonElement
ToggleButtonGroup
Tween
ViewportElement


DataGridElement

DataGridElement is a data-driven container that renders a header and rows
via a supplied ListCollection, DataGridColumnDefinition(s), and Data/Item Renderers.
A scroll bar will be added if the collection size exceeds the available area.
DataGridElement only renders visible DataRenderers so collection size does not impact performance
and allows the header, rows, header item, and row item classes to be specified and styled if desired.
The default header class is DataGridHeaderElement.
The default ListItem DataRenderer (renders a row) is DataGridDataRenderer.
Default header/row ItemRenderers are supplied by the DataGridColumnDefinition and are as follows.
The default HeaderItem DataRenderer is DataGridHeaderItemRenderer.
The default RowItem DataRenderer DataGridLabelItemRenderer.

Inheritance:     DataGridElement ➞ DataListElementCanvasElementStyleableBaseStyleDefinitionEventDispatcher ➞ Object

Styles
Show Inherited
Style Defined By
GridLinesPriority     :    String DataGridElement
Determines which set of grid lines will be rendered first. Allowable values are "vertical" or "horizontal".
 
HeaderClass     :    CanvasElement DataGridElement
The CanvasElement constructor to be used for the DataGrid header. Default is DataGridHeaderElement.
 
HeaderStyle     :    StyleDefinition DataGridElement
The StyleDefinition or [StyleDefinition] array to apply to the header element.
 
HorizontalGridLinesClass     :    CanvasElement DataGridElement
The CanvasElement constructor to be used for the DataGrid horizontal grid lines. Default is null.
 
HorizontalGridLinesStyle     :    StyleDefinition DataGridElement
The StyleDefinition or [StyleDefinition] array to apply to the horizontal grid line elements.
 
VerticalGridLinesClass     :    CanvasElement DataGridElement
The CanvasElement constructor to be used for the DataGrid vertical grid lines. Default is CanvasElement.
 
VerticalGridLinesStyle     :    StyleDefinition DataGridElement
The StyleDefinition or [StyleDefinition] array to apply to the vertical grid line elements.
 


Events
Show Inherited
Event Defined By
listitemclick     :    ElementGridItemClickEvent DataGridElement
Dispatched when an ItemRenderer or header is clicked. Includes associated collection item/index.
 


Public Functions
Show Inherited
Function Defined By
DataGridElement() [Constructor] DataGridElement
Creates new DataGridElement instance.
 
addColumnDefinition(columnDefinition) DataGridElement
Adds a column definition to be rendered by the DataGrid.
  columnDefinition     :    DataGridColumnDefinition
Column definition to be rendered by the DataGrid.
 
addColumnDefinitionAt(columnDefinition, index) DataGridElement
Adds a column definition to be rendered by the DataGrid at a supplied column index.
  columnDefinition     :    DataGridColumnDefinition
Column definition to be rendered by the DataGrid.
  index     :    int
The index to insert the column definition.
  returns     :    DataGridColumnDefinition
The added DataGridColumnDefinition or null if could not be added.
 
getColumnDefinitionAt(index) DataGridElement
Gets the DataGridColumnDefinition at a supplied column index.
  index     :    int
The index to return the DataGridColumnDefinition.
  returns     :    DataGridColumnDefinition
The DataGridColumnDefinition at the supplied index.
 
getNumColumns() DataGridElement
Gets the number of column definitions.
  returns     :    int
Number of column definitions.
 
getSelectedIndex() [Override] DataGridElement
Gets the selected collection (row) and column index.
  returns     :    Object
Returns and object containing row and column indexes {row:-1, column:-1}
 
removeColumnDefinition(columnDefinition) DataGridElement
Removes a column definition from the DataGrid.
  columnDefinition     :    DataGridColumnDefinition
Column definition to be removed.
  returns     :    DataGridColumnDefinition
The removed column definition.
 
removeColumnDefinitionAt(index) DataGridElement
Removes a column definition from the DataGrid.
  index     :    int
Column index of definition to be removed.
  returns     :    DataGridColumnDefinition
The removed column definition or null if the index was out of range.
 
setSelectedIndex(rowIndex, columnIndex) [Override] DataGridElement
Sets the selected collection (row) index and column index.
When both row and column is specified the associated cell is selected.
  rowIndex     :    int
The collection (row) index to be selected or -1 for none.
  columnIndex     :    int
the column index to be selected or -1 for none.
  returns     :    bool
Returns true if the selection changed.
 


Internal Members
Show Inherited
Member Defined By
_gridColumns     :    Array DataGridElement
Read Only - Array of DataGridColumnDefinition.
 


Internal Functions
Show Inherited
Function Defined By
_columnsChanged() DataGridElement
Called in response to columns being added/removed or their styles changed.
Updates the DataGrid columns.
 
_createGridLine(direction) DataGridElement
Generates a grid line element based on vertical/horizontal GridLinesClass style.
  direction     :    String
The grid line direction "vertical" or "horizontal"
  returns     :    CanvasElement
The new grid line element.
 
_createHeaderItemRenderer(columnIndex) DataGridElement
Generates a header ItemRenderer base on the column definition HeaderItemClass style.
  columnIndex     :    int
Column index associated with the header ItemRenderer.
  returns     :    CanvasElement
The new header ItemRenderer instance.
 
_createRowItemRenderer(itemIndex, columnIndex) DataGridElement
Generates a row ItemRenderer base on the column definition RowItemClass style.
  itemIndex     :    int
Collection item index to associate with the row ItemRenderer.
  columnIndex     :    int
Column index to associate with the row ItemRenderer.
  returns     :    CanvasElement
The new row ItemRenderer instance.
 
_onDataGridColumnDefinitionChanged(styleChangedEvent) DataGridElement
Event handler for DataGridColumnDefinition "stylechanged" event. Updates the DataGrid column.
  styleChangedEvent     :    StyleChangedEvent
The StyleChangedEvent to process.
 
_onDataGridHeaderItemClick(elementMouseEvent) DataGridElement
Event handler for header ItemRenderer "click" event. Sorts the collection if a
CollectionSort is assigned to the DataGridColumDefinition and dispatched "listitemclick" event.
  elementMouseEvent     :    ElementMouseEvent
The ElementMouseEvent to process.
 
_onDataGridRowItemClick(elementMouseEvent) DataGridElement
Event handler for the row ItemRenderer "click" event. Updates selected index/item and dispatches "listitemclick" and "changed" events.
  elementMouseEvent     :    ElementMouseEvent
The ElementMouseEvent to process.
 
_updateHeaderItemRendererData(renderer, columnIndex) DataGridElement
Updates the header ItemRenderer list data.
  renderer     :    CanvasElement
Header ItemRenderer to update.
  columnIndex     :    int
Column index to associate with the header ItemRenderer.
 
_updateRowItemRendererData(renderer, itemIndex, columnIndex) DataGridElement
Updates the row ItemRenderer list data.
  renderer     :    CanvasElement
Row ItemRenderer to update.
  itemIndex     :    int
Collection item index to associate with the row ItemRenderer.
  columnIndex     :    int
Column index to associate with the row ItemRenderer.