| Pacote | flash.html |
| Classe | public class HTMLLoader |
| Herança | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Notes about the dimensions of HTMLLoader object:
width
and height properties to make the HTMLLoader object visible.width or height of an HTMLLoader is 2880.
Setting width or height of an HTMLLoader object to a number greater than
2880 results in an ArgumentError exception being thrown.| Propriedade | Definido por | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
The current accessibility options for this display object.
| DisplayObject | |
| alpha : Number
Indicates the alpha transparency value of the object specified.
| DisplayObject | |
| authenticate : Boolean
Specifies whether authentication requests should be handled (true
or not (false) for this HTTP requests issued by this object.
| HTMLLoader | ||
| blendMode : String
A value from the BlendMode class that specifies which blend mode to use.
| DisplayObject | |
| buttonMode : Boolean
Specifies the button mode of this sprite.
| Sprite | |
| cacheAsBitmap : Boolean
If set to true, Flash Player or the Adobe Integrated Runtime (AIR) caches an internal bitmap representation of the
display object.
| DisplayObject | |
| cacheResponse : Boolean
Specifies whether successful response data should be cached for HTTP requests issued by this object.
| HTMLLoader | ||
| constructor : Object
A reference to the class object or constructor function for a given object instance.
| Object | |
| contentHeight : Number
[read-only]
The height, in pixels, of the HTML content.
| HTMLLoader | ||
| contentWidth : Number
[read-only]
The width, in pixels, of the HTML content.
| HTMLLoader | ||
| contextMenu : NativeMenu
Specifies the context menu associated with this object.
| InteractiveObject | |
| doubleClickEnabled : Boolean
Specifies whether the object receives doubleClick events.
| InteractiveObject | |
| dropTarget : DisplayObject
[read-only]
Specifies the display object over which the sprite is being dragged, or on
which the sprite was dropped.
| Sprite | |
| filters : Array
An indexed array that contains each filter object currently associated with the display object.
| DisplayObject | |
| focusRect : Object
Specifies whether this object displays a focus rectangle.
| InteractiveObject | |
| graphics : Graphics
[read-only]
Specifies the Graphics object that belongs to this sprite where vector
drawing commands can occur.
| Sprite | |
| hasFocusableContent : Boolean
[read-only]
| HTMLLoader | ||
| height : Number
Specifies the height of the rectangle of the HTML canvas that is being rendered.
| HTMLLoader | ||
| historyLength : uint
[read-only]
The overall length of the history list, including back and forward entries.
| HTMLLoader | ||
| historyPosition : uint
The current position in the history list.
| HTMLLoader | ||
| hitArea : Sprite
Designates another sprite to serve as the hit area for a sprite.
| Sprite | |
| htmlHost : 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 | ||
| 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.
| HTMLLoader | ||
| loaderInfo : LoaderInfo
[read-only]
Returns a LoaderInfo object containing information about loading the file
to which this display object belongs.
| DisplayObject | |
| location : String
[read-only]
The URL for the content loaded in the HTMLLoader object.
| HTMLLoader | ||
| manageCookies : Boolean
Specifies whether the HTTP protocol stack should manage cookies for this
object.
| HTMLLoader | ||
| mask : DisplayObject
The calling display object is masked by the specified mask object.
| DisplayObject | |
| mouseChildren : Boolean
Determines whether or not the children of the object are mouse enabled.
| DisplayObjectContainer | |
| mouseEnabled : Boolean
Specifies whether this object receives mouse messages.
| InteractiveObject | |
| mouseX : Number
[read-only]
Indicates the x coordinate of the mouse position, in pixels.
| DisplayObject | |
| mouseY : Number
[read-only]
Indicates the y coordinate of the mouse position, in pixels.
| DisplayObject | |
| name : String
Indicates the instance name of the DisplayObject.
| DisplayObject | |
| numChildren : int
[read-only]
Returns the number of children of this object.
| DisplayObjectContainer | |
| opaqueBackground : Object
Specifies whether the display object is opaque with a certain background color.
| DisplayObject | |
| paintsDefaultBackground : Boolean
Determines whether the background of the HTMLLoader document is opaque white (true) or
not (false).
| HTMLLoader | ||
| parent : DisplayObjectContainer
[read-only]
Indicates the DisplayObjectContainer object that contains this display object.
| DisplayObject | |
| pdfCapability : int
[static] [read-only]
The type of PDF support on the user's system, defined as an integer code value.
| HTMLLoader | ||
| prototype : Object
[static]
A reference to the prototype object of a class or function object.
| Object | |
| root : 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 | |
| rotation : Number
Indicates the rotation of the DisplayObject instance, in degrees, from its original orientation.
| DisplayObject | |
| runtimeApplicationDomain : ApplicationDomain
The application domain to use for the window.runtime
object in JavaScript in the HTML page.
| HTMLLoader | ||
| scale9Grid : Rectangle
The current scaling grid that is in effect.
| DisplayObject | |
| scaleX : Number
Indicates the horizontal scale (percentage) of the object as applied from the registration point.
| DisplayObject | |
| scaleY : Number
Indicates the vertical scale (percentage) of an object as applied from the registration point of the object.
| DisplayObject | |
| scrollH : Number
The horizonal scroll position of the HTML content within the HTMLLoader object.
| HTMLLoader | ||
| scrollRect : Rectangle
The scroll rectangle bounds of the display object.
| DisplayObject | |
| scrollV : Number
The vertical scroll position of the HTML content within the HTMLLoader object.
| HTMLLoader | ||
| soundTransform : SoundTransform
Controls sound within this sprite.
| Sprite | |
| stage : Stage
[read-only]
The Stage of the display object.
| DisplayObject | |
| tabChildren : Boolean
Determines whether the children of the object are tab enabled.
| DisplayObjectContainer | |
| tabEnabled : Boolean
Specifies whether this object is in the tab order.
| InteractiveObject | |
| tabIndex : int
Specifies the tab ordering of objects in a SWF file.
| InteractiveObject | |
| textEncodingOverride : String
The character set used by the HTMLLoader content.
| HTMLLoader | ||
| textSnapshot : TextSnapshot
[read-only]
Returns a TextSnapshot object for this DisplayObjectContainer instance.
| DisplayObjectContainer | |
| transform : Transform
An object with properties pertaining to a display object's matrix, color transform, and pixel bounds.
| DisplayObject | |
| useCache : Boolean
Specifies whether the local cache should be consulted before HTTP requests issued by this object
fetche data.
| HTMLLoader | ||
| useHandCursor : 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 | |
| userAgent : String
The user agent string to be used in any upcoming content requests from this HTMLLoader
object.
| HTMLLoader | ||
| visible : Boolean
Whether or not the display object is visible.
| DisplayObject | |
| width : Number
Specifies the width of the rectangle of the HTML canvas that is being rendered.
| HTMLLoader | ||
| window : JavaScriptObject
[read-only]
The global JavaScript object for the content loaded into the HTML control.
| HTMLLoader | ||
| x : Number
Indicates the x coordinate of the DisplayObject instance relative to the local coordinates of
the parent DisplayObjectContainer.
| DisplayObject | |
| y : Number
Indicates the y coordinate of the DisplayObject instance relative to the local coordinates of
the parent DisplayObjectContainer.
| DisplayObject | |
| Método | Definido por | ||
|---|---|---|---|
|
Creates an HTMLLoader object.
| HTMLLoader | ||
|
Adds a child DisplayObject instance to this DisplayObjectContainer instance.
| DisplayObjectContainer | |
|
Adds a child DisplayObject instance to this DisplayObjectContainer
instance.
| DisplayObjectContainer | |
|
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 | |
|
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 | |
|
Cancels any load operation in progress.
| HTMLLoader | ||
|
Determines whether the specified display object is a child of the DisplayObjectContainer instance or
the instance itself.
| DisplayObjectContainer | |
|
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):HTMLLoader
[static]
Creates a new NativeWindow object that contains an HTMLLoader object.
| HTMLLoader | ||
|
Dispatches an event into the event flow.
| EventDispatcher | |
|
Returns a rectangle that defines the area of the display object relative to the coordinate system
of the targetCoordinateSpace object.
| DisplayObject | |
|
Returns the child display object instance that exists at the specified index.
| DisplayObjectContainer | |
|
Returns the child display object that exists with the specified name.
| DisplayObjectContainer | |
|
Returns the index position of a child DisplayObject instance.
| DisplayObjectContainer | |
|
Returns the history entry at the specified position.
| HTMLLoader | ||
|
Returns an array of objects that lie under the specified point and are children
(or grandchildren, and so on) of this DisplayObjectContainer instance.
| DisplayObjectContainer | |
|
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 | |
|
Converts the point object from the Stage (global) coordinates
to the display object's (local) coordinates.
| DisplayObject | |
|
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event.
| EventDispatcher | |
|
Indicates whether an object has a specified property defined.
| Object | |
|
Navigates back in the browser history, if possible.
| HTMLLoader | ||
|
Navigates forward in the browser history, if possible.
| HTMLLoader | ||
|
Navigates the indicated number of steps in the browser history.
| HTMLLoader | ||
|
Evaluates the display object to see if it overlaps or intersects with the
obj display object.
| DisplayObject | |
|
Evaluates the display object to see if it overlaps or intersects with the
point specified by the x and y parameters.
| DisplayObject | |
|
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter.
| Object | |
|
Loads the HTMLLoader object with data from the site specified by the urlRequestToLoad parameter.
| HTMLLoader | ||
|
Loads the HTMLLoader object with the HTML content contained in the HTML string.
| HTMLLoader | ||
|
Converts the point object from the display object's (local) coordinates to the
Stage (global) coordinates.
| DisplayObject | |
|
Indicates whether the specified property exists and is enumerable.
| Object | |
|
Reloads the page from the current location.
| HTMLLoader | ||
|
Removes the specified child DisplayObject instance from the child list of the DisplayObjectContainer instance.
| DisplayObjectContainer | |
|
Removes a child DisplayObject from the specified index position in the child list of
the DisplayObjectContainer.
| DisplayObjectContainer | |
|
Removes a listener from the EventDispatcher object.
| EventDispatcher | |
|
Changes the position of an existing child in the display object container.
| DisplayObjectContainer | |
|
Sets the availability of a dynamic property for loop operations.
| Object | |
|
Lets the user drag the specified sprite.
| Sprite | |
|
Ends the startDrag() method.
| Sprite | |
|
Swaps the z-order (front-to-back order) of the two specified child objects.
| DisplayObjectContainer | |
|
Swaps the z-order (front-to-back order) of the child objects at the two specified index positions in the
child list.
| DisplayObjectContainer | |
|
Returns the string representation of the specified object.
| Object | |
|
Returns the primitive value of the specified object.
| Object | |
|
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type.
| EventDispatcher | |
| Evento | Descrição | Definido por | ||
|---|---|---|---|---|
| Dispatched when Flash Player or the and AIR application gains operating system focus and becomes active. | EventDispatcher | ||
| Dispatched when a display object is added to the display list. | DisplayObject | ||
| Dispatched 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 | ||
| Dispatched when a user presses and releases the main button of the user's pointing device over the same InteractiveObject. | InteractiveObject | ||
| Signals that the last load operation requested by loadString or load has completed. | HTMLLoader | |||
| Dispatched when Flash Player loses operating system focus and is becoming inactive. | EventDispatcher | ||
| Dispatched 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 | ||
| Dispatched when the playhead is entering a new frame. | DisplayObject | ||
| Dispatched after a display object gains focus. | InteractiveObject | ||
| Dispatched after a display object loses focus. | InteractiveObject | ||
| Signals the one or both of the contentWidth and contentHeight properties have changed. | HTMLLoader | |||
| Signals that the HTML DOM has be created in response to a load operation. | HTMLLoader | |||
| Signals that the rendering of content in the HTMLLoader object is fully up-to-date. | HTMLLoader | |||
| Dispatched when the user presses a key. | InteractiveObject | ||
| Dispatched when the user attempts to change focus by using keyboard navigation. | InteractiveObject | ||
| Dispatched when the user releases a key. | InteractiveObject | ||
| Signals that the location property of the HTMLLoader object has changed. | HTMLLoader | |||
| Dispatched when a user presses the pointing device button over an InteractiveObject instance. | InteractiveObject | ||
| Dispatched when the user attempts to change focus by using a pointer device. | InteractiveObject | ||
| Dispatched when a user moves the pointing device while it is over an InteractiveObject. | InteractiveObject | ||
| Dispatched when the user moves a pointing device away from an InteractiveObject instance. | InteractiveObject | ||
| Dispatched when the user moves a pointing device over an InteractiveObject instance. | InteractiveObject | ||
| Dispatched when a user releases the pointing device button over an InteractiveObject instance. | InteractiveObject | ||
| Dispatched when a mouse wheel is spun over an InteractiveObject instance. | InteractiveObject | ||
| Dispatched by the drag initiator DisplayObject when the user releases the drag gesture. | DisplayObject | ||
| Dispatched by the target DisplayObject when a dragged object is dropped on it and the drop has been accepted with a call to DragManager.acceptDragDrop(). | DisplayObject | ||
| Dispatched by a DisplayObject when a drag gesture enters its boundary. | DisplayObject | ||
| Dispatched by a DisplayObject when a drag gesture leaves its boundary. | DisplayObject | ||
| Dispatched by a DisplayObject continually while a drag gesture remains within its boundary. | DisplayObject | ||
| Dispatched at the beginning of a drag operation by the DisplayObject that is specified as the drag initiator in the DragManager.doDrag() call. | DisplayObject | ||
| Dispatched when a display object is about to be removed from the display list. | DisplayObject | ||
| Dispatched 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 | ||
| Dispatched when the display list is about to be updated and rendered. | DisplayObject | ||
| Dispatched when the user moves a pointing device away from an InteractiveObject instance. | InteractiveObject | ||
| Dispatched when the user moves a pointing device over an InteractiveObject instance. | InteractiveObject | ||
| Signals that the scrollH or scrollV property have been changed by the HTMLLoader. | HTMLLoader | |||
| Dispatched when the value of the object's tabChildren flag changes. | InteractiveObject | ||
| Dispatched when the object's tabEnabled flag changes. | InteractiveObject | ||
| Dispatched when the value of the object's tabIndex property changes. | InteractiveObject | ||
| Signals that an uncaught JavaScript exception occurred in the HTMLLoader. | HTMLLoader | |||
| authenticate | propriedade |
Esconder Propriedades Públicas Herdadas
Exibir Propriedades Públicas Herdadasauthenticate:Boolean [read-write]
Specifies whether authentication requests should be handled (true
or not (false) for this HTTP requests issued by this object. If false, authentication
challenges return an HTTP error.
The default value is initialized from URLRequestDefaults.authenticate.
public function get authenticate():Boolean
public function set authenticate(value:Boolean):void
Veja também
| cacheResponse | propriedade |
cacheResponse:Boolean [read-write] Specifies whether successful response data should be cached for HTTP requests issued by this object.
The default value is initialized from URLRequestDefaults.cacheResponse.
public function get cacheResponse():Boolean
public function set cacheResponse(value:Boolean):void
Veja também
| contentHeight | propriedade |
contentHeight:Number [read-only] The height, in pixels, of the HTML content.
public function get contentHeight():Number
| contentWidth | propriedade |
contentWidth:Number [read-only] The width, in pixels, of the HTML content.
public function get contentWidth():Number
| hasFocusableContent | propriedade |
hasFocusableContent:Boolean [read-only] public function get hasFocusableContent():Boolean
| height | propriedade |
height:Number [read-write]
Specifies the height of the rectangle of the HTML canvas that is being rendered.
This is the height of the HTMLLoader DisplayObject in pixels.
Changing this property will cause the HTMLLoader to re-render the HTML document.
HTML_BOUNDS_CHANGE events may dispatched in response to changing this property.
When you set the width and
height property of an HTMLLoader object, the bounds of the object change but
content is not scaled (as would happen with other types of display objects).
public function get height():Number
public function set height(value:Number):void
| historyLength | propriedade |
historyLength:uint [read-only]
The overall length of the history list, including back and forward entries.
This property has the same value as the window.history.length
JavaScript property of the the HTML page.
public function get historyLength():uint
Veja também
| historyPosition | propriedade |
historyPosition:uint [read-write]
The current position in the history list. The history list corresponds to the
window.history object of the HTML page.
Entries less than the current position are the "back" list; entries greater are "forward."
Attempts to set position beyond the end will set it to the end.
public function get historyPosition():uint
public function set historyPosition(value:uint):void
Veja também
| htmlHost | propriedade |
htmlHost:HTMLHost [read-write]
The HTMLHost object used to handle changes to certain user interface elements, such as the
window.document.title property of the HTMLLoader object. To override default
behaviors for the HTMLLoader, create a subclass of the HTMLHost class, and override its member
functions to handle various user interface changes in the HTML content.
public function get htmlHost():HTMLHost
public function set htmlHost(value:HTMLHost):void
Veja também
| loaded | propriedade |
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. This property will be true before the COMPLETE event is dispatched. It is possible that this property will never become true. This happens in the same cases as when the COMPLETE event is never dispatched.
public function get loaded():Boolean
| location | propriedade |
location:String [read-only] The URL for the content loaded in the HTMLLoader object.
public function get location():String
| manageCookies | propriedade |
manageCookies:Boolean [read-write]
Specifies whether the HTTP protocol stack should manage cookies for this
object. When true, cookies are added to the request
and response cookies are remembered. If false, cookies are
not added to the request and response cookies are not
remembered.
The default value is initialized from URLRequestDefaults.manageCookies.
public function get manageCookies():Boolean
public function set manageCookies(value:Boolean):void
Veja também
| paintsDefaultBackground | propriedade |
paintsDefaultBackground:Boolean [read-write]
Determines whether the background of the HTMLLoader document is opaque white (true) or
not (false). With this property set to false, the HTMLLoader
object uses its display object container as a background for the HTML and it use the opacity
(alpha value) of the display object container as the HTML background. However, if
the body element or any other element of the HTML document has an opaque background
color (specified by style="background-color:gray", for instance), then that portion
of the rendered HTML will use the specified opaque background color.
public function get paintsDefaultBackground():Boolean
public function set paintsDefaultBackground(value:Boolean):void
| pdfCapability | propriedade |
pdfCapability:int [read-only]
The type of PDF support on the user's system, defined as an integer code value.
An HTMLConrol can display PDF content only if this property evaluates to
PDFCapability.STATUS_OK. The PDFCapability class defines constants
for possible values of the pdfCapability property, as follows:
| PDFCapability constant | Meaning |
|---|---|
STATUS_OK | A sufficient version (8.1 or later) of Acrobat Reader is detected and PDF content
can be loaded in an HTMLLoader object.
Note: On Windows, if a Acrobat Acrobat or Acrobat Reader version 7.x or above,
is currently running on the user's system, that version is used even if a later version
that supports loading PDF loaded in an HTMLLoader object is installed. In this case,
if the the value of the |
ERROR_INSTALLED_READER_NOT_FOUND | No version of Acrobat Reader is detected. An HTMLConrol object cannot display PDF content. |
ERROR_INSTALLED_READER_TOO_OLD | Acrobat Reader has been detected, but the version is too old. An HTMLConrol object cannot display PDF content. |
ERROR_PREFERED_READER_TOO_OLD | A sufficient version (8.1 or later) of Acrobat Reader is detected, but the the version of Acrobat Reader that is setup to handle PDF content is older than Reader 8.1. An HTMLConrol object cannot display PDF content. |
public static function get pdfCapability():int
| runtimeApplicationDomain | propriedade |
runtimeApplicationDomain:ApplicationDomain [read-write]
The application domain to use for the window.runtime
object in JavaScript in the HTML page.
If null, or if the HTML content is from a different security domain than
the SWF content that contains the HTMLLoader object, the page will use a default
application domain for the page's domain.
public function get runtimeApplicationDomain():ApplicationDomain
public function set runtimeApplicationDomain(value:ApplicationDomain):void
SecurityError — if the ApplicationDomain object is not from the
caller's security domain.
|
Veja também
| scrollH | propriedade |
scrollH:Number [read-write] The horizonal scroll position of the HTML content within the HTMLLoader object.
public function get scrollH():Number
public function set scrollH(value:Number):void
| scrollV | propriedade |
scrollV:Number [read-write] The vertical scroll position of the HTML content within the HTMLLoader object.
public function get scrollV():Number
public function set scrollV(value:Number):void
| textEncodingOverride | propriedade |
textEncodingOverride:String [read-write]
The character set used by the HTMLLoader content. The specified character set overrides any setting
specified in a meta tag in the HTML content, such as the following:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
public function get textEncodingOverride():String
public function set textEncodingOverride(value:String):void
| useCache | propriedade |
useCache:Boolean [read-write] Specifies whether the local cache should be consulted before HTTP requests issued by this object fetche data.
The default value is initialized from URLRequestDefaults.useCache.
public function get useCache():Boolean
public function set useCache(value:Boolean):void
Veja também
| userAgent | propriedade |
userAgent:String [read-write] The user agent string to be used in any upcoming content requests from this HTMLLoader object.
To set the user agent string, set the userAgent property of the HTMLLoader
object before calling the load() method. The userAgent
property of the URLRequest passed to the load() method is not used.
You can set the default user agent string used by all HTMLLoader objects in an application
domain by setting the URLRequestDefaults.userAgent property. If no value
is set for the userAgent property of the HTMLLoader (or if the value
is set to null), the user agent string is set the value of the static
URLRequestDefaults.userAgent property.
If a value is set for neither the userAgent property of the HTMLLoader nor for
URLRequestDefaults.userAgent, a default value is used as the user agent string.
This default value varies depending on the runtime operating system (such as Mac OS or Windows),
the runtime language, and the runtime version, as in the following two examples:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) Safari/419.3 Apollo/1.0""Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) Safari/419.3 Apollo/1.0" public function get userAgent():String
public function set userAgent(value:String):void
Veja também
| width | propriedade |
width:Number [read-write]
Specifies the width of the rectangle of the HTML canvas that is being rendered.
This is the width of the HTMLLoader DisplayObject in pixels.
Changing this property will cause the HTMLLoader to re-render the HTML document.
HTML_BOUNDS_CHANGE events may dispatched in response to changing this property.
When you set the width and
height property of an HTMLLoader object, the bounds of the object change but
content is not scaled (as would happen with other types of display objects).
public function get width():Number
public function set width(value:Number):void
| window | propriedade |
window:JavaScriptObject [read-only] The global JavaScript object for the content loaded into the HTML control.
public function get window():JavaScriptObject
| HTMLLoader | () | Construtor |
public function HTMLLoader()
Creates an HTMLLoader object.
| cancelLoad | () | método |
public function cancelLoad():void
Cancels any load operation in progress.
| createRootWindow | () | método |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):HTMLLoader
Creates a new NativeWindow object that contains an HTMLLoader object. Use the HTMLLoader object that is returned by this method to load HTML content.
By default (when you set no parameters in calling this method), the new window uses standard system chrome and includes scrollbar controls for the content. You can set the parameters to change the properties of the new window.
Parâmetros
visible:Boolean (default = true) |
|
windowInitOptions:NativeWindowInitOptions (default = null)null uses default
NativeWindowInitOptions values.
|
|
scrollBarsVisible:Boolean (default = true) |
|
bounds:Rectangle (default = null)x, y,
width, or height is NaN, then the corresponding dimension of the window is
left with its default value.
|
HTMLLoader — A new HTMLLoader object that is on the stage of the a new NativeWindow object.
|
| getHistoryAt | () | método |
public function getHistoryAt(position:uint):HTMLHistoryItem
Returns the history entry at the specified position.
Parâmetros
position:uint — The position in the history list.
|
HTMLHistoryItem — A URLRequest object for the history entry at the specified position.
|
Veja também
| historyBack | () | método |
public function historyBack():void
Navigates back in the browser history, if possible.
Calling this method of the HTMLLoader object has the same effect
as calling the back() method of the window.history
property in JavaScript in the HTML page.
This function throws no errors.
Veja também
| historyForward | () | método |
public function historyForward():void
Navigates forward in the browser history, if possible.
Calling this method of the HTMLLoader object has the same effect
as calling the forward() method of the window.history
property in JavaScript in the HTML page.
This function throws no errors.
Veja também
| historyGo | () | método |
public function historyGo(steps:int):void
Navigates the indicated number of steps in the browser history. Navigates forward if positive, backward if negative. Navigation by zero forces a reload.
This method is equivalent to calling the go() method of
the window.history property in JavaScript in the HTML page.
This function throws no errors.
Parâmetros
steps:int — The number of steps in the history list to move
forward (positive) or backward (negative).
|
Veja também
| load | () | método |
public function load(urlRequestToLoad:URLRequest):void
Loads the HTMLLoader object with data from the site specified by the urlRequestToLoad parameter.
Calling this method initially sets the loaded property to false. This method
initiates an operation that always completes asynchronously.
A call to this method implicitly cancels any pending previous load operation initiated with
this method or the loadString method. The complete event for the previous load operation will never
be delivered.
It is possible the complete event will never be delivered. This happens if any of
the HTML content loaded into the HTMLLoader object never downloads completely. This can happen if
the HTML content references a URL to a CGI script that repetedly generates content indefinitely.
Parâmetros
urlRequestToLoad:URLRequest — The URLRequest object containing information about the URL to
load. In addition to the URL to load, a URLRequest object contains properties that define
the HTTP form submission method (GET or POST), any data to be transmitted with the request,
and request headers.
|
Veja também
| loadString | () | método |
public function loadString(htmlContent:String):void
Loads the HTMLLoader object with the HTML content contained in the HTML string. When rendering of the
of the HTML in the string is complete, the complete event is dispatched. The
complete event is always dispatched asynchronously.
A call to this method implicitly cancels any pending previous load operation initiated with
this method or the load method. The complete event for the previous load operation will never
be delivered.
If the HTML specified in the string has no references to external resources, then this method
will synchronously render the HTML. However, the complete event will still be dispatched
asynchronously. If the loaded property of this class is true immediately
following a call to this function, the HTML content specified in the htmlContent argument
was rendered synchronously.
It is possible the complete event will never be delivered. This happens if any of
the HTML content loaded into the HTMLLoader object never downloads completely. This can happen if
the HTML content references a URL to a CGI script that repetedly generates content indefinitely.
Parâmetros
htmlContent:String — The string containing the HTML content to load into the HTMLLoader object.
|
| reload | () | método |
public function reload():void
Reloads the page from the current location.
| complete | Evento |
flash.events.Event
flash.events.Event.COMPLETE
Signals that the last load operation requested by loadString or load has completed. The event is dispatched AFTER the javascript load event has fired on the HTML DOM in the HTMLLoader. Always dispatched asynchronously. The event handler for this event may call any method or access any property of the HTMLLoader.
TheEvent.COMPLETE constant defines the value of the type property of a complete event object.
This event has the following properties:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The network object that has completed loading. |
Veja também
| htmlBoundsChange | Evento |
flash.events.Event
flash.events.Event.HTML_BOUNDS_CHANGE
Signals the one or both of the contentWidth and contentHeight
properties have changed. This may be result from a new image or other content loading,
for exemplo. Event handlers may call any method or access any property
of the HTMLLoader object.
The HTMLLoader object may dispatch this event any time after a load operation is initiated.
The HTMLLoader object may dispatch this event even after the object has dispatched the
complete event.
Event.HTML_BOUNDS_CHANGE constant defines the value of the type property of an htmlBoundsChange event object.
Signals the one or both of the contentWidth and contentHeight properties
of an HTMLLoader object have changed.
Veja também
| htmlDOMInitialize | Evento |
flash.events.Event
flash.events.Event.HTML_DOM_INITIALIZE
Signals that the HTML DOM has be created in response to a load operation. The load()
and loadString() methods of the HTMLLoader object throw an exception while
this event is being dispatched. Any property or method of any JavaScript object accessible from the
window property of the HTMLLoader object that controls the URL that is loaded in
the HTMLLoader object throws an exception if set or called while this event is dispatched.
For exemplo, setting window.location via the window property of
the HTMLLoader object will result in a JavaScript exception.
Event.HTML_DOM_INITIALIZE constant defines the value of the type property of a htmlDOMInitialize event object.
Signals that the HTML DOM in and HTMLLoader object has be created in response to a load operation.
Veja também
| htmlRender | Evento |
flash.events.Event
flash.events.Event.HTML_RENDER
Signals that the rendering of content in the HTMLLoader object is fully up-to-date. This event can be dispatched quite frequentlywhenever any rendering change is made to the HTML content. For exemplo, this event is dispatched when new content is displayed as a result of a user clicking a link or when JavaScript in the page renders HTML. Event listeners may call any method or access any property of the HTMLLoader.
Handlers of this event should check the contentWidth and contentHeight
properties of the HTMLLoader to update any scroll bars associated with the HTMLLoader.
The HTMLLoader object may dispatch this event any time after a load operation is initiated.
The HTMLLoader object may dispatch this event even after the object has dispatched the
complete event.
Event.HTML_RENDER constant defines the value of the type property of an htmlRender event object.
Signals that the rendering of content in an HTMLLoader object is fully up-to-date.
| locationChange | Evento |
flash.events.Event
flash.events.Event.LOCATION_CHANGE
Signals that the location property of the HTMLLoader object has changed.
The event handler for this event may call any method or access any property of the
HTMLLoader object.
Event.LOCATION_CHANGE constant defines the value of the type property of a locationChange event object.
Signals the location property of an HTMLLoader object has changed.
Veja também
| scroll | Evento |
flash.events.Event
flash.events.Event.SCROLL
Signals that the scrollH or scrollV property have been changed
by the HTMLLoader. The HTMLLoader object dispatches this event when JavaScript running in the
HTMLLoader invokes the scrollTo() method of the window object
and the desired location is not already visible. The event is not dispatched when ActionScript
code changes the scrollH or scrollV property.
Event handlers may call any method or access any property
of the HTMLLoader object.
Event handlers for this event should check the scrollH and scrollV
properties to update any scroll bars associated with the HTMLLoader object.
The HTMLLoader object may dispatch this event any time after a load operation is initiated.
The HTMLLoader object may dispatch this event even after the object has dispatched the
complete event.
Event.SCROLL constant defines the value of the type property of a scroll event object.
This event has the following properties:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The TextField object that has been scrolled.
The target is not always the object in the display list
that registered the event listener. Use the currentTarget
property to access the object in the display list that is currently processing the event. |
| uncaughtJavaScriptException | Evento |
flash.events.HTMLUncaughtJavaScriptExceptionEvent
flash.events.HTMLUncaughtJavaScriptExceptionEvent.UNCAUGHT_JAVASCRIPT_EXCEPTION
Signals that an uncaught JavaScript exception occurred in the HTMLLoader. Event handlers may call any method or access any property of the HTMLLoader object.
Defines the value of the type property of anuncaughtJavaScriptException event object.
Veja também