Home Reference Source
public class | source

FlexDataGridFooterCell

Extends:

react~React.ComponentEventDispatcherUIComponentFlexDataGridCell → FlexDataGridFooterCell

Constructor Summary

Public Constructor
public

Member Summary

Public Members
public

Method Summary

Public Methods
public

a. The default text of the footer is calculated on basis of the following logic:
i. First we check to see if a footerLabelFunction2 is specified on the column.

public
  1. Checks to see the value of the columns footerOperation.
public
public
public
public
public
public
public

initializeCheckBoxRenderer(renderer: *): *

public

Refreshing the contents of this cell.

Inherited Summary

From class EventDispatcher
public

[prop]: *

public
public

A list of event listeners for this event dispatcher object.

public

typeCache: {}

public

addEventListener(context: *, type: *, listener: *)

Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.

public
public

dispatchEvent(event: *): boolean

Dispatches an event into the event flow.

public
public

getStyle(prop: *): *

Gets the value of the prop property on this object

public

Returns true if an event listener exists

public

Returns true if the class name to check is in the list of class names defined for this class.

public

kill()

Removes all event listeners

public

killArray(arr: *)

Given an array of event dispatchers, calls the kill method on each of them.

public

removeEventListener(type: *, listener: *)

Removes a listener from the EventDispatcher object.

public

setStyle(prop: *, val: *)

Sets the value of the prop property on this object

From class UIComponent
public static
public static
public
public

children: *[]

public
public

data: *

This is a getter/setter for the data property.

public

domElement: HTMLElement

The dom element associated with this UIComponent.

public

A list of event listeners that are added to the domElement (these create html dom event listeners as opposed to js only event listeners)

public

Whether or not this control is enabled.

public
public
public
public
public
public
public
public

A flag to store if this object has been marked for invalidation.

public
public

parent: *

public
public

props: *

public

reactElement: ReactElement

The react element associated with this UIComponent.

public

state: *

public

tagName: *

public

toolTip: *

public
public

Whether or not this control is enabled.

public
public

x: *

public

y: *

public

addChild(child: *)

This methods takes another UIComponent object, and adds it to the dom as a child of the domElement of this UIComponent.

public

addChildAt(child: *, idx: *)

This methods takes another UIComponent object, and adds it to the dom as a child of the domElement of this UIComponent.

public

addDomEventListener(evt: *, f: *)

When you call addEventListener on a UIComponent, certain events, defined by the domEvents array are also associated with the corresponding domElement.

public

addEventListener(context: *, type: *, listener: *)

Calls super.addEventListener, and for dom based events, also adds a HTML Event listener

public

attachClass(newClass: *)

public
public
public
public
public
public

detachClass(newClass: *)

public

domEventFired(event: *)

The event handler that gets triggered from the HTML DOM.

public

focus()

public
public

getAttribute(attr: *): *

public
public

getChildAt(idx: *): *

Returns the child of the domElement at the specified index.

public
public
public

getData(): *

This is a getter/setter for the data property.

public

getElementByTagName(tag: *): *

public

getEnabled(): *

Sets the enabled flag

public

getErrorString(val: *): *

public
public
public

getHeight(): *

public
public
public

getIncludeInLayout(val: *): *

public

Getter for the innerHTML property

public
public

getStyleAttribute(attr: *): *

public

getText(): *

Getter for the text property

public
public
public

getVisible(val: *): *

Sets the visible flag

public

getWidth(): *

public

getX(): *

Gets the X co ordinate

public

getY(): *

Gets the Y co ordinate

public

globalToLocal(ptIn: *): flexiciousNmsp.Point

Converts the given global Point to local co-ordinates.

public

initFromProps(props: *)

public

Any initialization code is supposed to go in this method.

public

This method will queue the component so the display list will render it once the current frame of execution is over.

public

kill()

First, calls super.kill(), which takes out all event listeners.

public

localToGlobal(ptIn: *): flexiciousNmsp.Point

Converts the given local Point to global co-ordinates.

public

measureText(textToMeasure: *): {"width": *}

Returns the width of the given text.

public

mergeObjects(obj1: *, obj2: *): *

public

move(x: *, y: *)

Sets the X and Y co ordinates of the current dom element

public

Gets the number of children of the dom element associated with this UIComponent.

public

owns(elem: *): Boolean

Recursively iterates through the parent hierarchy of the given element to check to see if the current node is in its parent hierarchy.

public

ownsPoint(pt: *): boolean

public

removeAllChildren(child: *)

public

removeChild(child: *)

This methods takes another UIComponent object, and removes it from the dom.

public

removeChildAt(idx: *)

This methods takes another UIComponent object, and removes it from the dom.

public
public

removeDomEventListener(evt: *, f: *)

Removes a previously attached DOM event listener.

public

removeEventListener(type: *, listener: *)

Calls super.addEventListener, and for dom based events, also removes the previously added HTML Event listener

public

removeEventListenerKeepDomListener(type: *, listener: *)

Calls super.addEventListener, and for dom based events, also removes the previously added HTML Event listener

public

render(): *

public

setActualSize(w: *, h: *)

public
public

setAttribute(attr: *, val: *)

public
public

setChildIndex(child: *, index: *)

Sets the visible flag

public

setComponentStyleAttribute(attr: *, val: *)

public

setData(val: *)

This is important, because the grid looks for a "setData" method on the renderer.

public

setDomElement(elem: *)

Sets the domElement of this UIComponent to the specified element, and creates a property on the dom element called component to this.

public

setEnabled(val: *)

Sets the enabled flag

public

setErrorString(val: *)

public

setHandCursor(val: *)

public

setHeight(val: *): *

public
public
public
public

setInnerHTML(val: *)

Setter for the innerHTML property

public

setState(newState: *)

public

setStateIfDomPresent(state: *, db: *)

public

setStateInternal(newState: *)

public

setStyleAttribute(attr: *, val: *)

public

setText(val: *)

Setter for the text property

public

setToolTip(val: *)

public
public
public

setVisible(val: *)

Sets the visible flag

public

setWidth(val: *): *

public

setX(val: *): *

Sets the X co ordinate

public

setY(val: *): *

Sets the Y co ordinate

public

updateDisplayList(w: *, h: *)

Called as a part of render phase.

public
public
From class FlexDataGridCell
public

A number of operations can cause the cells text and background colors to change.

public

children: *[]

public

When column.enableIcon=true, this is the icon that will be associated with the cell.

public

column: *

public

componentInfo: ComponentInfo

The component info that holds this cell in the cells collection of the associated rowInfo object.

public

This property stores the temporary value of a cells background color when the user hovers over it.

public

This property stores the temporary value of a cells text color when the user hovers over it.

public

Once a grid is rendered, each cell in the grid is shown in the UI.

public

expandCollapseIcon: ExpandCollapseIcon

In 2.7, ability was added to have any cell be a expand collapse cell.

public
public
public
public
public

The FlexDataGridColumnLevel associated with this cell.

public

Used by header cells and column group cells for drag drop move.

public
public

rowInfo: RowInfo

The rowInfo object associated with this cell.

public
public

attachUserClass(className: *)

public

If there is a value for the prefix parameter, capitalizes the first word of the val parameter and returns it

public
public

destroy function.

public

drawBackground(unscaledWidth: *, unscaledHeight: *)

Draws the background as well as calls drawBorder on the given cell

public

drawCell(unscaledWidth: *, unscaledHeight: *)

Draws the background as well as calls drawBorder on the given cell

public

drawRightBorder(unscaledWidth: *, unscaledHeight: *): *

Draws the right border for this cell.

public

If the cell.backgroundColors is an array, returns a string join using a comma.

public

The getBackgroundColors method is responsible for evaluating the background color of the cell.

public

If column is a checkbox column, returns the current state of the checkbox renderer

public
public

getColumn(): FlexDataGridColumn

The FlexDataGridColumn associated with this cell.

public

Calculated property that controls whether or not to draw the top border.

public

getGrid(): FlexDataGrid

The FlexDataGrid associated with this cell.

public

What color to use to draw the horizontal grid lines for this cell.

public

What thickness to use to draw the horizontal grid lines for this cell.

public

getIExpandCollapseComponent(): IExpandCollapseComponent

public

getIconUrl(over: *): String

public

The "Chrome" is defined as header,footer,pager,filter sections.

public

Returns true if we are a data cell or if we area a chrome cell at a nest depth of greater than 1.

public

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

public

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

public

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

public

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

public

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

public

When a cell is created for the first time, this flag is set to true.

public

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

public
public

The FlexDataGridColumnLevel associated with this cell.

public

getLevel(): FlexDataGridColumnLevel

The FlexDataGridColumnLevel associated with this cell.

public

Returns the nestpDepth property of the associated level, if it is not null.

public

The X Position of this cell, as the user sees it.

public

Returns one of the following values on basis of what type of cell this is:

  • Blank string for data cells
  • header
  • footer
  • filter
  • columnGroup
  • pager

public

getRenderer(): DisplayObject

The actual renderer component that displays the value of the cell.

public

getRendererFactory(): IFactory

The factory class used for initializing the cell.

public

If this is a fillRow, returns the value of the color property.

public

Returns the value of the textRollOverColor style property.

public

getRowInfo(): RowInfo

The rowInfo object associated with this cell.

public

getStyleValue(styleProp: *): *

public

This is the actual text to display in the cell.

public

The getTextColors method is responsible for evaluating the text color of the cell.

public

What color to use to draw the vertical grid lines for this cell.

public

What thickness to use to draw the horizontal grid lines for this cell.

public

This flag is a used for enabling the wordWrap on the associated renderer.

public

globalToLocal(ptIn: *): flexiciousNmsp.Point

Converts the given global Point to local co-ordinates.

public

Returns true if the style property for horizontalGridLines is defined for the type of the row.

public

Returns true if the style property for verticalGridLines is defined for the type of the row.

public

initializeCheckBoxRenderer(renderer: *): *

This method is responsible for initializing the checkbox renderer for both the header and data cells.

public

Marks the cell so that the background and borders are drawn in the next validation cycle.

public

kill()

Clean up this cell

public

onCheckChange(event: *)

public

when the icon is enables, handles the mouse click event of the icon.

public

onIconMouseOut(evnt: *)

when the icon is enables, handles the mouse out event of the icon.

public

onIconMouseOver(evnt: *)

when the icon is enables, handles the mouse over event of the icon.

public

onTimerComplete(evt: *)

Once the timer completed its time, the final result will be renderered such as showing shooltips or dispatching some events.

public

placeComponent(cellRenderer: *, unscaledWidth: *, unscaledHeight: *, usePadding: *): *

This method will size and place the renderer within the bounds of this cell.

public

setting the position of ExpandCollapseIcon.

public

setting the correct position of the Icon.

public

Used to refresh the contents of a Cell.

public

setActualSize(w: *, h: *)

To set the actualsize value using width and height values.

public

setColumn(value: *)

The FlexDataGridColumnLevel associated with this cell.

public

setEnabled(val: *)

Is this enabled cell

public

setHeight(value: *)

public

setRendererFactory(value: *)

The factory class used for initializing the cell.

public

setRendererSize(cellRenderer: *, w: *, h: *)

Given a renderer, sets the size on basis of whether or not there are vertical and horizotnal gridlines .

public

setSelectable(val: *)

public

setText(val: *)

This is the actual text to display in the cell.

public
public

setWidth(value: *)

Setting the width.

public

setWordWrap(val: *)

This flag is a used for enabling the wordWrap on the associated renderer.

public

updateDisplayList(w: *, h: *)

Public Constructors

public constructor() source

Override:

FlexDataGridCell#constructor

Public Members

public dataProvider: *[] source

Public Methods

public calculateValue(flat: *): String source

a. The default text of the footer is calculated on basis of the following logic:
i. First we check to see if a footerLabelFunction2 is specified on the column. If so, we use it.
ii. Second, we check to see if there is a footerLabelFunction specified on the column. If so, we use it.
iii. Finally, if neither of these is specified, we use a default footer label function, which performs the following logic:

  1. Checks to see the value of the columns footerOperation. The valid values for this property are sum, min, max, count and average. On basis of this , it computes the value.
  2. It calls toFixed method passing in the footerOperationPrecision value to give it the appropriate number of decimal places
  3. If there is a footerFormater specified, it calls the format method of the footerFormatter passing in the value and displays the result.
  4. If there is a footerLabel specified, it will concatenate the value of the footer label to the result of the calculated value in step 3.

Params:

NameTypeAttributeDescription
flat *

Return:

String

public defaultLabelFunction(col: *): String source

  1. Checks to see the value of the columns footerOperation. The valid values for this property are sum, min, max, count and average. On basis of this , it computes the value.
  2. It calls toFixed method passing in the footerOperationPrecision value to give it the appropriate number of decimal places
  3. If there is a footerFormater specified, it calls the format method of the footerFormatter passing in the value and displays the result.
  4. If there is a footerLabel specified, it will concatenate the value of the footer label to the result of the calculated value in step 3.

Params:

NameTypeAttributeDescription
col *

Return:

String

public getBackgroundColors(): String source

The getBackgroundColors method is responsible for evaluating the background color of the cell.

  • First, it checks to see if this is a filler row. If so, it will use the alternatingItemColors array and return its 0th or 1st index based upton the rowInfo.rowPositionInfo.rowIndex.
  • Next, it checks to see if the cell is disabled. If so, it will return the value of the selectionDisabledColor style property
  • Next, it checks to see if there is a custom cellBackgroundColorFunction on the column and if so, it returns the result of this function
  • Next, it checks to see if there is a custom rowBackgroundColorFunction on the level and if so, it returns the result of this function
  • Next, it checks to see if there rowInfo's data object is in the errors collection of the grid, and if so, it return the value of the errorBackgroundColor property.
  • Next, it checks to see if there enableEditRowHighlight is true amd this row is in edit mode, then it returns the value of the editItemColors style property.
  • Next, it checks to see if there is a value for the currentBackgroundColors property (based upon rollover) and if so returns that. The currentBackgroundColors property is a result of the grid.highlightRow method.
    • If enableActiveCellHighlight=true uses the value of the activeCellColor style.
    • Else, uses the value of the rollOverColor style property.
    • Next, it checks to see if the row is selected (row selection mode) or cell is selected (cell selection mode) and if so, returns selectionColor property.
    • Next, it checks to see if a backgroundColor property is specified on the associated column and if so, returns the value of this property.
    • Finally, it uses the alternatingItemColors array and return its 0th or 1st index based upton the rowInfo.rowPositionInfo.rowIndex.
    • Getting the BackgroundColors of a FlexDataGridCell

      Override:

      FlexDataGridCell#getBackgroundColors

      Return:

      String

      public getClassNames(): string[] source

      Override:

      FlexDataGridCell#getClassNames

      Return:

      string[]

      public getDrawTopBorder(): Boolean source

      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
      To control the bottom border, the following properties are available:
      • horizontalGridLines
      • headerHorizontalGridLines
      • footerHorizontalGridLines
      • pagerHorizontalGridLines
      • filterHorizontalGridLines
      • columnGroupHorizontalGridLines

      Override:

      FlexDataGridCell#getDrawTopBorder

      Return:

      Boolean

      public getPrefix(): String source

      Returns one of the following values on basis of what type of cell this is:

      • Blank string for data cells
      • header
      • footer
      • filter
      • columnGroup
      • pager

      Override:

      FlexDataGridCell#getPrefix

      Return:

      String

      public getRolloverColor(): String source

      If this is a fillRow, returns the value of the color property. Else, returns the value of the "prop" property which is the value of one of the following style properties:

      • rollOverColors
      • headerRollOverColors
      • footerRollOverColors
      • filterRollOverColors
      • pagerRollOverColors
      • columnGroupRollOverColors
      • Getting the Roll Over Color Of a FlexDataGridCell

        Override:

        FlexDataGridCell#getRolloverColor

        Return:

        String

        public getTextColors(): String source

        The getTextColors method is responsible for evaluating the text color of the cell.

        • First, it checks to see if the cell is disabled. If so, it will return the value of the textDisabledColor style property
        • Next, it checks to see if there is a value for the currentTextColors property (based upon rollover) and if so returns that.
        • Next, it checks to see if there is a custom cellTextColorFunction on the column and if so, it returns the result of this function
        • Next, it checks to see if there is a custom rowTextColorFunction on the level and if so, it returns the result of this function
        • Next, it checks to see if there enableEditRowHighlight is true amd this row is in edit mode, then it returns the value of the editTextColor style property.
        • Next, it checks to see if the row is selected (row selection mode) or cell is selected (cell selection mode) and if so, returns textSelectedColor property.
        • Next, it checks to see if a columnTextColor property is specified on the associated column and if so, returns the value of this property.
        • Finally, it uses the alternatingTextColors array and return its 0th or 1st index based upton the rowInfo.rowPositionInfo.rowIndex.
        • Getting the TextColors of a FlexDataGridCell

          Override:

          FlexDataGridCell#getTextColors

          Return:

          String

          public initializeCheckBoxRenderer(renderer: *): * source

          This method is responsible for initializing the checkbox renderer for both the header and data cells. It performns the following tasks

          • First, it will set the radio button mode of the associated TriStateCheckBox to true if col.radioButtonMode or level.enableSingleSelect is set to true
          • Next, if the grid.enableSelectionExclusion flag is set to true, it will set the selected state of the associated TriStateCheckBox to the result of the getCheckBoxStateBasedOnExclusion method of the level
          • Next, if the grid.enableSelectionExclusion flag is set to false (default), it will set the selected state of the associated TriStateCheckBox based upon the following logic (if enableTriStateCheckBox=true):
            • If the associated rowData object is in the selected objects collection of the level, sets it to checked
            • If any of the children the associated rowData object are selected, sets it to middle
            • Else sets it to unchecked
          • Finally, if the enableLabelAndCheckBox flag is set to true on the column, this method will apply the result of the columns itemToLabel function to the label property of the checkbox

          Override:

          FlexDataGridCell#initializeCheckBoxRenderer

          Params:

          NameTypeAttributeDescription
          renderer *

          public refreshCell() source

          Refreshing the contents of this cell.

          Override:

          FlexDataGridCell#refreshCell