Adobe® Flex® 4 Language Reference
Hide Packages and Classes List |  Packages  |  Classes  |  Index  |  Appendixes
mx.core 
FlexHTMLLoader 
Packagemx.core
Classpublic class FlexHTMLLoader
InheritanceFlexHTMLLoader Inheritance HTMLLoader Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Implements IFocusManagerComplexComponent, IIMESupport

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

FlexHTMLLoader is a subclass of the Player's HTMLLoader class used by the Flex HTML control. It overrides the toString() method to return a string indicating the location of the object within the hierarchy of DisplayObjects in the application.



Public Properties
 PropertyDefined By
 InheritedaccessibilityImplementation : AccessibilityImplementation
The current accessibility implementation (AccessibilityImplementation) for this InteractiveObject instance.
InteractiveObject
 InheritedaccessibilityProperties : AccessibilityProperties
The current accessibility options for this display object.
DisplayObject
 Inheritedalpha : Number
Indicates the alpha transparency value of the object specified.
DisplayObject
 InheritedAIR-only authenticate : Boolean
Specifies whether authentication requests should be handled (true) or not (false) for HTTP requests issued by this object.
HTMLLoader
 InheritedblendMode : String
A value from the BlendMode class that specifies which blend mode to use.
DisplayObject
 InheritedblendShader : Shader
[write-only] Sets a shader that is used for blending the foreground and background.
DisplayObject
 InheritedbuttonMode : Boolean
Specifies the button mode of this sprite.
Sprite
 InheritedcacheAsBitmap : Boolean
If set to true, Flash Player or Adobe AIR caches an internal bitmap representation of the display object.
DisplayObject
 InheritedAIR-only cacheResponse : Boolean
Specifies whether successful response data should be cached for HTTP requests issued by this object.
HTMLLoader
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 InheritedAIR-only contentHeight : Number
[read-only] The height, in pixels, of the HTML content.
HTMLLoader
 InheritedAIR-only contentWidth : Number
[read-only] The width, in pixels, of the HTML content.
HTMLLoader
 InheritedcontextMenu : NativeMenu
Specifies the context menu associated with this object.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Specifies whether the object receives doubleClick events.
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] Specifies the display object over which the sprite is being dragged, or on which the sprite was dropped.
Sprite
  enableIME : Boolean
[read-only] A flag that indicates whether the IME should be enabled when the component receives focus.
FlexHTMLLoader
 Inheritedfilters : Array
An indexed array that contains each filter object currently associated with the display object.
DisplayObject
  AIR-only focusEnabled : Boolean
A flag that indicates whether the component can receive focus when selected.
FlexHTMLLoader
 InheritedfocusRect : Object
Specifies whether this object displays a focus rectangle.
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] Specifies the Graphics object that belongs to this sprite where vector drawing commands can occur.
Sprite
  AIR-only hasFocusableChildren : Boolean
A flag that indicates whether child objects can receive focus.
FlexHTMLLoader
 InheritedAIR-only hasFocusableContent : Boolean
[read-only] Indicates whether any content in the HTMLLoader object is focusable.
HTMLLoader
 InheritedAIR-only height : Number
[override] Specifies the height of the rectangle of the HTML canvas that is being rendered.
HTMLLoader
 InheritedAIR-only historyLength : uint
[read-only] The overall length of the history list, including back and forward entries.
HTMLLoader
 InheritedAIR-only historyPosition : uint
The current position in the history list.
HTMLLoader
 InheritedhitArea : Sprite
Designates another sprite to serve as the hit area for a sprite.
Sprite
 InheritedAIR-only htmlHost : flash.html:HTMLHost
The HTMLHost object used to handle changes to certain user interface elements, such as the window.document.title property of the HTMLLoader object.
HTMLLoader
  imeMode : String
This is just a stub to support the interface.
FlexHTMLLoader
 InheritedAIR-only loaded : Boolean
[read-only] Indicates whether the JavaScript load event corresponding to the previous call to the load() or loadString() method has been delivered to the HTML DOM in the HTMLLoader object.
HTMLLoader
 InheritedloaderInfo : LoaderInfo
[read-only] Returns a LoaderInfo object containing information about loading the file to which this display object belongs.
DisplayObject
 InheritedAIR-only location : String
[read-only] The URL for the content loaded in the HTMLLoader object.
HTMLLoader
 InheritedAIR-only manageCookies : Boolean
Specifies whether the HTTP protocol stack should manage cookies for this object.
HTMLLoader
 Inheritedmask : DisplayObject
The calling display object is masked by the specified mask object.
DisplayObject
 InheritedmouseChildren : Boolean
Determines whether or not the children of the object are mouse enabled.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Specifies whether this object receives mouse messages.
InteractiveObject
  AIR-only mouseFocusEnabled : Boolean
Whether the component can receive focus when clicked on.
FlexHTMLLoader
 InheritedmouseX : Number
[read-only] Indicates the x coordinate of the mouse position, in pixels.
DisplayObject
 InheritedmouseY : Number
[read-only] Indicates the y coordinate of the mouse position, in pixels.
DisplayObject
 Inheritedname : String
Indicates the instance name of the DisplayObject.
DisplayObject
 InheritedAIR-only navigateInSystemBrowser : Boolean
Specifies whether navigation of the root frame of the HTML content (such as when the user clicks a link, when the window.location property is set, or when calling window.open()) results in navigation in the HTMLLoader object (false) or in the default system web browser (true).
HTMLLoader
 InheritednumChildren : int
[read-only] Returns the number of children of this object.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Specifies whether the display object is opaque with a certain background color.
DisplayObject
 InheritedAIR-only paintsDefaultBackground : Boolean
Specifies whether the background of the HTMLLoader document is opaque white (true) or not (false).
HTMLLoader
 Inheritedparent : DisplayObjectContainer
[read-only] Indicates the DisplayObjectContainer object that contains this display object.
DisplayObject
 InheritedAIR-only pdfCapability : int
[static] [read-only] The type of PDF support on the user's system, defined as an integer code value.
HTMLLoader
 InheritedAIR-only placeLoadStringContentInApplicationSandbox : Boolean
Specifies whether content loaded via the loadString() method is put in the application sandbox (true) or in a non-application sandbox (false).
HTMLLoader
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
 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.
DisplayObject
 Inheritedrotation : Number
Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation.
DisplayObject
 InheritedrotationX : Number
Indicates the x-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container.
DisplayObject
 InheritedrotationY : Number
Indicates the y-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container.
DisplayObject
 InheritedrotationZ : Number
Indicates the z-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container.
DisplayObject
 InheritedAIR-only runtimeApplicationDomain : ApplicationDomain
The application domain to use for the window.runtime object in JavaScript in the HTML page.
HTMLLoader
 Inheritedscale9Grid : Rectangle
The current scaling grid that is in effect.
DisplayObject
 InheritedscaleX : Number
Indicates the horizontal scale (percentage) of the object as applied from the registration point.
DisplayObject
 InheritedscaleY : Number
Indicates the vertical scale (percentage) of an object as applied from the registration point of the object.
DisplayObject
 InheritedscaleZ : Number
Indicates the depth scale (percentage) of an object as applied from the registration point of the object.
DisplayObject
 InheritedAIR-only scrollH : Number
The horizontal scroll position of the HTML content in the HTMLLoader object.
HTMLLoader
 InheritedscrollRect : Rectangle
The scroll rectangle bounds of the display object.
DisplayObject
 InheritedAIR-only scrollV : Number
The vertical scroll position of the HTML content in the HTMLLoader object.
HTMLLoader
 InheritedsoundTransform : flash.media:SoundTransform
Controls sound within this sprite.
Sprite
 Inheritedstage : Stage
[read-only] The Stage of the display object.
DisplayObject
 InheritedtabChildren : Boolean
Determines whether the children of the object are tab enabled.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Specifies whether this object is in the tab order.
InteractiveObject
  AIR-only tabFocusEnabled : Boolean
A flag that indicates whether child objects can receive focus This is similar to the tabEnabled property used by the Flash Player. This is usually true for components that handle keyboard input, but some components in controlbars have them set to false because they should not steal focus from another component like an editor.
FlexHTMLLoader
 InheritedtabIndex : int
Specifies the tab ordering of objects in a SWF file.
InteractiveObject
 InheritedAIR-only textEncodingFallback : String
The character encoding used by the HTMLLoader content if an HTML page does not specify a character encoding.
HTMLLoader
 InheritedAIR-only textEncodingOverride : String
The character encoding used by the HTMLLoader content, overriding any setting in the HTML page.
HTMLLoader
 InheritedtextSnapshot : flash.text:TextSnapshot
[read-only] Returns a TextSnapshot object for this DisplayObjectContainer instance.
DisplayObjectContainer
 Inheritedtransform : flash.geom:Transform
An object with properties pertaining to a display object's matrix, color transform, and pixel bounds.
DisplayObject
 InheritedAIR-only useCache : Boolean
Specifies whether the local cache should be consulted before HTTP requests issued by this object fetch data.
HTMLLoader
 InheriteduseHandCursor : Boolean
A Boolean value that indicates whether the pointing hand (hand cursor) appears when the mouse rolls over a sprite in which the buttonMode property is set to true.
Sprite
 InheritedAIR-only userAgent : String
The user agent string to be used in any upcoming content requests from this HTMLLoader object.
HTMLLoader
 Inheritedvisible : Boolean
Whether or not the display object is visible.
DisplayObject
 InheritedAIR-only width : Number
[override] Specifies the width of the rectangle of the HTML canvas that is being rendered.
HTMLLoader
 InheritedAIR-only window : Object
[read-only] The global JavaScript object for the content loaded into the HTML control.
HTMLLoader
 Inheritedx : Number
Indicates the x coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer.
DisplayObject
 Inheritedy : Number
Indicates the y coordinate of the DisplayObject instance relative to the local coordinates of the parent DisplayObjectContainer.
DisplayObject
 Inheritedz : Number
Indicates the z coordinate position along the z-axis of the DisplayObject instance relative to the 3D parent container.
DisplayObject
Public Methods
 MethodDefined By
  
Constructor.
FlexHTMLLoader
 Inherited
Adds a child DisplayObject instance to this DisplayObjectContainer instance.
DisplayObjectContainer
 Inherited
Adds a child DisplayObject instance to this DisplayObjectContainer instance.
DisplayObjectContainer
 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.
EventDispatcher
 Inherited
Indicates whether the security restrictions would cause any display objects to be omitted from the list returned by calling the DisplayObjectContainer.getObjectsUnderPoint() method with the specified point point.
DisplayObjectContainer
  
AIR-only assignFocus(direction:String):void
Called by the FocusManager when the component receives focus.
FlexHTMLLoader
 Inherited
Cancels any load operation in progress.
HTMLLoader
 Inherited
Determines whether the specified display object is a child of the DisplayObjectContainer instance or the instance itself.
DisplayObjectContainer
 Inherited
AIR-only createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader
[static] Creates a new NativeWindow object that contains an HTMLLoader object.
HTMLLoader
 Inherited
Dispatches an event into the event flow.
EventDispatcher
  
AIR-only drawFocus(isFocused:Boolean):void
Called by the FocusManager when the component receives focus.
FlexHTMLLoader
 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.
DisplayObject
 Inherited
Returns the child display object instance that exists at the specified index.
DisplayObjectContainer
 Inherited
Returns the child display object that exists with the specified name.
DisplayObjectContainer
 Inherited
Returns the index position of a child DisplayObject instance.
DisplayObjectContainer
 Inherited
Returns the history entry at the specified position.
HTMLLoader
 Inherited
Returns an array of objects that lie under the specified point and are children (or grandchildren, and so on) of this DisplayObjectContainer instance.
DisplayObjectContainer
 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.
DisplayObject
 Inherited
Converts the point object from the Stage (global) coordinates to the display object's (local) coordinates.
DisplayObject
 Inherited
Converts a two-dimensional point from the Stage (global) coordinates to a three-dimensional display object's (local) coordinates.
DisplayObject
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Navigates back in the browser history, if possible.
HTMLLoader
 Inherited
Navigates forward in the browser history, if possible.
HTMLLoader
 Inherited
AIR-only historyGo(steps:int):void
Navigates the specified number of steps in the browser history.
HTMLLoader
 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.
DisplayObject
 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.
DisplayObject
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
AIR-only load(urlRequestToLoad:URLRequest):void
Loads the HTMLLoader object with data from the site specified by the urlRequestToLoad parameter.
HTMLLoader
 Inherited
AIR-only loadString(htmlContent:String):void
Loads the HTMLLoader object with the HTML content contained in the HTML string.
HTMLLoader
 Inherited
Converts a three-dimensional point of the three-dimensional display object's (local) coordinates to a two-dimensional point in the Stage (global) coordinates.
DisplayObject
 Inherited
Converts the point object from the display object's (local) coordinates to the Stage (global) coordinates.
DisplayObject
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Reloads the page from the current location.
HTMLLoader
 Inherited
Removes the specified child DisplayObject instance from the child list of the DisplayObjectContainer instance.
DisplayObjectContainer
 Inherited
Removes a child DisplayObject from the specified index position in the child list of the DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
 Inherited
Changes the position of an existing child in the display object container.
DisplayObjectContainer
  
Called by the FocusManager when the component receives focus.
FlexHTMLLoader
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Lets the user drag the specified sprite.
Sprite
 Inherited
Ends the startDrag() method.
Sprite
 Inherited
Swaps the z-order (front-to-back order) of the two specified child objects.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Swaps the z-order (front-to-back order) of the child objects at the two specified index positions in the child list.
DisplayObjectContainer
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
  
[override] Returns a string indicating the location of this object within the hierarchy of DisplayObjects in the Application.
FlexHTMLLoader
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Events
 Event Summary Defined By
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.EventDispatcher
 InheritedDispatched when a display object is added to the display list.DisplayObject
 InheritedDispatched when a display object is added to the on stage display list, either directly or through the addition of a sub tree in which the display object is contained.DisplayObject
 InheritedDispatched when the user selects 'Clear' (or 'Delete') from the text context menu.InteractiveObject
 InheritedDispatched when a user presses and releases the main button of the user's pointing device over the same InteractiveObject.InteractiveObject
 InheritedSignals that the last load operation requested by loadString or load method has completed.HTMLLoader
 InheritedDispatched when a user gesture triggers the context menu associated with this interactive object in an AIR application.InteractiveObject
 InheritedDispatched when the user activates the platform specific accelerator key combination for a copy operation or selects 'Copy' from the text context menu.InteractiveObject
 InheritedDispatched when the user activates the platform specific accelerator key combination for a cut operation or selects 'Cut' from the text context menu.InteractiveObject
 Inherited[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.EventDispatcher
 InheritedDispatched when a user presses and releases the main button of a pointing device twice in rapid succession over the same InteractiveObject when that object's doubleClickEnabled flag is set to true.InteractiveObject
 Inherited[broadcast event] Dispatched when the playhead is entering a new frame.DisplayObject
 Inherited[broadcast event] Dispatched when the playhead is exiting the current frame.DisplayObject
 InheritedDispatched after a display object gains focus.InteractiveObject
 InheritedDispatched after a display object loses focus.InteractiveObject
 Inherited[broadcast event] Dispatched after the constructors of frame display objects have run but before frame scripts have run.DisplayObject
 InheritedSignals that one or both of the contentWidth and contentHeight properties of the HTMLLoader object has changed.HTMLLoader
 InheritedSignals that the HTML DOM has been created in response to a load operation.HTMLLoader
 InheritedSignals that the rendering of content in the HTMLLoader object is fully up to date.HTMLLoader
 InheritedDispatched when the user presses a key.InteractiveObject
 InheritedDispatched when the user attempts to change focus by using keyboard navigation.InteractiveObject
 InheritedDispatched when the user releases a key.InteractiveObject
 InheritedSignals that the location property of the HTMLLoader object has changed.HTMLLoader
 InheritedDispatched when a user presses and releases the middle button of the user's pointing device over the same InteractiveObject.InteractiveObject
 InheritedDispatched when a user presses the middle pointing device button over an InteractiveObject instance.InteractiveObject
 InheritedDispatched when a user releases the pointing device button over an InteractiveObject instance.InteractiveObject
 InheritedDispatched when a user presses the pointing device button over an InteractiveObject instance.InteractiveObject
 InheritedDispatched when the user attempts to change focus by using a pointer device.InteractiveObject
 InheritedDispatched when a user moves the pointing device while it is over an InteractiveObject.InteractiveObject
 InheritedDispatched when the user moves a pointing device away from an InteractiveObject instance.InteractiveObject
 InheritedDispatched when the user moves a pointing device over an InteractiveObject instance.InteractiveObject
 InheritedDispatched when a user releases the pointing device button over an InteractiveObject instance.InteractiveObject
 InheritedDispatched when a mouse wheel is spun over an InteractiveObject instance.InteractiveObject
 InheritedDispatched by the drag initiator InteractiveObject when the user releases the drag gesture.InteractiveObject
 InheritedDispatched by the target InteractiveObject when a dragged object is dropped on it and the drop has been accepted with a call to DragManager.acceptDragDrop().InteractiveObject
 InheritedDispatched by an InteractiveObject when a drag gesture enters its boundary.InteractiveObject
 InheritedDispatched by an InteractiveObject when a drag gesture leaves its boundary.InteractiveObject
 InheritedDispatched by an InteractiveObject continually while a drag gesture remains within its boundary.InteractiveObject
 InheritedDispatched at the beginning of a drag operation by the InteractiveObject that is specified as the drag initiator in the DragManager.doDrag() call.InteractiveObject
 InheritedDispatched during a drag operation by the InteractiveObject that is specified as the drag initiator in the DragManager.doDrag() call.InteractiveObject
 InheritedDispatched when the user activates the platform specific accelerator key combination for a paste operation or selects 'Paste' from the text context menu.InteractiveObject
 InheritedDispatched when a display object is about to be removed from the display list.DisplayObject
 InheritedDispatched when a display object is about to be removed from the display list, either directly or through the removal of a sub tree in which the display object is contained.DisplayObject
 Inherited[broadcast event] Dispatched when the display list is about to be updated and rendered.DisplayObject
 InheritedDispatched when a user presses and releases the right button of the user's pointing device over the same InteractiveObject.InteractiveObject
 InheritedDispatched when a user presses the pointing device button over an InteractiveObject instance.InteractiveObject
 InheritedDispatched when a user releases the pointing device button over an InteractiveObject instance.InteractiveObject
 InheritedDispatched when the user moves a pointing device away from an InteractiveObject instance.InteractiveObject
 InheritedDispatched when the user moves a pointing device over an InteractiveObject instance.InteractiveObject
 InheritedSignals that the scrollH or scrollV property has been changed by the HTMLLoader object.HTMLLoader
 InheritedDispatched when the user activates the platform specific accelerator key combination for a select all operation or selects 'Select All' from the text context menu.InteractiveObject
 InheritedDispatched when the value of the object's tabChildren flag changes.InteractiveObject
 InheritedDispatched when the object's tabEnabled flag changes.InteractiveObject
 InheritedDispatched when the value of the object's tabIndex property changes.InteractiveObject
 InheritedDispatched when a user enters one or more characters of text.InteractiveObject
 InheritedSignals that an uncaught JavaScript exception occurred in the HTMLLoader object.HTMLLoader
Property Detail

enableIME

property
enableIME:Boolean  [read-only]

Language Version: ActionScript 3.0
Product Version: Flex 4
Runtime Versions: Flash Player 10, AIR 1.5

A flag that indicates whether the IME should be enabled when the component receives focus.



Implementation
    public function get enableIME():Boolean
AIR-only 

focusEnabled

property 
focusEnabled:Boolean

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

A flag that indicates whether the component can receive focus when selected.

As an optimization, if a child component in your component implements the IFocusManagerComponent interface, and you never want it to receive focus, you can set focusEnabled to false before calling addChild() on the child component.

This will cause the FocusManager to ignore this component and not monitor it for changes to the tabFocusEnabled, tabChildren, and mouseFocusEnabled properties. This also means you cannot change this value after addChild() and expect the FocusManager to notice.

Note: It does not mean that you cannot give this object focus programmatically in your setFocus() method; it just tells the FocusManager to ignore this IFocusManagerComponent component in the Tab and mouse searches.



Implementation
    public function get focusEnabled():Boolean
    public function set focusEnabled(value:Boolean):void
AIR-only 

hasFocusableChildren

property 
hasFocusableChildren:Boolean

Language Version: ActionScript 4.0
Product Version: Flex 4
Runtime Versions: AIR 1.5

A flag that indicates whether child objects can receive focus.

Note: This property is similar to the tabChildren property used by Flash Player. Use the hasFocusableChildren property with Flex applications. Do not use the tabChildren property.

This property is usually false because most components either receive focus themselves or delegate focus to a single internal sub-component and appear as if the component has received focus. For example, a TextInput control contains a focusable child RichEditableText control, but while the RichEditableText sub-component actually receives focus, it appears as if the TextInput has focus. TextInput sets hasFocusableChildren to false because TextInput is considered the component that has focus. Its internal structure is an abstraction.

Usually only navigator components, such as TabNavigator and Accordion, have this flag set to true because they receive focus on Tab but focus goes to components in the child containers on further Tabs.

The default value is false, except for the spark.components.Scroller component. For that component, the default value is true.

The default value is false.

This property can be used as the source for data binding. When this property is modified, it dispatches the hasFocusableChildrenChange event.



Implementation
    public function get hasFocusableChildren():Boolean
    public function set hasFocusableChildren(value:Boolean):void

imeMode

property 
imeMode:String

This is just a stub to support the interface. The parent mx.controls.HTML contains the conversionMode and applies it.



Implementation
    public function get imeMode():String
    public function set imeMode(value:String):void
AIR-only 

mouseFocusEnabled

property 
mouseFocusEnabled:Boolean

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

Whether the component can receive focus when clicked on. If false, focus will be transferred to the first parent that is mouseFocusEnable set to true.

The default value is true.



Implementation
    public function get mouseFocusEnabled():Boolean
    public function set mouseFocusEnabled(value:Boolean):void
AIR-only 

tabFocusEnabled

property 
tabFocusEnabled:Boolean

Language Version: ActionScript 4.0
Product Version: Flex 4
Runtime Versions: AIR 1.5

A flag that indicates whether child objects can receive focus

This is similar to the tabEnabled property used by the Flash Player.

This is usually true for components that handle keyboard input, but some components in controlbars have them set to false because they should not steal focus from another component like an editor.

The default value is true.

This property can be used as the source for data binding. When this property is modified, it dispatches the tabFocusEnabledChange event.



Implementation
    public function get tabFocusEnabled():Boolean
    public function set tabFocusEnabled(value:Boolean):void
Constructor Detail
AIR-only 

FlexHTMLLoader

()Constructor
public function FlexHTMLLoader()

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

Constructor.

Sets the name property to a string returned by the createUniqueName() method of the mx.utils.NameUtils class.

This string is the name of the object's class concatenated with an integer that is unique within the application, such as "FlexLoader13".

See also

flash.display.DisplayObject.name
mx.utils.NameUtils.createUniqueName()
Method Detail

AIR-only assignFocus

()method
public function assignFocus(direction:String):void

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

Called by the FocusManager when the component receives focus. The component may in turn set focus to an internal component. The component's setFocus() method will still be called when focused by the mouse, but this method will be used when focus changes via the keyboard.

Parameters

direction:String — one of flash.display.FocusDirection

AIR-only drawFocus

()method 
public function drawFocus(isFocused:Boolean):void

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

Called by the FocusManager when the component receives focus. The component should draw or hide a graphic that indicates that the component has focus.

Parameters

isFocused:Boolean — If true, draw the focus indicator, otherwise hide it.

AIR-only setFocus

()method 
public function setFocus():void

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

Called by the FocusManager when the component receives focus. The component may in turn set focus to an internal component.

AIR-only toString

()method 
override public function toString():String

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: AIR 1.1

Returns a string indicating the location of this object within the hierarchy of DisplayObjects in the Application. This string, such as "MyApp0.HBox5.FlexLoader13", is built by the displayObjectToString() method of the mx.utils.NameUtils class from the name property of the object and its ancestors.

Returns
String — A String indicating the location of this object within the DisplayObject hierarchy.

See also

flash.display.DisplayObject.name
mx.utils.NameUtils.displayObjectToString()