Packageardisia.components.paneNavigators.tabPaneNavigator
Classpublic class TabPaneNavigator
InheritanceTabPaneNavigator Inheritance ViewStack Inheritance spark.components.SkinnableContainer

Tab viewstack that displays a single Pane at a time. Pane children can be dragged out of the viewstack and floated. Panes can also be dragged in and docked.

Supports deferred instantiation for MXML content. Set the "creationPolicy" property to "all" to immediately initialize content.

All direct children must extend the Pane container class.

To enable deferred instantiation, set the "creationPolicy" to "auto" ( the default). To create all content immediately, set the creationPolicy to "all".

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

Default MXML PropertymxmlContentFactory



Public Properties
 PropertyDefined By
 InheritedselectedChild : IVisualElement
The selected child element in the ViewStack.
ViewStack
 InheritedselectedIndex : int
The zero-based index of the currently visible child element.
ViewStack
  unDockThreshold : Number = 50
Pixels mouse must move outside of the navigator to un-dock a Pane.
TabPaneNavigator
Public Methods
 MethodDefined By
  
dockFloatedPane(floatPane:*):Boolean
Call to dock a floating pane to this navigator.
TabPaneNavigator
  
removeAll():void
Removes all panes and tabs from the TabPaneNavigator.
TabPaneNavigator
Protected Methods
 MethodDefined By
 Inherited
commitSelectedIndex(removeFromLayout:Boolean = true):void
Commit the selected index, update the visible element and update the bindings.
ViewStack
  
eventHandler(event:Event):void
[override] Handles events on the class.
TabPaneNavigator
  
Handles events on the managed panes.
TabPaneNavigator
 Inherited
selectElement(element:IVisualElement):void
Select the following element and initialize if necessary.
ViewStack
 Inherited
Setup the deferred content.
ViewStack
  
tabBarPartHandler(event:Event):void
Handles events on the tab bar skin part.
TabPaneNavigator
Events
 Event Summary Defined By
 InheritedDispatched when the selectedChild changes.ViewStack
 InheritedDispatched when the selectedChild is about to change.ViewStack
  Dispatched when a floated pane has been docked to the navigator.TabPaneNavigator
  Dispatched when a floated pane is about to be docked to the navigator.TabPaneNavigator
  Dispatched when a pane is dragged over this pane navigator.TabPaneNavigator
  Dispatched when a dragged pane is dragged out of this pane navigator.TabPaneNavigator
  Dispatched when a pane has been un-docked from the navigator and floated.TabPaneNavigator
  Dispatched when a pane is about to be un-docked from the navigator and floated.TabPaneNavigator
Styles
 Style Description Defined By
 InheritedType: Number CSS Inheritance: no
The alpha of the background.
ViewStack
 InheritedType: uint Format: Color CSS Inheritance: no
The color of the background.
ViewStack
 InheritedType: Number CSS Inheritance: no
The alpha of the border.
ViewStack
 InheritedType: uint Format: Color CSS Inheritance: no
The color of the border.
ViewStack
 InheritedType: Boolean CSS Inheritance: no
True to display a border.
ViewStack
Skin Parts

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


 Skin Part Description Defined By
  
tabBarPart:TabBar
Required: true Part Type: Static
The button bar linked to the viewstack.
TabPaneNavigator
Property Detail
unDockThresholdproperty
public var unDockThreshold:Number = 50

Pixels mouse must move outside of the navigator to un-dock a Pane.

The default value is 50;.

Method Detail
dockFloatedPane()method
public function dockFloatedPane(floatPane:*):Boolean

Call to dock a floating pane to this navigator.

Not typically called directly. Called by the dragged pane.

Parameters

floatPane:* — the Pane to dock to the navigator

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

Handles events on the class.

Parameters

event:Event — the Event 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

removeAll()method 
public function removeAll():void

Removes all panes and tabs from the TabPaneNavigator.

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

Handles events on the tab bar skin part.

Parameters

event:Event — the Event that triggered the handler

Event Detail
docked Event
Event Object Type: ardisia.components.paneNavigators.events.PaneNavigatorEvent
PaneNavigatorEvent.type property = ardisia.components.paneNavigators.events.PaneNavigatorEvent

Dispatched when a floated pane has been docked to the navigator.

docking Event  
Event Object Type: ardisia.components.paneNavigators.events.PaneNavigatorEvent
PaneNavigatorEvent.type property = ardisia.components.paneNavigators.events.PaneNavigatorEvent

Dispatched when a floated pane is about to be docked to the navigator.

Can be cancelled to cancel the dock.

dragEnter Event  
Event Object Type: ardisia.components.paneNavigators.events.PaneNavigatorEvent
PaneNavigatorEvent.type property = ardisia.components.paneNavigators.events.PaneNavigatorEvent

Dispatched when a pane is dragged over this pane navigator.

Cancel to prevent the pane from docking to this navigator.

dragExit Event  
Event Object Type: ardisia.components.paneNavigators.events.PaneNavigatorEvent
PaneNavigatorEvent.type property = ardisia.components.paneNavigators.events.PaneNavigatorEvent

Dispatched when a dragged pane is dragged out of this pane navigator.

unDocked Event  
Event Object Type: ardisia.components.paneNavigators.events.PaneNavigatorEvent
PaneNavigatorEvent.type property = ardisia.components.paneNavigators.events.PaneNavigatorEvent

Dispatched when a pane has been un-docked from the navigator and floated.

unDocking Event  
Event Object Type: ardisia.components.paneNavigators.events.PaneNavigatorEvent
PaneNavigatorEvent.type property = ardisia.components.paneNavigators.events.PaneNavigatorEvent

Dispatched when a pane is about to be un-docked from the navigator and floated.

Can be cancelled to prevent the un-docking.