| 套件 | flash.html |
| 類別 | public class HTMLLoader |
| 繼承 | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 子類別 | FlexHTMLLoader |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
AIR 描述檔支援：所有桌上型電腦作業系統都支援此項功能，但行動裝置或 AIR for TV 裝置不支援。您可以使用 HTMLLoader.isSupported 屬性測試執行階段的支援狀況。如需有關跨多個描述檔之 API 支援的詳細資訊，請參閱 AIR 描述檔支援。
在桌上型電腦上 (在桌面與擴充桌面描述檔中)，HTMLLoader 類別使用內部 AIR WebKit 引擎。可用的功能和顯示外觀與 StageWebView 類別相同，加上 ActionScript 與 JavaScript 之間密切整合與指令碼橋接。由於 StageWebView 類別使用 Flash Player 外掛程式所提供的系統網頁控制項，強烈建議不要同時使用 StageWebView 和 HTMLLoader 實體，因為它具有未定義的行為且可能會終止應用程式。
HTMLLoader 的預設尺寸為 0 x 0 像素。設定 width 和 height 屬性，以使 HTMLLoader 物件顯示。
HTMLLoader 物件的最大高度為 4,096 像素，而最大寬度為 4,096 像素。如果您將 HTMLLoader 物件的 width 或 height 設定為超過 4,095 的數字，就會導致 HTMLLoader 物件擲出 ArgumentError 例外。(請注意，在 AIR 2 之前，HTMLLoader 物件的大小上限為 2,880 像素)。
注意：在透明視窗中顯示時，在 HTML 頁面內嵌的 SWF 內容必須使用 transparent 或 opaque wmode 來內嵌。wmode 的預設值是 window，因此如果您未指定值，則無法顯示 SWF 內容。在 Windows 與 Linux 上，SWF 內容會在 wmode 設為 window 或 opaque 時，永遠顯示在其他內容頂端。無論使用哪個 wmode 設定，PDF 內容都無法顯示在透明視窗中。
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。 | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
此顯示物件的目前輔助功能選項。 | DisplayObject | |
| alpha : Number
指出所指定物件的 Alpha 透明度值。 | DisplayObject | |
| authenticate : Boolean
指定是 (true) 否 (false) 應針對這個物件所發出的 HTTP 要求處理驗證要求。 | HTMLLoader | ||
| blendMode : String
來自 BlendMode 類別的值，會指定要使用何種混合模式。 | DisplayObject | |
| blendShader : Shader [唯寫]
設定用來混合前景和背景的著色器。 | DisplayObject | |
| buttonMode : Boolean
可指定此 sprite 的按鈕模式。 | Sprite | |
| cacheAsBitmap : Boolean
如果設定為 true，Flash 執行階段會快取顯示物件的內部點陣圖表示法。 | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
如果為非 null，當 cacheAsBitmap 設定為 true 時，這個 Matrix 物件會定義顯示物件的顯示方法。 | DisplayObject | |
| cacheResponse : Boolean
針對這個物件所發出的 HTTP 要求，指定是否應快取成功回應資料。 | HTMLLoader | ||
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| contentHeight : Number [唯讀]
HTML 內容的高度，以像素為單位。 | HTMLLoader | ||
| contentWidth : Number [唯讀]
HTML 內容的寬度，以像素為單位。 | HTMLLoader | ||
| contextMenu : NativeMenu
指定與此物件有關聯的快顯選單。 | InteractiveObject | |
| doubleClickEnabled : Boolean
會指定物件是否會收到 doubleClick 事件。 | InteractiveObject | |
| dropTarget : DisplayObject [唯讀]
指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。 | Sprite | |
| filters : Array
索引的陣列，其中包含目前和顯示物件相關的每個濾鏡物件。 | DisplayObject | |
| focusRect : Object
會指定這個物件是否會顯示焦點矩形。 | InteractiveObject | |
| graphics : Graphics [唯讀]
指定屬於此 sprite 物件的 Graphics 物件，其中可能會產生向量繪圖命令。 | Sprite | |
| hasFocusableContent : Boolean [唯讀]
指出 HTMLLoader 物件中的任何內容是否可取得焦點。 | HTMLLoader | ||
| height : Number [覆寫]
指定所呈現 HTML 畫布矩形的高度。 | HTMLLoader | ||
| historyLength : uint [唯讀]
操作記錄清單的整體長度，包括後退和前進項目。 | HTMLLoader | ||
| historyPosition : uint
操作記錄清單中目前的位置。 | HTMLLoader | ||
| hitArea : Sprite
指定用來當作 sprite 作用區域的另一個 sprite。 | Sprite | |
| htmlHost : flash.html:HTMLHost
HTMLHost 物件，用來處理特定使用者介面元素 (如 HTMLLoader 物件的 window.document.title 屬性) 的變更。 | HTMLLoader | ||
| idleTimeout : Number
指定由這個物件發出之 HTTP 要求的閒置逾時值 (以毫秒為單位)。 | HTMLLoader | ||
| isSupported : Boolean [靜態] [唯讀]
指出用戶端系統是否支援 HTMLLoader 類別。 | HTMLLoader | ||
| loaded : Boolean [唯讀]
指出對應於上一個 load() 或 loadString() 方法呼叫的 JavaScript load 事件是否已傳送至 HTMLLoader 物件中的 HTML DOM。 | HTMLLoader | ||
| loaderInfo : LoaderInfo [唯讀]
會傳回 LoaderInfo 物件，其中包含關於載入此顯示物件所屬之檔案的資訊。 | DisplayObject | |
| location : String [唯讀]
HTMLLoader 物件中所載入內容的 URL。 | HTMLLoader | ||
| manageCookies : Boolean
指定 HTTP 通訊協定堆疊是否應管理這個物件的 Cookie。 | HTMLLoader | ||
| mask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。 | DisplayObject | |
| metaData : Object
如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存，則會取得 DisplayObject 實體的中繼資料物件。 | DisplayObject | |
| mouseChildren : Boolean
判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。 | DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此物件是否接收滑鼠或其他使用者輸入及訊息。 | InteractiveObject | |
| mouseX : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 x 座標，以像素為單位。 | DisplayObject | |
| mouseY : Number [唯讀]
指出滑鼠或使用者輸入裝置位置的 y 座標，以像素為單位。 | DisplayObject | |
| name : String
指出 DisplayObject 的實體名稱。 | DisplayObject | |
| navigateInSystemBrowser : Boolean
指定 HTML 內容根框架瀏覽 (例如，當使用者按一下連結時、在設定 window.location 屬性時，或在呼叫 window.open() 時) 會造成 HTMLLoader 物件中的瀏覽 (false) 或預設系統網頁瀏覽器中的瀏覽 (true)。 | HTMLLoader | ||
| needsSoftKeyboard : Boolean
指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。 | InteractiveObject | |
| numChildren : int [唯讀]
傳回此物件的子系數量。 | DisplayObjectContainer | |
| opaqueBackground : Object
會指定顯示物件是否不透明，並具有特定背景顏色。 | DisplayObject | |
| paintsDefaultBackground : Boolean
指定 HTMLLoader 文件的背景是 (true) 否 (false) 為不透明白色。 | HTMLLoader | ||
| parent : DisplayObjectContainer [唯讀]
指出包含此顯示物件的 DisplayObjectContainer 物件。 | DisplayObject | |
| pdfCapability : int [靜態] [唯讀]
使用者系統上的 PDF 支援類型，定義為整數碼值。 | HTMLLoader | ||
| placeLoadStringContentInApplicationSandbox : Boolean
指定透過 loadString() 方法所載入的內容是放入應用程式安全執行程序中 (true)，或是放入非應用程式安全執行程序中 (false)。 | HTMLLoader | ||
| root : DisplayObject [唯讀]
對載入之 SWF 檔案的顯示物件而言，root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。 | DisplayObject | |
| rotation : Number
指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。 | DisplayObject | |
| rotationX : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 x 軸旋轉 (以度數為單位)。 | DisplayObject | |
| rotationY : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 y 軸旋轉 (以度數為單位)。 | DisplayObject | |
| rotationZ : Number
表示 DisplayObject 實體相對於 3D 父輩容器從原始方向旋轉的 z 軸旋轉 (以度數為單位)。 | DisplayObject | |
| runtimeApplicationDomain : ApplicationDomain
HTML 網頁中 JavaScript window.runtime 物件所使用的應用程式網域。 | HTMLLoader | ||
| scale9Grid : Rectangle
目前產生效用的縮放格線。 | DisplayObject | |
| scaleX : Number
指出從註冊點套用的物件水平縮放 (百分比)。 | DisplayObject | |
| scaleY : Number
指出從物件註冊點套用的物件垂直縮放 (百分比)。 | DisplayObject | |
| scaleZ : Number
指出從物件註冊點套用的物件深度縮放 (百分比)。 | DisplayObject | |
| scrollH : Number
HTMLLoader 物件中 HTML 內容的水平捲動位置。 | HTMLLoader | ||
| scrollRect : Rectangle
顯示物件的捲動矩形範圍。 | DisplayObject | |
| scrollV : Number
HTMLLoader 物件中 HTML 內容的垂直捲動位置。 | HTMLLoader | ||
| softKeyboard : String
控制軟體鍵盤的外觀。 | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時，應保留於螢幕上的區域 (iOS 未提供)。 | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
控制此 Sprite 的聲音。 | Sprite | |
| stage : Stage [唯讀]
顯示物件的「舞台」。 | DisplayObject | |
| swfCapability : int [靜態] [唯讀]
使用者系統上的 SWF 支援類型，定義為整數碼值。 | HTMLLoader | ||
| tabChildren : Boolean
判斷物件的子系是否支援啟用定位鍵。 | DisplayObjectContainer | |
| tabEnabled : Boolean
會指定這個物件是否在停駐點順序中。 | InteractiveObject | |
| tabIndex : int
會指定 SWF 檔中的物件停駐點順序。 | InteractiveObject | |
| textEncodingFallback : String
HTMLLoader 內容使用的字元編碼 (如果 HTML 網頁未指定字元編碼)。 | HTMLLoader | ||
| textEncodingOverride : String
HTMLLoader 內容使用的字元編碼，覆寫 HTML 網頁中的任何設定。 | HTMLLoader | ||
| textSnapshot : flash.text:TextSnapshot [唯讀]
傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。 | DisplayObjectContainer | |
| transform : flash.geom:Transform
這是一個物件，具有和顯示物件的矩陣、顏色轉換和像素邊界有關的屬性。 | DisplayObject | |
| useCache : Boolean
在這個物件所發出的 HTTP 要求取得資料之前，指定是否應查閱本機快取。 | HTMLLoader | ||
| useHandCursor : Boolean
指示當指標滑入 Sprite，且其 buttonMode 屬性設為 true 時，是否要出現指示手掌 (手掌游標) 的 Boolean 值。 | Sprite | |
| userAgent : String
來自這個 HTMLLoader 物件的任何即將發出內容要求中所使用的使用者代理字串。 | HTMLLoader | ||
| visible : Boolean
不管是否看得見顯示物件。 | DisplayObject | |
| width : Number [覆寫]
指定所呈現 HTML 畫布矩形的寬度。 | HTMLLoader | ||
| window : Object [唯讀]
HTML 控制項中所載入內容的全域 JavaScript 物件。 | HTMLLoader | ||
| x : Number
指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 x 座標。 | DisplayObject | |
| y : Number
指出 DisplayObject 實體相對於父輩 DisplayObjectContainer 之區域座標的 y 座標。 | DisplayObject | |
| z : Number
表示 DisplayObject 實體相對於 3D 父輩容器的 z 座標位置 (沿著 z 軸)。 | DisplayObject | |
| 方法 | 定義自 | ||
|---|---|---|---|
建立 HTMLLoader 物件。 | HTMLLoader | ||
|
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | |
|
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。 | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
|
指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。 | DisplayObjectContainer | |
取消進行中的任何載入作業。 | HTMLLoader | ||
|
判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系，或為實體本身。 | DisplayObjectContainer | |
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [靜態]
建立一個包含 HTMLLoader 物件的新 NativeWindow 物件。 | HTMLLoader | ||
|
會將事件傳送到事件流程。 | EventDispatcher | |
|
傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。 | DisplayObject | |
|
傳回存在於指定索引位置的子顯示物件實體。 | DisplayObjectContainer | |
|
傳回具有指定名稱的子顯示物件。 | DisplayObjectContainer | |
|
傳回 child DisplayObject 實體的索引位置。 | DisplayObjectContainer | |
在指定位置傳回操作記錄項目。 | HTMLLoader | ||
|
傳回位於指定點底下，且屬於此 DisplayObjectContainer 實體之子系 (或孫系，以下類推) 的物件陣列。 | DisplayObjectContainer | |
|
根據 targetCoordinateSpace 參數所定義的座標系統，並排除形狀上的任何筆畫，傳回可定義顯示物件邊界的矩形。 | DisplayObject | |
|
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。 | DisplayObject | |
|
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。 | DisplayObject | |
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
如果可能，在瀏覽器操作記錄中向後瀏覽。 | HTMLLoader | ||
如果可能，在瀏覽器操作記錄中向前瀏覽。 | HTMLLoader | ||
在瀏覽器操作記錄中瀏覽指定的步驟數。 | HTMLLoader | ||
|
評估顯示物件的範圍框，看它是否與 obj 顯示物件的範圍框重疊或相交。 | DisplayObject | |
|
評估顯示物件，看它是否與 x 和 y 參數所指定的點重疊或相交。 | DisplayObject | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
使用 urlRequestToLoad 參數所指定網站中的資料來載入 HTMLLoader 物件。 | HTMLLoader | ||
使用 HTML 字串中包含的 HTML 內容來載入 HTMLLoader 物件。 | HTMLLoader | ||
|
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。 | DisplayObject | |
|
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。 | DisplayObject | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
從目前位置重新載入頁面。 | HTMLLoader | ||
|
將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
|
從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。 | DisplayObjectContainer | |
|
將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。 | DisplayObjectContainer | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
升起顯示虛擬鍵盤。 | InteractiveObject | |
|
變更顯示物件容器中現有子系的位置。 | DisplayObjectContainer | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
讓使用者拖曳指定的 sprite。 | Sprite | |
|
讓使用者將指定的 Sprite 拖曳至觸控裝置上。 | Sprite | |
|
遞迴停止執行所有 MovieClips 的時間軸根源於此物件。 | DisplayObjectContainer | |
|
結束 startDrag() 方法。 | Sprite | |
|
結束觸控裝置使用的 startTouchDrag() 方法。 | Sprite | |
|
替換兩個指定子物件的 z 順序 (深度階層，由前至後順序)。 | DisplayObjectContainer | |
|
在子清單的兩個指定索引位置，替換子物件的 z 順序 (深度階層，由前至後順序)。 | DisplayObjectContainer | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
| 事件 | 摘要 | 定義自 | ||
|---|---|---|---|---|
| [廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。 | EventDispatcher | ||
| 當顯示物件加入顯示清單中時傳送。 | DisplayObject | ||
| 會在顯示物件加入舞台上的顯示清單時，以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | ||
| 當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。 | InteractiveObject | ||
| 會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。 | InteractiveObject | ||
| 指出 loadString 或 load 方法所要求的最後一個載入作業已完成。 | HTMLLoader | |||
| 當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。 | InteractiveObject | ||
| 當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。 | InteractiveObject | ||
| 當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。 | InteractiveObject | ||
| [廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。 | EventDispatcher | ||
| 在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下，當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。 | InteractiveObject | ||
| [廣播事件] 當播放磁頭進入新影格時傳送。 | DisplayObject | ||
| [廣播事件] 當播放磁頭結束目前影格時傳送。 | DisplayObject | ||
| 當顯示物件取得焦點之後傳送。 | InteractiveObject | ||
| 當顯示物件失去焦點時傳送。 | InteractiveObject | ||
| [廣播事件] 在影格顯示物件的建構函式執行之後，且影格指令碼執行之前傳送。 | DisplayObject | ||
| 當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選)，某些裝置可能也會將此接觸解譯為數個觸控事件的組合。 | InteractiveObject | ||
| 當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方，以兩支手指按下後鬆開)。 | InteractiveObject | ||
| 當使用者在觸控裝置上，將接觸點移動到 InteractiveObject 實體上方後傳送 (例如，在行動電話或平板電腦觸控螢幕的顯示物件上，由左向右移動手指)。 | InteractiveObject | ||
| 當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上旋轉)。 | InteractiveObject | ||
| 當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如，三指併在一起觸碰行動電話或平板電腦的觸控螢幕，然後在顯示物件上快速平行移動手指)。 | InteractiveObject | ||
| 當使用者與 InteractiveObject 實體建立接觸點，然後在觸控裝置上點一下後送出 (例如，將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單，然後其中一根手點一下，選取選單項目)。 | InteractiveObject | ||
| 當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上快速張開)。 | InteractiveObject | ||
| 指出 HTMLLoader 物件的 contentWidth 或 contentHeight 屬性或兩者已變更。 | HTMLLoader | |||
| 指出為了回應載入作業，已建立 HTML DOM。 | HTMLLoader | |||
| 指出 HTMLLoader 物件中的內容顯示都是最新的。 | HTMLLoader | |||
| 這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。 | InteractiveObject | ||
| 會當使用者按下按鍵時傳送。 | InteractiveObject | ||
| 當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。 | InteractiveObject | ||
| 會當使用者放開按鍵時傳送。 | InteractiveObject | ||
| 指出 HTMLLoader 物件的 location 屬性已變更。 | HTMLLoader | |||
| 指出 HTMLLoader 物件的 location 屬性已變更。 | HTMLLoader | |||
| 發出訊號，表示 HTMLLoader 物件的 location 屬性即將變更。 | HTMLLoader | |||
| 當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
| 會當使用者嘗試使用指向裝置變更焦點時傳送。 | InteractiveObject | ||
| 會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
| 當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。 | InteractiveObject | ||
| 當使用者釋放手勢時，由拖曳初始程式 InteractiveObject 傳送。 | InteractiveObject | ||
| 已在目標 InteractiveObject 上放下拖曳的物件，而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時，由此目標 InteractiveObject 傳送。 | InteractiveObject | ||
| 當手勢進入 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。 | InteractiveObject | ||
| 當手勢離開 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。 | InteractiveObject | ||
| 當拖曳手勢還留在 InteractiveObject 的邊界內，由此 InteractiveObject 持續傳送。 | InteractiveObject | ||
| 在呼叫 DragManager.doDrag() 進行拖曳作業初期，由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | ||
| 在呼叫 DragManager.doDrag() 進行拖曳作業期間，由指定做為拖曳初始程式的 InteractiveObject 傳送。 | InteractiveObject | ||
| 當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆移到螢幕上方，而其餘仍在鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆移出這個 InteractiveObject 之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方，而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。 | InteractiveObject | ||
| 在使用者透過這個 InteractiveObject，從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。 | InteractiveObject | ||
| 當使用者第一次按下 InteractiveObject 實體上方的按鈕，然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。 | InteractiveObject | ||
| 會當顯示物件將要從顯示清單移除時傳送。 | DisplayObject | ||
| 會在顯示物件即將從顯示清單移除時，以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。 | DisplayObject | ||
| [廣播事件] 當顯示清單將要更新和顯示時傳送。 | DisplayObject | ||
| 當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。 | InteractiveObject | ||
| 當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移開 InteractiveObject 實體時傳送。 | InteractiveObject | ||
| 會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。 | InteractiveObject | ||
| 指出 HTMLLoader 物件已變更 scrollH 或 scrollV 屬性。 | HTMLLoader | |||
| 當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。 | InteractiveObject | ||
| 升起顯示軟體鍵盤之後立即傳送。 | InteractiveObject | ||
| 升起顯示軟體鍵盤前立即傳送。 | InteractiveObject | ||
| 降下隱藏軟體鍵盤之後立即傳送。 | InteractiveObject | ||
| 在物件的 tabChildren 旗標值變更時傳送。 | InteractiveObject | ||
| 在物件的 tabEnabled 旗標變更時傳送。 | InteractiveObject | ||
| 在物件的 tabIndex 屬性值變更時傳送。 | InteractiveObject | ||
| 當使用者輸入一或多文字的字元時送出。 | InteractiveObject | ||
| 當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。 | InteractiveObject | ||
| 當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。 | InteractiveObject | ||
| 當使用者觸控裝置時傳送，並且連續不斷地傳送，直到接觸點移除為止。 | InteractiveObject | ||
| 當使用者在觸控裝置中，將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件移至另一個顯示物件)。 | InteractiveObject | ||
| 當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。 | InteractiveObject | ||
| 當使用者在觸控裝置上，將接觸點從 InteractiveObject 實體移出後送出 (例如，在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件上方拖曳到顯示物件以外)。 | InteractiveObject | ||
| 當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。 | InteractiveObject | ||
| 當使用者在觸控裝置的同一個 InteractiveObject 實體上，在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方，以手指按下某個點後又鬆開)。 | InteractiveObject | ||
| 指出 HTMLLoader 物件中發生未捕捉的 JavaScript 例外。 | HTMLLoader | |||
authenticate | 屬性 |
cacheResponse | 屬性 |
contentHeight | 屬性 |
contentWidth | 屬性 |
hasFocusableContent | 屬性 |
height | 屬性 |
height:Number[覆寫] | 執行階段版本: | AIR 1.0 |
指定所呈現 HTML 畫布矩形的高度。此屬性值是 HTMLLoader 顯示物件的高度，以像素為單位。height 最大值為 4095 像素。變更這個屬性會使 HTMLLoader 物件重新顯示 HTML 文件。為了回應這個屬性變更，可能會傳送 htmlBoundsChanged 事件。
當您設定 HTMLLoader 物件的 width 或 height 屬性時，物件邊界會變更但內容不會縮放 (其他類型的顯示物件也是如此)。
實作
override public function get height():Number override public function set height(value:Number):void historyLength | 屬性 |
historyPosition | 屬性 |
htmlHost | 屬性 |
htmlHost:flash.html:HTMLHost| 執行階段版本: | AIR 1.0 |
HTMLHost 物件，用來處理特定使用者介面元素 (如 HTMLLoader 物件的 window.document.title 屬性) 的變更。若要覆寫 HTMLLoader 物件的預設行為，請建立 HTMLHost 類別的子類別並覆寫它的成員函數，以處理 HTML 內容中的各種使用者介面變更。
實作
public function get htmlHost():flash.html:HTMLHost public function set htmlHost(value:flash.html:HTMLHost):void相關 API 元素
idleTimeout | 屬性 |
isSupported | 屬性 |
loaded | 屬性 |
location | 屬性 |
manageCookies | 屬性 |
manageCookies:Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
指定 HTTP 通訊協定堆疊是否應管理這個物件的 Cookie。如果為 true，則 Cookie 會加入要求而且會記住回應 Cookie。如果為 false，則 Cookie 不會加入要求而且不會記住回應 Cookie。
預設值為 initialized from URLRequestDefaults.manageCookies。
實作
public function get manageCookies():Boolean public function set manageCookies(value:Boolean):void相關 API 元素
navigateInSystemBrowser | 屬性 |
navigateInSystemBrowser:Boolean| 執行階段版本: | AIR 1.0 |
指定 HTML 內容根框架瀏覽 (例如，當使用者按一下連結時、在設定 window.location 屬性時，或在呼叫 window.open() 時) 會造成 HTMLLoader 物件中的瀏覽 (false) 或預設系統網頁瀏覽器中的瀏覽 (true)。如果您想要所有瀏覽都在系統網頁瀏覽器中發生 (而不是在 HTMLLoader 物件中)，請將這個屬性設定為 true。
預設值為 false。
實作
public function get navigateInSystemBrowser():Boolean public function set navigateInSystemBrowser(value:Boolean):void paintsDefaultBackground | 屬性 |
paintsDefaultBackground:Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
指定 HTMLLoader 文件的背景是 (true) 否 (false) 為不透明白色。如果這個屬性設定為 false，HTMLLoader 物件會使用它的顯示物件容器做為 HTML 背景，而且也會使用顯示物件容器的不透明度 (alpha 值) 做為 HTML 背景。不過，如果 HTML 文件的 body 元素或其他元素有不透明背景顏色 (例如，由 style="background-color:gray" 指定)，則所顯示 HTML 的該部分會使用指定的不透明背景顏色。
實作
public function get paintsDefaultBackground():Boolean public function set paintsDefaultBackground(value:Boolean):void pdfCapability | 屬性 |
pdfCapability:int [唯讀] | 執行階段版本: | AIR 1.0 |
使用者系統上的 PDF 支援類型，定義為整數碼值。只有在這個屬性評估為 PDFCapability.STATUS_OK 時，HTMLLoader 物件才能顯示 PDF 內容。PDFCapability 類別為 pdfCapability 屬性的可能值定義了常數，如下：
| PDFCapability 常數 | 意義 |
|---|---|
STATUS_OK | 偵測到適用版本的 Acrobat 或 Adobe Reader (8.1 或更新版本)，而且 PDF 內容可以載入 HTMLLoader 物件。
注意：在 Windows 上，如果 Acrobat 或 Adobe Reader 7.x 版或更新版本目前正在使用者系統上執行，即使同時安裝可支援載入 HTMLLoader 物件中所載入 PDF 的更新版本，也會使用該舊版。在這種情況下，如果 |
ERROR_INSTALLED_READER_NOT_FOUND | 未偵測到任何 Acrobat 或 Adobe Reader 版本。HTMLLoader 物件無法顯示 PDF 內容。 |
ERROR_INSTALLED_READER_TOO_OLD | 偵測到 Acrobat 或 Adobe Reader，但版本太舊。HTMLLoader 物件無法顯示 PDF 內容。 |
ERROR_PREFERED_READER_TOO_OLD | 雖然偵測到適用版本的 Acrobat 或 Adobe Reader (8.1 或更新版本)，但設定為處理 PDF 內容的版本比 8.1 還舊。HTMLLoader 物件無法顯示 PDF 內容。 |
實作
public static function get pdfCapability():int相關 API 元素
placeLoadStringContentInApplicationSandbox | 屬性 |
placeLoadStringContentInApplicationSandbox:Boolean| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.5 |
指定透過 loadString() 方法所載入的內容是放入應用程式安全執行程序中 (true)，或是放入非應用程式安全執行程序中 (false)。
當這個屬性設定為 false 時，透過 loadString() 方法所載入的內容就會放入具有下列特性的非應用程式安全執行程序中：
- 它具有從網路 (而非檔案系統) 載入內容的存取權。
- 它無法使用 XMLHttpRequest 來載入資料。
window.location屬性設定為"about:blank"。- 此內容無法存取
window.runtime屬性 (如同任何非應用程式安全執行程序中的內容)。
當這個屬性設定為 true 時，透過 loadString() 方法所載入的內容就會放入具備 window.runtime 屬性和所有 AIR API 之存取權的應用程式安全執行程序中。您應該確定 loadString() 方法呼叫中使用之字串的資料來源受到信任。當這個屬性設定為 true 時，HTML 字串中的程式碼陳述式就會以完整應用程式權限執行。只有當您確定字串不可能包含有害的程式碼時，才應該將這個屬性設定為 true。
在使用 AIR 1.0 或 AIR 1.1 SDK 所編譯的應用程式中，透過 loadString() 方法所載入的內容會放入應用程式安全執行程序中。
預設值為 false。
實作
public function get placeLoadStringContentInApplicationSandbox():Boolean public function set placeLoadStringContentInApplicationSandbox(value:Boolean):void相關 API 元素
runtimeApplicationDomain | 屬性 |
runtimeApplicationDomain:ApplicationDomain| 執行階段版本: | AIR 1.0 |
HTML 頁面中 JavaScript window.runtime 物件所使用的應用程式網域。
如果為 null，或是如果 HTML 內容不是來自包含 HTMLLoader 物件之 SWF 內容的安全性網域，頁面就會將預設應用程式網域做為頁面網域使用。
實作
public function get runtimeApplicationDomain():ApplicationDomain public function set runtimeApplicationDomain(value:ApplicationDomain):void擲回值
SecurityError — 如果 ApplicationDomain 物件不是來自呼叫者的安全性網域。
|
相關 API 元素
scrollH | 屬性 |
scrollV | 屬性 |
swfCapability | 屬性 |
swfCapability:int [唯讀] | 執行階段版本: | AIR 2 |
使用者系統上的 SWF 支援類型，定義為整數碼值。只有在這個屬性評估為 HTMLSWFCapability.STATUS_OK 時，HTMLLoader 物件才能顯示 SWF 內容。HTMLSWFCapability 類別為 swfCapability 屬性的可能值定義了常數，如下：
| HTMLSWFCapability 常數 | 意義 |
|---|---|
STATUS_OK | 已偵測到合適的 Adobe Flash Player 版本，而且 SWF 內容可以載入 HTMLLoader 物件。 |
ERROR_INSTALLED_PLAYER_NOT_FOUND | 未偵測到任何版本的 Adobe Flash Player。HTMLLoader 物件無法顯示 SWF 內容。 |
ERROR_INSTALLED_PLAYER_TOO_OLD | 偵測到 Adobe Flash Player，但版本太舊。HTMLLoader 物件無法顯示 SWF 內容。 |
實作
public static function get swfCapability():int相關 API 元素
textEncodingFallback | 屬性 |
textEncodingFallback:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
HTMLLoader 內容使用的字元編碼 (如果 HTML 網頁未指定字元編碼)。HTML 網頁會在 meta 標籤中指定字元編碼，如下所示：
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
值已定義在 IANA 的「有效字元集」清單中。
如果 HTML 網頁未指定編碼 (藉由使用 textEncodingFallback 屬性或 textEncodingOverride 屬性)，則 HTML 內容會使用 ISO-8859-1 編碼。
實作
public function get textEncodingFallback():String public function set textEncodingFallback(value:String):void相關 API 元素
textEncodingOverride | 屬性 |
textEncodingOverride:String| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
HTMLLoader 內容使用的字元編碼，覆寫 HTML 網頁中的任何設定。HTML 網頁會在 meta 標籤中指定字元編碼，如下所示：
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
這個設定也會覆寫 textEncodingFallback 屬性中的任何設定。
值已定義在 IANA 的「有效字元集」清單中。
在 HTML 內容載入之後設定 textEncodingOverride 屬性，可讓 AIR 使用指定的編碼來重新整理 HTML 內容。一旦 HTMLLoader 瀏覽至新頁面，如果您想要新頁面使用特定編碼，則必須重新設定屬性。
如果 HTML 網頁未指定編碼 (藉由使用 textEncodingFallback 屬性或 textEncodingOverride 屬性)，則 HTML 內容會使用 ISO-8859-1 編碼。
將 textEncodingOverride 屬性設定為 null 會還原預設行為。
實作
public function get textEncodingOverride():String public function set textEncodingOverride(value:String):void相關 API 元素
useCache | 屬性 |
userAgent | 屬性 |
userAgent:String| 執行階段版本: | AIR 1.0 |
來自這個 HTMLLoader 物件的任何即將發出內容要求中所使用的使用者代理字串。
若要設定使用者代理字串，請在呼叫 load() 方法之前先設定 HTMLLoader 物件的 userAgent 屬性。「不」使用傳遞給 load() 方法之 URLRequest 物件的 userAgent 屬性。
您可以藉由設定 URLRequestDefaults.userAgent 屬性，設定應用程式網域中所有 HTMLLoader 物件使用的預設使用者代理字串。如果未設定 HTMLLoader 物件的 userAgent 屬性 (或是如果此值設定為 null)，則使用者代理字串會設定為靜態 URLRequestDefaults.userAgent 屬性的值。
如果未設定 HTMLLoader 的 userAgent 屬性值，也未設定 URLRequestDefaults.userAgent 屬性值，則會使用預設值做為使用者代理字串。這個預設值根據執行階段作業系統 (如 Mac OS、Linux 或 Windows)、執行階段語言和執行階段版本而有所不同，如下列範例所示：
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
實作
public function get userAgent():String public function set userAgent(value:String):void相關 API 元素
width | 屬性 |
width:Number[覆寫] | 執行階段版本: | AIR 1.0 |
指定所呈現 HTML 畫布矩形的寬度。這是 HTMLLoader 顯示物件的寬度，以像素為單位。width 最大值為 4095 像素。變更這個屬性會使 HTMLLoader 物件重新顯示 HTML 文件。為了回應這個屬性變更，可能會傳送 htmlBoundsChange 事件。當您設定 HTMLLoader 物件的 width 和 height 屬性時，物件邊界會變更但內容不會縮放 (其他類型的顯示物件也是如此)。
實作
override public function get width():Number override public function set width(value:Number):void window | 屬性 |
HTMLLoader | () | 建構函式 |
public function HTMLLoader()| 執行階段版本: | AIR 1.0 |
建立 HTMLLoader 物件。
cancelLoad | () | 方法 |
createRootWindow | () | 方法 |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader| 執行階段版本: | AIR 1.0 |
建立一個包含 HTMLLoader 物件的新 NativeWindow 物件。使用由這個方法傳回的 HTMLLoader 物件，以載入 HTML 內容。
根據預設 (呼叫這個方法但未設定參數時)，新視窗會使用標準系統顏色並包含內容的捲軸控制項。您可以設定參數以變更新視窗的屬性。
在視窗載入內容並套用樣式表時，可能會發生小的圖形干擾。若要避免出現不連續的情況，請將 visible 參數設為 false。載入視窗且配置其內容後，請將 window.nativeWindow.visible 屬性設為 true，或呼叫 window.nativeWindow.activate() 方法以顯現它。
參數
visible:Boolean (default = true) | |
windowInitOptions:NativeWindowInitOptions (default = null)null，則使用預設 NativeWindowInitOptions 值。
| |
scrollBarsVisible:Boolean (default = true) | |
bounds:Rectangle (default = null)null，則會指定視窗邊界。如果 x、y、width 或 height 當中的任何一個是 NaN，視窗的對應尺寸就是預設值。
|
flash.html:HTMLLoader — 在新 NativeWindow 物件之舞台上的新 HTMLLoader 物件。
|
getHistoryAt | () | 方法 |
public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem| 執行階段版本: | AIR 1.0 |
在指定位置傳回操作記錄項目。
參數
position:uint — 操作記錄清單中的位置。
|
flash.html:HTMLHistoryItem — 指定位置上操作記錄項目的 URLRequest 物件。
|
相關 API 元素
historyBack | () | 方法 |
public function historyBack():void| 執行階段版本: | AIR 1.0 |
如果可能，在瀏覽器操作記錄中向後瀏覽。
呼叫 HTMLLoader 物件的這個方法與呼叫 HTML 網頁中 JavaScript window.history 屬性的 back() 方法具有相同作用。
這個函數不會擲出錯誤。
相關 API 元素
historyForward | () | 方法 |
public function historyForward():void| 執行階段版本: | AIR 1.0 |
如果可能，在瀏覽器操作記錄中向前瀏覽。
呼叫 HTMLLoader 物件的這個方法與呼叫 HTML 網頁中 JavaScript window.history 屬性的 forward() 方法具有相同作用。
這個函數不會擲出錯誤。
相關 API 元素
historyGo | () | 方法 |
load | () | 方法 |
public function load(urlRequestToLoad:URLRequest):void| 執行階段版本: | AIR 1.0 |
使用 urlRequestToLoad 參數所指定網站中的資料來載入 HTMLLoader 物件。呼叫這個方法一開始會將 loaded 屬性設定為 false。這個方法會起始一個一定以非同步方式完成的作業。
以隱含方式呼叫這個方法會取消以這個方法或 loadString() 方法所起始、任何待處理的前一個載入作業。絕不會傳送前一個載入作業的 complete 事件。
可能永遠不會傳送 complete 事件。這發生於載入 HTMLLoader 物件中的任何 HTML 內容從未完整下載時。如果 HTML 內容參考無限重複產生內容之 CGI 指令碼的 URL，就會發生這種情況。
參數
urlRequestToLoad:URLRequest — URLRequest 物件，包含要載入 URL 的相關資訊。除了要載入的 URL 之外，URLRequest 物件還包含可定義 HTTP 表單送出方法 (GET 或 POST) 的屬性、與要求一併傳輸的任何資料，並要求標頭。
|
相關 API 元素
loadString | () | 方法 |
public function loadString(htmlContent:String):void| 執行階段版本: | AIR 1.0 |
使用 HTML 字串中包含的 HTML 內容來載入 HTMLLoader 物件。當字串中的 HTML 完成呈現時，會傳送 complete 事件。complete 事件一定是以非同步方式傳送。
以隱含方式呼叫這個方法會取消以這個方法或 load() 方法所起始、任何待處理的前一個載入作業。絕不會傳送前一個載入作業的 complete 事件。
如果字串中指定的 HTML 沒有外部資源的參考，這個方法就會以同步方式顯示 HTML。不過，仍會以非同步方式傳送 complete 事件。在呼叫這個函數之後，如果這個類別的 loaded 屬性為 true，則會以同步方式顯示 htmlContent 引數中指定的 HTML 內容。
可能永遠不會傳送 complete 事件。這發生於載入 HTMLLoader 物件中的任何 HTML 內容從未完整下載時。如果 HTML 內容參考無限重複產生內容之 CGI 指令碼的 URL，就會發生這種情況。
只有當 placeLoadStringContentInApplicationSandbox 屬性設定為 true 時，透過 loadString() 方法所載入的內容才會放入應用程式安全執行程序中。
參數
htmlContent:String — 字串，包含要載入 HTMLLoader 物件的 HTML 內容。
|
相關 API 元素
reload | () | 方法 |
complete | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.COMPLETE| 執行階段版本: | AIR 1.0 |
指出 loadString 或 load 方法所要求的最後一個載入作業已完成。當 JavaScript load 事件已在 HTMLLoader 物件的 HTML DOM 上觸發之後，就會傳送此事件。這個事件一定是以非同步方式傳送。這個事件的事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。
Event.COMPLETE 常數會定義 complete 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 已完成載入的網路物件。 |
相關 API 元素
htmlBoundsChange | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.HTML_BOUNDS_CHANGE| 執行階段版本: | AIR 1.0 |
指出 HTMLLoader 物件的 contentWidth 和 contentHeight 屬性或兩者已變更。例如，新影像或其他內容載入可能產生變更。事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。
HTMLLoader 物件可以在起始載入作業之後的任何時間傳送這個事件，甚至在此物件已經傳送 complete 事件之後。
Event.HTML_BOUNDS_CHANGE 常數會定義 htmlBoundsChange 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | HTMLLoader 物件。 |
target | HTMLLoader 物件。 |
相關 API 元素
htmlDOMInitialize | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.HTML_DOM_INITIALIZE| 執行階段版本: | AIR 1.0 |
指出為了回應載入作業，已建立 HTML DOM。在傳送此事件時，HTMLLoader 物件的 load() 和 loadString() 方法會擲出例外。在傳送此事件時，如果設定或呼叫任何 JavaScript 物件的任何屬性或方法，而該 JavaScript 物件可從控制 HTMLLoader 物件中所載入 URL 之 HTMLLoader 物件的 window 屬性來進行存取，也會擲出例外。例如，透過設定 HTMLLoader 物件的 window 屬性來設定 window.location 會產生 JavaScript 例外。
Event.HTML_DOM_INITIALIZE 常數會定義 htmlDOMInitialize 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | HTMLLoader 物件。 |
target | HTMLLoader 物件。 |
相關 API 元素
htmlRender | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.HTML_RENDER| 執行階段版本: | AIR 1.0 |
指出 HTMLLoader 物件中的內容顯示都是最新的。每當 HTML 內容發生任何呈現變更時，就會頻繁地傳送這個事件。例如，當使用者按一下連結之後顯示新內容，或當網頁中的 JavaScript 呈現 HTML 時，會傳送這個事件。事件偵聽程式可以呼叫 HTMLLoader 的任何方法或存取其任何屬性。
這個事件的處理常式應該檢查 HTMLLoader 物件的 contentWidth 和 contentHeight 屬性，以便更新與它相關聯的任何捲軸。
HTMLLoader 物件可以在起始載入作業之後的任何時間傳送這個事件，甚至在此物件已經傳送 complete 事件之後。
Event.HTML_RENDER 常數會定義 htmlRender 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | HTMLLoader 物件。 |
target | HTMLLoader 物件。 |
locationChange | 事件 |
flash.events.LocationChangeEvent屬性 LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE| 執行階段版本: | AIR 2.7 |
指出 HTMLLoader 物件的 location 屬性已變更。這個事件的事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。
LocationChangeEvent 類型的 locationChange 事件是由使用 AIR namespace 2.7 和更新版本之應用程式中的 HTMLLoader 所傳送。在舊版 AIR 中，傳送的事件物件是 Event 類別的實體。
相關 API 元素
locationChange | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.LOCATION_CHANGE| 執行階段版本: | AIR 1.0 |
指出 HTMLLoader 物件的 location 屬性已變更。這個事件的事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。
Event 類型的 locationChange 事件是由使用 AIR 2.7 以前版本命名空間之應用程式中的 HTMLLoader 所傳送。在 AIR 2.7 和更新版本中，事件物件是 LocationChangeEvent 類別的實體，可提供其他設定為新頁面 URL 的 location 屬性。
Event.LOCATION_CHANGE 常數會定義 locationChange 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | HTMLLoader 物件。 |
target | HTMLLoader 物件。 |
相關 API 元素
locationChanging | 事件 |
flash.events.LocationChangeEvent屬性 LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 2.7 |
發出訊號，表示 HTMLLoader 物件的 location 屬性即將變更。
locationChanging 事件只會在透過使用者互動而使位置變更時傳送，例如當使用者按一下連結，或是由 HTMLLoader 內執行的程式碼傳送，例如用戶端重新導向。根據預設，新位置將顯示在此 HTMLLoader 物件中。您可以呼叫事件物件的 preventDefault() 方法，以取消預設行為。例如，您可以使用 flash.net.navigateToURL() 函數，根據事件物件的 location 屬性，在系統瀏覽器中開啟頁面。
當您呼叫下列方法時，不會傳送 locationChanging() 事件：
- load()
- loadString()
- reload()
- historyBack()
- historyForward()
- historyGo()
此外，當 navigateInSystemBrowser 屬性為 true 且目的地頁面在系統瀏覽器中開啟時，不會傳送此事件，因為 HTMLLoader 位置未變更。
LOCATION_CHANGING 常數會定義頁面位置變更之前所傳送 type 屬性 LocationChangeEvent 物件的值。
範例 ( 如何使用本範例 )
package{
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class LocationChanging extends Sprite
{
var htmlLoader:HTMLLoader = new HTMLLoader();
public function LocationChanging()
{
htmlLoader.width = stage.stageWidth;
htmlLoader.height = stage.stageHeight;
htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
this.addChild( htmlLoader );
}
private function onLocationChanging( event:LocationChangeEvent ):void
{
trace( "Location changing: " + event.location );
if ( event.location.indexOf( "http://www.adobe.com" ) < 0 )
{
event.preventDefault();
}
}
}
}
scroll | 事件 |
flash.events.Event屬性 Event.type =
flash.events.Event.SCROLL| 執行階段版本: | AIR 1.0 |
指出 HTMLLoader 物件已變更 scrollH 或 scrollV 屬性。當 HTMLLoader 物件中執行的 JavaScript 叫用 window 物件的 scrollTo() 方法，而所需的位置尚未顯示時，HTMLLoader 物件就會傳送這個事件。當 ActionScript 程式碼變更 scrollH 或 scrollV 屬性時，不會傳送此事件。事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。
這個事件的事件處理常式應該檢查 scrollH 和 scrollV 屬性，以更新與 HTMLLoader 物件關聯的任何捲軸。
HTMLLoader 物件可以在起始載入作業之後的任何時間傳送這個事件，甚至在此物件已經傳送 complete 事件之後。
Event.SCROLL 常數會定義 scroll 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | 正主動使用事件偵聽程式處理 Event 物件的物件。 |
target | 已經過捲動的 TextField 物件。 這個 target 屬性並非永遠都是註冊事件偵聽之顯示清單中的物件。請使用 currentTarget 屬性，存取目前正在處理該事件之顯示清單中的物件。 |
uncaughtScriptException | 事件 |
flash.events.HTMLUncaughtScriptExceptionEvent屬性 HTMLUncaughtScriptExceptionEvent.type =
flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION| 執行階段版本: | AIR 1.0 |
指出 HTMLLoader 物件中發生未捕捉的 JavaScript 例外。事件處理常式可以呼叫 HTMLLoader 物件的任何方法或存取其任何屬性。此事件是可以取消的，在 AIR 除錯啟動程式中執行時，預設行為是將 JavaScript 堆疊傳送至追蹤輸出。
HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION 常數會定義 uncaughtScriptException 事件物件的 type 屬性值。
這個事件具有下列屬性：
| 屬性 | 值 |
|---|---|
bubbles | false |
cancelable | false；沒有要取消的預設行為指令。 |
exceptionValue | 評估 throw 陳述式中導致未捕捉例外的運算式所得出的結果。 |
stackTrace | 在執行導致未捕捉例外的 throw 陳述式時，代表堆疊追蹤的物件陣列。 |
target | HTMLLoader 物件。 |
相關 API 元素
package {
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class HTMLLoaderExample extends Sprite
{
public function HTMLLoaderExample()
{
var html:HTMLLoader = new HTMLLoader();
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.width = stage.stageWidth;
html.height = stage.stageHeight;
html.load(urlReq);
addChild(html);
}
}
}
Tue Jun 12 2018, 03:47 PM Z