Packageardisia.components.floatPaneControlBar
Classpublic class FloatPaneControlBar
InheritanceFloatPaneControlBar Inheritance ButtonBar Inheritance ButtonBarBase Inheritance spark.components.supportClasses.ButtonBarBase

Automatically detects when a Pane is floated and manages the visiblity of floating panes and when panes are activated/deactivated. Works similiarly to a OS taskbar.

View the technical documentation on the Ardisia Labs website for more information.

DESIGN NOTES

Default MXML PropertydataProvider



Public Properties
 PropertyDefined By
  activePane : Pane
The pane managed by this control that is activated.
FloatPaneControlBar
  animationDuration : Number = 350
The duration of animations for the minimize and maximize animations.
FloatPaneControlBar
 InheritedclosableField : String
The field on the data to look for a boolean value if the button can be closed by clicking the close button skin part.
ButtonBarBase
 Inheritedduration : Number = 150
The duration of animations in milliseconds.
ButtonBarBase
 Inheritedeaser : IEaser
The default easer to apply to animations.
ButtonBarBase
 InheritedisAnimating : Boolean
[read-only] True if a animation is running.
ButtonBarBase
 InheritedisDragging : Boolean
[read-only] True if a button is being dragged.
ButtonBarBase
  maximizeBottom : Number = 0
The offset from the bottom of the screen when a pane is maximized.
FloatPaneControlBar
  maximizeLeft : Number = 0
The offset from the left of the screen when a pane is maximized.
FloatPaneControlBar
  maximizeRight : Number = 0
The offset from the right of the screen when a pane is maximized.
FloatPaneControlBar
  maximizeTop : Number = 0
The offset from the top of the screen when a pane is maximized.
FloatPaneControlBar
  paneEaser : IEaser
The easer to use for the minimize and maximize animations.
FloatPaneControlBar
Public Methods
 MethodDefined By
  
FloatPaneControlBar
 Inherited
addButton(data:Object, selected:Boolean):void
Use this method to add a button via animation.
ButtonBarBase
 Inherited
End a selected button drag.
ButtonBarBase
 Inherited
removeButton(index:int):void
Use this method to remove a button via animation.
ButtonBarBase
 Inherited
startButtonDrag(initialX:Number):void
Start dragging the selected button.
ButtonBarBase
Protected Methods
 MethodDefined By
  
Add handlers to the systemManager.
FloatPaneControlBar
  
awmHandler(event:FocusEvent):void
Handles events for the ActiveWindowManager.
FloatPaneControlBar
 Inherited
Commits the buttonSnapshot to the underlying collection and updates the buttons to reflect the buttonSnapshot.
ButtonBarBase
 Inherited
dragHandler(event:Event):void
Handles the events and logic for user initiated dragging.
ButtonBarBase
 Inherited
effectHandler(event:EffectEvent):void
Handles the events and logic for effects.
ButtonBarBase
  
eventHandler(event:Event):void
[override] Handles the changes to selection made via user interaction.
FloatPaneControlBar
 Inherited
Sets up the final animations after a removeSession is finished.
ButtonBarBase
 Inherited
Creates and returns a Fade effect on the passed data.
ButtonBarBase
 Inherited
Creates and returns a Move animation to move a button to the new position.
ButtonBarBase
 Inherited
Creates and returns a resize effect on the passed data.
ButtonBarBase
  
maximizePane(pane:Pane, minToMax:Boolean = false):void
Maximize a pane.
FloatPaneControlBar
  
minimizePane(pane:Pane):void
Minimize a pane.
FloatPaneControlBar
  
paneEffectHandler(event:EffectEvent = null):void
Handles effect events.
FloatPaneControlBar
  
Handles events on the managed panes.
FloatPaneControlBar
 Inherited
rendererHandler(event:Event):void
Handles events on the renderers.
ButtonBarBase
  
restorePane(pane:Pane):void
Restore a pane.
FloatPaneControlBar
  
setActivePane(pane:Pane):void
Sets the activePane property and updates bindings and dispatches a change event.
FloatPaneControlBar
  
Set a pending active pane that is commited after a short pause to prevent the activePane property from changing rapidly.
FloatPaneControlBar
  
setupAnimation(type:String, pane:Pane):void
Handles the animation for minimizing, maximizing, or restoring a pane.
FloatPaneControlBar
 Inherited
Setup the final animation for a removal session.
ButtonBarBase
  
stageHandler(event:Event):void
Handles events for the Stage.
FloatPaneControlBar
  
systemManagerEventHandler(event:Event):void
Handles events on the systemManager.
FloatPaneControlBar
  
timerHandler(event:TimerEvent):void
Handles timer events to update the activePane.
FloatPaneControlBar
 Inherited
Creates a vector of SlidingButtonData objects for each button from left to right.
ButtonBarBase
Events
 Event Summary Defined By
  Dispatched when the "activePane" property changes.FloatPaneControlBar
 InheritedDispatched when a button is closed via the close button.ButtonBarBase
 InheritedDispatched when a button is about to be closed via the close button.ButtonBarBase
 InheritedDispatched when a ButtonBarButton's closeButtonPart is clicked.ButtonBarBase
 InheritedDispatched when a drag ends.ButtonBarBase
 InheritedDispatched while a button is dragging.ButtonBarBase
 InheritedDispatched when a button drag starts.ButtonBarBase
 InheritedDispatched immediately before a button is dragged.ButtonBarBase
Styles
 Style Description Defined By
  
borderAlpha
Type: Number CSS Inheritance: no
The alpha of the border.
FloatPaneControlBar
  
borderColor
Type: uint CSS Inheritance: no
The color of the border.
FloatPaneControlBar
  
borderVisible
Type: Boolean CSS Inheritance: no
True to display the border. The default value is true.
FloatPaneControlBar
  
gap
Type: Number CSS Inheritance: no
The distance between float pane buttons.
FloatPaneControlBar
  
paddingBottom
Type: Number CSS Inheritance: no
Bottom padding. The default value is 4.
FloatPaneControlBar
  
paddingLeft
Type: Number CSS Inheritance: no
Left padding. The default value is 4.
FloatPaneControlBar
  
paddingRight
Type: Number CSS Inheritance: no
Right padding. The default value is 4.
FloatPaneControlBar
  
paddingTop
Type: Number CSS Inheritance: no
Top padding. The default value is 4.
FloatPaneControlBar
Property Detail
activePaneproperty
activePane:Pane

The pane managed by this control that is activated. If null, all managed panes are deactivated.

The default value is null.

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


Implementation
    public function get activePane():Pane
    public function set activePane(value:Pane):void
animationDurationproperty 
public var animationDuration:Number = 350

The duration of animations for the minimize and maximize animations.

Set to 0 to skip animation.

The default value is 350.

maximizeBottomproperty 
public var maximizeBottom:Number = 0

The offset from the bottom of the screen when a pane is maximized.

The default value is 0.

maximizeLeftproperty 
public var maximizeLeft:Number = 0

The offset from the left of the screen when a pane is maximized.

The default value is 0.

maximizeRightproperty 
public var maximizeRight:Number = 0

The offset from the right of the screen when a pane is maximized.

The default value is 0.

maximizeTopproperty 
public var maximizeTop:Number = 0

The offset from the top of the screen when a pane is maximized.

The default value is 0.

paneEaserproperty 
public var paneEaser:IEaser

The easer to use for the minimize and maximize animations.

The default value is Power easer.

Constructor Detail
FloatPaneControlBar()Constructor
public function FloatPaneControlBar()



Method Detail
addSysManListeners()method
protected function addSysManListeners():void

Add handlers to the systemManager.

awmHandler()method 
protected function awmHandler(event:FocusEvent):void

Handles events for the ActiveWindowManager.

Parameters

event:FocusEvent — the FocusEvent

eventHandler()method 
override protected function eventHandler(event:Event):void

Handles the changes to selection made via user interaction.

Parameters

event:Event — the Event that triggered the handler

maximizePane()method 
protected function maximizePane(pane:Pane, minToMax:Boolean = false):void

Maximize a pane.

Parameters

pane:Pane — the Pane to maximize
 
minToMax:Boolean (default = false) — whether the pane is moving from min to max

minimizePane()method 
protected function minimizePane(pane:Pane):void

Minimize a pane.

Parameters

pane:Pane — the Pane to minimize

paneEffectHandler()method 
protected function paneEffectHandler(event:EffectEvent = null):void

Handles effect events.

Parameters

event:EffectEvent (default = null) — the effect that triggered the handler

paneHandler()method 
protected function paneHandler(event:PaneEvent):void

Handles events on the managed panes.

Parameters

event:PaneEvent — the PaneEvent dispatched by the pane

restorePane()method 
protected function restorePane(pane:Pane):void

Restore a pane.

Parameters

pane:Pane — the Pane to restore

setActivePane()method 
protected function setActivePane(pane:Pane):void

Sets the activePane property and updates bindings and dispatches a change event.

Parameters

pane:Pane — the Pane that is activated

setPendingActivePane()method 
protected function setPendingActivePane(pane:Pane):void

Set a pending active pane that is commited after a short pause to prevent the activePane property from changing rapidly.

Parameters

pane:Pane — the Pane to set as the pending active pane

setupAnimation()method 
protected function setupAnimation(type:String, pane:Pane):void

Handles the animation for minimizing, maximizing, or restoring a pane.

Parameters

type:String — description of the animation to run
 
pane:Pane — the Pane run the animation on

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

Handles events for the Stage.

Parameters

event:Event — the Event

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

Handles events on the systemManager.

Parameters

event:Event — the Event that triggered the handler

timerHandler()method 
protected function timerHandler(event:TimerEvent):void

Handles timer events to update the activePane.

Parameters

event:TimerEvent — the TimerEvent that triggered the handler

Event Detail
activePaneChange Event
Event Object Type: ardisia.components.floatPaneControlBar.events.FloatPaneControlBarEvent
FloatPaneControlBarEvent.type property = ardisia.components.floatPaneControlBar.events.FloatPaneControlBarEvent

Dispatched when the "activePane" property changes.