Packageardisia.components.compassContainer
Classpublic class CompassContainer
InheritanceCompassContainer Inheritance CompassContainerBase Inheritance spark.components.supportClasses.SkinnableComponent

Creates a container with north, south, east, west, and center regions that content can be added to programmatically or via mxml.

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

Default MXML PropertycenterContent



Public Properties
 PropertyDefined By
 InheritedanimationDuration : Number
The duration of animations for the minimize/maximize animations.
CompassContainerBase
 InheritedcenterContent : Array
[write-only] Array of MXML content to add to the center region.
CompassContainerBase
 InheritedcenterRegionInstance : CompassRegionContainer
CompassContainerBase
 InheritedcenterRegionTitle : String
The title to display in the header for the center region if the header is displayed.
CompassContainerBase
 Inheritedeaser : IEaser
The easer to use for the minimize/maximize fade animation.
CompassContainerBase
 InheritedeastCanBeClosed : Boolean
True if the east region can be closed via mouse interaction.
CompassContainerBase
 InheritedeastCanBeMinimized : Boolean
True if the east region can be minimized via mouse interaction.
CompassContainerBase
 InheritedeastContent : Array
[write-only] Array of MXML content to add to the east region.
CompassContainerBase
  eastDividerInstance : ButtonBase
CompassContainer
 InheritedeastRegionInstance : CompassRegionContainer
CompassContainerBase
 InheritedeastRegionTitle : String
The title to display in the header for the east region if the header is displayed.
CompassContainerBase
 InheritedeastResizeLocked : Boolean
True to prevent the region from being resized via user interaction.
CompassContainerBase
 InheritedeastWidth : Number
Explicit width of the east region.
CompassContainerBase
 InheritedmaxEastWidth : Number
The maximum allowed size of the east region.
CompassContainerBase
 InheritedmaxNorthHeight : Number
The maximum allowed size of the north region.
CompassContainerBase
 InheritedmaxSouthHeight : Number
The maximum allowed size of the south region.
CompassContainerBase
 InheritedmaxWestWidth : Number
The maximum allowed size of the west region.
CompassContainerBase
 InheritedminEastWidth : Number
The minimum allowed size of the east region.
CompassContainerBase
  minimizedRegionEastInstance : CompassMinimizedRegion
CompassContainer
  minimizedRegionNorthInstance : CompassMinimizedRegion
CompassContainer
  minimizedRegionSouthInstance : CompassMinimizedRegion
CompassContainer
  minimizedRegionWestInstance : CompassMinimizedRegion
CompassContainer
 InheritedminNorthHeight : Number
The minimum allowed size of the north region.
CompassContainerBase
 InheritedminSouthHeight : Number
The minimum allowed size of the south region.
CompassContainerBase
 InheritedminWestWidth : Number
The minimum allowed size of the west region.
CompassContainerBase
 InheritednorthCanBeClosed : Boolean
True if the north region can be closed via mouse interaction.
CompassContainerBase
 InheritednorthCanBeMinimized : Boolean
True if the north region can be minimized via mouse interaction.
CompassContainerBase
 InheritednorthContent : Array
[write-only] Array of MXML content to add to the north region.
CompassContainerBase
  northDividerInstance : ButtonBase
CompassContainer
 InheritednorthHeight : Number
Explicit height of the north region.
CompassContainerBase
 InheritednorthRegionInstance : CompassRegionContainer
CompassContainerBase
 InheritednorthRegionTitle : String
The title to display in the header for the north region if the header is displayed.
CompassContainerBase
 InheritednorthResizeLocked : Boolean
True to prevent the region from being resized via user interaction.
CompassContainerBase
 InheritedshowCenterChrome : Boolean
True to display the chrome for the center region.
CompassContainerBase
 InheritedshowEastChrome : Boolean
True to display the chrome for the east region.
CompassContainerBase
 InheritedshowNorthChrome : Boolean
True to display the chrome for the north region.
CompassContainerBase
 InheritedshowSouthChrome : Boolean
True to display the chrome for the south region.
CompassContainerBase
 InheritedshowWestChrome : Boolean
True to display the chrome for the west region.
CompassContainerBase
 InheritedsouthCanBeClosed : Boolean
True if the east region can be closed via mouse interaction.
CompassContainerBase
 InheritedsouthCanBeMinimized : Boolean
True if the south region can be minimized via mouse interaction.
CompassContainerBase
 InheritedsouthContent : Array
[write-only] Array of MXML content to add to the south region.
CompassContainerBase
  southDividerInstance : ButtonBase
CompassContainer
 InheritedsouthHeight : Number
Explicit height of the south region.
CompassContainerBase
 InheritedsouthRegionInstance : CompassRegionContainer
CompassContainerBase
 InheritedsouthRegionTitle : String
The title to display in the header for the south region if the header is displayed.
CompassContainerBase
 InheritedsouthResizeLocked : Boolean
True to prevent the region from being resized via user interaction.
CompassContainerBase
 InheritedwestCanBeClosed : Boolean
True if the west region can be closed via mouse interaction.
CompassContainerBase
 InheritedwestCanBeMinimized : Boolean
True if the west region can be minimized via mouse interaction.
CompassContainerBase
 InheritedwestContent : Array
[write-only] Array of MXML content to add to the west region.
CompassContainerBase
  westDividerInstance : ButtonBase
CompassContainer
 InheritedwestRegionInstance : CompassRegionContainer
CompassContainerBase
 InheritedwestRegionTitle : String
The title to display in the header for the west region if the header is displayed.
CompassContainerBase
 InheritedwestResizeLocked : Boolean
True to prevent the region from being resized via user interaction.
CompassContainerBase
 InheritedwestWidth : Number
Explicit width of the west region.
CompassContainerBase
Public Methods
 MethodDefined By
  
A non-mxml way to add a region.
CompassContainer
  
dispose():void
Remove the container from the display list and remove listeners.
CompassContainer
  
Return the region container based on the mouse position.
CompassContainer
  
Remove the passed region.
CompassContainer
  
setMinimizeState(compassQuadrant:String, minimize:Boolean, skipAnimation:Boolean = true):void
Set whether a region is minimized or not.
CompassContainer
Protected Methods
 MethodDefined By
  
Close a floated region.
CompassContainer
  
dividerHandler(event:Event):void
Handles events of the dividers.
CompassContainer
  
effectHandler(event:EffectEvent):void
Handles effect events.
CompassContainer
  
floatingRegionHandler(event:Event):void
Handles events on floated regions.
CompassContainer
  
Displays the region for a minimized region by displaying it above the CompassContainer.
CompassContainer
  
initializeRegion(region:String):void
Setup the passed region.
CompassContainer
  
minimizedRegionHandler(event:Event):void
Handles events on the minimized regions.
CompassContainer
  
regionEventHandler(event:Event):void
Handles events.
CompassContainer
  
regionHandler(event:Event):void
Handles events on the region.
CompassContainer
  
Remove the minimized region display element.
CompassContainer
  
resizeHandler(event:MouseEvent):void
Handles the MouseEvents dispatched by resizing drags.
CompassContainer
  
Update region properties.
CompassContainer
Events
 Event Summary Defined By
  Dispatched when a "divider" is dragged.CompassContainer
  Dispatched when a "divider" is moused down.CompassContainer
  Dispatched when a "divider" is moused up or released.CompassContainer
  Dispatched when a region is closed.CompassContainer
  Dispatched when a region is initialized and added to the CompassContainer.CompassContainer
  Dispatched when a region's minimization state changes.CompassContainer
Styles
 Style Description Defined By
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the background for the center region.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Alpha of the border for the center region.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the border for the center region.
CompassContainerBase
 InheritedType: Boolean CSS Inheritance: no
True to display a border around the center region.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the background for the east region.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Alpha of the border for the east region.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the border for the east region.
CompassContainerBase
 InheritedType: Boolean CSS Inheritance: no
True to display a border around the east region.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
The gap between regions.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Alpha of the gap.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Color of the gap between regions.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the background for the north region.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Alpha of the border for the north region.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the border for the north region.
CompassContainerBase
 InheritedType: Boolean CSS Inheritance: no
True to display a border around the north region.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Height of the divider button for horizontal dividers.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Width of the divider button for vertical dividers.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the background for the south region.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Alpha of the border for the south region.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the border for the south region.
CompassContainerBase
 InheritedType: Boolean CSS Inheritance: no
True to display a border around the south region.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the background for the west region.
CompassContainerBase
 InheritedType: Number CSS Inheritance: no
Alpha of the border for the west region.
CompassContainerBase
 InheritedType: uint Format: Color CSS Inheritance: no
Color of the border for the west region.
CompassContainerBase
 InheritedType: Boolean CSS Inheritance: no
True to display a border around the west region.
CompassContainerBase
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
  
HDividerFactoryPart:mx.core.IFactory
Required: false Part Type: Dynamic
Factory that creates the horizontal divider buttons.

The IFactory must return an object of type ButtonBase
CompassContainer
  
minimizedRegionFactoryPart:mx.core.IFactory
Required: false Part Type: Dynamic
Factory that creates the display element when a region is minimized.

The IFactory must return an object of type CompassMinimizedRegion
CompassContainer
  
regionContainerFactoryPart:mx.core.IFactory
Required: false Part Type: Dynamic
Factory that creates the region containers.

The IFactory must return an object of type CompassRegionContainer
CompassContainer
  
VDividerFactoryPart:mx.core.IFactory
Required: false Part Type: Dynamic
Factory that creates the vertical divider buttons.

The IFactory must return an object of type ButtonBase
CompassContainer
Skin States

To skin the component, implement a skin that defines the following states. Although you must implement all skin states, a skin state can be empty. An empty skin state specifies no changes to the default skin state.


 Skin State Description Defined By
 InheritedCompassContainerBase
 InheritedCompassContainerBase
Property Detail
eastDividerInstanceproperty
public var eastDividerInstance:ButtonBase

minimizedRegionEastInstanceproperty 
public var minimizedRegionEastInstance:CompassMinimizedRegion

minimizedRegionNorthInstanceproperty 
public var minimizedRegionNorthInstance:CompassMinimizedRegion

minimizedRegionSouthInstanceproperty 
public var minimizedRegionSouthInstance:CompassMinimizedRegion

minimizedRegionWestInstanceproperty 
public var minimizedRegionWestInstance:CompassMinimizedRegion

northDividerInstanceproperty 
public var northDividerInstance:ButtonBase

southDividerInstanceproperty 
public var southDividerInstance:ButtonBase

westDividerInstanceproperty 
public var westDividerInstance:ButtonBase

Method Detail
addRegion()method
public function addRegion(region:String):CompassRegionContainer

A non-mxml way to add a region. Add content to the returned Group or access the specific region instance container.

Parameters

region:String — the string description of the region to add

Returns
CompassRegionContainer — the initialized region container
closeFloatRegion()method 
protected function closeFloatRegion():void

Close a floated region.

dispose()method 
public function dispose():void

Remove the container from the display list and remove listeners.

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

Handles events of the dividers.

Parameters

event:Event — the Event that triggered the handler

effectHandler()method 
protected function effectHandler(event:EffectEvent):void

Handles effect events.

Parameters

event:EffectEvent — the EffectEvent that triggered the handler

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

Handles events on floated regions.

Parameters

event:Event — the Event that triggered the handler

floatMinimizedRegionContent()method 
protected function floatMinimizedRegionContent(region:CompassRegionContainer):void

Displays the region for a minimized region by displaying it above the CompassContainer.

Parameters

region:CompassRegionContainer — the CompassRegionContainer to display the content for

getHoveredRegion()method 
public function getHoveredRegion():CompassRegionContainer

Return the region container based on the mouse position. If the hovered region is east/west/north/south the returned element is a CompassRegionContainer. If the region is a center region, the centerRegionInstance is returned.

Returns
CompassRegionContainer — the container
initializeRegion()method 
protected function initializeRegion(region:String):void

Setup the passed region.

Parameters

region:String — the string representation of the region to initialize

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

Handles events on the minimized regions.

Parameters

event:Event — the Event that triggered the handler

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

Handles events.

Parameters

event:Event — the Event that triggered the handler

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

Handles events on the region.

Parameters

event:Event — the Event that triggered the handler

removeMinimizedGroup()method 
protected function removeMinimizedGroup(minimizedRegion:CompassMinimizedRegion):void

Remove the minimized region display element.

Parameters

minimizedRegion:CompassMinimizedRegion — the minimized region element

removeRegion()method 
public function removeRegion(region:String):CompassRegionContainer

Remove the passed region.

Parameters

region:String

Returns
CompassRegionContainer — the removed region container
resizeHandler()method 
protected function resizeHandler(event:MouseEvent):void

Handles the MouseEvents dispatched by resizing drags.

Parameters

event:MouseEvent — the MouseEvent that triggered the handler

setMinimizeState()method 
public function setMinimizeState(compassQuadrant:String, minimize:Boolean, skipAnimation:Boolean = true):void

Set whether a region is minimized or not.

Will skip any animations.

Parameters

compassQuadrant:String — the CompassQuadrant string for the region to change its minimized state
 
minimize:Boolean — Boolean whether to set as minimized or not
 
skipAnimation:Boolean (default = true) — Boolean true to skip any animations

updateRegionProperties()method 
protected function updateRegionProperties():void

Update region properties.

Event Detail
dividerDrag Event
Event Object Type: ardisia.components.compassContainer.events.CompassContainerEvent
CompassContainerEvent.type property = ardisia.components.compassContainer.events.CompassContainerEvent

Dispatched when a "divider" is dragged.

dividerPress Event  
Event Object Type: ardisia.components.compassContainer.events.CompassContainerEvent
CompassContainerEvent.type property = ardisia.components.compassContainer.events.CompassContainerEvent

Dispatched when a "divider" is moused down.

dividerRelease Event  
Event Object Type: ardisia.components.compassContainer.events.CompassContainerEvent
CompassContainerEvent.type property = ardisia.components.compassContainer.events.CompassContainerEvent

Dispatched when a "divider" is moused up or released.

regionClose Event  
Event Object Type: ardisia.components.compassContainer.events.CompassContainerEvent
CompassContainerEvent.type property = ardisia.components.compassContainer.events.CompassContainerEvent

Dispatched when a region is closed.

regionInitialized Event  
Event Object Type: ardisia.components.compassContainer.events.CompassContainerEvent
CompassContainerEvent.type property = ardisia.components.compassContainer.events.CompassContainerEvent

Dispatched when a region is initialized and added to the CompassContainer.

regionMinimizeChange Event  
Event Object Type: ardisia.components.compassContainer.events.CompassContainerEvent
CompassContainerEvent.type property = ardisia.components.compassContainer.events.CompassContainerEvent

Dispatched when a region's minimization state changes.