Package | com.flexicious.components.dashboard |
Class | public class DashboardContainer |
Inheritance | DashboardContainer ![]() ![]() |
Implements | IPersistable, IPrintable, ISpinnerOwner |
Subclasses | PrintDashboardContainer |
Language Version : | ActionScript 3.0 |
Default MXML PropertymxmlContentFactory
Property | Defined By | ||
---|---|---|---|
![]() | allowInteractivity : Boolean [read-only]
A flat that controls appearance of the buttons. | DashboardBase | |
autoLoadPreferences : Boolean = true | DashboardContainer | ||
autoRefreshInterval : Number
The number of milliseconds to wait before issuing an autorefresh call. | DashboardContainer | ||
contentLayoutFunction : Function
Layout of the content group. | DashboardContainer | ||
currentMaximizedDashlet : Dashlet [read-only]
The Dashlet that is currently maximized. | DashboardContainer | ||
dashletBeingDragged : Dashlet
The dashlet that initiated the drag operation
| DashboardContainer | ||
dashletBeingMoved : Dashlet
The dashlet that initiated the move operation
| DashboardContainer | ||
![]() | dashlets : Array
A list of all available dashlets
| DashboardBase | |
dragDropCompleteFunction : Function
A function that gets executed when the drag drop operation is complete. | DashboardContainer | ||
dragDropZones : Array
An array of drag drop zones. | DashboardContainer | ||
dropAcceptRejectFunction : Function
A function that determines whether drop should be shown. | DashboardContainer | ||
dropDashletOrDropZone : IUIComponent
The dashlet or dropzone that the drag operation ended on. | DashboardContainer | ||
elementsToBlur : Array [read-only] | DashboardContainer | ||
elementToCenter : IUIComponent [read-only] | DashboardContainer | ||
enableAutoRefresh : Boolean
If flag is set to true, grid will dispatch an AUTO_REFRESH event every autoRefreshInterval milliseconds. | DashboardContainer | ||
enableMultiplePreferences : Boolean
A Flag that will enable multiple named versions of preferences to be persisted. | DashboardContainer | ||
enablePdf : Boolean
Enables the print operation. | DashboardContainer | ||
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'
| DashboardContainer | ||
enablePrint : Boolean
Enables the print operation. | DashboardContainer | ||
enableRefresh : Boolean
Flag to show the refresh icon. | DashboardContainer | ||
enableSettings : Boolean
Boolean flag to control whether the settings icon is visible. | DashboardContainer | ||
enableTaskBar : Boolean [read-only]
Flag to draw a task bar UI at the bottom. | DashboardContainer | ||
enableTileLayoutRowColumns : Boolean
In cases where you have a dashboard with tile layout, the user can control the number
of rows and columns that the dashboard should show. | DashboardContainer | ||
enableTitleToggle : Boolean
Boolean flag to control whether user is allowed to toggle the title bars
of all the dashlets. | DashboardContainer | ||
excelOptions : ExportOptions
The Export options object that is used to configure the excel export behavior - currently only supported in Ultimate
| DashboardContainer | ||
lastAutoRefresh : Date
Last time the auto refresh timer was triggered
| DashboardContainer | ||
maximizedContentLayoutFunction : Function
Layout of the maximized Content Group. | DashboardContainer | ||
mimimizedDashlets : Array [read-only]
A list of all dashlets taht are currently closed (or minimized) by the user. | DashboardContainer | ||
minDashletHeight : Number = 190
During a resize operation we do not allow the user to resize the dashllet
less then this number
| DashboardContainer | ||
minDashletWidth : Number = 190
During a resize operation we do not allow the user to resize the dashllet
less then this number
| DashboardContainer | ||
openDashlets : Array [read-only]
Returns a list of open dashlets
| DashboardContainer | ||
pdfOptions : PrintOptions
The Print options object that is used to configure the pdf behavior - currently only supported in Ultimate
| DashboardContainer | ||
pdfPrinter : IPDFPrinter
A class that takes the PDF Pages as they are generated. | DashboardContainer | ||
popupFactoryExportOptions : IFactory
The renderer that shows up when the user clicks on the Word or Excel button - currently only supported in Ultimate
| DashboardContainer | ||
popupFactoryOpenSettingsPopup : IFactory
The renderer that shows up when the user clicks on the Open Settings button - currently only supported in Ultimate
| DashboardContainer | ||
popupFactoryPrintOptions : IFactory
The renderer that shows up when the user clicks on the Print or PDF button - currently only supported in Ultimate
| DashboardContainer | ||
popupFactorySaveSettingsPopup : IFactory
The renderer that shows up when the user clicks on the Save Settings button - currently only supported in Ultimate
| DashboardContainer | ||
popupFactorySettingsPopup : IFactory
The renderer that shows up when the user clicks on the Settings button - currently only supported in Ultimate
| DashboardContainer | ||
preferencePersistenceKey : String
String value that uniquely identifies this grid across the application. | DashboardContainer | ||
preferencePersistenceMode : String
String value "server" or "client". | DashboardContainer | ||
preferences : String
Returns an XML representation of the preferences specified in
the preferencesToPersist property and values being the actual
values. | DashboardContainer | ||
preferencesLoaded : Boolean [read-only]
Returns true if the load preferences has been called. | DashboardContainer | ||
preferencesSet : Boolean
A flag to indicate that the preferences for this grid
has been set. | DashboardContainer | ||
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. | DashboardContainer | ||
printComponentFactory : IFactory | DashboardContainer | ||
printOptions : PrintOptions
The Print options object that is used to configure the print behavior - currently only supported in Ultimate
| DashboardContainer | ||
showSpinnerOnCreationComplete : Boolean | DashboardContainer | ||
spinner : ISpinner | DashboardContainer | ||
spinnerBehavior : SpinnerBehavior | DashboardContainer | ||
spinnerFactory : IFactory
Factory responsible for instantiating a new spinner. | DashboardContainer | ||
spinnerLabel : String
The label of the spinner control, you can use styles
to control the appearance. | DashboardContainer | ||
spinnerParent : Object [read-only] | DashboardContainer | ||
title : String
Title or caption displayed in the title bar. | DashboardContainer | ||
titleBarHeight : Number
Height of the title bar
| DashboardContainer | ||
toolbarPdfHandlerFunction : Function
Function that actually runs the pdf. | DashboardContainer | ||
toolbarPrintHandlerFunction : Function
Function that actually runs the print. | DashboardContainer | ||
tooltipBehavior : TooltipBehavior | DashboardContainer | ||
topGroup : IUIComponent
The skin part that defines the appearance of the titlebar
| DashboardContainer | ||
uniqueIdentifier : String
A key used to uniquely identify a zone. | DashboardContainer | ||
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. | DashboardContainer | ||
useElements : Boolean [read-only]
Whether to use addElement or addChild;
| DashboardContainer | ||
useModuleFactory : Boolean [read-only]
Flag that indicates to use the module factory of the grid to show popups. | DashboardContainer | ||
userSettingsOptionsFunction : Function
Hook for the client to plug in their own UserSettings. | DashboardContainer | ||
wordOptions : ExportOptions
The Export options object that is used to configure the word export behavior - currently only supported in Ultimate
| DashboardContainer |
Property | Defined By | ||
---|---|---|---|
autoRefreshTimer : Timer
Timer instance to work with the auto refresh mechanism
| DashboardContainer | ||
dashletBeingResized : Dashlet
The dashlet that initiated the drag operation
| DashboardContainer | ||
originalPoint : Point
During the move operation, the original left and top co-ordinates of this dashlet
| DashboardContainer | ||
referencePoint : Point
During the move operation, the reference point where move started
| DashboardContainer |
Method | Defined By | ||
---|---|---|---|
The constructor
| DashboardContainer | ||
clearPreferences():void | DashboardContainer | ||
clone(to:DashboardContainer = null, dbFactory:IFactory = null, dzFactory:IFactory = null, dlFactory:IFactory = null, propertiesToTransfer:Array = null, stylesToTransfer:Array = null):DashboardContainer
Clones the current dashboard. | DashboardContainer | ||
createPrintComponentFactory():IFactory
Gets the class responsible for handling the PrintUI for the Dashboard. | DashboardContainer | ||
createPrintDashletFactory():IFactory
Gets the class responsible for handling the PrintUI for the Dashlet. | DashboardContainer | ||
defaultPdfHandlerFunction():void
Default handler for the Print Button. | DashboardContainer | ||
defaultPrintHandlerFunction():void
Default handler for the Print Button. | DashboardContainer | ||
dispatchAutoRefreshEvent(event:Event):void
Handle for the auto refresh. | DashboardContainer | ||
Triggered when drag is starting. | DashboardContainer | ||
getAutoLoadPreferences():Boolean
By default, when the grid's creation complete event is dispatched, the grid will go
in and load the saved preference. | DashboardContainer | ||
When enableMultiplePreferences = true, this represents the currently applied preference
| DashboardContainer | ||
getDashletByUniqueIdentifier(id:String):Dashlet
Returns the dashlet by unique identifier
| DashboardContainer | ||
getDragDropZoneByUniqueIdentifier(id:String):DragDropZone
Returns the zone by unique identifier
| DashboardContainer | ||
When enableMultiplePreferences = true, this represents a list of all preferences saved for this
grid. | DashboardContainer | ||
getTileLayout():TileLayout | DashboardContainer | ||
![]() | getUIComponentBitmapData(target:IUIComponent):Image
Drag and Drop support, create a image representation of the dashlet being dragged. | DashboardBase | |
DashboardContainer | |||
hideSpinner():void
Removes the spinner and sets the bodyContainer.alpha back to 1
| DashboardContainer | ||
loadPreferences():void
Loads preference values from the Shared object, called automatically in
preferencePersistenceMode=client. | DashboardContainer | ||
loadTileLayout(arr:Array):void
Given an array of row and column count, initializes the getTileLayout() layout
to the requestedRowCount as the first item in the array, and requestedColumnCount
as the second item in the array
| DashboardContainer | ||
Maximizes the provided dashlet. | DashboardContainer | ||
onSaveSettingsPopup():void
Default handler for the Save Settings Popup
Calls var popup:DashboardSaveSettingsPopup=new DashboardSaveSettingsPopup();
UIUtils.addPopUp(popup,this as DisplayObject);
popup.dashboard=this;
| DashboardContainer | ||
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
| DashboardContainer | ||
resizeBegin(event:MouseEvent, dashlet:Dashlet):void
Start the resize
| DashboardContainer | ||
restore():void
Restores the provided dashlet. | DashboardContainer | ||
setCurrentPreferenceInfo(val:PreferenceInfo, applyPreferences:Boolean = true):void
When enableMultiplePreferences = true, applies the given preference as the current
preference. | DashboardContainer | ||
setGridPreferencesInfo(val:GridPreferencesInfo, applyPreferences:Boolean = true):void
Sets the multiple preferences array. | DashboardContainer | ||
showSpinner(msg:String):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 . | DashboardContainer | ||
showToaster(message:String, toasterPosition:String, toasterRenderer:IFactory = null, animationDuration:Number = 1000, visibleDuration:Number = 5000, moveAnimate:Boolean = true, fadeAnimate:Boolean = true):void [override]
Shows the given toaster message
| DashboardContainer | ||
toggleTitleBars():void
Toggles the visibility of the titlebars of the dashlets. | DashboardContainer |
Method | Defined By | ||
---|---|---|---|
addDragDropZones(dragDropZones:Array):void
Adds the specified drag drop zones to the content group
| DashboardContainer | ||
returns UserSettingsOptions.create(this);
| DashboardContainer | ||
dragAcceptReject(cell:IUIComponent, event:MouseEvent = null):void
Called when the drag enters over a cell. | DashboardContainer | ||
getPeristenceKey():String | DashboardContainer | ||
onCreationComplete(event:FlexEvent):void [override] | DashboardContainer | ||
onDashletDraggingMouseMove(event:MouseEvent):void
Called when the DragEnter event is dispatched over any of the cells. | DashboardContainer | ||
onDragDrop(event:DragEvent):void [override]
Called when the DragDrop event is dispatched over any of the cells. | DashboardContainer | ||
onDragDropStageMouseUpHandler(event:MouseEvent):void | DashboardContainer | ||
setPreferences(arrayCollection:ArrayCollection):void
Takes an array collection of preferences and applies them to the grid. | DashboardContainer | ||
showDropIndicator(dashletOrDragDropZone:IUIComponent, event:MouseEvent = null):void
Called to show the drop indicator below the passed in cells row. | DashboardContainer |
Event | Summary | Defined By | ||
---|---|---|---|---|
Dispatched when the auto refresh interval elapses with enableAutoRefresh=true or when the user clicks the refresh button | DashboardContainer | |||
Dispatched when the grid is about to be generated for the print, or the preview. | DashboardContainer | |||
Fired when the grid needs to clear its preferences. | DashboardContainer | |||
Dispatched when the dashlet is closed | DashboardContainer | |||
Dispatched when the dashlet is is about to be closed. | DashboardContainer | |||
Dispatched when the dashlet is is about to be collapsed. | DashboardContainer | |||
Dispatched when the dashlet is collapsed | DashboardContainer | |||
Dispatched when the dashlet is is about to start drag and drop. | DashboardContainer | |||
Dispatched when the dashlets resize has been dropped over a zone or another dashlet | DashboardContainer | |||
Dispatched when the dashlet is expanded | DashboardContainer | |||
Dispatched when the dashlet is is about to be expanded. | DashboardContainer | |||
Dispatched when the dashlet is is about to be start moving. | DashboardContainer | |||
Dispatched when the dashlets move has completed | DashboardContainer | |||
Dispatched when the dashlet is opened | DashboardContainer | |||
Dispatched when the dashlet is is about to be opened. | DashboardContainer | |||
Dispatched when the dashlet is is about to start resizing. | DashboardContainer | |||
Dispatched when the dashlets resize has completed | DashboardContainer | |||
Fired In preferencePersistenceMode=server , when the dashboard needs to load its preferences. | DashboardContainer | |||
Dispatched when the dashlet is maximized or restored | DashboardContainer | |||
Dispatched when the dashlet is maximized | DashboardContainer | |||
Dispatched when the user clicks the 'Generate PDF' button on the Print Preview. | DashboardContainer | |||
Fired when the grid needs to persist its preferences. | DashboardContainer | |||
Fired right before preferences are being loaded and applied. | DashboardContainer | |||
Dispatched when the grid is sent to the printer. | DashboardContainer | |||
Dispatched when the dashlet is maximized | DashboardContainer |
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 | ||
---|---|---|---|---|
btnSettings:mx.core.IUIComponent | Required: false Part Type: Static The skin part that defines the appearance of the settings button. See also spark.skins.spark.PanelSkin | DashboardContainer | ||
btnTileLayout:mx.core.IUIComponent | Required: false Part Type: Static The skin part that defines the appearance of the tile layout button. Required only if you set enableTileLayoutRowColumns to true. See also spark.skins.spark.PanelSkin | DashboardContainer | ||
contentGroupScroller:spark.components.Scroller | Required: false Part Type: Static The skin part that holds the scrollable content group in basic layout scenarios. | DashboardContainer | ||
dropIndicator:mx.core.UIComponent | Required: false Part Type: Static The skin part that defines the appearance of the drop indicator line. | DashboardContainer | ||
maximizedContentGroup:spark.components.Group | Required: false Part Type: Static An optional skin part that defines the Group where the maximized dashlet gets pushed into and laid out. | DashboardContainer | ||
resizeIndicator:mx.core.IVisualElement | Required: false Part Type: Static The skin part that defines the appearance of the resize indicator line. | DashboardContainer | ||
taskbar:DashboardTaskbar | Required: false Part Type: Static The skin part that holds the taskbar if enableTaskBar=true. | DashboardContainer | ||
titleDisplay:Object | Required: false Part Type: Static The skin part that defines the appearance of the title text in the container. See also spark.skins.spark.PanelSkin | DashboardContainer |
autoLoadPreferences | property |
public var autoLoadPreferences:Boolean = true
autoRefreshInterval | property |
autoRefreshInterval:Number
The number of milliseconds to wait before issuing an autorefresh call. Defaults to 30000 (30 seconds)
public function get autoRefreshInterval():Number
public function set autoRefreshInterval(value:Number):void
autoRefreshTimer | property |
protected var autoRefreshTimer:Timer
Timer instance to work with the auto refresh mechanism
contentLayoutFunction | property |
contentLayoutFunction:Function
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.5 |
Layout of the content group.
The default value is VerticalLayout
.
This property can be used as the source for data binding.
public function get contentLayoutFunction():Function
public function set contentLayoutFunction(value:Function):void
currentMaximizedDashlet | property |
currentMaximizedDashlet:Dashlet
[read-only] The Dashlet that is currently maximized. Null if none.
This property can be used as the source for data binding.
public function get currentMaximizedDashlet():Dashlet
dashletBeingDragged | property |
public var dashletBeingDragged:Dashlet
The dashlet that initiated the drag operation
dashletBeingMoved | property |
public var dashletBeingMoved:Dashlet
The dashlet that initiated the move operation
dashletBeingResized | property |
protected var dashletBeingResized:Dashlet
The dashlet that initiated the drag operation
dragDropCompleteFunction | property |
dragDropCompleteFunction:Function
A function that gets executed when the drag drop operation is complete. Takes 2 Dashlet objects, the initiator, and the target.
public function get dragDropCompleteFunction():Function
public function set dragDropCompleteFunction(value:Function):void
dragDropZones | property |
dragDropZones:Array
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.5 |
An array of drag drop zones. User can drag and drop widgets in the zones defined.
public function get dragDropZones():Array
public function set dragDropZones(value:Array):void
dropAcceptRejectFunction | property |
dropAcceptRejectFunction:Function
A function that determines whether drop should be shown. When a dashlet is dragged, it can be dropped on another dashlet or a drag drop zone. This function should take a IUIComponent, which could be either a drag drop zone or a dashlet, and return true or false on basis of whether the target dashlet or drag drop zone is capable of accepting drag drop from the dashlet that is currently being dragged. You can access this via dashboardContinaer.dashletBeingDragged
public function get dropAcceptRejectFunction():Function
public function set dropAcceptRejectFunction(value:Function):void
dropDashletOrDropZone | property |
public var dropDashletOrDropZone:IUIComponent
The dashlet or dropzone that the drag operation ended on. Can be either a Dashlet or a DragDropZone
elementsToBlur | property |
elementsToBlur:Array
[read-only] public function get elementsToBlur():Array
elementToCenter | property |
elementToCenter:IUIComponent
[read-only] public function get elementToCenter():IUIComponent
enableAutoRefresh | property |
enableAutoRefresh:Boolean
If flag is set to true, grid will dispatch an AUTO_REFRESH event every autoRefreshInterval milliseconds. Setting this to true automatically sets teh enableRefresh flag
This property can be used as the source for data binding.
public function get enableAutoRefresh():Boolean
public function set enableAutoRefresh(value:Boolean):void
enableMultiplePreferences | property |
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.
public function get enableMultiplePreferences():Boolean
public function set enableMultiplePreferences(value:Boolean):void
enablePdf | property |
enablePdf:Boolean
Enables the print operation. This is simply a flag that the pager control looks for to show or hide the pdf button.
This property can be used as the source for data binding.
public function get enablePdf():Boolean
public function set enablePdf(value:Boolean):void
enablePreferencePersistence | property |
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.
public function get enablePreferencePersistence():Boolean
public function set enablePreferencePersistence(value:Boolean):void
enablePrint | property |
enablePrint:Boolean
Enables the print operation. This is simply a flag that the pager control looks for to show or hide the print button.
This property can be used as the source for data binding.
public function get enablePrint():Boolean
public function set enablePrint(value:Boolean):void
enableRefresh | property |
enableRefresh:Boolean
Flag to show the refresh icon. Setting this to true does not automatically set enableAutoRefresh.
This property can be used as the source for data binding.
public function get enableRefresh():Boolean
public function set enableRefresh(value:Boolean):void
enableSettings | property |
enableSettings:Boolean
Boolean flag to control whether the settings icon is visible.
This property can be used as the source for data binding.
public function get enableSettings():Boolean
public function set enableSettings(value:Boolean):void
enableTaskBar | property |
enableTaskBar:Boolean
[read-only] Flag to draw a task bar UI at the bottom. Please ensure you set enableMinimize on your dashlets so it can be minimized to taskbar. Also, please ensure that your dashboard skin has a taskbar skinpart. See the default dashboard skin for an example. You can customize the appearance of the task bar via the skin.
This property can be used as the source for data binding.
public function get enableTaskBar():Boolean
enableTileLayoutRowColumns | property |
enableTileLayoutRowColumns:Boolean
In cases where you have a dashboard with tile layout, the user can control the number of rows and columns that the dashboard should show. This in turn controls the number of dashlets that are shown on the screen. The dashlets are sized on basis of how many rows and columns are requested. When this flag is set to true, we assume there is a single drag drop zone, and it has a tile layout.
This property can be used as the source for data binding.
public function get enableTileLayoutRowColumns():Boolean
public function set enableTileLayoutRowColumns(value:Boolean):void
enableTitleToggle | property |
enableTitleToggle:Boolean
Boolean flag to control whether user is allowed to toggle the title bars of all the dashlets.
This property can be used as the source for data binding.
public function get enableTitleToggle():Boolean
public function set enableTitleToggle(value:Boolean):void
excelOptions | property |
public var excelOptions:ExportOptions
The Export options object that is used to configure the excel export behavior - currently only supported in Ultimate
lastAutoRefresh | property |
lastAutoRefresh:Date
Last time the auto refresh timer was triggered
This property can be used as the source for data binding.
public function get lastAutoRefresh():Date
public function set lastAutoRefresh(value:Date):void
maximizedContentLayoutFunction | property |
maximizedContentLayoutFunction:Function
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.5 |
Layout of the maximized Content Group.
The default value is VerticalLayout
.
This property can be used as the source for data binding.
public function get maximizedContentLayoutFunction():Function
public function set maximizedContentLayoutFunction(value:Function):void
mimimizedDashlets | property |
mimimizedDashlets:Array
[read-only] A list of all dashlets taht are currently closed (or minimized) by the user.
This property can be used as the source for data binding.
public function get mimimizedDashlets():Array
minDashletHeight | property |
public var minDashletHeight:Number = 190
During a resize operation we do not allow the user to resize the dashllet less then this number
minDashletWidth | property |
public var minDashletWidth:Number = 190
During a resize operation we do not allow the user to resize the dashllet less then this number
openDashlets | property |
openDashlets:Array
[read-only] Returns a list of open dashlets
public function get openDashlets():Array
originalPoint | property |
protected var originalPoint:Point
During the move operation, the original left and top co-ordinates of this dashlet
pdfOptions | property |
public var pdfOptions:PrintOptions
The Print options object that is used to configure the pdf behavior - currently only supported in Ultimate
pdfPrinter | property |
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.
public function get pdfPrinter():IPDFPrinter
public function set pdfPrinter(value:IPDFPrinter):void
popupFactoryExportOptions | property |
popupFactoryExportOptions:IFactory
The 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:IFactory
The 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:IFactory
The 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:IFactory
The 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:IFactory
The 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: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.
public function get preferencePersistenceKey():String
public function set preferencePersistenceKey(value:String):void
preferencePersistenceMode | property |
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.
public function get preferencePersistenceMode():String
public function set preferencePersistenceMode(value:String):void
preferences | property |
preferences:String
Returns 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: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.
public function get preferencesSet():Boolean
public function set preferencesSet(value:Boolean):void
preferencesToPersist | property |
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.
public function get preferencesToPersist():String
public function set preferencesToPersist(value:String):void
printComponentFactory | property |
public var printComponentFactory:IFactory
printOptions | property |
public var printOptions:PrintOptions
The Print options object that is used to configure the print behavior - currently only supported in Ultimate
referencePoint | property |
protected var referencePoint:Point
During the move operation, the reference point where move started
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
spinnerBehavior | property |
public var spinnerBehavior:SpinnerBehavior
spinnerFactory | property |
spinnerFactory:IFactory
Factory 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:String
The 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
spinnerParent | property |
spinnerParent:Object
[read-only] public function get spinnerParent():Object
title | property |
title:String
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.5 |
Title or caption displayed in the title bar.
The default value is ""
.
This property can be used as the source for data binding.
public function get title():String
public function set title(value:String):void
titleBarHeight | property |
titleBarHeight:Number
Height of the title bar
public function get titleBarHeight():Number
public function set titleBarHeight(value:Number):void
toolbarPdfHandlerFunction | property |
public var toolbarPdfHandlerFunction:Function
Function that actually runs the pdf. Defaults to defaultPdfHandlerFunction
toolbarPrintHandlerFunction | property |
public var toolbarPrintHandlerFunction:Function
Function that actually runs the print. Defaults to defaultPrintHandlerFunction
tooltipBehavior | property |
public var tooltipBehavior:TooltipBehavior
topGroup | property |
public var topGroup:IUIComponent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.5 |
The skin part that defines the appearance of the titlebar
uniqueIdentifier | property |
uniqueIdentifier:String
A key used to uniquely identify a zone. Defaults to the title Used in print and preference persistence to identify drag drop zones.
public function get uniqueIdentifier():String
public function set uniqueIdentifier(value:String):void
useCompactPreferences | property |
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.
public function get useCompactPreferences():Boolean
public function set useCompactPreferences(value:Boolean):void
useElements | property |
useElements:Boolean
[read-only] Whether to use addElement or addChild;
public function get useElements():Boolean
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:Function
Hook 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
wordOptions | property |
public var wordOptions:ExportOptions
The Export options object that is used to configure the word export behavior - currently only supported in Ultimate
DashboardContainer | () | Constructor |
public function DashboardContainer()
The constructor
addDragDropZones | () | method |
protected function addDragDropZones(dragDropZones:Array):void
Adds the specified drag drop zones to the content group
Parameters
dragDropZones:Array |
clearPreferences | () | method |
public function clearPreferences():void
clone | () | method |
public function clone(to:DashboardContainer = null, dbFactory:IFactory = null, dzFactory:IFactory = null, dlFactory:IFactory = null, propertiesToTransfer:Array = null, stylesToTransfer:Array = null):DashboardContainer
Clones the current dashboard.
Parameters
to:DashboardContainer (default = null ) — The dashboard to clone this to. Can be null. IF null, instantiated from dbFactory.newInstance()
| |
dbFactory:IFactory (default = null ) — The factory used to initialize the resultant dashboard
| |
dzFactory:IFactory (default = null ) — The factory used to initialize the resultant drag drop zone
| |
dlFactory:IFactory (default = null ) — The factory used to initialize the resultant dashlet
| |
propertiesToTransfer:Array (default = null )
| |
stylesToTransfer:Array (default = null )
|
DashboardContainer — The cloned dashboard
|
createPrintComponentFactory | () | method |
public function createPrintComponentFactory():IFactory
Gets the class responsible for handling the PrintUI for the Dashboard. Should be a IPrintComponent.
ReturnsIFactory —
|
createPrintDashletFactory | () | method |
public function createPrintDashletFactory():IFactory
Gets the class responsible for handling the PrintUI for the Dashlet. Should be a IPrintComponent
ReturnsIFactory —
|
defaultPdfHandlerFunction | () | method |
public function defaultPdfHandlerFunction():void
Default handler for the Print Button. Calls var po:PrintOptions=PrintOptions.create(true); po.printOptionsViewrenderer = new ClassFactory(DashboardPrintPreview); po.showWarningMessage=false; DashboardPrintController.instance().print(this.grid,po)
defaultPrintHandlerFunction | () | method |
public function defaultPrintHandlerFunction():void
Default handler for the Print Button. Calls var po:PrintOptions=PrintOptions.create(); po.printOptionsViewrenderer = new ClassFactory(ExtendedPrintOptionsView); ExtendedPrintController.instance().print(this.grid,po)
defaultUseSettingsOptionsFunction | () | method |
protected function defaultUseSettingsOptionsFunction():UserSettingsOptions
returns UserSettingsOptions.create(this);
ReturnsUserSettingsOptions |
dispatchAutoRefreshEvent | () | method |
public function dispatchAutoRefreshEvent(event:Event):void
Handle for the auto refresh.
Parameters
event:Event |
dragAcceptReject | () | method |
protected function dragAcceptReject(cell:IUIComponent, event:MouseEvent = null):void
Called when the drag enters over a cell. Use the dropAcceptRejectFunction to control behavior
Parameters
cell:IUIComponent | |
event:MouseEvent (default = null )
|
dragBegin | () | method |
public function dragBegin(event:MouseEvent, dashlet:Dashlet):void
Triggered when drag is starting.
Parameters
event:MouseEvent | |
dashlet:Dashlet |
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(); }
ReturnsBoolean |
getCurrentPreferenceInfo | () | method |
public function getCurrentPreferenceInfo():PreferenceInfo
When enableMultiplePreferences = true, this represents the currently applied preference
ReturnsPreferenceInfo |
getDashletByUniqueIdentifier | () | method |
public function getDashletByUniqueIdentifier(id:String):Dashlet
Returns the dashlet by unique identifier
Parameters
id:String — Identifier to look for
|
Dashlet — Dashlet that matches the provided identifier, null of none found.
|
getDragDropZoneByUniqueIdentifier | () | method |
public function getDragDropZoneByUniqueIdentifier(id:String):DragDropZone
Returns the zone by unique identifier
Parameters
id:String — Identifier to look for
|
DragDropZone — Drag Drop Zone that matches the provided identifier, null of none found.
|
getGridPreferencesInfo | () | method |
public function getGridPreferencesInfo():GridPreferencesInfo
When enableMultiplePreferences = true, this represents a list of all preferences saved for this grid.
ReturnsGridPreferencesInfo |
getPeristenceKey | () | method |
protected function getPeristenceKey():String
ReturnsString |
getTileLayout | () | method |
public function getTileLayout():TileLayout
ReturnsTileLayout |
getUserSettingsController | () | method |
hideSpinner | () | method |
public function hideSpinner():void
Removes the spinner and sets the bodyContainer.alpha back to 1
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.
loadTileLayout | () | method |
public function loadTileLayout(arr:Array):void
Given an array of row and column count, initializes the getTileLayout() layout to the requestedRowCount as the first item in the array, and requestedColumnCount as the second item in the array
Parameters
arr:Array — An array of two items, the first being the requested row count, and the second one being
the requested column count.
|
maximize | () | method |
public function maximize(dashlet:Dashlet):void
Maximizes the provided dashlet.
Parameters
dashlet:Dashlet |
onCreationComplete | () | method |
override protected function onCreationComplete(event:FlexEvent):void
Parameters
event:FlexEvent |
onDashletDraggingMouseMove | () | method |
protected function onDashletDraggingMouseMove(event:MouseEvent):void
Called when the DragEnter event is dispatched over any of the cells. The event is passes in as is.
Parameters
event:MouseEvent |
onDragDrop | () | method |
override protected function onDragDrop(event:DragEvent):void
Called when the DragDrop event is dispatched over any of the cells. The event is passes in as is.
Parameters
event:DragEvent |
onDragDropStageMouseUpHandler | () | method |
protected function onDragDropStageMouseUpHandler(event:MouseEvent):void
Parameters
event:MouseEvent |
onSaveSettingsPopup | () | method |
public function onSaveSettingsPopup():void
Default handler for the Save Settings Popup Calls var popup:DashboardSaveSettingsPopup=new DashboardSaveSettingsPopup(); UIUtils.addPopUp(popup,this as DisplayObject); popup.dashboard=this;
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 )
|
resizeBegin | () | method |
public function resizeBegin(event:MouseEvent, dashlet:Dashlet):void
Start the resize
Parameters
event:MouseEvent | |
dashlet:Dashlet |
restore | () | method |
public function restore():void
Restores the provided dashlet.
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 )
|
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 |
showDropIndicator | () | method |
protected function showDropIndicator(dashletOrDragDropZone:IUIComponent, event:MouseEvent = null):void
Called to show the drop indicator below the passed in cells row. IF you wish to see custom drop signs, override this function.
Parameters
dashletOrDragDropZone:IUIComponent | |
event:MouseEvent (default = null )
|
showSpinner | () | method |
public function showSpinner(msg:String):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 .
Parameters
msg:String |
showToaster | () | method |
override public function showToaster(message:String, toasterPosition:String, toasterRenderer:IFactory = null, animationDuration:Number = 1000, visibleDuration:Number = 5000, moveAnimate:Boolean = true, fadeAnimate:Boolean = true):void
Shows the given toaster message
Parameters
message:String — The message to display in the toaster notification
| |
toasterPosition:String (default = NaN ) — A classfactory for the actual renderer control. Defaults to DefaultToasterRenderer.
| |
toasterRenderer:IFactory (default = null ) — Number of milli seconds to animate the move or the fade animation for the toaster to appear and disappear. Defaults to 1000
| |
animationDuration:Number (default = 1000 ) — Number of milli seconds to keep the toaster visible. Defaults to 5000
| |
visibleDuration:Number (default = 5000 ) — The position for the toaster. One of the Toaster.POSITION_XXXX constants. Defaults to Toaster.POSITION_BOTTOM_RIGHT
| |
moveAnimate:Boolean (default = true ) — Whether to use the move animation.
| |
fadeAnimate:Boolean (default = true ) — Whether to use the fade animation.
|
toggleTitleBars | () | method |
public function toggleTitleBars():void
Toggles the visibility of the titlebars of the dashlets.
autoRefresh | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the auto refresh interval elapses with enableAutoRefresh=true or when the user clicks the refresh button
beforePrint | Event |
com.flexicious.events.DashboardPrintEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the grid is about to be generated for the print, or the preview. The event has a handle to the grid that is being printed, as well as the PrintDataGrid instance. This lets you perform custom logic on the PrintDataGrid before the print occurs.
clearPreferences | Event |
com.flexicious.grids.events.PreferencePersistenceEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Fired when the grid needs to clear its preferences.
dashletClosed | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is closed
dashletClosing | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is is about to be closed. Can be cancelled
dashletCollapsed | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is is about to be collapsed. Can be cancelled
dashletCollapsing | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is collapsed
dashletDragBegin | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is is about to start drag and drop. Can be cancelled
dashletDragDrop | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlets resize has been dropped over a zone or another dashlet
dashletExpanded | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is expanded
dashletExpanding | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is is about to be expanded. Can be cancelled
dashletMoveBegin | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is is about to be start moving. Can be cancelled
dashletMoved | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlets move has completed
dashletOpen | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is opened
dashletOpening | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is is about to be opened. Can be cancelled
dashletResizeBegin | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is is about to start resizing. Can be cancelled
dashletResized | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlets resize has completed
loadPreferences | Event |
com.flexicious.grids.events.PreferencePersistenceEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Fired In preferencePersistenceMode=server , when the dashboard needs to load its preferences. Fired In preferencePersistenceMode=client , when the dashboard has successfully loaded preferences.
maximizeChanged | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is maximized or restored
maximized | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is maximized
pdfBytesReady | Event |
com.flexicious.print.PrintPreviewEvent
Dispatched when the user clicks the 'Generate PDF' button on the Print Preview. In response to this user action, the grid simply prints it output to a byte array of page images. This byte array can then be sent to any pdf generation library either on the client or the server, for example Alive PDF. We provide integration code for AlivePDF out of the box.
persistPreferences | Event |
com.flexicious.grids.events.PreferencePersistenceEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Fired when the grid needs to persist its preferences.
preferencesLoading | Event |
com.flexicious.grids.events.PreferencePersistenceEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Fired right before preferences are being loaded and applied.
printComplete | Event |
com.flexicious.events.DashboardPrintEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the grid is sent to the printer.
restored | Event |
com.flexicious.events.DashboardEvent
Language Version : | ActionScript 3.0 |
Product Version : | Flex 4 |
Runtime Versions : | Flash Player 10, AIR 1.1 |
Dispatched when the dashlet is maximized