HTMLLoader  - AS3

このオブジェクトから発行された HTTP リクエストに対して認証リクエストを処理する（true）か、しない（false）かを指定します。false の場合、認証チャレンジは HTTP エラーを返します。

デフォルト値： initialized from URLRequestDefaults.authenticate。

関連する API エレメント

このオブジェクトから発行された HTTP リクエストに対する正常な応答データをキャッシュするかどうかを指定します。true に設定された場合、HTMLLoader オブジェクトはオペレーティングシステムの HTTP キャッシュを使用します。

デフォルト値： initialized from URLRequestDefaults.cacheResponse。

関連する API エレメント

HTML コンテンツの高さです（ピクセル単位）。このプロパティは HTMLLoader オブジェクトのサイズの変更に合わせて変更できます。例えば、HTML ページは HTMLLoader オブジェクトの高さ全体を使用する場合が多く、HTMLLoader オブジェクトの高さを変更すると contentHeight プロパティも変更されます。

HTML コンテンツの幅です（ピクセル単位）。このプロパティは HTMLLoader オブジェクトのサイズの変更に合わせて変更できます。例えば、HTML ページは HTMLLoader オブジェクトの幅全体を使用することが多く、HTMLLoader オブジェクトの幅を変えると contentWidth プロパティも変更される場合があります。

HTMLLoader オブジェクト内のコンテンツがフォーカス可能であるかどうかを示します。

レンダリング中の HTML キャンバスの矩形の高さを指定します。このプロパティ値は、HTMLLoader 表示オブジェクトの高さです（ピクセル単位）。height の最大値は 4,095 ピクセルです。このプロパティを変更すると、HTMLLoader オブジェクトによって HTML ドキュメントの再レンダリングが実行されます。このプロパティの変更に応答して、htmlBoundsChanged イベントが送出されることがあります。

HTMLLoader オブジェクトの width プロパティまたは height プロパティを設定すると、オブジェクトの境界は変更されますが、（他の種類の表示オブジェクトと同様に）コンテンツは拡大または縮小されません。

後方と前方のエントリを含む、履歴リスト全体の長さです。このプロパティの値は、HTML ページの JavaScript プロパティ window.history.length の値と同じです。

関連する API エレメント

履歴リストでの現在の位置です。履歴リストは、HTML ページの window.history オブジェクトに対応しています。現在の位置未満のエントリは "後方" リスト、現在の位置を超えるエントリは "前方" リストです。最後の位置を超える位置を設定しようとすると、最後の位置に設定されます。

関連する API エレメント

ユーザーインターフェイスにある、HTMLLoader オブジェクトの window.document.title プロパティなどの特定のエレメントの変更を扱う HTMLHost オブジェクトです。 HTMLLoader オブジェクトのデフォルトの動作をオーバーライドするには、HTMLHost クラスのサブクラスを作成し、HTML コンテンツで様々なユーザーインターフェイスの変更を処理できるようにそのメンバ関数をオーバーライドします。

関連する API エレメント

このオブジェクトによって発行された HTTP 要求のタイムアウト値（ミリ秒）を指定します。

アイドルタイムアウトとは、接続が確立された後、要求が廃棄されるまでの間、クライアントがサーバーからの応答を待機する時間です。

デフォルト値： initialized from URLRequestDefaults.idleTimeout。

関連する API エレメント

クライアントシステムで HTMLLoader クラスがサポートされているかどうかを示します。

以前の load() または loadString() メソッドの呼び出しに対応する JavaScript の load イベントが、HTMLLoader オブジェクトの HTML DOM に発行されたかどうかを示します。このプロパティが true であるのは、complete イベントが送出されていない場合です。このプロパティが true にならない場合もあります。complete イベントが送出されない場合も、同様の結果になります。

HTMLLoader オブジェクトにロードされたコンテンツの URL です。

このオブジェクトのクッキーの管理に HTTP プロトコルスタックを使用するかどうかを指定します。true の場合、クッキーが要求に追加され、応答クッキーが記憶されます。false の場合、クッキーはリクエストに追加されず、応答クッキーは記憶されません。

デフォルト値： initialized from URLRequestDefaults.manageCookies。

関連する API エレメント

HTML コンテンツのルートフレームの移動（ユーザーがリンクをクリックするとき、window.location プロパティが設定されるとき、window.open() を呼び出すときなど）が、HTMLLoader オブジェクトでの移動（false）になるのか、デフォルトシステム Web ブラウザーでの移動（true）になるのかを示します。すべての移動を（HTMLLoader オブジェクト内ではなく）システム Web ブラウザー内で発生させる場合は、このプロパティを true に設定します。

デフォルト値： false。

HTMLLoader ドキュメントの背景を不透明白色にする（true）か、しない（false）かを指定します。このプロパティを false に設定すると、HTMLLoader オブジェクトの HTML の背景には、表示オブジェクトコンテナと表示オブジェクトコンテナの透明度（alpha 値）が使用されます。ただし、HTML ドキュメントの body エレメントまたはその他のエレメントに不透明背景色が設定されている場合は（例えば style="background-color:gray" と指定されている場合など）、レンダリングされた HTML の該当部分には、指定の不透明背景色が使用されます。

ユーザーのシステムに対する PDF サポートのタイプです。整数のコード値で定義します。このプロパティが PDFCapability.STATUS_OK である場合にのみ、HTMLLoader オブジェクトで PDF のコンテンツを表示できます。PDFCapability クラスでは、pdfCapability プロパティの値として使用できる次の定数を定義します。

関連する API エレメント

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。

関連する API エレメント

HTML ページ内の JavaScript の window.runtime オブジェクトで使用するアプリケーションドメインです。

null の場合または HTMLLoader オブジェクトを含む SWF コンテンツと同じセキュリティドメインからのものではない HTML コンテンツの場合、HTML ページではドメインとしてデフォルトのアプリケーションドメインが使用されます。

関連する API エレメント

HTMLLoader オブジェクト内の HTML コンテンツの水平スクロール位置です。

HTMLLoader オブジェクト内の HTML コンテンツの垂直スクロール位置です。

ユーザーのシステムに対する SWF サポートのタイプです。整数のコード値で定義します。このプロパティが HTMLSWFCapability.STATUS_OK である場合にのみ、HTMLLoader オブジェクトで SWF のコンテンツを表示できます。HTMLSWFCapability クラスでは、swfCapability プロパティの値として使用できる次の定数を定義します。

関連する API エレメント

HTML ページで文字エンコーディングが指定されていない場合に HTMLLoader コンテンツで使用される文字エンコーディングです。HTML ページでは、文字エンコーディングは meta タグを使用して次のように指定されます。

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

値は、有効な文字セット の IANA リストで定義されています。

HTML ページ、textEncodingFallback プロパティ、または textEncodingOverride プロパティによってエンコーディングが指定された場合、HTML コンテンツは ISO-8859-1 エンコーディングを使用します。

関連する API エレメント

HTML ページの設定をオーバーライドする場合に HTMLLoader コンテンツで使用される文字エンコーディングです。HTML ページでは、文字エンコーディングは meta タグを使用して次のように指定されます。

<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">

この設定により、textEncodingFallback プロパティ内のすべての設定もオーバーライドされます。

値は、有効な文字セット の IANA リストで定義されています。

指定のエンコーディングを使って AIR が HTML コンテンツを更新するように HTML コンテンツがロードされた後で、textEncodingOverride プロパティを設定します。HTMLLoader が新しいページに移動した後、新しいページで指定のエンコーディングを使用する場合はもう一度プロパティを設定する必要があります。

HTML ページ、textEncodingFallback プロパティ、または textEncodingOverride プロパティによってエンコーディングが指定された場合、HTML コンテンツは ISO-8859-1 エンコーディングを使用します。

textEncodingOverride プロパティを null に設定すると、デフォルトビヘイビアーが復元されます。

関連する API エレメント

このオブジェクトから発行された HTTP リクエストがデータを取得する前に、ローカルキャッシュを調べるかどうかを指定します。

デフォルト値： initialized from URLRequestDefaults.useCache。

関連する API エレメント

この HTMLLoader オブジェクトからの今後のコンテンツ要求に使用するユーザーエージェントストリングです。

ユーザーエージェントストリングを設定するには、HTMLLoader オブジェクトの userAgent プロパティを load() メソッドの呼び出しの前に設定します。userAgent プロパティ（load() メソッドに渡される URLRequest のプロパティ）は使用されません。

アプリケーションドメインですべての HTMLLoader オブジェクトが使用するデフォルトのユーザーエージェントストリングを設定するには、静的な URLRequestDefaults.userAgent プロパティを設定します。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"

関連する API エレメント

レンダリング中の HTML キャンバスの矩形の幅を指定します。これは、HTMLLoader 表示オブジェクトの幅です（ピクセル単位）。width の最大値は 4,095 ピクセルです。このプロパティを変更すると、HTMLLoader オブジェクトによって HTML ドキュメントの再レンダリングが実行されます。このプロパティの変更に応答して、htmlBoundsChange イベントが送出されることがあります。HTMLLoader オブジェクトの width プロパティおよび height プロパティを設定すると、オブジェクトの境界は変更されますが、（他の種類の表示オブジェクトと同様に）コンテンツは拡大または縮小されません。

HTML コントロールにロードされたコンテンツのグローバル JavaScript オブジェクトです。

HTMLLoader オブジェクトを作成します。

進行中のロード操作をすべてキャンセルします。

HTMLLoader オブジェクトを格納する新しい NativeWindow オブジェクトを作成します。このメソッドによって返された HTMLLoader オブジェクトを使用して、HTML コンテンツをロードします。

デフォルトでは（このメソッドの呼び出し時にパラメーターを設定しなかった場合）、新しいウィンドウには標準のシステムクロムが使用され、コンテンツの ScrollBar コントロールが含まれます。新しいウィンドウのプロパティを変更するには、パラメーターを設定します。

ウィンドウにコンテンツを読み込み、スタイルシートを適用すると、グラフィックに関して重大ではない問題が発生する場合があります。このような不具合が表示されるのを防ぐには、visible パラメーターを false に設定します。ウィンドウがコンテンツを読み込んでレイアウトすると、window.nativeWindow.visible プロパティを true に設定するか、window.nativeWindow.activate() メソッドを呼び出して、そのコンテンツを表示します。

パラメーター

指定の位置で履歴エントリを返します。

パラメーター

関連する API エレメント

可能であれば、ブラウザーの履歴内を後方に戻ります。

HTMLLoader オブジェクトのこのメソッドを呼び出すと、該当する HTML ページの JavaScript で、back() メソッド（window.history プロパティのメソッド）を呼び出した場合と同じ結果が得られます。

この関数はエラーをスローしません。

関連する API エレメント

可能であれば、ブラウザーの履歴内を前方に進みます。

HTMLLoader オブジェクトのこのメソッドを呼び出すと、該当する HTML ページの JavaScript で、forward() メソッド（window.history プロパティのメソッド）を呼び出した場合と同じ結果が得られます。

この関数はエラーをスローしません。

関連する API エレメント

ブラウザーの履歴内を指定のステップ数だけ移動します。正数の場合は前方、負数の場合は後方に移動します。0 の場合は、強制的にリロードされます。

このメソッドを実行すると、HTML ページの JavaScript で go() メソッド（window.history プロパティのメソッド）を呼び出した場合と同じ結果が得られます。

この関数はエラーをスローしません。

パラメーター

関連する API エレメント

urlRequestToLoad パラメーターによって指定されたサイトからのデータと共に、HTMLLoader オブジェクトをロードします。このメソッドの呼び出しを実行すると、loaded プロパティの初期値は false に設定されます。このメソッドにより、必ず非同期的に完了する処理が開始されます。

このメソッドの呼び出しを実行すると、このメソッドまたは loadString() メソッドにより開始された保留中のロード処理が、暗黙的にすべてキャンセルされます。以前のロード処理に対する complete イベントは、発行されません。

complete イベントが発行されない場合もあります。これは、HTMLLoader オブジェクトにロードされた HTML コンテンツが完全にダウンロードされなかった場合に起こります。これは、コンテンツの生成を無限に繰り返す CGI スクリプトの URL への参照が、HTML コンテンツに設定されている場合に起こることがあります。

パラメーター

関連する API エレメント

HTML ストリングに含まれている HTML コンテンツと共に、HTMLLoader オブジェクトをロードします。ストリングに含まれる HTML のレンダリングが完了すると、complete イベントが送出されます。complete イベントは必ず非同期で送出されます。

このメソッドの呼び出しを実行すると、このメソッドまたは load() メソッドにより開始された保留中のロード処理が、暗黙的にすべてキャンセルされます。以前のロード処理に対する complete イベントは、発行されません。

ストリングで指定された HTML に外部リソースへの参照が設定されていない場合、このメソッドは HTML を同期的にレンダリングします。ただし、complete イベントは非同期で送出されます。この関数の呼び出しの直後に、このクラスの loaded プロパティが true である場合、htmlContent パラメーターで指定された HTML コンテンツが同期的にレンダリングされたことを意味します。

complete イベントが発行されない場合もあります。これは、HTMLLoader オブジェクトにロードされた HTML コンテンツが完全にダウンロードされなかった場合に起こります。これは、コンテンツの生成を無限に繰り返す CGI スクリプトの URL への参照が、HTML コンテンツに設定されている場合に起こることがあります。

loadString() メソッドを使用してロードされるコンテンツは、placeLoadStringContentInApplicationSandbox プロパティが true に設定されている場合のみ、アプリケーションセキュリティサンドボックスの中に置かれます。

パラメーター

関連する API エレメント

現在の location からページをリロードします。

loadString または load メソッドによって要求された最後のロード処理が完了したことを通知します。このイベントは、後（JavaScript の load イベントが HTMLLoader オブジェクトの HTML DOM で発行された後）に送出されます。このイベントは必ず非同期で送出されます。このイベントのイベントハンドラーでは、任意のメソッドの呼び出しおよび HTMLLoader オブジェクトの任意のプロパティへのアクセスが可能です。

このイベントには、次のプロパティがあります。

関連する API エレメント

HTMLLoader オブジェクトの contentWidth プロパティと contentHeight プロパティの一方または両方が変更されたことを通知します。これは、例えば新しいイメージまたはその他のコンテンツをロードした結果である可能性があります。イベントハンドラーでは、任意のメソッドの呼び出しおよび HTMLLoader オブジェクトの任意のプロパティへのアクセスが可能です。

HTMLLoader オブジェクトは、ロード処理が開始された後であれば、complete イベントを送出した後でも、このイベントを随時送出できます。

このイベントには、次のプロパティがあります。

関連する API エレメント

ロード操作に対する応答で HTML DOM が作成されたことを通知します。このイベントの送出中に、HTMLLoader オブジェクトの load() メソッドおよび loadString() メソッドが例外をスローします。HTMLLoader オブジェクトにロードされる URL を制御する HTMLLoader オブジェクトの window プロパティからアクセスできる JavaScript オブジェクトの任意のプロパティおよびメソッドは、このイベントの送出中に設定された（または呼び出された）場合、例外をスローします。例えば、window.location を HTMLLoader オブジェクトの window プロパティを使用して設定すると、JavaScript 例外が発生します。

このイベントには、次のプロパティがあります。

関連する API エレメント

HTMLLoader オブジェクト内のコンテンツのレンダリングが最新の状態であることを通知します。このイベントは、HTML コンテンツのレンダリングが変更されるたびに、頻繁に送出することができます。例えば、ユーザーがリンクをクリックして新しいコンテンツが表示されるとき、ページ内の JavaScript が HTML をレンダリングするときなどに、このイベントが送出されます。イベントリスナーでは、任意のメソッドの呼び出しおよび HTMLLoader オブジェクトの任意のプロパティへのアクセスが可能です。

このイベントのハンドラーを使用して HTMLLoader オブジェクトの contentWidth プロパティおよび contentHeight プロパティを確認し、HTMLLoader オブジェクトに関連付けられたすべてのスクロールバーを更新する必要があります。

HTMLLoader オブジェクトは、ロード処理が開始された後であれば、complete イベントを送出した後でも、このイベントを随時送出できます。

このイベントには、次のプロパティがあります。

HTMLLoader オブジェクトの location プロパティが変更されたことを通知します。このイベントのイベントハンドラーでは、任意のメソッドの呼び出しおよび HTMLLoader オブジェクトの任意のプロパティへのアクセスが可能です。

AIR 名前空間 2.7 以降を使用するアプリケーションでは、タイプ LocationChangeEvent の locationChange イベントが HTMLLoader によって送出されます。AIR の以前のバージョンでは、送出されたイベントオブジェクトは Event クラスのインスタンスです。

関連する API エレメント

HTMLLoader オブジェクトの location プロパティが変更されたことを通知します。このイベントのイベントハンドラーでは、任意のメソッドの呼び出しおよび HTMLLoader オブジェクトの任意のプロパティへのアクセスが可能です。

2.7 より前の AIR 名前空間を使用するアプリケーションでは、タイプ Event の locationChange イベントが HTMLLoader によって送出されます。AIR 2.7 以降では、イベントオブジェクトは LocationChangeEvent クラスのインスタンスです。このクラスでは、新しいページの URL に設定される追加の location プロパティが用意されています。

このイベントには、次のプロパティがあります。

関連する API エレメント

HTMLLoader オブジェクトの location プロパティが変更されることを通知します。

locationChanging イベントが送出されるのは、ユーザーがリンクをクリックするなどのユーザー操作によって、またはクライアント側のリダイレクトなどの HTMLLoader 内部で実行するコードによって、location の変更が開始されたときのみです。デフォルトで、新しい場所はこの HTMLLoader オブジェクトに表示されます。デフォルトの動作をキャンセルするには、イベントオブジェクトの preventDefault() メソッドを呼び出します。例えば、イベントオブジェクトの location プロパティに基づいて、システムブラウザーのページを開くには、flash.net.navigateToURL() 関数を使用します.

次のメソッドを呼び出すときには、locationChanging() イベントは送出されません。

• load()
• loadString()
• reload()
• historyBack()
• historyForward()
• historyGo()

また、navigateInSystemBrowser プロパティが true で、目的のページをシステムブラウザーで開く場合、HTMLLoader の location が変更されないので、このイベントは送出されません。

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();
            }
        }
    }
}

scrollH プロパティまたは scrollV プロパティが HTMLLoader オブジェクトによって変更されたことを通知します。このイベントは、HTMLLoader オブジェクトで実行中の JavaScript が scrollTo() メソッド（window オブジェクト）を呼び出し、目的の場所がまだ表示されないときに、HTMLLoader オブジェクトによって送出されます。ActionScript コードで scrollH プロパティまたは scrollV プロパティが変更された場合、イベントは送出されません。イベントハンドラーでは、任意のメソッドの呼び出しおよび HTMLLoader オブジェクトの任意のプロパティへのアクセスが可能です。

このイベントのイベントハンドラーを使用して scrollH プロパティおよび scrollV プロパティを確認し、HTMLLoader オブジェクトに関連付けられたすべてのスクロールバーを更新する必要があります。

HTMLLoader オブジェクトは、ロード処理が開始された後であれば、complete イベントを送出した後でも、このイベントを随時送出できます。

このイベントには、次のプロパティがあります。

HTMLLoader オブジェクトで不明な JavaScript 例外が発生したことを通知します。イベントハンドラーでは、任意のメソッドの呼び出しおよび HTMLLoader オブジェクトの任意のプロパティへのアクセスが可能です。イベントはキャンセルすることができ、AIR Debug Launcher 実行時のデフォルトビヘイビアーは JavaScript スタックをトレース出力に送信することです。

このイベントには、次のプロパティがあります。

関連する API エレメント