ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
ga.model 

ILayoutHost  - AS3 ADEP Guides

Packagega.model
Interfacepublic interface ILayoutHost extends IUIComponent , IEventDispatcher , IStyleClient , IFlexDisplayObject , ISimpleStyleClient , IBitmapDrawable , IEventDispatcher
Implementors LayoutTemplate

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

This is the core interface of Guide panel layouts and needs to be implemented by all guide panel layouts.



Public Properties
 PropertyDefined By
 InheritedaccessibilityProperties : AccessibilityProperties
The current accessibility options for this display object.
IFlexDisplayObject
 Inheritedalpha : Number
Indicates the alpha transparency value of the object specified.
IFlexDisplayObject
 InheritedbaselinePosition : Number
[read-only] The y-coordinate of the baseline of the first line of text of the component.
IUIComponent
  baseReferenceChain : BaseReferenceChain
[read-only] The chain of bindings up the ancestor chain.
ILayoutHost
 InheritedblendMode : String
A value from the BlendMode class that specifies which blend mode to use.
IFlexDisplayObject
 InheritedcacheAsBitmap : Boolean
If set to true, Flash runtimes cache an internal bitmap representation of the display object.
IFlexDisplayObject
 InheritedclassName : String
[read-only] The name of the component class.
IStyleClient
  dataProvider : Object
The data provider that is bound to this panel layout.
ILayoutHost
  defaultCaptionWidth : int
The default caption width for each panel item within a panel layout.
ILayoutHost
 Inheriteddocument : Object
A reference to the document object associated with this component.
IUIComponent
 Inheritedenabled : Boolean
Whether the component can accept user interaction.
IUIComponent
 InheritedexplicitHeight : Number
The explicitly specified height for the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMaxHeight : Number
[read-only] Number that specifies the maximum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMaxWidth : Number
[read-only] Number that specifies the maximum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMinHeight : Number
[read-only] Number that specifies the minimum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitMinWidth : Number
[read-only] Number that specifies the minimum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedexplicitWidth : Number
The explicitly specified width for the component, in pixels, as the component's coordinates.
IUIComponent
 Inheritedfilters : Array
An indexed array that contains each filter object currently associated with the display object.
IFlexDisplayObject
 InheritedfocusPane : Sprite
A single Sprite object that is shared among components and used as an overlay for drawing the focus indicator.
IUIComponent
 Inheritedheight : Number
Indicates the height of the display object, in pixels.
IFlexDisplayObject
 InheritedincludeInLayout : Boolean
Specifies whether this component is included in the layout of the parent container.
IUIComponent
 InheritedinheritingStyles : Object
An object containing the inheritable styles for this component.
IStyleClient
 InheritedisPopUp : Boolean
Set to true by the PopUpManager to indicate that component has been popped up.
IUIComponent
 InheritedloaderInfo : LoaderInfo
[read-only] Returns a LoaderInfo object containing information about loading the file to which this display object belongs.
IFlexDisplayObject
 Inheritedmask : DisplayObject
The calling display object is masked by the specified mask object.
IFlexDisplayObject
 InheritedmaxHeight : Number
[read-only] Number that specifies the maximum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedmaxWidth : Number
[read-only] Number that specifies the maximum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedmeasuredHeight : Number
[read-only] The measured height of this object.
IFlexDisplayObject
 InheritedmeasuredMinHeight : Number
The default minimum height of the component, in pixels.
IUIComponent
 InheritedmeasuredMinWidth : Number
The default minimum width of the component, in pixels.
IUIComponent
 InheritedmeasuredWidth : Number
[read-only] The measured width of this object.
IFlexDisplayObject
 InheritedminHeight : Number
[read-only] Number that specifies the minimum height of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedminWidth : Number
[read-only] Number that specifies the minimum width of the component, in pixels, as the component's coordinates.
IUIComponent
 InheritedmouseX : Number
[read-only] Indicates the x coordinate of the mouse or user input device position, in pixels.
IFlexDisplayObject
 InheritedmouseY : Number
[read-only] Indicates the y coordinate of the mouse or user input device position, in pixels.
IFlexDisplayObject
 Inheritedname : String
Indicates the instance name of the DisplayObject.
IFlexDisplayObject
 InheritednonInheritingStyles : Object
An object containing the noninheritable styles for this component.
IStyleClient
 InheritedopaqueBackground : Object
Specifies whether the display object is opaque with a certain background color.
IFlexDisplayObject
 Inheritedowner : DisplayObjectContainer
The owner of this IVisualElement object.
IUIComponent
  panel : Panel
the parent panel of the layout.
ILayoutHost
  panelItems : Array
An array of panel items that are slotted into the panel layout.
ILayoutHost
 Inheritedparent : DisplayObjectContainer
[read-only] Indicates the DisplayObjectContainer object that contains this display object.
IFlexDisplayObject
 InheritedpercentHeight : Number
Number that specifies the height of a component as a percentage of its parent's size.
IUIComponent
 InheritedpercentWidth : Number
Number that specifies the width of a component as a percentage of its parent's size.
IUIComponent
 Inheritedroot : DisplayObject
[read-only] For a display object in a loaded SWF file, the root property is the top-most display object in the portion of the display list's tree structure represented by that SWF file.
IFlexDisplayObject
 Inheritedrotation : Number
Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation.
IFlexDisplayObject
 Inheritedscale9Grid : Rectangle
The current scaling grid that is in effect.
IFlexDisplayObject
 InheritedscaleX : Number
Indicates the horizontal scale (percentage) of the object as applied from the registration point.
IFlexDisplayObject
 InheritedscaleY : Number
Indicates the vertical scale (percentage) of an object as applied from the registration point of the object.
IFlexDisplayObject
 InheritedscrollRect : Rectangle
The scroll rectangle bounds of the display object.
IFlexDisplayObject
  sizeState : int
The size state of this panel in the Guide layout.
ILayoutHost
 Inheritedstage : Stage
[read-only] The Stage of the display object.
IFlexDisplayObject
 InheritedstyleDeclaration : CSSStyleDeclaration
The style declaration that holds the inline styles declared by this object.
IStyleClient
 InheritedstyleName : Object
The source of this object's style values.
ISimpleStyleClient
  supportsDynamicAlignmentAreas : Boolean
[read-only] Indicates that this layout supports a dynamic number of alignment areas.
ILayoutHost
  supportsKeepWithPrevious : Boolean
[read-only] Indicates that this layout supports the keep with previous hint on a panel item.
ILayoutHost
 InheritedsystemManager : ISystemManager
A reference to the SystemManager object for this component.
IUIComponent
 Inheritedtransform : flash.geom:Transform
An object with properties pertaining to a display object's matrix, color transform, and pixel bounds.
IFlexDisplayObject
 InheritedtweeningProperties : Array
Used by EffectManager.
IUIComponent
 Inheritedvisible : Boolean
Whether or not the display object is visible.
IFlexDisplayObject
 Inheritedwidth : Number
Indicates the width of the display object, in pixels.
IFlexDisplayObject
 Inheritedx : Number
Indicates the x coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer.
IFlexDisplayObject
 Inheritedy : Number
Indicates the y coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer.
IFlexDisplayObject
Public Methods
 MethodDefined By
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
IEventDispatcher
 Inherited
Deletes a style property from this component instance.
IStyleClient
  
Clone this panel layout.
ILayoutHost
 Inherited
Dispatches an event into the event flow.
IEventDispatcher
  
executeBindings(recurse:Boolean = false):void
Execute all bindings within this panel layout.
ILayoutHost
  
getAllItems(container:DisplayObjectContainer = null, itemList:Array = null):Array
Returns all display objects on this panel.
ILayoutHost
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Returns a rectangle that defines the area of the display object relative to the coordinate system of the targetCoordinateSpace object.
IFlexDisplayObject
 Inherited
Returns an Array of CSSStyleDeclaration objects for the type selector that applies to this component, or null if none exist.
IStyleClient
 Inherited
A convenience method for determining whether to use the explicit or measured height
IUIComponent
 Inherited
A convenience method for determining whether to use the explicit or measured width
IUIComponent
  
getFields(visibleFieldsOnly:Boolean = false, container:DisplayObjectContainer = null):Array
Returns the bound visible fields which are referenced in this layout.
ILayoutHost
  
Returns the first panel item in the panel layout.
ILayoutHost
  
Get label corresponding to the index in the data provider.
ILayoutHost
  
Return an array of name areas or groups that this layout supports.
ILayoutHost
  
getPanelItems(visibleItemsOnly:Boolean = false, container:DisplayObjectContainer = null, itemList:Array = null):Array
Returns the panel items contained in the panel layout.
ILayoutHost
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Returns a rectangle that defines the boundary of the display object, based on the coordinate system defined by the targetCoordinateSpace parameter, excluding any strokes on shapes.
IFlexDisplayObject
 Inherited
getStyle(styleProp:String):*
Gets a style property that has been set anywhere in this component's style lookup chain.
IStyleClient
 Inherited
Converts the point object from the Stage (global) coordinates to the display object's (local) coordinates.
IFlexDisplayObject
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
IEventDispatcher
 Inherited
Evaluates the bounding box of the display object to see if it overlaps or intersects with the bounding box of the obj display object.
IFlexDisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evaluates the display object to see if it overlaps or intersects with the point specified by the x and y parameters.
IFlexDisplayObject
 Inherited
Initialize the object.
IUIComponent
  
True if this is a panel containing is a document of record.
ILayoutHost
  
True if this is a panel containing a PDF rendition.
ILayoutHost
 Inherited
Converts the point object from the display object's (local) coordinates to the Stage (global) coordinates.
IFlexDisplayObject
 Inherited
Moves this object to the specified x and y coordinates.
IFlexDisplayObject
 Inherited
Propagates style changes to the children of this component.
IStyleClient
 Inherited
owns(displayObject:DisplayObject):Boolean
Returns true if the chain of owner properties points from child to this UIComponent.
IUIComponent
 Inherited
Called by Flex when a UIComponent object is added to or removed from a parent.
IUIComponent
 Inherited
Sets up the internal style cache values so that the getStyle() method functions.
IStyleClient
 Inherited
Registers the EffectManager as one of the event listeners for each effect event.
IStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
IEventDispatcher
  
Resets the fields in a container.
ILayoutHost
 Inherited
setActualSize(newWidth:Number, newHeight:Number):void
Sets the actual size of this object.
IFlexDisplayObject
  
set the selected panel on this layout.
ILayoutHost
 Inherited
setStyle(styleProp:String, newValue:*):void
Sets a style property on this component instance.
IStyleClient
 Inherited
setVisible(value:Boolean, noEvent:Boolean = false):void
Called when the visible property changes.
IUIComponent
 Inherited
Called when the value of a style property is changed.
ISimpleStyleClient
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
IEventDispatcher
Property Detail

baseReferenceChain

property
baseReferenceChain:BaseReferenceChain  [read-only]

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

The chain of bindings up the ancestor chain. Items in the panel will bind relative to a base reference in the ancestor chain. If the item binding is not relative to any base references in the ancestor chain it will be bind using the absolute address.



Implementation
    public function get baseReferenceChain():BaseReferenceChain

dataProvider

property 
dataProvider:Object

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

The data provider that is bound to this panel layout. Can be a single instance or a collection/instanceManager.



Implementation
    public function get dataProvider():Object
    public function set dataProvider(value:Object):void

defaultCaptionWidth

property 
defaultCaptionWidth:int

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

The default caption width for each panel item within a panel layout.



Implementation
    public function get defaultCaptionWidth():int
    public function set defaultCaptionWidth(value:int):void

panel

property 
panel:Panel

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

the parent panel of the layout.



Implementation
    public function get panel():Panel
    public function set panel(value:Panel):void

panelItems

property 
panelItems:Array

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

An array of panel items that are slotted into the panel layout.



Implementation
    public function get panelItems():Array
    public function set panelItems(value:Array):void

sizeState

property 
sizeState:int

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

The size state of this panel in the Guide layout. This determines whether or not a panel is displayed full screen. 0 - display the panel normal size along with the panel navigator. non-zero - display the panel full screen.



Implementation
    public function get sizeState():int
    public function set sizeState(value:int):void

supportsDynamicAlignmentAreas

property 
supportsDynamicAlignmentAreas:Boolean  [read-only]

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Indicates that this layout supports a dynamic number of alignment areas. This is queried by guide builder and is a design time parameter. When dynamic alignment areas are supported the designer will automatically create a new alignment area when the last alignment area is used.



Implementation
    public function get supportsDynamicAlignmentAreas():Boolean

supportsKeepWithPrevious

property 
supportsKeepWithPrevious:Boolean  [read-only]

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Indicates that this layout supports the keep with previous hint on a panel item. This is queried by guide builder and is a design time parameter. When keep with previous is supported the layout will position a panel item with keep with previous set to the right of the last panel item added to the layout.



Implementation
    public function get supportsKeepWithPrevious():Boolean
Method Detail

clone

()method
public function clone():Object

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Clone this panel layout.

Returns
Object — the clone of this object

executeBindings

()method 
public function executeBindings(recurse:Boolean = false):void

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Execute all bindings within this panel layout.

Parameters

recurse:Boolean (default = false) — whether to recursively call executeBinding of child objects.

getAllItems

()method 
public function getAllItems(container:DisplayObjectContainer = null, itemList:Array = null):Array

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Returns all display objects on this panel. Recursively searches through all DisplayObjectContainers inside this panel.

Parameters

container:DisplayObjectContainer (default = null) — - the container to start the search. If null defaults to this object.
 
itemList:Array (default = null) — - the array to append the results. If null creates a new array.

Returns
Array — the array containing all display objects.

getFields

()method 
public function getFields(visibleFieldsOnly:Boolean = false, container:DisplayObjectContainer = null):Array

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Returns the bound visible fields which are referenced in this layout.

Parameters

visibleFieldsOnly:Boolean (default = false) — - Set to true if the visible flelds are required. The default value is false.
 
container:DisplayObjectContainer (default = null) — - The container to search for panelItems/fields (used for recursive searches).

Returns
Array — The array of fields

getFirstPanelItem

()method 
public function getFirstPanelItem(oContainer:DisplayObjectContainer = null):IPanelItem

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Returns the first panel item in the panel layout.

Parameters

oContainer:DisplayObjectContainer (default = null) — the container to being searching for the first panel item.

Returns
IPanelItem — the first panel item

getLabelAt

()method 
public function getLabelAt(index:int):String

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Get label corresponding to the index in the data provider.

Parameters

index:int — - index into the data provider

Returns
String — the label.

getNamedAreas

()method 
public function getNamedAreas():Array

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Return an array of name areas or groups that this layout supports. This is queried by guide builder and is a design time parameter.

Returns
Array — array of named areas for this layout

getPanelItems

()method 
public function getPanelItems(visibleItemsOnly:Boolean = false, container:DisplayObjectContainer = null, itemList:Array = null):Array

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Returns the panel items contained in the panel layout. This include all components implementing the IPanelItem interface. which include PanelItem (interactive controls) and PanelText (static text).

Parameters

visibleItemsOnly:Boolean (default = false) — - Set to true if the visible panel items are required only. The default value is false.
 
container:DisplayObjectContainer (default = null) — - The container to search for panelItems/fields (used for recursive searches).
 
itemList:Array (default = null) — - The aggregate of all the fields found during the search (used for recursive searches).

Returns
Array — The array of panel items.

isDocPanel

()method 
public function isDocPanel():Boolean

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

True if this is a panel containing is a document of record.

Returns
Boolean — Boolean indicating whether or not this is a document of record panel.

isPDFPanel

()method 
public function isPDFPanel():Boolean

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

True if this is a panel containing a PDF rendition.

Returns
Boolean — Boolean indicating whether or not this is a PDF panel.

resetData

()method 
public function resetData(container:DisplayObjectContainer = null):void

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

Resets the fields in a container. This function also resets data in the nested layouts if there are any. This is only used when the submitAll option is false, some customers need the ability to clear the data from a hidden field, as they have legal restructions that data from non-visible fields can never be submitted.

Parameters

container:DisplayObjectContainer (default = null) — - The container from which the fields must be reset.

setSelectedPanelItem

()method 
public function setSelectedPanelItem(item:Object):void

Language Version: ActionScript 3.0
Product Version: Adobe Digital Enterprise Platform Document Services - Guides 10
Runtime Versions: AIR 1.0, Flash Player 10.2

set the selected panel on this layout.

Parameters

item:Object — the selected panel item.