| Package | com.flexicious.grids.spark | 
| Class | public class ExtendedSparkDataGrid | 
| Inheritance | ExtendedSparkDataGrid  SEdgBase  spark.components.DataGrid | 
| Implements | com.flexicious.grids.dependencies.IExtendedDataGrid | 
| Subclasses | ExtendedSparkPrintDataGrid | 
Default MXML PropertydataProvider
| Property | Defined By | ||
|---|---|---|---|
|  | additionalFilterArgumentsFunction : 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 | ||
|  | displayOrder : 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 | ||
|  | enableCopy : Boolean 
 
 A flag that indicates whether or not to show the context menu options to
 copy the cell,row, or table data
  | SEdgBase | |
|  | enableDoubleClickEdit : Boolean 
 Enables or disables keyboard navigation for filters. | SEdgBase | |
|  | enableExport : Boolean 
 A flag that may be used for binding purposes
 in the custom pager control. | SEdgBase | |
|  | enableFilters : Boolean 
 A flag that indicates whether or not to show the filters
  | SEdgBase | |
|  | enableFooters : Boolean 
 A flag that indicates whether or not to show the footer
  | SEdgBase | |
|  | enableKeyboardNavigation : 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 | ||
|  | enablePrint : 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 | ||
|  | filterPageSortMode : 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 | ||
|  | initialSortAscending : 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 | |
|  | initialSortField : 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 | ||
|  | lockedColumns : Array [read-only] 
		 Returns columns 0 through x, where x=lockedColumnCount
		  | SEdgBase | |
|  | lockedColumnWidth : int [read-only] 
		 Returns the width of the locked columns
		  | SEdgBase | |
|  | lockedHeader : 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 | ||
|  | pagerPosition : 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 | ||
|  | printExportData : Object 
 Gets the records to print or to export. | SEdgBase | |
|  | printExportParameters : 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 | ||
|  | showSpinnerOnFilterPageSort : 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 | ||
|  | unLockedHeader : 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 | ||
|  | verticalScrollBarOffset : 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 | ||
|  | visibleColumns : 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 | ||
| Property | Defined By | ||
|---|---|---|---|
| _iPager : IPager | ExtendedSparkDataGrid | ||
|  | _triggerEvent : Boolean = true 
 If we're setting filters programatically,
 we may not want the filterPageSortChange event 
 to fire. | SEdgBase | |
| Method | Defined By | ||
|---|---|---|---|
| 
		 Constructor 
		 
		  | ExtendedSparkDataGrid | ||
| addContextMenuItem(lbl:String, clickHandler:Function, separatorBefore:Boolean = false):void 
	 Adds the specified context menu item to the context menu. | ExtendedSparkDataGrid | ||
| clearFilter():void 
		 Calls clear on all internal filter controls, resetting the state
		  | ExtendedSparkDataGrid | ||
| clearPreferences():void | ExtendedSparkDataGrid | ||
| clearSelectedCheckBoxes():void 
		 Clears the checkbox selections when used in
		 conjunction with SelectAllCheckBoxHeaderColumn
		 see com.flexicious.grids.columns.SelectAllCheckBoxHeaderColumn
		  | ExtendedSparkDataGrid | ||
|  | 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 | ||
| createPrintComponentFactory():IFactory 
		 Gets the class responsible for handling the PrintUI should be a IPrintDataGrid
		  | ExtendedSparkDataGrid | ||
| getAutoLoadPreferences():Boolean 
		 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 | ||
| getExportableColumns(options:ExportOptions):Array | 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 | ||
| getLastItemUnderMouse():Object 
	 Gets the item that was under the mouse last
	  | ExtendedSparkDataGrid | ||
| getPrintableColumns(options:PrintOptions):Array | ExtendedSparkDataGrid | ||
|  | getRowText(item:Object):String 
 Converts an objects properties into tab delimited format
  | SEdgBase | |
| ExtendedSparkDataGrid | |||
| hideSpinner():void 
		  
		 Removes the spinner and sets the listContent.alpha back to 1 
		 
		  | ExtendedSparkDataGrid | ||
| invalidateDisplayList():void [override] 
		 Need to invalidte our children when we invalidate. | ExtendedSparkDataGrid | ||
| invalidateList():void 
		 Interface conformance, will simply reset the visibility of the footer, filter and pager groups. | ExtendedSparkDataGrid | ||
| loadPreferences():void 
 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 | ||
| 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
		  | ExtendedSparkDataGrid | ||
|  | processSort(sorts:ArrayCollection):void 
		 Used by state persistence to load sort settings that were
		 persisted previously. | SEdgBase | |
| 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. | 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 | ||
| setFocusOnNextFocusableFilterControl():Boolean 
		 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 | ||
| 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 . | 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 | ||
| Method | Defined By | ||
|---|---|---|---|
| adjustSelectionUponNavigation(event:KeyboardEvent):Boolean [override]  | ExtendedSparkDataGrid | ||
| commitProperties():void [override]  | ExtendedSparkDataGrid | ||
| createMenuItems():void | 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 | ||
| getPeristenceKey():String | ExtendedSparkDataGrid | ||
| initializeGrid():void | 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 | ||
|  | placeSort():void 
		 Places the sort icon
		  | SEdgBase | |
| redrawHeaderAndFooter(event:Event):void | ExtendedSparkDataGrid | ||
| selectAllCheckBoxes():void | ExtendedSparkDataGrid | ||
| setPreferences(arrayCollection:ArrayCollection):void 
 Takes an array collection of preferences and applies them to the grid. | ExtendedSparkDataGrid | ||
| 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 exported | ExtendedSparkDataGrid | |||
| 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 changes | ExtendedSparkDataGrid | |||
| Fired when the enableFooters Flag changes | ExtendedSparkDataGrid | |||
| Fired when the enablePaging Flag changes | ExtendedSparkDataGrid | |||
| Fired when the enablePreferencePersistence Flag changes | ExtendedSparkDataGrid | |||
| 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 changes | ExtendedSparkDataGrid | |||
| 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 changed | ExtendedSparkDataGrid | |||
| Fired when the checkbox selection changes | ExtendedSparkDataGrid | |||
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 | ||
| _columnWidthsDirty | property | 
public var _columnWidthsDirty:Boolean = false| _iPager | property | 
protected var _iPager:IPager| autoLoadPreferences | property | 
public var autoLoadPreferences:Boolean = true| clickBehavior | property | 
clickBehavior:StringGrid 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.
    public function get clickBehavior():String    public function set clickBehavior(value:String):void| clickParentDisplayObject | property | 
clickParentDisplayObject:DisplayObjectThe parent object to use while calling PopupManager.addPopUp. Defaults to the grid, but you can use any other DisplayObject.
    public function get clickParentDisplayObject():DisplayObject    public function set clickParentDisplayObject(value:DisplayObject):void| clickPopupClass | property | 
clickPopupClass:IFactoryThe 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.
    public function get clickPopupClass():IFactory    public function set clickPopupClass(value:IFactory):void| clickPopupHeight | property | 
clickPopupHeight:NumberThe height of the popup to launch when the clickBehavior is set.
    public function get clickPopupHeight():Number    public function set clickPopupHeight(value:Number):void| clickPopupTitle | property | 
clickPopupTitle:StringThe title of the popup to launch when the clickBehavior is set.
    public function get clickPopupTitle():String    public function set clickPopupTitle(value:String):void| clickPopupWidth | property | 
clickPopupWidth:NumberThe width of the popup to launch when the clickBehavior is set.
    public function get clickPopupWidth():Number    public function set clickPopupWidth(value:Number):void| collectionManipulatorFactory | property | 
public var collectionManipulatorFactory:IFactoryThe class that manages the collection filtering, paging and sorting. Needs to inherit from CollectionManipulator.
| columns | property | 
columns:IList  [write-only] [override]     public function set columns(value:IList):void| copyAllRowsMenuText | property | 
public var copyAllRowsMenuText:String = Copy All RowsText for the Copy All Rows
| copyCellMenuText | property | 
public var copyCellMenuText:String = Copy CellText for the Copy Cell Menu
| copySelectedRowMenuText | property | 
public var copySelectedRowMenuText:String = Copy Selected RowText for the Copy Selected Row
| currentItemUnderMouse | property | 
currentItemUnderMouse:Object  [read-only] This property can be used as the source for data binding.
    public function get currentItemUnderMouse():Object| dataProviderNoPaging | property | 
dataProviderNoPaging:Object  [read-only] Gets a copy of the dataprovider with filter and sort applied, but no paging. Used by the footer calculations.
    public function get dataProviderNoPaging():Object| enableColumnWidthMode | property | 
public var enableColumnWidthMode:Boolean = trueFlag 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.
| enableMultiplePreferences | property | 
enableMultiplePreferences:BooleanA 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.
    public function get enableMultiplePreferences():Boolean    public function set enableMultiplePreferences(value:Boolean):void| enablePaging | property | 
enablePaging:BooleanA flag to indicate whether or not to enable paging functionality
This property can be used as the source for data binding.
    public function get enablePaging():Boolean    public function set enablePaging(value:Boolean):void| enablePreferencePersistence | property | 
enablePreferencePersistence:BooleanWhen 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.
    public function get enablePreferencePersistence():Boolean    public function set enablePreferencePersistence(value:Boolean):void| excelOptions | property | 
public var excelOptions:ExportOptionsThe Export options object that is used to configure the excel export behavior - currently only supported in Ultimate
| exportableColumns | property | 
exportableColumns:Array  [read-only] Returns a list of columns that have excludeFromExport=false (default)
    public function get exportableColumns():Array| filterRowHeight | property | 
filterRowHeight:NumberThe height of the filter row. If not set, defaults to the value of the rowHeight property
    public function get filterRowHeight():Number    public function set filterRowHeight(value:Number):void| filterVisible | property | 
filterVisible:BooleanIf you have enableFilters set to true but want the filter row to not appear, you can set this value.
    public function get filterVisible():Boolean    public function set filterVisible(value:Boolean):void| footerRowHeight | property | 
footerRowHeight:NumberThe height of the footer row. If not set, defaults to the value of the rowHeight property
    public function get footerRowHeight():Number    public function set footerRowHeight(value:Number):void| footerVisible | property | 
footerVisible:BooleanIf you have enableFooters set to true but want the footer row to not appear, you can set this value.
    public function get footerVisible():Boolean    public function set footerVisible(value:Boolean):void| forcePagerRow | property | 
forcePagerRow:BooleanUse 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.
    public function get forcePagerRow():Boolean    public function set forcePagerRow(value:Boolean):void| groupedColumns | property | 
groupedColumns:ArrayUnused/Not Applicable. For legacy purposes only
    public function get groupedColumns():Array    public function set groupedColumns(value:Array):void| horizontalScrollPolicy | property | 
horizontalScrollPolicy:StringReturns scroller.getStyle("horizontalScrollPolicy");
    public function get horizontalScrollPolicy():String    public function set horizontalScrollPolicy(value:String):void| horizontalScrollPosition | property | 
horizontalScrollPosition:NumberReturns scroller.getStyle("horizontalScrollPolicy");
    public function get horizontalScrollPosition():Number    public function set horizontalScrollPosition(value:Number):void| listContent | property | 
listContent:Object  [read-only] returns scroller
    public function get listContent():Object| lockedColumnCount | property | 
lockedColumnCount:int  [read-only] Unused/Not Applicable. For legacy purposes only
    public function get lockedColumnCount():int| nativeExcelExporter | property | 
nativeExcelExporter:ExporterThe 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
    public function get nativeExcelExporter():Exporter    public function set nativeExcelExporter(value:Exporter):void| pageIndex | property | 
pageIndex:intThe current page index
    public function get pageIndex():int    public function set pageIndex(value:int):void| pager | property | 
pager:IPager  [read-only] Handle to the current IPager control.
    public function get pager():IPager| pagerRenderer | property | 
pagerRenderer:IFactoryA Class that implements com.flexicious.controls.interfaces.IPager. Defaults to a built in implementation
    public function get pagerRenderer():IFactory    public function set pagerRenderer(value:IFactory):voidSee also
| pagerRowHeight | property | 
pagerRowHeight:NumberThe height of the pager row. If not set, defaults to the value of the rowHeight property
    public function get pagerRowHeight():Number    public function set pagerRowHeight(value:Number):void| pagerVisible | property | 
pagerVisible:BooleanIf you have enablePaging set to true but want the pager row to not appear, you can set this value.
    public function get pagerVisible():Boolean    public function set pagerVisible(value:Boolean):void| pageSize | property | 
pageSize:intThe number of records to display per page
This property can be used as the source for data binding.
    public function get pageSize():int    public function set pageSize(value:int):void| pdfOptions | property | 
public var pdfOptions:PrintOptionsThe Print options object that is used to configure the pdf behavior - currently only supported in Ultimate
| pdfPrinter | property | 
pdfPrinter:IPDFPrinterA 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.
    public function get pdfPrinter():IPDFPrinter    public function set pdfPrinter(value:IPDFPrinter):void| popupFactoryExportOptions | property | 
popupFactoryExportOptions:IFactoryThe renderer that shows up when the user clicks on the Word or Excel button - currently only supported in Ultimate
    public function get popupFactoryExportOptions():IFactory    public function set popupFactoryExportOptions(value:IFactory):void| popupFactoryOpenSettingsPopup | property | 
popupFactoryOpenSettingsPopup:IFactoryThe renderer that shows up when the user clicks on the Open Settings button - currently only supported in Ultimate
    public function get popupFactoryOpenSettingsPopup():IFactory    public function set popupFactoryOpenSettingsPopup(value:IFactory):void| popupFactoryPrintOptions | property | 
popupFactoryPrintOptions:IFactoryThe renderer that shows up when the user clicks on the Print or PDF button - currently only supported in Ultimate
    public function get popupFactoryPrintOptions():IFactory    public function set popupFactoryPrintOptions(value:IFactory):void| popupFactorySaveSettingsPopup | property | 
popupFactorySaveSettingsPopup:IFactoryThe renderer that shows up when the user clicks on the Save Settings button - currently only supported in Ultimate
    public function get popupFactorySaveSettingsPopup():IFactory    public function set popupFactorySaveSettingsPopup(value:IFactory):void| popupFactorySettingsPopup | property | 
popupFactorySettingsPopup:IFactoryThe renderer that shows up when the user clicks on the Settings button - currently only supported in Ultimate
    public function get popupFactorySettingsPopup():IFactory    public function set popupFactorySettingsPopup(value:IFactory):void| preferencePersistenceKey | property | 
preferencePersistenceKey:StringString 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.
    public function get preferencePersistenceKey():String    public function set preferencePersistenceKey(value:String):void| preferencePersistenceMode | property | 
preferencePersistenceMode:StringString 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.
    public function get preferencePersistenceMode():String    public function set preferencePersistenceMode(value:String):void| preferences | property | 
preferences:StringReturns an XML representation of the preferences specified in the preferencesToPersist property and values being the actual values. When
    public function get preferences():String    public function set preferences(value:String):void| preferencesLoaded | property | 
preferencesLoaded:Boolean  [read-only] Returns true if the load preferences has been called.
    public function get preferencesLoaded():Boolean| preferencesSet | property | 
preferencesSet:BooleanA flag to indicate that the preferences for this grid has been set. Used by the clear preferences button to enable or disable itself.
    public function get preferencesSet():Boolean    public function set preferencesSet(value:Boolean):void| preferencesToPersist | property | 
preferencesToPersist:StringA comma delimited string of the following values: columnOrder,columnVisiblity,columnWidth,filter,sort,verticalScroll,horizontalScroll Each represents a setting that can potentially be persisted.
    public function get preferencesToPersist():String    public function set preferencesToPersist(value:String):void| printableColumns | property | 
printableColumns:Array  [read-only] Returns a list of columns that have excludeFromPrint=false (default)
    public function get printableColumns():Array| printOptions | property | 
public var printOptions:PrintOptionsThe Print options object that is used to configure the print behavior - currently only supported in Ultimate
| rowCount | property | 
rowCount:int  [read-only] Unused/Not Applicable. For legacy purposes only
    public function get rowCount():int| selectAllState | property | 
selectAllState:StringThe state of the select all header checkbox.
    public function get selectAllState():String    public function set selectAllState(value:String):void| selectedKeyField | property | 
selectedKeyField:StringThe 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.
    public function get selectedKeyField():String    public function set selectedKeyField(value:String):void| selectedKeys | property | 
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.
    public function get selectedKeys():ArrayCollection| selectedObjects | property | 
selectedObjects:ArrayCollection  [read-only] Gets the objects selected by the user when used in conjunction with the selectedKeyField object
    public function get selectedObjects():ArrayCollection| settingsColumns | property | 
settingsColumns:Array  [read-only] Returns a list of columns that have excludeFromPrint=false (default)
    public function get settingsColumns():Array| showSpinnerOnCreationComplete | property | 
showSpinnerOnCreationComplete:Boolean    public function get showSpinnerOnCreationComplete():Boolean    public function set showSpinnerOnCreationComplete(value:Boolean):void| spinner | property | 
spinner:ISpinner    public function get spinner():ISpinner    public function set spinner(value:ISpinner):void| spinnerFactory | property | 
spinnerFactory:IFactoryFactory responsible for instantiating a new spinner. Defaults to com.flexicious.Spinner. Needs to implement com.flexicious.interfaces.ISpinner, and extend UIComponent
    public function get spinnerFactory():IFactory    public function set spinnerFactory(value:IFactory):void| spinnerLabel | property | 
spinnerLabel:StringThe label of the spinner control, you can use styles to control the appearance.
    public function get spinnerLabel():String    public function set spinnerLabel(value:String):void| totalRecords | property | 
totalRecords:intThe 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.
    public function get totalRecords():int    public function set totalRecords(value:int):void| unLockedColumns | property | 
unLockedColumns:Array  [read-only] Returns columns x through columns.count, where x=lockedColumnCount
    public function get unLockedColumns():Array| useCompactPreferences | property | 
useCompactPreferences:BooleanIf 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.
    public function get useCompactPreferences():Boolean    public function set useCompactPreferences(value:Boolean):void| useModuleFactory | property | 
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
    public function get useModuleFactory():Boolean| userSettingsOptionsFunction | property | 
userSettingsOptionsFunction:FunctionHook for the client to plug in their own UserSettings. See the UserSettingsOptions class for details.
    public function get userSettingsOptionsFunction():Function    public function set userSettingsOptionsFunction(value:Function):void| verticalScrollPosition | property | 
verticalScrollPosition:NumberReturns scroller.getStyle("horizontalScrollPolicy");
    public function get verticalScrollPosition():Number    public function set verticalScrollPosition(value:Number):void| viewMetrics | property | 
viewMetrics:EdgeMetrics  [read-only] Unused/Not applicable to the Nested DataGrid.
    public function get viewMetrics():EdgeMetrics| wordOptions | property | 
public var wordOptions:ExportOptionsThe Export options object that is used to configure the word export behavior - currently only supported in Ultimate
| ExtendedSparkDataGrid | () | Constructor | 
public function ExtendedSparkDataGrid()Constructor
| addContextMenuItem | () | method | 
 public function addContextMenuItem(lbl:String, clickHandler:Function, separatorBefore:Boolean = false):voidAdds 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):BooleanParameters
| event:KeyboardEvent | 
| Boolean | 
| clearFilter | () | method | 
 public function clearFilter():voidCalls clear on all internal filter controls, resetting the state
| clearPreferences | () | method | 
 public function clearPreferences():void| clearSelectedCheckBoxes | () | method | 
 public function clearSelectedCheckBoxes():voidClears the checkbox selections when used in conjunction with SelectAllCheckBoxHeaderColumn see com.flexicious.grids.columns.SelectAllCheckBoxHeaderColumn
| commitProperties | () | method | 
override protected function commitProperties():void| createCollectionManipulator | () | method | 
| createFilter | () | method | 
 public function createFilter():FilterConsolidates 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):ObjectCreates the popup.
Parameters
| popupData:Object | 
| Object— | 
| createPrintComponentFactory | () | method | 
 public function createPrintComponentFactory():IFactoryGets the class responsible for handling the PrintUI should be a IPrintDataGrid
Returns| IFactory— | 
| defaultUseSettingsOptionsFunction | () | method | 
 protected function defaultUseSettingsOptionsFunction():UserSettingsOptionsreturns UserSettingsOptions.create(this);
Returns| UserSettingsOptions | 
| filterPageSort | () | method | 
 protected function filterPageSort(rebuildPageIndex:Boolean, recalculateTotal:Boolean):voidIn 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():BooleanBy 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():PreferenceInfoWhen enableMultiplePreferences = true, this represents the currently applied preference
Returns| PreferenceInfo | 
| getDistinctValuesForColumn | () | method | 
 public function getDistinctValuesForColumn(dataField:String):ArrayCollectionParameters
| dataField:String | 
| ArrayCollection | 
| getExportableColumns | () | method | 
 public function getExportableColumns(options:ExportOptions):ArrayParameters
| options:ExportOptions | 
| Array | 
| getFilterArguments | () | method | 
 public function getFilterArguments():ArrayCollectionReturns| ArrayCollection | 
| getFilterColumn | () | method | 
 public function getFilterColumn(searchField:String):ObjectGiven 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 | 
| 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 | 
| * | 
| getFilterX | () | method | 
 public function getFilterX(renderer:IFilterControl):NumberUsed by filter to identify where relative position for each control for tabbing
Parameters
| renderer:IFilterControl | 
| Number | 
| getGridPreferencesInfo | () | method | 
 public function getGridPreferencesInfo():GridPreferencesInfoWhen enableMultiplePreferences = true, this represents a list of all preferences saved for this grid.
Returns| GridPreferencesInfo | 
| getLastItemUnderMouse | () | method | 
 public function getLastItemUnderMouse():ObjectGets the item that was under the mouse last
Returns| Object | 
| getPeristenceKey | () | method | 
 protected function getPeristenceKey():StringReturns| String | 
| getPrintableColumns | () | method | 
 public function getPrintableColumns(options:PrintOptions):ArrayParameters
| options:PrintOptions | 
| Array | 
| getUserSettingsController | () | method | 
| hideSpinner | () | method | 
 public function hideSpinner():voidRemoves the spinner and sets the listContent.alpha back to 1
| initializeGrid | () | method | 
 protected function initializeGrid():void| invalidateDisplayList | () | method | 
override public function invalidateDisplayList():voidNeed to invalidte our children when we invalidate.
| invalidateList | () | method | 
 public function invalidateList():voidInterface 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):voidParameters
| event:KeyboardEvent | 
| loadPreferences | () | method | 
 public function loadPreferences():voidLoads 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):voidMethod 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):voidParameters
| event:Event | 
| onContextMenuShown | () | method | 
 protected function onContextMenuShown(event:ContextMenuEvent):voidParameters
| event:ContextMenuEvent | 
| onHeaderRelease | () | method | 
 protected function onHeaderRelease(evt:GridEvent):voidNeed 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):voidFor popup support, we keep track of what the user is hovering over.
Parameters
| event:ListEvent | 
| onRowContextMenuItemClick | () | method | 
 protected function onRowContextMenuItemClick(event:ContextMenuEvent):voidAdds the copy menu
Parameters
| event:ContextMenuEvent | 
| onTableContextMenuItemClick | () | method | 
 protected function onTableContextMenuItemClick(event:ContextMenuEvent):voidMethod 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):voidFor 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):voidPersists 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():voidIf 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):voidParameters
| event:Event | 
| refreshLayout | () | method | 
 public function refreshLayout():voidResets 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):voidRemoves the specified context menu item
Parameters
| lbl:String | 
| selectAllCheckBoxes | () | method | 
 protected function selectAllCheckBoxes():void| setColumnWidthsUsingWidthMode | () | method | 
 public function setColumnWidthsUsingWidthMode(force:Boolean = false):voidRecalculates 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):BooleanSets the enabled/disabled flag on the specified context menu item.
Parameters
| lbl:String | |
| enabled:Boolean | 
| Boolean | 
| setContextMenuEnableVisible | () | method | 
 public function setContextMenuEnableVisible(lbl:String, visible:Boolean):BooleanSets the visible flag on the specified context menu item.
Parameters
| lbl:String | |
| visible:Boolean | 
| Boolean | 
| setCurrentPreferenceInfo | () | method | 
 public function setCurrentPreferenceInfo(val:PreferenceInfo, applyPreferences:Boolean = true):voidWhen 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. | 
| 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):voidUsed 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():BooleanSets 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):voidSets 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):voidTakes an array collection of preferences and applies them to the grid.
Parameters
| arrayCollection:ArrayCollection | 
| showPopup | () | method | 
 public function showPopup(popupData:Object):ObjectLaunches the actual popup.
Parameters
| popupData:Object | 
| Object— | 
| showSpinner | () | method | 
 public function showSpinner():voidShows 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):voidParameters
| 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) | 
| afterExport | Event | 
com.flexicious.export.ExportEventDispatched 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 | 
com.flexicious.print.PrintPreviewEventDispatched 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 | 
com.flexicious.export.ExportEventDispatched when the grid is about to be exported
| beforePrint | Event | 
com.flexicious.print.PrintPreviewEventDispatched 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 | 
com.flexicious.grids.events.PreferencePersistenceEventFired 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 | 
com.flexicious.grids.events.FilterPageSortChangeEventFired when the grid's page, sort or filter state changes.
| loadPreferences | Event | 
com.flexicious.grids.events.PreferencePersistenceEventFired 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 | 
com.flexicious.grids.events.PreferencePersistenceEventFired when the grid needs to persist its preferences.
| preferencesLoading | Event | 
com.flexicious.grids.events.PreferencePersistenceEventFired right before preferences are being loaded and applied.
| printExportDataRequest | Event | 
com.flexicious.grids.events.PrintExportDataRequestEventFired 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