HTMLLoader オブジェクトの表示プロパティ

HTMLLoader の基本的な表示プロパティを使用すると、親表示オブジェクト内でのコントロールの位置指定、サイズの設定、コントロールの表示と非表示の切り替えを行うことができます。HTML ウィンドウの HTMLLoader オブジェクトについては、これらのプロパティを変更しないでください。

基本的な表示プロパティを次に示します。

HTML ウィンドウ外では、HTMLLoader オブジェクトの width プロパティと height プロパティのデフォルト値は 0 です。読み込んだ HTML コンテンツを表示するには、まず width と height を設定する必要があります。HTML コンテンツは、HTMLLoader のサイズで描画され、コンテンツの HTML プロパティと CSS プロパティに従ってレイアウトされます。HTMLLoader のサイズを変更すると、コンテンツが再配置されます。

コンテンツを新しい HTMLLoader オブジェクトに読み込む場合（ width は 0 に設定されたまま）、HTMLLoader の表示の width と height を contentWidth プロパティと contentHeight プロパティで設定することもできます。このテクニックは、HTML と CSS の配置ルールに従ってレイアウトした場合に、最小幅が十分に確保されるページに対しては有効です。ただし、HTMLLoader によって適正な幅が指定されていないと、ページが細長いレイアウトに配置される場合があります。

HTMLLoader オブジェクトの paintsDefaultBackground プロパティは、HTMLLoader オブジェクトで不透明な背景を描画するかどうかを決定するもので、デフォルトで true になっています。 paintsDefaultBackground を false にすると、背景が透明になります。表示オブジェクトコンテナまたは HTMLLoader オブジェクトの下に位置するその他の表示オブジェクトは、HTML コンテンツの前景エレメントの背後に表示されます。

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

HTMLLoader オブジェクトの拡大／縮小では、拡大／縮小率が 1.0 を超えないようにしてください。HTMLLoader コンテンツのテキストは特定の解像度でレンダリングされるので、HTMLLoader オブジェクトを拡大するとピクセルが目立つようになります。

次の場合、HTMLLoader オブジェクトに読み込まれる SWF コンテンツおよび PDF コンテンツは表示されません。

• HTMLLoader オブジェクトを 1.0 以外の倍率に拡大／縮小した場合。

• HTMLLoader オブジェクトの alpha プロパティを 1.0 以外の値に設定した場合。

• HTMLLoader コンテンツを回転した場合。

問題のあるプロパティ設定を削除し、アクティブなフィルターを削除すると、コンテンツが再表示されます。

また、ランタイムでは、透明ウィンドウに PDF コンテンツを表示できません。オブジェクトまたは埋め込みタグの wmode パラメーターが opaque または transparent に設定されている場合、ランタイムでは HTML ページに埋め込まれた SWF コンテンツのみが表示されます。 wmode のデフォルト値は window なので、wmode パラメーターを明示的に設定しない限り、SWF コンテンツは透明ウィンドウに表示されません。

HTMLLoader でこれらのタイプのメディアを読み込む方法について詳しくは、 HTML への SWF コンテンツの埋め込み および AIR での PDF コンテンツの追加 を参照してください。

HTMLLoader クラスは、特殊エフェクトに使用できるメソッドを複数継承しています。一般に、これらのエフェクトは、HTMLLoader の表示で使用する場合は制限がありますが、トランジションやその他の一時的なエフェクトに役立ちます。例えば、ユーザー入力を収集するダイアログウィンドウを表示する場合に、ユーザーがダイアログを閉じるまでメインウィンドウの表示をぼかすことができます。同様に、ウィンドウを閉じるときに表示をフェードアウトさせることもできます。

高度な表示プロパティを次に示します。

次の例では、 filters 配列を設定して HTML 表示全体をぼかす方法を示します。

var blur = new window.runtime.flash.filters.BlurFilter(); 
var filters = [blur]; 
window.htmlLoader.filters = filters;