Packagecom.flexicious.grids.spark
Classpublic class ExtendedSparkDataGrid
InheritanceExtendedSparkDataGrid Inheritance SEdgBase Inheritance spark.components.DataGrid
Implements com.flexicious.grids.dependencies.IExtendedDataGrid
Subclasses ExtendedSparkPrintDataGrid

Extension to the Spark DataGrid

Default MXML PropertydataProvider



Public Properties
 PropertyDefined By
 InheritedadditionalFilterArgumentsFunction : Function
In scenarios where there are detached filters, this function may be used to add on to the list of arguments before the filter is run.
SEdgBase
  autoLoadPreferences : Boolean = true
ExtendedSparkDataGrid
  clickBehavior : String
Grid can be setup to launch a popup when the user clicks or hovers.
ExtendedSparkDataGrid
  clickParentDisplayObject : DisplayObject
The parent object to use while calling PopupManager.addPopUp.
ExtendedSparkDataGrid
  clickPopupClass : IFactory
The popup class to launch.
ExtendedSparkDataGrid
  clickPopupHeight : Number
The height of the popup to launch when the clickBehavior is set.
ExtendedSparkDataGrid
  clickPopupTitle : String
The title of the popup to launch when the clickBehavior is set.
ExtendedSparkDataGrid
  clickPopupWidth : Number
The width of the popup to launch when the clickBehavior is set.
ExtendedSparkDataGrid
  collectionManipulatorFactory : IFactory
The class that manages the collection filtering, paging and sorting.
ExtendedSparkDataGrid
  columns : IList
[override] [write-only]
ExtendedSparkDataGrid
  _columnWidthsDirty : Boolean = false
ExtendedSparkDataGrid
  copyAllRowsMenuText : String = Copy All Rows
Text for the Copy All Rows
ExtendedSparkDataGrid
  copyCellMenuText : String = Copy Cell
Text for the Copy Cell Menu
ExtendedSparkDataGrid
  copySelectedRowMenuText : String = Copy Selected Row
Text for the Copy Selected Row
ExtendedSparkDataGrid
  currentItemUnderMouse : Object
[read-only]
ExtendedSparkDataGrid
  dataProviderNoPaging : Object
[read-only] Gets a copy of the dataprovider with filter and sort applied, but no paging.
ExtendedSparkDataGrid
 InheriteddisplayOrder : String
A comma seperated list of the following strings: filter,body,footer,pager for the Advanced Data Grid filter,header,body,footer,pager for the Classic Data Grid Changes the order in which the grid displays the filter,header,body,footer,pager The order in which the various sections of the grid are laid out.
SEdgBase
  enableColumnWidthMode : Boolean = true
Flag to use the columnWidthMode based column resizing.
ExtendedSparkDataGrid
 InheritedenableCopy : Boolean
A flag that indicates whether or not to show the context menu options to copy the cell,row, or table data
SEdgBase
 InheritedenableDoubleClickEdit : Boolean
Enables or disables keyboard navigation for filters.
SEdgBase
 InheritedenableExport : Boolean
A flag that may be used for binding purposes in the custom pager control.
SEdgBase
 InheritedenableFilters : Boolean
A flag that indicates whether or not to show the filters
SEdgBase
 InheritedenableFooters : Boolean
A flag that indicates whether or not to show the footer
SEdgBase
 InheritedenableKeyboardNavigation : Boolean
Enables or disables keyboard navigation for filters.
SEdgBase
  enableMultiplePreferences : Boolean
A Flag that will enable multiple named versions of preferences to be persisted.
ExtendedSparkDataGrid
  enablePaging : Boolean
A flag to indicate whether or not to enable paging functionality
ExtendedSparkDataGrid
  enablePreferencePersistence : Boolean
When set to true, causes the grid to look for settings stored previously in the local shared object store if preferencePersistenceMode='client' or dispatch an event requesting settings from the server in preferencePersistenceMode='server'
ExtendedSparkDataGrid
 InheritedenablePrint : Boolean
A flag that may be used for binding purposes in the custom pager control.
SEdgBase
  excelOptions : ExportOptions
The Export options object that is used to configure the excel export behavior - currently only supported in Ultimate
ExtendedSparkDataGrid
  exportableColumns : Array
[read-only] Returns a list of columns that have excludeFromExport=false (default)
ExtendedSparkDataGrid
 InheritedfilterPageSortMode : String
The Filter/Page/Sort Mode.
SEdgBase
  filterRowHeight : Number
The height of the filter row.
ExtendedSparkDataGrid
  filterVisible : Boolean
If you have enableFilters set to true but want the filter row to not appear, you can set this value.
ExtendedSparkDataGrid
  footerRowHeight : Number
The height of the footer row.
ExtendedSparkDataGrid
  footerVisible : Boolean
If you have enableFooters set to true but want the footer row to not appear, you can set this value.
ExtendedSparkDataGrid
  forcePagerRow : Boolean
Use this flag to show the pager control even if the enablePaging is set to false.
ExtendedSparkDataGrid
  groupedColumns : Array
Unused/Not Applicable.
ExtendedSparkDataGrid
  horizontalScrollPolicy : String
Returns scroller.getStyle("horizontalScrollPolicy");
ExtendedSparkDataGrid
  horizontalScrollPosition : Number
Returns scroller.getStyle("horizontalScrollPolicy");
ExtendedSparkDataGrid
 InheritedinitialSortAscending : Boolean
In conjunction with the initialSortField property, If the initial value used to set the dataProvider is sorted by a specific field, set this property to the name of that field.
SEdgBase
 InheritedinitialSortField : String
If the initial value used to set the dataProvider is sorted by a specific field, set this property to the name of that field.
SEdgBase
  listContent : Object
[read-only] returns scroller
ExtendedSparkDataGrid
  lockedColumnCount : int
[read-only] Unused/Not Applicable.
ExtendedSparkDataGrid
 InheritedlockedColumns : Array
[read-only] Returns columns 0 through x, where x=lockedColumnCount
SEdgBase
 InheritedlockedColumnWidth : int
[read-only] Returns the width of the locked columns
SEdgBase
 InheritedlockedHeader : DataGridHeader
[read-only] Returns the locked header row
SEdgBase
  nativeExcelExporter : Exporter
The default exporter in flexicious is a pure CSV exporter.
ExtendedSparkDataGrid
  pageIndex : int
The current page index
ExtendedSparkDataGrid
  pager : IPager
[read-only] Handle to the current IPager control.
ExtendedSparkDataGrid
 InheritedpagerPosition : String
The horizontal positioning of the contents of the pager.
SEdgBase
  pagerRenderer : IFactory
A Class that implements com.flexicious.controls.interfaces.IPager.
ExtendedSparkDataGrid
  pagerRowHeight : Number
The height of the pager row.
ExtendedSparkDataGrid
  pagerVisible : Boolean
If you have enablePaging set to true but want the pager row to not appear, you can set this value.
ExtendedSparkDataGrid
  pageSize : int
The number of records to display per page
ExtendedSparkDataGrid
  pdfOptions : PrintOptions
The Print options object that is used to configure the pdf behavior - currently only supported in Ultimate
ExtendedSparkDataGrid
  pdfPrinter : IPDFPrinter
A class that takes the PDF Pages as they are generated.
ExtendedSparkDataGrid
  popupFactoryExportOptions : IFactory
The renderer that shows up when the user clicks on the Word or Excel button - currently only supported in Ultimate
ExtendedSparkDataGrid
  popupFactoryOpenSettingsPopup : IFactory
The renderer that shows up when the user clicks on the Open Settings button - currently only supported in Ultimate
ExtendedSparkDataGrid
  popupFactoryPrintOptions : IFactory
The renderer that shows up when the user clicks on the Print or PDF button - currently only supported in Ultimate
ExtendedSparkDataGrid
  popupFactorySaveSettingsPopup : IFactory
The renderer that shows up when the user clicks on the Save Settings button - currently only supported in Ultimate
ExtendedSparkDataGrid
  popupFactorySettingsPopup : IFactory
The renderer that shows up when the user clicks on the Settings button - currently only supported in Ultimate
ExtendedSparkDataGrid
  preferencePersistenceKey : String
String value that uniquely identifies this grid across the application.
ExtendedSparkDataGrid
  preferencePersistenceMode : String
String value "server" or "client".
ExtendedSparkDataGrid
  preferences : String
Returns an XML representation of the preferences specified in the preferencesToPersist property and values being the actual values.
ExtendedSparkDataGrid
  preferencesLoaded : Boolean
[read-only] Returns true if the load preferences has been called.
ExtendedSparkDataGrid
  preferencesSet : Boolean
A flag to indicate that the preferences for this grid has been set.
ExtendedSparkDataGrid
  preferencesToPersist : String
A comma delimited string of the following values: columnOrder,columnVisiblity,columnWidth,filter,sort,verticalScroll,horizontalScroll Each represents a setting that can potentially be persisted.
ExtendedSparkDataGrid
  printableColumns : Array
[read-only] Returns a list of columns that have excludeFromPrint=false (default)
ExtendedSparkDataGrid
 InheritedprintExportData : Object
Gets the records to print or to export.
SEdgBase
 InheritedprintExportParameters : Object
Any custom data that you wish to pass into the print/export mechanism. This will then be available on Print/Export Options when the Print or Export is run.
SEdgBase
  printOptions : PrintOptions
The Print options object that is used to configure the print behavior - currently only supported in Ultimate
ExtendedSparkDataGrid
  rowCount : int
[read-only] Unused/Not Applicable.
ExtendedSparkDataGrid
  selectAllState : String
The state of the select all header checkbox.
ExtendedSparkDataGrid
  selectedKeyField : String
The property(attribute) of the type(class) of the objects contained within the collection bound to the dataProvider.
ExtendedSparkDataGrid
  selectedKeys : ArrayCollection
[read-only] Gets the keys of the objects selected by the user when used in conjunction with the selectedKeyField object
ExtendedSparkDataGrid
  selectedObjects : ArrayCollection
[read-only] Gets the objects selected by the user when used in conjunction with the selectedKeyField object
ExtendedSparkDataGrid
  settingsColumns : Array
[read-only] Returns a list of columns that have excludeFromPrint=false (default)
ExtendedSparkDataGrid
  showSpinnerOnCreationComplete : Boolean
ExtendedSparkDataGrid
 InheritedshowSpinnerOnFilterPageSort : Boolean
A flag when set, automatically shows the spinner on creation complete and any filter page or sort operation.
SEdgBase
  spinner : ISpinner
ExtendedSparkDataGrid
  spinnerFactory : IFactory
Factory responsible for instantiating a new spinner.
ExtendedSparkDataGrid
  spinnerLabel : String
The label of the spinner control, you can use styles to control the appearance.
ExtendedSparkDataGrid
  totalRecords : int
The total number of records (needs to be set only in server mode, because there is no way for the grid to know how many records on the server match the filter criteria) In client mode, the count of the data provider is used instead.
ExtendedSparkDataGrid
  unLockedColumns : Array
[read-only] Returns columns x through columns.count, where x=lockedColumnCount
ExtendedSparkDataGrid
 InheritedunLockedHeader : DataGridHeader
[read-only] Returns the unlocked part of the header
SEdgBase
  useCompactPreferences : Boolean
If set to true, uses the newer preference persistence scheme introduced in Flexicious 2.0, which stores the preferences as custom string as opposed to XML, making it a lot less verbose.
ExtendedSparkDataGrid
  useModuleFactory : Boolean
[read-only] Flag that indicates to use the module factory of the grid to show popups.
ExtendedSparkDataGrid
  userSettingsOptionsFunction : Function
Hook for the client to plug in their own UserSettings.
ExtendedSparkDataGrid
 InheritedverticalScrollBarOffset : int
[read-only] If the vertical scrollbar is visible, returns the width of the vertical scroll bar.
SEdgBase
  verticalScrollPosition : Number
Returns scroller.getStyle("horizontalScrollPolicy");
ExtendedSparkDataGrid
  viewMetrics : EdgeMetrics
[read-only] Unused/Not applicable to the Nested DataGrid.
ExtendedSparkDataGrid
 InheritedvisibleColumns : Array
[read-only] Returns the visible columns from the unlocked header.
SEdgBase
  wordOptions : ExportOptions
The Export options object that is used to configure the word export behavior - currently only supported in Ultimate
ExtendedSparkDataGrid
Protected Properties
 PropertyDefined By
  _iPager : IPager
ExtendedSparkDataGrid
 Inherited_triggerEvent : Boolean = true
If we're setting filters programatically, we may not want the filterPageSortChange event to fire.
SEdgBase
Public Methods
 MethodDefined By
  
Constructor
ExtendedSparkDataGrid
  
addContextMenuItem(lbl:String, clickHandler:Function, separatorBefore:Boolean = false):void
Adds the specified context menu item to the context menu.
ExtendedSparkDataGrid
  
Calls clear on all internal filter controls, resetting the state
ExtendedSparkDataGrid
  
ExtendedSparkDataGrid
  
Clears the checkbox selections when used in conjunction with SelectAllCheckBoxHeaderColumn see com.flexicious.grids.columns.SelectAllCheckBoxHeaderColumn
ExtendedSparkDataGrid
 Inherited
clearSort():void
Clears out the sort.
SEdgBase
  
ExtendedSparkDataGrid
  
Consolidates the current state of all our filters, pager and sorts and creates a filter object that can be used to act on it
ExtendedSparkDataGrid
  
createPopup(popupData:Object):Object
Creates the popup.
ExtendedSparkDataGrid
  
Gets the class responsible for handling the PrintUI should be a IPrintDataGrid
ExtendedSparkDataGrid
  
By default, when the grid's creation complete event is dispatched, the grid will go in and load the saved preference.
ExtendedSparkDataGrid
  
When enableMultiplePreferences = true, this represents the currently applied preference
ExtendedSparkDataGrid
  
getDistinctValuesForColumn(dataField:String):ArrayCollection
ExtendedSparkDataGrid
  
ExtendedSparkDataGrid
  
getFilterArguments():ArrayCollection
ExtendedSparkDataGrid
  
getFilterColumn(searchField:String):Object
Given a field to search for, return the column that has it's searchField set to the provided value.
ExtendedSparkDataGrid
  
getFilterValue(column:String):*
Used to get the current value of the filter.
ExtendedSparkDataGrid
  
getFilterX(renderer:IFilterControl):Number
Used by filter to identify where relative position for each control for tabbing
ExtendedSparkDataGrid
  
When enableMultiplePreferences = true, this represents a list of all preferences saved for this grid.
ExtendedSparkDataGrid
  
Gets the item that was under the mouse last
ExtendedSparkDataGrid
  
ExtendedSparkDataGrid
 Inherited
getRowText(item:Object):String
Converts an objects properties into tab delimited format
SEdgBase
  
ExtendedSparkDataGrid
  
Removes the spinner and sets the listContent.alpha back to 1
ExtendedSparkDataGrid
  
[override] Need to invalidte our children when we invalidate.
ExtendedSparkDataGrid
  
Interface conformance, will simply reset the visibility of the footer, filter and pager groups.
ExtendedSparkDataGrid
  
Loads preference values from the Shared object, called automatically in preferencePersistenceMode=client.
ExtendedSparkDataGrid
  
pauseKeyboardListeners(filterRenderer:Object):void
For some operations, like shift tab and tab key up, purposely pause the Container keyboard listenters, so we do not overwrite the work of one keyboard handler by triggering another.
ExtendedSparkDataGrid
  
persistPreferences(name:String = Default, isDefault:Boolean = false):void
Persists the preferences as Shared Objects when preferencePersistenceMode=client or dispatches an event with the preference information when preferencePersistenceMode=server
ExtendedSparkDataGrid
  
If you want to control when the filter runs, set the filterTriggerEvent="none" on each of the columns, and call this function to trigger the filter
ExtendedSparkDataGrid
 Inherited
processSort(sorts:ArrayCollection):void
Used by state persistence to load sort settings that were persisted previously.
SEdgBase
  
Resets the position of each of the filter controls, the position, height and width of the filter and footer container rows, as well as the pager control This is done automatically when the columns are resized, or the list changes, or the grid is resized.
ExtendedSparkDataGrid
  
removeContextMenuItem(lbl:String):void
Removes the specified context menu item
ExtendedSparkDataGrid
  
setColumnWidthsUsingWidthMode(force:Boolean = false):void
Recalculates column widths on basis of columnWidthMode.
ExtendedSparkDataGrid
  
setContextMenuEnableDisable(lbl:String, enabled:Boolean):Boolean
Sets the enabled/disabled flag on the specified context menu item.
ExtendedSparkDataGrid
  
setContextMenuEnableVisible(lbl:String, visible:Boolean):Boolean
Sets the visible flag on the specified context menu item.
ExtendedSparkDataGrid
  
setCurrentPreferenceInfo(val:PreferenceInfo, applyPreferences:Boolean = true):void
When enableMultiplePreferences = true, applies the given preference as the current preference.
ExtendedSparkDataGrid
  
setFilterFocus(fld:String):Boolean
ExtendedSparkDataGrid
  
setFilterValue(column:String, value:Object, triggerEvent:Boolean = true):void
Used to set the initial value of the filter.
ExtendedSparkDataGrid
  
Sets the focus on the next focusable filter control, starting at column index 0.
ExtendedSparkDataGrid
  
setGridPreferencesInfo(val:GridPreferencesInfo, applyPreferences:Boolean = true):void
Sets the multiple preferences array.
ExtendedSparkDataGrid
  
showPopup(popupData:Object):Object
Launches the actual popup.
ExtendedSparkDataGrid
  
Shows the spinner with default values defined below: Label: "Loading please wait" X Position : center X of the grid Y Position : center Y of the grid Grid Alpa when the spinner is active : 0.3 Spinner appearance can be modified using styles .
ExtendedSparkDataGrid
  
showToaster(message:String, toasterPosition:String = BOTTOM_RIGHT, toasterRenderer:IFactory = null, animationDuration:Number = 1000, visibleDuration:Number = 5000, moveAnimate:Boolean = true, fadeAnimate:Boolean = true):void
[override]
ExtendedSparkDataGrid
Protected Methods
 MethodDefined By
  
adjustSelectionUponNavigation(event:KeyboardEvent):Boolean
[override]
ExtendedSparkDataGrid
  
[override]
ExtendedSparkDataGrid
  
ExtendedSparkDataGrid
  
returns UserSettingsOptions.create(this);
ExtendedSparkDataGrid
  
filterPageSort(rebuildPageIndex:Boolean, recalculateTotal:Boolean):void
In client mode, whenever there is a filter or a page or a sort, we basically so the filter, then do the sort, and then apply the page (which is really a filter on the page index)
ExtendedSparkDataGrid
  
ExtendedSparkDataGrid
  
ExtendedSparkDataGrid
  
keyDownHandler(event:KeyboardEvent):void
[override]
ExtendedSparkDataGrid
  
onCellContextMenuItemClick(event:ContextMenuEvent):void
Method to handle the click for the copy cell menu item Copies the current cell in tab delimited format into the clipboard
ExtendedSparkDataGrid
  
onCollectionChange(event:Event):void
ExtendedSparkDataGrid
  
onContextMenuShown(event:ContextMenuEvent):void
ExtendedSparkDataGrid
  
onHeaderRelease(evt:GridEvent):void
Need to handle the sort manually, because in client mode, we are sorting all the pages.
ExtendedSparkDataGrid
  
onItemRollover(event:ListEvent):void
For popup support, we keep track of what the user is hovering over.
ExtendedSparkDataGrid
  
onRowContextMenuItemClick(event:ContextMenuEvent):void
Adds the copy menu
ExtendedSparkDataGrid
  
onTableContextMenuItemClick(event:ContextMenuEvent):void
Method to handle the click for the copy table menu item Copies the current page in tab delimited format into the clipboard
ExtendedSparkDataGrid
 Inherited
placeSort():void
Places the sort icon
SEdgBase
  
redrawHeaderAndFooter(event:Event):void
ExtendedSparkDataGrid
  
ExtendedSparkDataGrid
  
setPreferences(arrayCollection:ArrayCollection):void
Takes an array collection of preferences and applies them to the grid.
ExtendedSparkDataGrid
Events
 Event Summary Defined By
  Dispatched when the grid is finished exporting.ExtendedSparkDataGrid
  Dispatched right after a grid has printed.ExtendedSparkDataGrid
  Dispatched when the grid is about to be exportedExtendedSparkDataGrid
  Dispatched right before a grid is about to print.ExtendedSparkDataGrid
  Fired when the grid needs to clear its preferences.ExtendedSparkDataGrid
  Fired when the enableFilters Flag changesExtendedSparkDataGrid
  Fired when the enableFooters Flag changesExtendedSparkDataGrid
  Fired when the enablePaging Flag changesExtendedSparkDataGrid
  Fired when the enablePreferencePersistence Flag changesExtendedSparkDataGrid
  Fired when the filter is applied.ExtendedSparkDataGrid
  Fired when the grid's page, sort or filter state changes.ExtendedSparkDataGrid
  Fired In preferencePersistenceMode=server , when the grid needs to load its preferences.ExtendedSparkDataGrid
  Fired when the Page Size changesExtendedSparkDataGrid
  Fired when the grid needs to persist its preferences.ExtendedSparkDataGrid
  Fired right before preferences are being loaded and applied.ExtendedSparkDataGrid
  Fired only in server mode, when the grid needs to print or export more data than is currently loaded in memory.ExtendedSparkDataGrid
  Fired when the select all checkbox is changedExtendedSparkDataGrid
  Fired when the checkbox selection changesExtendedSparkDataGrid
Styles
 Style Description Defined By
  
filterBackgroundColor
Type: color CSS Inheritance: no
Color of the filter background. Defaults to white. Only for Classic - for ultimate use filterColors
ExtendedSparkDataGrid
  
filterBorderColor
Type: color CSS Inheritance: no
Color of the filter border. Defaults to the borderColor attribute of the grid.
ExtendedSparkDataGrid
  
filterBorderSides
Type: String Format: Length CSS Inheritance: no
Bounding box sides for the filter. A space-delimited String that specifies the sides of the border to show. The String can contain "top", and "bottom" in any order. The default value is "top bottom", which shows top and bottom.
ExtendedSparkDataGrid
  
filterBorderThickness
Type: Number Format: Length CSS Inheritance: no
Bounding box thickness for the filter row. The default value is 1.
ExtendedSparkDataGrid
  
footerBackgroundColor
Type: color CSS Inheritance: no
Color of the footer background. Defaults to white. Only for Classic - for ultimate use footerColors
ExtendedSparkDataGrid
  
footerBorderColor
Type: color CSS Inheritance: no
Color of the footer border. Defaults to the borderColor attribute of the grid.
ExtendedSparkDataGrid
  
footerBorderSides
Type: String Format: Length CSS Inheritance: no
Bounding box sides for the footer. A space-delimited String that specifies the sides of the border to show. The String can contain "top", and "bottom" in any order. Set to "none" for no borders. The default value is "top bottom", which shows top and bottom.
ExtendedSparkDataGrid
  
footerBorderThickness
Type: Number Format: Length CSS Inheritance: no
Bounding box thickness for the footer row. The default value is 1.
ExtendedSparkDataGrid
  
pagerBackgroundColor
Type: color CSS Inheritance: no
Color of the filter background. Defaults to white. Only for Classic - for ultimate use pagerColors
ExtendedSparkDataGrid
  
spinnerColors
Type: Array Format: Color
Colors for the spinners as an array. First element for the circle color and second for the spinner color
ExtendedSparkDataGrid
  
spinnerGridAlpha
Type: Number Format: Length
Background color of the grid when the spinner is active
ExtendedSparkDataGrid
  
spinnerLabelBackgroundColor
Type: uint Format: Color
Bacground color for the box in which the label is displayed
ExtendedSparkDataGrid
  
spinnerLabelColor
Type: uint Format: Color CSS Inheritance: yes
Label color for the spinner
ExtendedSparkDataGrid
  
spinnerLabelfontFamily
Type: String CSS Inheritance: yes
Label font family
ExtendedSparkDataGrid
  
spinnerLabelfontSize
Type: Number Format: Length CSS Inheritance: yes
Label font size
ExtendedSparkDataGrid
  
spinnerLabelfontStyle
Type: String CSS Inheritance: yes
Label font style
ExtendedSparkDataGrid
  
spinnerLabelfontThickness
Type: Number CSS Inheritance: yes
Label font thinkcness
ExtendedSparkDataGrid
  
spinnerLabelfontWeight
Type: String CSS Inheritance: yes
Label font weight
ExtendedSparkDataGrid
  
spinnerLabelShowBackground
Type: Boolean
A flag that controls whether or not to show the spinner.
ExtendedSparkDataGrid
  
spinnerRadius
Type: Number Format: Length
Spinner radius , default value is 10
ExtendedSparkDataGrid
  
spinnerThickness
Type: Number Format: Length
Spinner thickness , default value is 5
ExtendedSparkDataGrid
  
useModuleFactory
Type: Boolean
A flag that asks the grid to use its module factory when instantiating popups. This is required when you are using the control inside a module.
ExtendedSparkDataGrid
Skin Parts

This component uses skins made up of skin parts. Do not set the skin parts directly. The component's skin sets the skin parts.


 Skin Part Description Defined By
  
columnFilterGroup:GridColumnFilterGroup
Required: false Part Type: Static
The filter bar
ExtendedSparkDataGrid
  
columnFooterGroup:GridColumnFooterGroup
Required: false Part Type: Static
The footer bar
ExtendedSparkDataGrid
  
pagerGroup:spark.components.Group
Required: false Part Type: Static
The footer bar
ExtendedSparkDataGrid
Property Detail
_columnWidthsDirtyproperty
public var _columnWidthsDirty:Boolean = false

_iPagerproperty 
protected var _iPager:IPager

autoLoadPreferencesproperty 
public var autoLoadPreferences:Boolean = true

clickBehaviorproperty 
clickBehavior:String

Grid can be setup to launch a popup when the user clicks or hovers. The popup class should have a public show method, that takes an object.This is the object bound to the row that triggers the click or hover event.


Implementation
    public function get clickBehavior():String
    public function set clickBehavior(value:String):void
clickParentDisplayObjectproperty 
clickParentDisplayObject:DisplayObject

The parent object to use while calling PopupManager.addPopUp. Defaults to the grid, but you can use any other DisplayObject.


Implementation
    public function get clickParentDisplayObject():DisplayObject
    public function set clickParentDisplayObject(value:DisplayObject):void
clickPopupClassproperty 
clickPopupClass:IFactory

The popup class to launch. Should have a public show method that takes an object. This is the object bound to the row that triggers the click or hover event.


Implementation
    public function get clickPopupClass():IFactory
    public function set clickPopupClass(value:IFactory):void
clickPopupHeightproperty 
clickPopupHeight:Number

The height of the popup to launch when the clickBehavior is set.


Implementation
    public function get clickPopupHeight():Number
    public function set clickPopupHeight(value:Number):void
clickPopupTitleproperty 
clickPopupTitle:String

The title of the popup to launch when the clickBehavior is set.


Implementation
    public function get clickPopupTitle():String
    public function set clickPopupTitle(value:String):void
clickPopupWidthproperty 
clickPopupWidth:Number

The width of the popup to launch when the clickBehavior is set.


Implementation
    public function get clickPopupWidth():Number
    public function set clickPopupWidth(value:Number):void
collectionManipulatorFactoryproperty 
public var collectionManipulatorFactory:IFactory

The class that manages the collection filtering, paging and sorting. Needs to inherit from CollectionManipulator.

columnsproperty 
columns:IList  [write-only] [override]


Implementation
    public function set columns(value:IList):void
copyAllRowsMenuTextproperty 
public var copyAllRowsMenuText:String = Copy All Rows

Text for the Copy All Rows

copyCellMenuTextproperty 
public var copyCellMenuText:String = Copy Cell

Text for the Copy Cell Menu

copySelectedRowMenuTextproperty 
public var copySelectedRowMenuText:String = Copy Selected Row

Text for the Copy Selected Row

currentItemUnderMouseproperty 
currentItemUnderMouse:Object  [read-only]

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


Implementation
    public function get currentItemUnderMouse():Object
dataProviderNoPagingproperty 
dataProviderNoPaging:Object  [read-only]

Gets a copy of the dataprovider with filter and sort applied, but no paging. Used by the footer calculations.


Implementation
    public function get dataProviderNoPaging():Object
enableColumnWidthModeproperty 
public var enableColumnWidthMode:Boolean = true

Flag to use the columnWidthMode based column resizing. In cases where you are not using the column width mode property on any of the columns, set this to false. Defaults to true.

enableMultiplePreferencesproperty 
enableMultiplePreferences:Boolean

A Flag that will enable multiple named versions of preferences to be persisted. The UI will be modified to allow for this to happen. This is new functionality introduced in v2.9. The default renderers for the different popups can be retrieved from the 2.9 blog post.


Implementation
    public function get enableMultiplePreferences():Boolean
    public function set enableMultiplePreferences(value:Boolean):void
enablePagingproperty 
enablePaging:Boolean

A flag to indicate whether or not to enable paging functionality

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


Implementation
    public function get enablePaging():Boolean
    public function set enablePaging(value:Boolean):void
enablePreferencePersistenceproperty 
enablePreferencePersistence:Boolean

When set to true, causes the grid to look for settings stored previously in the local shared object store if preferencePersistenceMode='client' or dispatch an event requesting settings from the server in preferencePersistenceMode='server'

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


Implementation
    public function get enablePreferencePersistence():Boolean
    public function set enablePreferencePersistence(value:Boolean):void
excelOptionsproperty 
public var excelOptions:ExportOptions

The Export options object that is used to configure the excel export behavior - currently only supported in Ultimate

exportableColumnsproperty 
exportableColumns:Array  [read-only]

Returns a list of columns that have excludeFromExport=false (default)


Implementation
    public function get exportableColumns():Array
filterRowHeightproperty 
filterRowHeight:Number

The height of the filter row. If not set, defaults to the value of the rowHeight property


Implementation
    public function get filterRowHeight():Number
    public function set filterRowHeight(value:Number):void
filterVisibleproperty 
filterVisible:Boolean

If you have enableFilters set to true but want the filter row to not appear, you can set this value.


Implementation
    public function get filterVisible():Boolean
    public function set filterVisible(value:Boolean):void
footerRowHeightproperty 
footerRowHeight:Number

The height of the footer row. If not set, defaults to the value of the rowHeight property


Implementation
    public function get footerRowHeight():Number
    public function set footerRowHeight(value:Number):void
footerVisibleproperty 
footerVisible:Boolean

If you have enableFooters set to true but want the footer row to not appear, you can set this value.


Implementation
    public function get footerVisible():Boolean
    public function set footerVisible(value:Boolean):void
forcePagerRowproperty 
forcePagerRow:Boolean

Use this flag to show the pager control even if the enablePaging is set to false. This is used in a scenario where you wish to show buttons other than the paging buttons in the pager bar.


Implementation
    public function get forcePagerRow():Boolean
    public function set forcePagerRow(value:Boolean):void
groupedColumnsproperty 
groupedColumns:Array

Unused/Not Applicable. For legacy purposes only


Implementation
    public function get groupedColumns():Array
    public function set groupedColumns(value:Array):void
horizontalScrollPolicyproperty 
horizontalScrollPolicy:String

Returns scroller.getStyle("horizontalScrollPolicy");


Implementation
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void
horizontalScrollPositionproperty 
horizontalScrollPosition:Number

Returns scroller.getStyle("horizontalScrollPolicy");


Implementation
    public function get horizontalScrollPosition():Number
    public function set horizontalScrollPosition(value:Number):void
listContentproperty 
listContent:Object  [read-only]

returns scroller


Implementation
    public function get listContent():Object
lockedColumnCountproperty 
lockedColumnCount:int  [read-only]

Unused/Not Applicable. For legacy purposes only


Implementation
    public function get lockedColumnCount():int
nativeExcelExporterproperty 
nativeExcelExporter:Exporter

The default exporter in flexicious is a pure CSV exporter. This property lets you hook in a native excel exporter using a libary like as3xls. Just like Alive PDF, as3xls is not embedded in to the core flexicious library, instead it is distributed as a part of the sample. Just like for pdf, you hook up the AlivePdfPrinter, you use the nativeExcelExporter to hookup an implementation of the flexicious expoter that interfaces with the as3xls library to provide native excel export


Implementation
    public function get nativeExcelExporter():Exporter
    public function set nativeExcelExporter(value:Exporter):void
pageIndexproperty 
pageIndex:int

The current page index


Implementation
    public function get pageIndex():int
    public function set pageIndex(value:int):void
pagerproperty 
pager:IPager  [read-only]

Handle to the current IPager control.


Implementation
    public function get pager():IPager
pagerRendererproperty 
pagerRenderer:IFactory

A Class that implements com.flexicious.controls.interfaces.IPager. Defaults to a built in implementation


Implementation
    public function get pagerRenderer():IFactory
    public function set pagerRenderer(value:IFactory):void

See also

com.flexicious.grids.columns.footers.PagerControl.
com.flexicious.controls.interfaces.IPager.
pagerRowHeightproperty 
pagerRowHeight:Number

The height of the pager row. If not set, defaults to the value of the rowHeight property


Implementation
    public function get pagerRowHeight():Number
    public function set pagerRowHeight(value:Number):void
pagerVisibleproperty 
pagerVisible:Boolean

If you have enablePaging set to true but want the pager row to not appear, you can set this value.


Implementation
    public function get pagerVisible():Boolean
    public function set pagerVisible(value:Boolean):void
pageSizeproperty 
pageSize:int

The number of records to display per page

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


Implementation
    public function get pageSize():int
    public function set pageSize(value:int):void
pdfOptionsproperty 
public var pdfOptions:PrintOptions

The Print options object that is used to configure the pdf behavior - currently only supported in Ultimate

pdfPrinterproperty 
pdfPrinter:IPDFPrinter

A class that takes the PDF Pages as they are generated. This functionality was introduced in 2.9 to provide a responsive UI during the generation of the PDF. Previously, the print controller created image snapshots in memory, and handed them all to the pdf engine, which processed them individually by adding them to the display tree in one go. Instead, now, the step of the snapshot itself adds the image to the pdf doc and this whole thing runs inside a timer so the UI has an opportunity to update itself. First, you specify a class that implements IPDFPrinter as the pdfPrinter property. The AlivePdfPrinter is a sample implementation of IPDFPrinter. This class should expose the methods defined in the IPDFPrinter which are used as such: The beginDocument method is called when the Print controller is ready to send out the pages. For each page generated by the Print Controller, the addPage method is called. Once all pages are added to the doc, the endDocument method is called.


Implementation
    public function get pdfPrinter():IPDFPrinter
    public function set pdfPrinter(value:IPDFPrinter):void
popupFactoryExportOptionsproperty 
popupFactoryExportOptions:IFactory

The renderer that shows up when the user clicks on the Word or Excel button - currently only supported in Ultimate


Implementation
    public function get popupFactoryExportOptions():IFactory
    public function set popupFactoryExportOptions(value:IFactory):void
popupFactoryOpenSettingsPopupproperty 
popupFactoryOpenSettingsPopup:IFactory

The renderer that shows up when the user clicks on the Open Settings button - currently only supported in Ultimate


Implementation
    public function get popupFactoryOpenSettingsPopup():IFactory
    public function set popupFactoryOpenSettingsPopup(value:IFactory):void
popupFactoryPrintOptionsproperty 
popupFactoryPrintOptions:IFactory

The renderer that shows up when the user clicks on the Print or PDF button - currently only supported in Ultimate


Implementation
    public function get popupFactoryPrintOptions():IFactory
    public function set popupFactoryPrintOptions(value:IFactory):void
popupFactorySaveSettingsPopupproperty 
popupFactorySaveSettingsPopup:IFactory

The renderer that shows up when the user clicks on the Save Settings button - currently only supported in Ultimate


Implementation
    public function get popupFactorySaveSettingsPopup():IFactory
    public function set popupFactorySaveSettingsPopup(value:IFactory):void
popupFactorySettingsPopupproperty 
popupFactorySettingsPopup:IFactory

The renderer that shows up when the user clicks on the Settings button - currently only supported in Ultimate


Implementation
    public function get popupFactorySettingsPopup():IFactory
    public function set popupFactorySettingsPopup(value:IFactory):void
preferencePersistenceKeyproperty 
preferencePersistenceKey:String

String value that uniquely identifies this grid across the application. If you have multiple grids' with enablePreferencePersistence, and they happen to share the same value for the id field, e.g. id="grid1" they might overwrite each others' preferences. To combat this situation, we provide a property, which defaults to the id of the grid, but you can override to provide a globally unique key.


Implementation
    public function get preferencePersistenceKey():String
    public function set preferencePersistenceKey(value:String):void
preferencePersistenceModeproperty 
preferencePersistenceMode:String

String value "server" or "client". When this property is set to client(default), the grid uses a shared object on the client to store preference settings. When it is set to server, the grid fires an event, preferencesChanged, which contains a XML string representation of the preference values. This can then be persisted on the backend, tied to a specific user id.


Implementation
    public function get preferencePersistenceMode():String
    public function set preferencePersistenceMode(value:String):void
preferencesproperty 
preferences:String

Returns an XML representation of the preferences specified in the preferencesToPersist property and values being the actual values. When


Implementation
    public function get preferences():String
    public function set preferences(value:String):void
preferencesLoadedproperty 
preferencesLoaded:Boolean  [read-only]

Returns true if the load preferences has been called.


Implementation
    public function get preferencesLoaded():Boolean
preferencesSetproperty 
preferencesSet:Boolean

A flag to indicate that the preferences for this grid has been set. Used by the clear preferences button to enable or disable itself.


Implementation
    public function get preferencesSet():Boolean
    public function set preferencesSet(value:Boolean):void
preferencesToPersistproperty 
preferencesToPersist:String

A comma delimited string of the following values: columnOrder,columnVisiblity,columnWidth,filter,sort,verticalScroll,horizontalScroll Each represents a setting that can potentially be persisted.


Implementation
    public function get preferencesToPersist():String
    public function set preferencesToPersist(value:String):void
printableColumnsproperty 
printableColumns:Array  [read-only]

Returns a list of columns that have excludeFromPrint=false (default)


Implementation
    public function get printableColumns():Array
printOptionsproperty 
public var printOptions:PrintOptions

The Print options object that is used to configure the print behavior - currently only supported in Ultimate

rowCountproperty 
rowCount:int  [read-only]

Unused/Not Applicable. For legacy purposes only


Implementation
    public function get rowCount():int
selectAllStateproperty 
selectAllState:String

The state of the select all header checkbox.


Implementation
    public function get selectAllState():String
    public function set selectAllState(value:String):void
selectedKeyFieldproperty 
selectedKeyField:String

The property(attribute) of the type(class) of the objects contained within the collection bound to the dataProvider. Example, "employeeId" property would be the selectedKeyField of the class "Employee.as". This is then used by the selectedKeys and selectedObjects properties to return the appropriate collection.

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


Implementation
    public function get selectedKeyField():String
    public function set selectedKeyField(value:String):void
selectedKeysproperty 
selectedKeys:ArrayCollection  [read-only]

Gets the keys of the objects selected by the user when used in conjunction with the selectedKeyField object

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


Implementation
    public function get selectedKeys():ArrayCollection
selectedObjectsproperty 
selectedObjects:ArrayCollection  [read-only]

Gets the objects selected by the user when used in conjunction with the selectedKeyField object


Implementation
    public function get selectedObjects():ArrayCollection
settingsColumnsproperty 
settingsColumns:Array  [read-only]

Returns a list of columns that have excludeFromPrint=false (default)


Implementation
    public function get settingsColumns():Array
showSpinnerOnCreationCompleteproperty 
showSpinnerOnCreationComplete:Boolean


Implementation
    public function get showSpinnerOnCreationComplete():Boolean
    public function set showSpinnerOnCreationComplete(value:Boolean):void
spinnerproperty 
spinner:ISpinner


Implementation
    public function get spinner():ISpinner
    public function set spinner(value:ISpinner):void
spinnerFactoryproperty 
spinnerFactory:IFactory

Factory responsible for instantiating a new spinner. Defaults to com.flexicious.Spinner. Needs to implement com.flexicious.interfaces.ISpinner, and extend UIComponent


Implementation
    public function get spinnerFactory():IFactory
    public function set spinnerFactory(value:IFactory):void
spinnerLabelproperty 
spinnerLabel:String

The label of the spinner control, you can use styles to control the appearance.


Implementation
    public function get spinnerLabel():String
    public function set spinnerLabel(value:String):void
totalRecordsproperty 
totalRecords:int

The total number of records (needs to be set only in server mode, because there is no way for the grid to know how many records on the server match the filter criteria) In client mode, the count of the data provider is used instead.


Implementation
    public function get totalRecords():int
    public function set totalRecords(value:int):void
unLockedColumnsproperty 
unLockedColumns:Array  [read-only]

Returns columns x through columns.count, where x=lockedColumnCount


Implementation
    public function get unLockedColumns():Array
useCompactPreferencesproperty 
useCompactPreferences:Boolean

If set to true, uses the newer preference persistence scheme introduced in Flexicious 2.0, which stores the preferences as custom string as opposed to XML, making it a lot less verbose.


Implementation
    public function get useCompactPreferences():Boolean
    public function set useCompactPreferences(value:Boolean):void
useModuleFactoryproperty 
useModuleFactory:Boolean  [read-only]

Flag that indicates to use the module factory of the grid to show popups. Use this when you are using modules and your parent application is not under your control. Please note, you will still need to ensure that the parent application imports PopupManager. http://bugs.adobe.com/jira/browse/SDK-873


Implementation
    public function get useModuleFactory():Boolean
userSettingsOptionsFunctionproperty 
userSettingsOptionsFunction:Function

Hook for the client to plug in their own UserSettings. See the UserSettingsOptions class for details.


Implementation
    public function get userSettingsOptionsFunction():Function
    public function set userSettingsOptionsFunction(value:Function):void
verticalScrollPositionproperty 
verticalScrollPosition:Number

Returns scroller.getStyle("horizontalScrollPolicy");


Implementation
    public function get verticalScrollPosition():Number
    public function set verticalScrollPosition(value:Number):void
viewMetricsproperty 
viewMetrics:EdgeMetrics  [read-only]

Unused/Not applicable to the Nested DataGrid.


Implementation
    public function get viewMetrics():EdgeMetrics
wordOptionsproperty 
public var wordOptions:ExportOptions

The Export options object that is used to configure the word export behavior - currently only supported in Ultimate

Constructor Detail
ExtendedSparkDataGrid()Constructor
public function ExtendedSparkDataGrid()

Constructor

Method Detail
addContextMenuItem()method
public function addContextMenuItem(lbl:String, clickHandler:Function, separatorBefore:Boolean = false):void

Adds the specified context menu item to the context menu.

Parameters

lbl:String
 
clickHandler:Function
 
separatorBefore:Boolean (default = false)

adjustSelectionUponNavigation()method 
override protected function adjustSelectionUponNavigation(event:KeyboardEvent):Boolean

Parameters

event:KeyboardEvent

Returns
Boolean
clearFilter()method 
public function clearFilter():void

Calls clear on all internal filter controls, resetting the state

clearPreferences()method 
public function clearPreferences():void

clearSelectedCheckBoxes()method 
public function clearSelectedCheckBoxes():void

Clears the checkbox selections when used in conjunction with SelectAllCheckBoxHeaderColumn see com.flexicious.grids.columns.SelectAllCheckBoxHeaderColumn

commitProperties()method 
override protected function commitProperties():void

createCollectionManipulator()method 
public function createCollectionManipulator():CollectionManipulator

Returns
CollectionManipulator
createFilter()method 
public function createFilter():Filter

Consolidates the current state of all our filters, pager and sorts and creates a filter object that can be used to act on it

Returns
Filter

See also

createMenuItems()method 
protected function createMenuItems():void

createPopup()method 
public function createPopup(popupData:Object):Object

Creates the popup.

Parameters

popupData:Object

Returns
Object
createPrintComponentFactory()method 
public function createPrintComponentFactory():IFactory

Gets the class responsible for handling the PrintUI should be a IPrintDataGrid

Returns
IFactory
defaultUseSettingsOptionsFunction()method 
protected function defaultUseSettingsOptionsFunction():UserSettingsOptions

returns UserSettingsOptions.create(this);

Returns
UserSettingsOptions
filterPageSort()method 
protected function filterPageSort(rebuildPageIndex:Boolean, recalculateTotal:Boolean):void

In client mode, whenever there is a filter or a page or a sort, we basically so the filter, then do the sort, and then apply the page (which is really a filter on the page index)

Parameters

rebuildPageIndex:Boolean — -- When we filter or sort, this is set to true, becuase the page indexes associated with each item in the array could have changed.
 
recalculateTotal:Boolean — -- If filters are applied, we need to update our total record count.

getAutoLoadPreferences()method 
public function getAutoLoadPreferences():Boolean

By default, when the grid's creation complete event is dispatched, the grid will go in and load the saved preference. This works well in most cases, but in some cases, where the data needed to build selection comboboxes (for filters) is built from the dataprovider, it makes sense to wait until the dataprovider is loaded to parse and set the preferences, otherwise the grid will end up ignoring saved preferences for filters that have dropdown based UI. In this case set autoLoadPreferences to true, and manually call loadPreferences when the data is received from the server and the dataprovider is set. grid:FlexDataGrid autoLoadPreferences=”false” And then, when you set the dataprovider: dgReport.dataProvider=dp; if(!dgReport.preferencesLoaded){ dgReport.loadPreferences(); }

Returns
Boolean
getCurrentPreferenceInfo()method 
public function getCurrentPreferenceInfo():PreferenceInfo

When enableMultiplePreferences = true, this represents the currently applied preference

Returns
PreferenceInfo
getDistinctValuesForColumn()method 
public function getDistinctValuesForColumn(dataField:String):ArrayCollection

Parameters

dataField:String

Returns
ArrayCollection
getExportableColumns()method 
public function getExportableColumns(options:ExportOptions):Array

Parameters

options:ExportOptions

Returns
Array
getFilterArguments()method 
public function getFilterArguments():ArrayCollection

Returns
ArrayCollection
getFilterColumn()method 
public function getFilterColumn(searchField:String):Object

Given a field to search for, return the column that has it's searchField set to the provided value.

Parameters

searchField:String — The field to search for

Returns
Object — The column that has its search field set to the specified searchField
getFilterValue()method 
public function getFilterValue(column:String):*

Used to get the current value of the filter.

Parameters

column:String — The dataField of the column to get the filter value for

Returns
*
getFilterX()method 
public function getFilterX(renderer:IFilterControl):Number

Used by filter to identify where relative position for each control for tabbing

Parameters

renderer:IFilterControl

Returns
Number
getGridPreferencesInfo()method 
public function getGridPreferencesInfo():GridPreferencesInfo

When enableMultiplePreferences = true, this represents a list of all preferences saved for this grid.

Returns
GridPreferencesInfo
getLastItemUnderMouse()method 
public function getLastItemUnderMouse():Object

Gets the item that was under the mouse last

Returns
Object
getPeristenceKey()method 
protected function getPeristenceKey():String

Returns
String
getPrintableColumns()method 
public function getPrintableColumns(options:PrintOptions):Array

Parameters

options:PrintOptions

Returns
Array
getUserSettingsController()method 
public function getUserSettingsController():UserSettingsController

Returns
UserSettingsController
hideSpinner()method 
public function hideSpinner():void

Removes the spinner and sets the listContent.alpha back to 1

initializeGrid()method 
protected function initializeGrid():void

invalidateDisplayList()method 
override public function invalidateDisplayList():void

Need to invalidte our children when we invalidate.

invalidateList()method 
public function invalidateList():void

Interface conformance, will simply reset the visibility of the footer, filter and pager groups. DOES NOT re-render the grid like the MX grid does. To re-render, call the refresh method on the dataprovider.

keyDownHandler()method 
override protected function keyDownHandler(event:KeyboardEvent):void

Parameters

event:KeyboardEvent

loadPreferences()method 
public function loadPreferences():void

Loads preference values from the Shared object, called automatically in preferencePersistenceMode=client. In server mode, you can directly set the preferences property to the string XML value persisted earlier.

onCellContextMenuItemClick()method 
protected function onCellContextMenuItemClick(event:ContextMenuEvent):void

Method to handle the click for the copy cell menu item Copies the current cell in tab delimited format into the clipboard

Parameters

event:ContextMenuEvent

onCollectionChange()method 
protected function onCollectionChange(event:Event):void

Parameters

event:Event

onContextMenuShown()method 
protected function onContextMenuShown(event:ContextMenuEvent):void

Parameters

event:ContextMenuEvent

onHeaderRelease()method 
protected function onHeaderRelease(evt:GridEvent):void

Need to handle the sort manually, because in client mode, we are sorting all the pages. In server mode, the caller will sort things for us, but we need to still keep track for drawing the little sort arrow icon.

Parameters

evt:GridEvent

onItemRollover()method 
protected function onItemRollover(event:ListEvent):void

For popup support, we keep track of what the user is hovering over.

Parameters

event:ListEvent

onRowContextMenuItemClick()method 
protected function onRowContextMenuItemClick(event:ContextMenuEvent):void

Adds the copy menu

Parameters

event:ContextMenuEvent

onTableContextMenuItemClick()method 
protected function onTableContextMenuItemClick(event:ContextMenuEvent):void

Method to handle the click for the copy table menu item Copies the current page in tab delimited format into the clipboard

Parameters

event:ContextMenuEvent

pauseKeyboardListeners()method 
public function pauseKeyboardListeners(filterRenderer:Object):void

For some operations, like shift tab and tab key up, purposely pause the Container keyboard listenters, so we do not overwrite the work of one keyboard handler by triggering another.

Parameters

filterRenderer:Object

persistPreferences()method 
public function persistPreferences(name:String = Default, isDefault:Boolean = false):void

Persists the preferences as Shared Objects when preferencePersistenceMode=client or dispatches an event with the preference information when preferencePersistenceMode=server

Parameters

name:String (default = Default)
 
isDefault:Boolean (default = false)

processFilter()method 
public function processFilter():void

If you want to control when the filter runs, set the filterTriggerEvent="none" on each of the columns, and call this function to trigger the filter

redrawHeaderAndFooter()method 
protected function redrawHeaderAndFooter(event:Event):void

Parameters

event:Event

refreshLayout()method 
public function refreshLayout():void

Resets the position of each of the filter controls, the position, height and width of the filter and footer container rows, as well as the pager control This is done automatically when the columns are resized, or the list changes, or the grid is resized. But this method may be used from the calling code if required.

removeContextMenuItem()method 
public function removeContextMenuItem(lbl:String):void

Removes the specified context menu item

Parameters

lbl:String

selectAllCheckBoxes()method 
protected function selectAllCheckBoxes():void

setColumnWidthsUsingWidthMode()method 
public function setColumnWidthsUsingWidthMode(force:Boolean = false):void

Recalculates column widths on basis of columnWidthMode. This method changes the widths only only if user has not persisted preferences or the force parameter is true.

Parameters

force:Boolean (default = false)

setContextMenuEnableDisable()method 
public function setContextMenuEnableDisable(lbl:String, enabled:Boolean):Boolean

Sets the enabled/disabled flag on the specified context menu item.

Parameters

lbl:String
 
enabled:Boolean

Returns
Boolean
setContextMenuEnableVisible()method 
public function setContextMenuEnableVisible(lbl:String, visible:Boolean):Boolean

Sets the visible flag on the specified context menu item.

Parameters

lbl:String
 
visible:Boolean

Returns
Boolean
setCurrentPreferenceInfo()method 
public function setCurrentPreferenceInfo(val:PreferenceInfo, applyPreferences:Boolean = true):void

When enableMultiplePreferences = true, applies the given preference as the current preference.

Parameters

val:PreferenceInfo
 
applyPreferences:Boolean (default = true)

setFilterFocus()method 
public function setFilterFocus(fld:String):Boolean

Parameters

fld:String — The string to match the searchField property of the filter control with.

Returns
Boolean — True if focus was set, false if otherwise. Focus may not be set if the given search field does not exist, or if the filter control for the given search field does not implement IFocusManagerComponent.
setFilterValue()method 
public function setFilterValue(column:String, value:Object, triggerEvent:Boolean = true):void

Used to set the initial value of the filter.

Parameters

column:String — The column to set filter for
 
value:Object — The value to set
 
triggerEvent:Boolean (default = true) — Whether or not to fire the filterPageSortChange event. Defaults to true.

setFocusOnNextFocusableFilterControl()method 
public function setFocusOnNextFocusableFilterControl():Boolean

Sets the focus on the next focusable filter control, starting at column index 0.

Returns
Boolean
setGridPreferencesInfo()method 
public function setGridPreferencesInfo(val:GridPreferencesInfo, applyPreferences:Boolean = true):void

Sets the multiple preferences array. On basis of the applyPreferences parameter, loops through the preferences and sets the preferences value to the first preference where isDefault=true.

Parameters

val:GridPreferencesInfo
 
applyPreferences:Boolean (default = true)

setPreferences()method 
protected function setPreferences(arrayCollection:ArrayCollection):void

Takes an array collection of preferences and applies them to the grid.

Parameters

arrayCollection:ArrayCollection

showPopup()method 
public function showPopup(popupData:Object):Object

Launches the actual popup.

Parameters

popupData:Object

Returns
Object
showSpinner()method 
public function showSpinner():void

Shows the spinner with default values defined below: Label: "Loading please wait" X Position : center X of the grid Y Position : center Y of the grid Grid Alpa when the spinner is active : 0.3 Spinner appearance can be modified using styles .

showToaster()method 
override public function showToaster(message:String, toasterPosition:String = BOTTOM_RIGHT, toasterRenderer:IFactory = null, animationDuration:Number = 1000, visibleDuration:Number = 5000, moveAnimate:Boolean = true, fadeAnimate:Boolean = true):void

Parameters

message:String
 
toasterPosition:String (default = BOTTOM_RIGHT)
 
toasterRenderer:IFactory (default = null)
 
animationDuration:Number (default = 1000)
 
visibleDuration:Number (default = 5000)
 
moveAnimate:Boolean (default = true)
 
fadeAnimate:Boolean (default = true)

Event Detail
afterExport Event
Event Object Type: com.flexicious.export.ExportEvent

Dispatched when the grid is finished exporting. At this point, the textWritten variable of the dispatched event is available to you, to customize the generated text if you need to.

afterPrint Event  
Event Object Type: com.flexicious.print.PrintPreviewEvent

Dispatched right after a grid has printed. Contains a handle to the printOptions object that contains both the grid being printed extendedDataGrid - (IExtendedDataGrid) and printDataGrid (IPrintDatagrid). You can use it to make modifications to the grid being printed.

beforeExport Event  
Event Object Type: com.flexicious.export.ExportEvent

Dispatched when the grid is about to be exported

beforePrint Event  
Event Object Type: com.flexicious.print.PrintPreviewEvent

Dispatched right before a grid is about to print. Contains a handle to the printOptions object that contains both the grid being printed extendedDataGrid - (IExtendedDataGrid) and printDataGrid (IPrintDatagrid). You can use it to make modifications to the grid being printed.

clearPreferences Event  
Event Object Type: com.flexicious.grids.events.PreferencePersistenceEvent

Fired when the grid needs to clear its preferences.

enableFilterChanged Event  

Fired when the enableFilters Flag changes

enableFootersChanged Event  

Fired when the enableFooters Flag changes

enablePagingChanged Event  

Fired when the enablePaging Flag changes

enablePreferencePersistenceChanged Event  

Fired when the enablePreferencePersistence Flag changes

filterComplete Event  

Fired when the filter is applied. Only applicable in filterPageSortMode=client.

filterPageSortChange Event  
Event Object Type: com.flexicious.grids.events.FilterPageSortChangeEvent

Fired when the grid's page, sort or filter state changes.

loadPreferences Event  
Event Object Type: com.flexicious.grids.events.PreferencePersistenceEvent

Fired In preferencePersistenceMode=server , when the grid needs to load its preferences. Fired In preferencePersistenceMode=client , when the grid has successfully loaded preferences.

pageSizeChanged Event  

Fired when the Page Size changes

persistPreferences Event  
Event Object Type: com.flexicious.grids.events.PreferencePersistenceEvent

Fired when the grid needs to persist its preferences.

preferencesLoading Event  
Event Object Type: com.flexicious.grids.events.PreferencePersistenceEvent

Fired right before preferences are being loaded and applied.

printExportDataRequest Event  
Event Object Type: com.flexicious.grids.events.PrintExportDataRequestEvent

Fired only in server mode, when the grid needs to print or export more data than is currently loaded in memory.

selectAllChanged Event  

Fired when the select all checkbox is changed

selectedKeysChanged Event  

Fired when the checkbox selection changes