To provide a friendly name for automation.

A number of operations can cause the cells text and background colors to change. Resizing, mouse interactions, scrolling, hovering, etc. In order to make sure we're not calling the painting and color calculating routines unnecessarily, all these operations simply mark the background as dirty. The is done by calling the invalidateBackground() method. This method will set the backgroundDirty flag to true and call invalidateDisplayList. In the next validation cycle the cell get's its color calculation code executed and painting code will then use the calculated color values to paint the cell.

The FlexDataGridColumn associated with this cell. Can be null for cells that do not have a column (e.g. ExpandCollapse Cells). For Cells that span multiple columns, it is still the column that this cell starts on.

This property can be used as the source for data binding.

The component info that holds this cell in the cells collection of the associated rowInfo object. When a row is rendered in the FlexDataGrid, the memory structure used to hold each row is the RowInfo object. If you look at grid.bodyContainer.rows, each item in this collection is an object of type RowInfo. These are the rows in the dataprovider that are currently rendered, which is different than the list of items in the dataprovider. In the cells collection of the rowInfo object, we have a list of ComponentInfo objects. The componentInfo object stores a bunch of additional information and provides a number of handy methods to interact with the cell object. It is basically a wrapper around the IFlexDataGridCell object.

This property stores the temporary value of a cells background color when the user hovers over it. The background colors of each cell are calculated using a series of rules as defined in the documentation for the getBackgroundColors method of the CellUtils class.

This property stores the temporary value of a cells text color when the user hovers over it. The text colors of each cell are calculated using a series of rules as defined in the documentation for the getTextColors method of the CellUtils class.

Once a grid is rendered, each cell in the grid is shown in the UI. After being shown, if the user performs operations like filtering, or paging, that result in the cell being taken out of view and no longer being rendered on the UI, instead of removing the cell from memory, we store it in the renderer cache of the grid. Prior to decommissioning the cell, we call the destroy method on the cell. This method will set the destroyed flag to true.

Calculated property that controls whether or not to draw the top border. Each cell in Ultimate will draw its own background and border. In order to prevent cells from drawing double borders (cell above me drew bottom border, so I should not need to draw my top border), this flag evaluates to false. But in certain cases, you may want to draw both top and bottom border. The bottom border is always controlled by the horizontalGridLines style property. The top border is controlled by the drawTopBorder style property. In order to provide fine grained control over border drawing functionality, there are the following style properties available.

• drawTopBorder
• headerDrawTopBorder
• footerDrawTopBorder
• pagerDrawTopBorder
• filterDrawTopBorder
• columnGroupDrawTopBorder

• horizontalGridLines
• headerHorizontalGridLines
• footerHorizontalGridLines
• pagerHorizontalGridLines
• filterHorizontalGridLines
• columnGroupHorizontalGridLines

The graphics object associated with the given sprite.

What color to use to draw the horizontal grid lines for this cell. The value is used to draw the bottom border. Similar to the drawTopBorder, this is a calculated property which is derived from the associated rowInfo object's row type. The result is the value of one of the following based on the rowInfo.rowPositionInfo.rowType:

• horizontalGridLineColor
• headerHorizontalGridLineColor
• footerHorizontalGridLineColor
• pagerHorizontalGridLineColor
• filterHorizontalGridLineColor
• columnHorizontalGridLineColor

What thickness to use to draw the horizontal grid lines for this cell. The value is used to draw the bottom border. drawTopBorder Similar to the drawTopBorder, this is a calculated property which is derived from the associated rowInfo object's row type. The result is the value of one of the following based on the rowInfo.rowPositionInfo.rowType:

• horizontalGridLineThickness
• headerHorizontalGridLineThickness
• footerHorizontalGridLineThickness
• pagerHorizontalGridLineThickness
• filterHorizontalGridLineThickness
• columnGroupHorizontalGridLineThickness

In 2.7, ability was added to have any cell be a expand collapse cell. If you set enableExpandCollapse=true on the column the cells that belong to that column are provided with an iExpandCollapseComponent, which defaults to an instance of

See also

The "Chrome" is defined as header,footer,pager,filter sections. This method returns true if this cell belongs to either of these containers.

Returns true if we are a data cell or if we area a chrome cell at a nest depth of greater than 1. These cells are all drawn in the content area, hence have to scroll. The "Chrome" is defined as header,footer,pager,filter sections. This method returns true if this cell belongs to either of these containers.

Returns true if the rowInfo object associated with this cell is of type RowPositionInfo.ROW_TYPE_DATA.

Returns true if this cell is not right locked or not fixed width.

Calcualted property that returns if this cell is a expand collapse cell.

Returns true if the column associated with this cell has columnLockMode="left"

Returns true if the column associated with this cell has columnLockMode="left" or columnLockMode="right"

When a cell is created for the first time, this flag is set to true. After the cell is no longer needed the cell is put back into the renderer cache. If after being put in the renderer cache, the cell gets called back into action and is added to the display list, this flag will be set to false.

Returns true if the column associated with this cell has columnLockMode="right"

The FlexDataGridColumnLevel associated with this cell. This set on initialize. This is usually never null.

This property can be used as the source for data binding.

Returns the nestpDepth property of the associated level, if it is not null. If it is null, returns 1. The top level column has nestDepth=1;

The X Position of this cell, as the user sees it. Since the Left, Right and Unlocked containers are measuremment frames in themselves, each cell's X is relative to its container. This method converts the measurement of the x value relative to the corresponding parent container to the measurement of X relative to the grid. This is used mainly by keyboard navigation to figure out which cell is to the right or left of the given cell.

The actual renderer component that displays the value of the cell. For all but the FlexDataGridDataCell2 and FlexDataGridDataCell3 there is a separate component that does the rendering. For FlexDataGridDataCell2 and FlexDataGridDataCell3, the cell itself becomes the renderer. This is why both FlexDataGridDataCell2 and FlexDataGridDataCell3 are more performant and optimized than the others. These are also more numerous, since they display data values. The header, filters and footers are relatively smaller in number.

The factory class used for initializing the cell. This is arrived at by calling the deriveRenderer method of the associated column.

See also

The rowInfo object associated with this cell. This cell should be within the cells collection of this rowInfo object.

This is the actual text to display in the cell. This is just a placeholder for the text. Ultimately this value is applied to the renderers text property. This is why, if you specify a custom renderer that exposes a text property, the grid automatically applies the result of the column.itemToLabel method on the associated rowInfo.data object to the text property of the itemRenderer.

What color to use to draw the vertical grid lines for this cell. The value is used to draw the right border. drawTopBorder Similar to the drawTopBorder, this is a calculated property which is derived from the associated rowInfo object's row type. The result is the value of one of the following based on the rowInfo.rowPositionInfo.rowType:

• verticalGridLineColor
• headerVerticalGridLineColor
• footerVerticalGridLineColor
• pagerVerticalGridLineColor
• filterVerticalGridLineColor
• columnGroupVerticalGridLineColor

What thickness to use to draw the horizontal grid lines for this cell. The value is used to draw the bottom border. drawTopBorder Similar to the drawTopBorder, this is a calculated property which is derived from the associated rowInfo object's row type. The result is the value of one of the following based on the rowInfo.rowPositionInfo.rowType:

• verticalGridLineThickness
• headerVerticalGridLineThickness
• footerVerticalGridLineThickness
• pagerVerticalGridLineThickness
• filterVerticalGridLineThickness
• columnGroupVerticalGridLineThickness

This flag is a used for enabling the wordWrap on the associated renderer. Please note, if you define an item renderer, setting wordWrap will only have an impact if you define a renderer that exposes a wordWrap property. When you specify wordWrap on the associated column, the grid will set this flag to true. It will also use a predefined item renderer that has a wordWrap property, unless you specify a custom renderer. If you specify a custom renderer, then this renderer must assume responsibility for exposing a wordWrap property and handling wordWrap appropriately.

Once a grid is rendered, each cell in the grid is shown in the UI. After being shown, if the user performs operations like filtering, or paging, that result in the cell being taken out of view and no longer being rendered on the UI, instead of removing the cell from memory, we store it in the renderer cache of the grid. Prior to decommissioning the cell, we call the destroy method on the cell. The destroy method typically will set the level, column, rowInfo, currentBackgroundColors, currentTextColors, for all cells to null. For header cells, it will destroy the associated sort icons, if any. For filter cells, it will call the clear method on the filter control.

Parameters

Returns the value of the textRollOverColor style property.

Parameters

Parameters

Returns true if the style property for horizontalGridLines is defined for the type of the row. Based upon the rowInfo.rowPositionInfo.rowType, one of the following properties are inspected:

• horizontalGridLines
• headerHorizontalGridLines
• footerHorizontalGridLines
• pagerHorizontalGridLines
• filterHorizontalGridLines
• columnGroupHorizontalGridLines

Returns true if the style property for verticalGridLines is defined for the type of the row. Based upon the rowInfo.rowPositionInfo.rowType, one of the following properties are inspected:

• verticalGridLines
• headerVerticalGridLines
• footerVerticalGridLines
• pagerVerticalGridLines
• filterVerticalGridLines
• columnGroupVerticalGridLines

Marks the cell so that the background and borders are drawn in the next validation cycle. Please, note this does not update or re-evaluate the content of the cell, just the border and the background. To updated the content, call the refreshCell method instead.

Marks a component so that its updateDisplayList() method gets called during a later screen update.

This method will size and place the renderer within the bounds of this cell. The renderer of the cell gets a width of cell.width - paddingLeft - paddingRight. It gets a height of cell.height - paddingTop - paddingBottom. It then gets placed at x position of paddingLeft and y position of paddingTop. The padding is only applied if usePadding is set to true (default). The padding is calculated on basis of what type of cell this is. The following style properties are used to figure out padding:

• paddingLeft
• paddingRight
• paddingTop
• paddingBottom
• headerPaddingLeft
• headerPaddingRight
• headerPaddingTop
• headerPaddingBottom
• footerPaddingLeft
• footerPaddingRight
• footerPaddingTop
• filterPaddingBottom
• filterPaddingLeft
• filterPaddingRight
• filterPaddingTop
• filterPaddingBottom
• columnGroupPaddingBottom
• columnGroupPaddingLeft
• columnGroupPaddingRight
• columnGroupPaddingTop
• columnGroupPaddingBottom

Parameters

This method is responsible for preparing the cell for display. It gets triggered both the first time the cell is intantiated, and again when the cell is pulled out from cache, and also when the cell is assigned to another row data object during vertical scrolling, or another column during horizontal scrolling. For all cells, It performns the following steps:

• It sets the doubleClickEnabled flag on the cell on basis of grid.enableDoubleClickEdit||grid.doubleClickEnabled
• It sets the automationName to friendly name
• It sets the destroyed flag to false
• It sets the currentBackgroundColors and currentTextColors to null
• It sets the styleName property on the renderer to the level
• It dispatches the RENDERER_INITIALIZED event, if one is wired up
• For checkbox based cells, it calls the initializeCheckBoxRenderer method
• If enableExpandCollapse is set to true, it initializes the expand collapse icon component
• It calls the placeComponent method
• If enableIcon method is set to true, it initializes the icon component

• It sets the textDecoration, useHandCursor, selectable, truncateToFit properties
• For checkbox based cells, it sets the enabled flag based upon the checkRowSelectable method of the level

• It creates the sort icon, if one is necessary, and hides the renderer, if the hideHeaderText flag is set to true

• Calculates, formats and displays the footer value based upton the footerOperation or footerLabelFunction and other footer related properties

Parameters