fl.containers.UILoader (ActionScript 3.0)

	プロパティ	定義元
		accessibilityProperties : AccessibilityProperties この表示オブジェクトの現在のアクセシビリティオプションです。	DisplayObject
		alpha : Number 指定されたオブジェクトのアルファ透明度値を示します。	DisplayObject
		autoLoad : Boolean UILoader インスタンスで指定したコンテンツを自動的にロードするかどうかを指定する値を取得または設定します。	UILoader
		blendMode : String 使用するブレンドモードを指定する BlendMode クラスの値です。	DisplayObject
		buttonMode : Boolean このスプライトのボタンモードを指定します。	Sprite
		bytesLoaded : uint [read-only] それまでにロードしたコンテンツのバイト数を取得します。	UILoader
		bytesTotal : uint [read-only] ロードされるコンテンツのバイト数を取得します。	UILoader
		cacheAsBitmap : Boolean true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。	DisplayObject
		constructor : Object 特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		content : DisplayObject [read-only] load() メソッドまたは source プロパティを使用してロードされた SWF ファイルや (JPG、PNG、GIF などの形式の) イメージファイルのルート表示オブジェクトが含まれます。	UILoader
		contextMenu : ContextMenu このオブジェクトに関連付けられたコンテキストメニューを指定します。	InteractiveObject
		doubleClickEnabled : Boolean オブジェクトが doubleClick イベントを受け取るかどうかを指定します。	InteractiveObject
		dropTarget : DisplayObject [read-only] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。	Sprite
		enabled : Boolean コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。	UIComponent
		filters : Array 表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。	DisplayObject
		focusEnabled : Boolean ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示すブール値を取得または設定します。	UIComponent
		focusManager : IFocusManager このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得または設定します。	UIComponent
		focusRect : Object このオブジェクトがフォーカス矩形を表示するかどうかを指定します。	InteractiveObject
		graphics : Graphics [read-only] ベクターの描画コマンドが発生する、このスプライトに属する Graphics オブジェクトを指定します。	Sprite
		height : Number コンポーネントの高さを取得または設定します (ピクセル単位)。	UIComponent
		hitArea : Sprite スプライトのヒット領域となる別のスプライトを指定します。	Sprite
		loaderInfo : LoaderInfo [read-only] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。	DisplayObject
		maintainAspectRatio : Boolean 元のイメージの縦横比を維持するか、またはイメージのサイズを UILoader コンポーネントの現在の幅と高さに合わせるかどうかを示す値を取得または設定します。	UILoader
		mask : DisplayObject 呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。	DisplayObject
		mouseChildren : Boolean オブジェクトの子に対してマウスが有効かどうかを調べます。	DisplayObjectContainer
		mouseEnabled : Boolean このオブジェクトがマウスメッセージを受け取るかどうかを指定します。	InteractiveObject
		mouseFocusEnabled : Boolean ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示す値を取得または設定します。	UIComponent
		mouseX : Number [read-only] マウス位置の x 座標を示します (ピクセル単位)。	DisplayObject
		mouseY : Number [read-only] マウス位置の y 座標を示します (ピクセル単位)。	DisplayObject
		name : String DisplayObject のインスタンス名を示します。	DisplayObject
		numChildren : int [read-only] このオブジェクトの子の数を返します。	DisplayObjectContainer
		opaqueBackground : Object 表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。	DisplayObject
		parent : DisplayObjectContainer [read-only] この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。	DisplayObject
		percentLoaded : Number [read-only] ロード済みのコンテンツのパーセンテージを示す 0 から 100 までの数値を取得します。	UILoader
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		root : DisplayObject [read-only] ロードされた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。	DisplayObject
		rotation : Number DisplayObject インスタンスの元の位置からの回転角を度単位で示します。	DisplayObject
		scale9Grid : Rectangle 現在有効な拡大 / 縮小グリッドです。	DisplayObject
		scaleContent : Boolean UILoader インスタンスのサイズに合わせてイメージのサイズを自動的に拡大 / 縮小するかどうかを指定する値を取得または設定します。	UILoader
		scaleX : Number コンポーネントの現在の幅に縮尺率を乗算します。	UIComponent
		scaleY : Number コンポーネントの現在の高さに縮尺率を乗算します。	UIComponent
		scrollRect : Rectangle 表示オブジェクトのスクロール矩形の境界です。	DisplayObject
		soundTransform : SoundTransform このスプライト内のサウンドを制御します。	Sprite
		source : Object ロードする SWF ファイルやイメージファイルの場所を示す絶対 URL または相対 URL、ライブラリ内のムービークリップのクラス名、表示オブジェクトを指す参照、コンポーネントと同じレベルにあるムービークリップのインスタンス名のいずれかを取得または設定します。	UILoader
		stage : Stage [read-only] 表示オブジェクトのステージです。	DisplayObject
		tabChildren : Boolean オブジェクトの子に対してタブが有効かどうかを調べます。	DisplayObjectContainer
		tabEnabled : Boolean このオブジェクトがタブ順序に含まれるかどうかを指定します。	InteractiveObject
		tabIndex : int SWF ファイル内のオブジェクトのタブ順序を指定します。	InteractiveObject
		textSnapshot : TextSnapshot [read-only] この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。	DisplayObjectContainer
		transform : Transform 表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。	DisplayObject
		useHandCursor : Boolean buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。	Sprite
		version : String = "3.0.0.15" コンポーネントのバージョン番号。	UIComponent
		visible : Boolean 現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。	UIComponent
		width : Number コンポーネントの幅を取得または設定します (ピクセル単位)。	UIComponent
		x : Number 親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。	UIComponent
		y : Number 親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。	UIComponent

	メソッド	定義元
		UILoader() UILoader コンポーネントの新しいインスタンスを作成します。	UILoader
		addChild(child:DisplayObject):DisplayObject この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。	DisplayObjectContainer
		clearStyle(style:String):void このコンポーネントインスタンスからスタイルプロパティを削除します。	UIComponent
		close():void その Loader インスタンスで現在進行中の load() メソッドの処理をキャンセルします。	UILoader
		contains(child:DisplayObject):Boolean 指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		drawFocus(focused:Boolean):void このコンポーネントのフォーカスインジケータを表示または非表示にします。	UIComponent
		drawNow():void invalidateNow とは異なり、すべてを無効化せずに直ちに描画を開始します。	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。	DisplayObject
		getChildAt(index:int):DisplayObject 指定のインデックス位置にある子表示オブジェクトインスタンスを返します。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 指定された名前に一致する子表示オブジェクトを返します。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 子 DisplayObject インスタンスのインデックス位置を返します。	DisplayObjectContainer
		getFocus():InteractiveObject 現在フォーカスを持っているオブジェクトを取得します。	UIComponent
		getObjectsUnderPoint(point:Point):Array 指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。	DisplayObject
		getStyle(style:String):Object コンポーネントのスタイル参照チェーンに設定されているスタイルプロパティを取得します。	UIComponent
		getStyleDefinition():Object [static] 現在のコンポーネントのデフォルトスタイルマップを取得します。	UILoader
		globalToLocal(point:Point):Point point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。	DisplayObject
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		hitTestObject(obj:DisplayObject):Boolean 表示オブジェクトを評価して、obj 表示オブジェクトと重複または交差するかどうかを調べます。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void プロパティが無効であることを示し、指定がない限り、コンポーネントを次のフレームに再描画します。	UIComponent
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		load(request:URLRequest = null, context:LoaderContext = null):void 指定されたコンテンツをロードしますが、コンテンツが指定されていない場合には、source プロパティに指定されているロケーションからコンテンツをロードします。	UILoader
		loadBytes(bytes:ByteArray, context:LoaderContext = null):void ByteArray オブジェクトに保管されているバイナリデータからロードします。	UILoader
		localToGlobal(point:Point):Point point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。	DisplayObject
		mergeStyles(... list):Object [static] 複数のクラスのスタイルを 1 つのオブジェクトに結合します。	UIComponent
		move(x:Number, y:Number):void 親の内部の指定された位置にコンポーネントを移動します。	UIComponent
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し列挙できるかどうかを示します。	Object
		removeChild(child:DisplayObject):DisplayObject DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject DisplayObjectContainer の子リストの指定されたインデックス位置から子 DisplayObject を削除します。	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setChildIndex(child:DisplayObject, index:int):void 表示オブジェクトコンテナの既存の子の位置を変更します。	DisplayObjectContainer
		setFocus():void 現在扱っているコンポーネントにフォーカスを設定します。	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		setSize(w:Number, h:Number):void コンポーネントのサイズを指定のサイズに変更します。	UILoader
		setStyle(style:String, value:Object):void このコンポーネントインスタンスのスタイルプロパティを設定します。	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 指定されたスプライトをユーザーがドラッグできるようにします。	Sprite
		stopDrag():void startDrag() メソッドを終了します。	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 指定された 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。	DisplayObjectContainer
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		unload():void この UILoader オブジェクトの子 (load() メソッドまたは source プロパティを使用してロードされたもの) を削除します。	UILoader
		validateNow():void 必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。	UIComponent
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

概要	定義元
activate	Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
added	表示オブジェクトが表示リストに追加されたときに送出されます。	DisplayObject
addedToStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。	DisplayObject
click	ユーザーが InteractiveObject をポインティングデバイスのメインボタンでクリックしたときに送出されます。	InteractiveObject
complete	コンテンツのロードが完了したときに送出されます。	UILoader
deactivate	Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
doubleClick	オブジェクトの doubleClickEnabled フラグが true に設定されている場合にユーザーが InteractiveObject をポインティングデバイスのメインボタンで 2 回続けてすばやくクリックすると送出されます。	InteractiveObject
enterFrame	再生ヘッドが新しいフレームに入るときに送出されます。	DisplayObject
focusIn	表示オブジェクトがフォーカスを取得したときに送出されます。	InteractiveObject
focusOut	表示オブジェクトがフォーカスを失ったときに送出されます。	InteractiveObject
hide	コンポーネントの可視性が可視から不可視に変化した後に送出されます。	UIComponent
init	ロードされた SWF ファイルのプロパティおよびメソッドにアクセスできる場合に送出されます。	UILoader
ioError	入出力エラーが発生すると送出されます。	UILoader
keyDown	ユーザーがキーを押したときに送出されます。	InteractiveObject
keyFocusChange	ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。	InteractiveObject
keyUp	ユーザーがキーを離したときに送出されます。	InteractiveObject
mouseDown	Flash Player ウィンドウの InteractiveObject インスタンスの上でユーザーがポインティングデバイスのボタンを押すと送出されます。	InteractiveObject
mouseFocusChange	ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。	InteractiveObject
mouseMove	ユーザーが InteractiveObject の上でポインティングデバイスを移動させたときに送出されます。	InteractiveObject
mouseOut	ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。	InteractiveObject
mouseOver	ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。	InteractiveObject
mouseUp	ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスの上でポインティングデバイスのボタンを解放したときに送出されます。	InteractiveObject
mouseWheel	Flash Player ウィンドウの InteractiveObject インスタンスの上でマウスホイールを回転させたときに送出されます。	InteractiveObject
move	コンポーネントが移動された後に送出されます。	UIComponent
open	ネットワーク操作が開始したときに送出されます。	UILoader
progress	コンテンツのロード中に送出されます。	UILoader
removed	表示オブジェクトが表示リストから削除されようとしているときに送出されます。	DisplayObject
removedFromStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。	DisplayObject
render	表示リストが更新およびレンダリングされようとしているときに送出されます。	DisplayObject
resize	コンポーネントのサイズが変更されたときに送出されます。	UILoader
rollOut	ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。	InteractiveObject
rollOver	ユーザーが InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。	InteractiveObject
securityError	コンテンツのロード中にセキュリティエラーが発生したときに送出されます。	UILoader
show	コンポーネントの可視性が不可視から可視に変化した後に送出されます。	UIComponent
tabChildrenChange	オブジェクトの tabChildren フラグの値が変更されたときに送出されます。	InteractiveObject
tabEnabledChange	オブジェクトの tabEnabled フラグが変更されたときに送出されます。	InteractiveObject
tabIndexChange	オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。	InteractiveObject

説明	定義元
disabledTextFormat	データ型: flash.text.TextFormat ボタンが無効な場合に、コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。	UIComponent
focusRectPadding	データ型: Number 形式: Length コンポーネント領域の外側とフォーカスインジケータ領域のエッジを区切るパディングです (ピクセル単位)。	UIComponent
focusRectSkin	データ型: Class フォーカスインジケータの表示に使用されるスキンです。	UIComponent
textFormat	データ型: flash.text.TextFormat コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。	UIComponent

プロパティの詳細

autoLoad

プロパティ

autoLoad:Boolean [read-write]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

UILoader インスタンスで指定したコンテンツを自動的にロードするかどうかを指定する値を取得または設定します。この値を true に設定すると、UILoader はコンテンツを自動的にロードし、false に設定すると、load() メソッドが呼び出されるまでコンテンツはロードされません。

デフォルト値 : true.

実装
public function get autoLoad():Boolean
public function set autoLoad(value:Boolean):void

関連項目

load()
source

例

次の例では、autoLoad プロパティを false に設定して、load() メソッドが呼び出されときだけコンテンツがロードされるようにする方法を示します。


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 40);
addChild(myUILoader);

var myButton:Button = new Button();
myButton.label = "Load image";
myButton.move(10, 10);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

function clickHandler(event:MouseEvent):void {
    myUILoader.load();
}

bytesLoaded

プロパティ

bytesLoaded:uint [read-only]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

それまでにロードしたコンテンツのバイト数を取得します。このプロパティの値が bytesTotal の値に等しくなったときには、コンテンツのロードが完了しています。

デフォルト値 : 0.

実装
public function get bytesLoaded():uint

関連項目

bytesTotal
percentLoaded

例

次の例では、ロードしたイメージを表示する UILoader コンポーネントインスタンスと、イメージの現在のダウンロードステータスを表示する ProgressBar および Label コンポーネントインスタンスを作成します。


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

bytesTotal

プロパティ

bytesTotal:uint [read-only]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

ロードされるコンテンツのバイト数を取得します。

デフォルト値 : 0.

実装
public function get bytesTotal():uint

関連項目

bytesLoaded
percentLoaded

例


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

content

プロパティ

content:DisplayObject [read-only]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

load() メソッドまたは source プロパティの設定を使用してロードされた SWF ファイルや (JPG、PNG、GIF などの形式の) イメージファイルのルート表示オブジェクトが含まれます。この値は、ロードが開始されるまでは undefined です。complete イベントのイベントハンドラ関数内にあるコンテンツのプロパティを設定します。

デフォルト値 : null.

実装
public function get content():DisplayObject

関連項目

complete
load()
source

例

次の例では、UILoader オブジェクトのコンテンツの透明度を変更するスライダを作成します。


import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.SliderEvent;

var s:Slider = new Slider();
s.minimum = 10;
s.maximum = 100;
s.liveDragging = true;
s.value = s.maximum;
s.move(10,10);
s.addEventListener(SliderEvent.THUMB_DRAG, updateUILoaderContentAlpha);
addChild(s);

var loader:UILoader = new UILoader();
loader.move(10,40);
loader.setSize(400, 300);
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

function updateUILoaderContentAlpha(e:SliderEvent):void {
    loader.content.alpha = s.value/100;
}

maintainAspectRatio

プロパティ

maintainAspectRatio:Boolean [read-write]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

元のイメージの縦横比を維持するか、またはイメージのサイズを UILoader コンポーネントの現在の幅と高さに合わせるかどうかを示す値を取得または設定します。この値を true に設定すると、元の縦横比が維持され、false に設定すると、ロードされるコンテンツのサイズは、UILoader の現在の寸法に合わせて変更されます。

このプロパティを使用するには、scaleContent プロパティを false に設定しておく必要があります。そうしないと、このプロパティは無視されます。

デフォルト値 : true.

実装
public function get maintainAspectRatio():Boolean
public function set maintainAspectRatio(value:Boolean):void

関連項目

scaleContent

例

次の例では、maintainAspectRatio プロパティの値を切り替えるチェックボックスを使用します。


import fl.containers.UILoader;
import fl.controls.CheckBox;

var myUILoader:UILoader = new UILoader();
myUILoader.setSize(200, 200);
myUILoader.scaleContent = true;
myUILoader.maintainAspectRatio = true;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 10);
addChild(myUILoader);

var myCheckBox:CheckBox = new CheckBox();
myCheckBox.label = "maintainAspectRatio";
myCheckBox.selected = myUILoader.maintainAspectRatio;
myCheckBox.width = 150;
myCheckBox.move(220, 10);
myCheckBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myCheckBox);

function changeHandler(event:Event):void {
    myUILoader.maintainAspectRatio = event.target.selected;
}

percentLoaded

プロパティ

percentLoaded:Number [read-only]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

ロード済みのコンテンツのパーセンテージを示す 0 から 100 までの数値を取得します。ロードしているコンテンツが、外部コンテンツではなく、ライブラリのアセットである場合、percentLoaded プロパティは 0 に設定されます。

デフォルト値 : 0.

実装
public function get percentLoaded():Number

関連項目

bytesLoaded
bytesTotal

例


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

scaleContent

プロパティ

scaleContent:Boolean [read-write]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

UILoader インスタンスのサイズに合わせてイメージのサイズを自動的に拡大 / 縮小するかどうかを指定する値を取得または設定します。この値を true に設定すると、イメージは UILoader インスタンスのサイズに合わせて自動的に拡大 / 縮小され、false に設定すると、ロードされたコンテンツは自動的にデフォルトサイズで表示されます。

デフォルト値 : true.

実装
public function get scaleContent():Boolean
public function set scaleContent(value:Boolean):void

関連項目

maintainAspectRatio

例

次の例では、イメージのサイズをロードして一致させる UILoader オブジェクトを作成します。


import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

source

プロパティ

source:Object [read-write]

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

ロードする SWF ファイルやイメージファイルの場所を示す絶対 URL または相対 URL、ライブラリ内のムービークリップのクラス名、表示オブジェクトを指す参照、コンポーネントと同じレベルにあるムービークリップのインスタンス名のいずれかを取得または設定します。

有効な画像ファイル形式は、GIF、PNG、JPEG などです。URLRequest オブジェクトを使用してアセットをロードするには、load() メソッドを使用します。

デフォルト値 : null.

実装
public function get source():Object
public function set source(value:Object):void

関連項目

autoLoad
load()

例

次の例では、イメージのサイズをロードして一致させる UILoader オブジェクトを作成します。

import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

コンストラクタの詳細

UILoader

()

コンストラクタ

public function UILoader()

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

UILoader コンポーネントの新しいインスタンスを作成します。

メソッドの詳細

()

メソッド

public function close():void

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

Loader インスタンスに対して現在進行中の load() メソッドの処理をキャンセルします。この load() メソッドは、source パラメータから呼び出すこともできます。

例外

Error — この URLStream オブジェクトには開いているストリームがありません。

関連項目

load()
source

例

次の例では、UILoader コンポーネントインスタンスと、UILoader インスタンスのイメージのダウンロードをキャンセルする Button コンポーネントインスタンスを作成します。


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 30);
addChild(myUILoader);

var cancelButton:Button = new Button();
cancelButton.label = "Cancel download";
cancelButton.move(10, 10);
cancelButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(cancelButton);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = myUILoader;
    try {
        uil.close();
        trace("Download cancelled:", uil.source);
    } catch (error:Error) {
        trace("Unable to cancel download.", error.message);
    }
}

getStyleDefinition

()

メソッド

public static function getStyleDefinition():Object

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

現在のコンポーネントのデフォルトスタイルマップを取得します。スタイルマップには、使用されているスタイルに基づき、コンポーネントの適切な型が保持されます。たとえば、disabledTextFormat スタイルには、null または TextFormat オブジェクトの値が保持されます。現在のコンポーネントに対し、これらのスタイルを使用して、setStyle() を呼び出すことができます。次のコードでは、指定したコンポーネントのデフォルトの disabledTextFormat スタイルがオーバーライドされます。

componentInstance.setStyle("disabledTextFormat", new TextFormat());

戻り値

Object — デフォルトスタイルのオブジェクトです。

例

次の例では、複数のコンポーネントクラス用のスタイルブラウザを作成します。

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

load

()

メソッド

public function load(request:URLRequest = null, context:LoaderContext = null):void

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

指定されたコンテンツをロードしますが、コンテンツが指定されていない場合には、source プロパティに指定されているロケーションからコンテンツをロードします。特に指定しない限り、LoaderContext オブジェクトは現在のドメインをアプリケーションドメインとして使用します。別の ApplicationDomain 値の指定、ポリシーファイルのチェック、または SecurityDomain 値の変更を行うには、新しい LoaderContext オブジェクトを初期化してそのオブジェクトにこのメソッドを渡します。

特に指定しない限り、context プロパティには現在のドメインが使用されます。別の ApplicationDomain の指定、ポリシーファイルのチェック、または SecurityDomain の変更を行うには、新しい LoaderContext オブジェクトを渡します。

パラメータ

	`request:URLRequest` (default = `null`) — コンテンツを読み込み先を示す URLRequest オブジェクトです。この値が指定されていない場合は、`source` プロパティの現在の値がコンテンツロケーションとして使用されます。

	`context:LoaderContext` (default = `null`) — ロード処理のコンテキストを設定する LoaderContext オブジェクトです。

例

次の例では、新しい UILoader インスタンスを作成し、load() メソッドに source プロパティを指定してイメージをロードします。


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.load();
myUILoader.move(10, 10);
addChild(myUILoader);

次の例では、新しい UILoader インスタンスを作成し、load() メソッドと URLRequest インスタンスを使用してイメージをロードします。


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";
var req:URLRequest = new URLRequest(url);

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.move(10, 10);
myUILoader.load(req);
addChild(myUILoader);

loadBytes

()

メソッド

public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

ByteArray オブジェクトに保管されているバイナリデータからロードします。

パラメータ

	`bytes:ByteArray` — Loader クラスでサポートされるファイル形式 (SWF、GIF、JPEG、PNG のいずれか) のファイルを含む ByteArray オブジェクトです。

	`context:LoaderContext` (default = `null`) — LoaderContext オブジェクトの `applicationDomain` プロパティのみが適用され、LoaderContext オブジェクトの `checkPolicyFile` および `securityDomain` プロパティは適用されません。

例外

	`ArgumentError` — ByteArray オブジェクトの `length` プロパティが 0 の場合。

	`IllegalOperationError` — `context` パラメータの `checkPolicyFile` または `securityDomain` プロパティが null 以外であった場合。

	`SecurityError` — 受け取った `context` プロパティの `applicationDomain` プロパティが、許可されていないドメインのものであった場合。

関連項目

source
Loader.loadBytes()
LoaderContext

例

次の例では、未処理のバイトである GIF を UILoader オブジェクトにロードします。

import fl.containers.UILoader;

var imageBytes:Array = [ 71, 73, 70, 56, 57, 97, 50, 0, 30, 0, 230, 0, 0, 0, 0, 0, 173, 169, 206, 82, 73, 153, 74, 74, 74, 115, 109, 155, 248, 247, 251, 102, 102, 102, 26, 24, 35, 181, 181, 181, 70, 61, 145, 222, 222, 222, 153, 153, 153, 204, 204, 204, 58, 58, 58, 132, 132, 132, 231, 231, 231, 8, 7, 14, 90, 90, 90, 89, 81, 163, 153, 153, 153, 191, 188, 217, 165, 165, 165, 190, 190, 190, 237, 237, 233, 51, 51, 51, 214, 214, 214, 90, 82, 156, 156, 152, 190, 123, 123, 123, 140, 140, 140, 140, 135, 187, 103, 96, 165, 78, 70, 150, 173, 173, 173, 127, 121, 179, 82, 82, 82, 206, 204, 226, 195, 195, 193, 102, 102, 102, 247, 247, 247, 41, 41, 41, 66, 66, 66, 183, 179, 212, 146, 141, 190, 21, 21, 20, 227, 226, 238, 119, 111, 181, 198, 195, 221, 99, 91, 162, 255, 255, 255, 218, 216, 233, 114, 114, 114, 16, 15, 27, 114, 107, 171, 210, 208, 228, 8, 8, 8, 179, 175, 209, 240, 239, 246, 153, 153, 153, 234, 233, 243, 95, 88, 160, 90, 74, 156, 33, 33, 33, 16, 16, 16, 163, 159, 200, 142, 137, 188, 197, 189, 222, 134, 129, 183, 151, 147, 193, 202, 199, 223, 222, 221, 235, 122, 115, 176, 215, 213, 231, 74, 66, 147, 82, 75, 146, 197, 197, 197, 106, 99, 166, 231, 230, 240, 175, 171, 207, 239, 239, 239, 209, 207, 227, 25, 25, 22, 119, 112, 182, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 33, 249, 4, 0, 7, 0, 255, 0, 44, 0, 0, 0, 0, 50, 0, 30, 0, 0, 7, 255, 128, 49, 130, 131, 132, 132, 8, 24, 0, 16, 6, 15, 133, 141, 5, 54, 69, 77, 141, 147, 148, 147, 51, 63, 0, 153, 0, 40, 8, 148, 5, 1, 53, 48, 48, 31, 30, 50, 149, 167, 133, 5, 41, 154, 172, 0, 33, 141, 59, 76, 9, 2, 26, 181, 32, 32, 42, 168, 168, 170, 173, 172, 63, 23, 132, 59, 31, 32, 181, 197, 181, 73, 185, 186, 147, 5, 3, 189, 173, 29, 131, 194, 196, 198, 198, 184, 202, 141, 205, 206, 172, 35, 130, 77, 195, 212, 224, 73, 56, 215, 131, 217, 218, 154, 41, 49, 222, 211, 224, 212, 226, 228, 230, 231, 153, 6, 5, 223, 237, 237, 239, 186, 241, 242, 0, 11, 46, 236, 247, 194, 5, 64, 181, 79, 222, 129, 15, 180, 2, 6, 76, 226, 164, 82, 193, 115, 52, 148, 72, 80, 72, 145, 225, 164, 135, 218, 34, 242, 160, 200, 145, 225, 133, 12, 229, 248, 177, 210, 200, 177, 36, 136, 13, 140, 98, 112, 16, 169, 9, 130, 146, 141, 37, 75, 38, 121, 17, 195, 2, 38, 150, 81, 8, 76, 228, 40, 160, 39, 79, 38, 77, 26, 176, 4, 192, 130, 129, 148, 132, 10, 147, 0, 65, 162, 1, 169, 194, 32, 67, 127, 100, 40, 224, 244, 94, 18, 34, 130, 108, 248, 228, 200, 242, 7, 131, 24, 70, 170, 134, 91, 65, 8, 202, 86, 133, 17, 248, 121, 21, 148, 131, 135, 216, 98, 73, 255, 130, 52, 42, 114, 182, 157, 8, 5, 62, 206, 173, 29, 228, 33, 137, 85, 15, 148, 232, 190, 213, 0, 195, 84, 5, 109, 123, 7, 181, 104, 26, 110, 200, 169, 23, 32, 196, 38, 24, 40, 168, 195, 141, 86, 40, 190, 54, 34, 161, 33, 73, 207, 158, 73, 0, 163, 122, 33, 192, 115, 79, 16, 87, 11, 101, 152, 209, 0, 195, 128, 5, 39, 42, 237, 32, 194, 132, 7, 143, 35, 20, 174, 181, 88, 241, 193, 182, 8, 154, 228, 42, 229, 200, 17, 188, 184, 241, 224, 29, 150, 148, 0, 25, 35, 67, 133, 24, 39, 20, 44, 89, 18, 3, 1, 243, 37, 8, 136, 215, 68, 112, 34, 250, 146, 39, 5, 16, 88, 16, 36, 125, 73, 120, 230, 25, 16, 164, 44, 81, 194, 0, 2, 235, 5, 44, 116, 232, 244, 0, 67, 135, 8, 41, 58, 52, 200, 80, 194, 129, 131, 1, 49, 204, 48, 195, 2, 6, 224, 197, 65, 6, 35, 44, 192, 193, 12, 57, 160, 112, 95, 126, 13, 40, 16, 130, 1, 21, 140, 144, 129, 3, 51, 84, 128, 194, 18, 28, 148, 32, 31, 7, 6, 196, 160, 64, 4, 49, 44, 65, 162, 3, 11, 88, 128, 98, 10, 10, 164, 35, 72, 6, 0, 46, 48, 131, 32, 3, 88, 64, 98, 123, 42, 85, 136, 226, 12, 29, 112, 163, 146, 5, 28, 88, 16, 66, 7, 11, 0, 56, 98, 77, 33, 162, 56, 194, 88, 18, 10, 52, 240, 64, 4, 22, 40, 208, 1, 3, 36, 50, 48, 130, 116, 17, 28, 9, 100, 12, 14, 132, 224, 64, 7, 82, 142, 168, 94, 10, 37, 112, 16, 66, 10, 25, 48, 144, 194, 5, 90, 38, 89, 193, 2, 40, 140, 128, 65, 5, 12, 248, 224, 3, 7, 79, 10, 226, 128, 157, 37, 156, 192, 141, 5, 51, 114, 80, 193, 19, 24, 196, 121, 66, 157, 173, 49, 208, 161, 3, 40, 68, 208, 0, 7, 129, 0, 0, 59 ];

var totalBytes:uint = imageBytes.length;
var newBytes:ByteArray = new ByteArray()
var i:uint;
for(i=0; i<totalBytes; i++) {
    newBytes.writeByte(imageBytes[i]);
}

var loader:UILoader = new UILoader();
loader.loadBytes(newBytes);
addChild(loader);

setSize

()

メソッド

public override function setSize(w:Number, h:Number):void

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

コンポーネントのサイズを指定のサイズに変更します。If the scaleContent property is set to true , the UILoader is not resized.

パラメータ

	`w:Number` — コンポーネントの幅 (ピクセル単位)。

	`h:Number` — コンポーネントの高さ (ピクセル単位)。

関連項目

scaleContent

例

次の例では、UILoader コンポーネントインスタンスを作成し、setSize() メソッドを使ってステージ上でサイズを変更します。


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var image:DisplayObject = uiLdr.content as DisplayObject;
    trace("UILoader:", uiLdr.width, uiLdr.height); // 100 100
    trace("UILoader.content:", image.width, image.height); // 400 267
    uiLdr.setSize(image.width, image.height);
    uiLdr.move((stage.stageWidth - image.width) / 2, (stage.stageHeight - image.height) / 2);
}

unload

()

メソッド

public function unload():void

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

この UILoader オブジェクトの子 (load() メソッドまたは source プロパティを使用してロードされたもの) を削除します。

関連項目

load()
source

例

次の例では、イメージを UILoader コンポーネントにロードし、UILoader コンポーネントの click イベントが送出されたときに、ロードしたイメージをアンロードします。


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 10);
myUILoader.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myUILoader);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = event.currentTarget as UILoader;
    uil.unload();
    removeChild(uil);
}

イベントの詳細

complete

イベント

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.COMPLETE

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

コンテンツのロードが完了したときに送出されます。このイベントは、ロードが autoload プロセスによってトリガされた場合にも load() メソッドの明示的な呼び出しによってトリガされた場合にも送出されます。

type プロパティ (complete イベントオブジェクト) の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	ロードが完了したネットワークオブジェクトです。

例

次の例では、UILoader インスタンスを作成し、指定されたイメージのロードが完了した後、そのイメージをステージの中央に配置します。


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var newX:uint = (stage.stageWidth - uiLdr.content.width) / 2;
    var newY:uint = (stage.stageHeight - uiLdr.content.height) / 2;
    uiLdr.move(newX, newY);
}

関連項目

progress

init

イベント

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.INIT

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

ロードされた SWF ファイルのプロパティおよびメソッドにアクセスできる場合に送出されます。このイベントは、次の 2 つの条件が満たされていない限り送出されません。

ロードされたオブジェクトに関係したすべてのプロパティとメソッド、およびコンポーネントに関係したすべてのプロパティとメソッドにアクセスできる必要があります。
すべての子オブジェクトのコンストラクタが完了していること。

type プロパティ (init イベントオブジェクト) の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	ロードする SWF ファイルに関係のある LoaderInfo オブジェクトです。

ioError

イベント

イベントオブジェクトの型: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

入出力エラーが発生すると送出されます。

type プロパティ (ioError イベントオブジェクト) の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	入出力エラーが発生したネットワークオブジェクトです。
`text`	エラーメッセージとして表示されるテキストです。

例

次の例では、UILoader コンポーネントインスタンスを作成し、存在しないファイルのロードを試行したときに、ioError イベントが送出されることを示します。


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image404.jpg"

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.move(10, 10);
myUILoader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
addChild(myUILoader);

function ioErrorHandler(event:IOErrorEvent):void {
    trace("<<", event.text, ">>");
    myUILoader.removeEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    removeChild(myUILoader);
}

open

イベント

イベントオブジェクトの型: flash.events.Event
Event.type property = flash.events.Event.OPEN

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

ネットワーク操作が開始したときに送出されます。

type プロパティ (open イベントオブジェクト) の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	接続をオープンしたネットワークオブジェクトです。

progress

イベント

イベントオブジェクトの型: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.PROGRESS

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

コンテンツのロード中に送出されます。このイベントは、ロードが autoload プロセスによってトリガされた場合にも load() メソッドの明示的な呼び出しによってトリガされた場合にも送出されます。

type プロパティ (progress イベントオブジェクト) の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`bytesLoaded`	リスナーがイベントを処理しているときにロードされたアイテム数またはバイト数です。
`bytesTotal`	ロードプロセスが成功した場合に最終的にロードされるアイテムまたはバイトの総数です。
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	進行状況をレポートするネットワークオブジェクトです。

例


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

関連項目

complete

resize

イベント

イベントオブジェクトの型: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.RESIZE

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

コンポーネントのサイズが変更されたときに送出されます。

type プロパティ (resize イベントオブジェクト) の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	イベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、`currentTarget` プロパティを使用します。

例

次の例では、UILoader コンポーネントインスタンスを作成し、resize イベントをリッスンして、イメージのロードが完了した後、そのイメージをステージの中央に配置します。


import fl.containers.UILoader;
import fl.events.ComponentEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
addChild(myUILoader);

function resizeHandler(event:ComponentEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    trace(uiLdr.width, uiLdr.height); // 400 267
    uiLdr.move((stage.stageWidth - uiLdr.width) / 2, (stage.stageHeight - uiLdr.height) / 2);
}

securityError

イベント

イベントオブジェクトの型: flash.events.SecurityErrorEvent
SecurityErrorEvent.type property = flash.events.SecurityErrorEvent.SECURITY_ERROR

言語バージョン :

ActionScript 3.0

Player のバージョン :

Flash Player 9.0.28.0

コンテンツのロード中にセキュリティエラーが発生したときに送出されます。

SecurityErrorEvent.SECURITY_ERROR 定数は、type プロパティ (securityError イベントオブジェクト) の値を定義します。

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`target`	セキュリティエラーを報告するネットワークオブジェクトです。
`text`	エラーメッセージとして表示されるテキストです。

例例の使用法

UILoaderExample.as

次の例では、UILoader クラスの簡単な操作を示します。

例を実行するには、次の手順に従います。

UILoader のインスタンスをステージに配置し、そのインスタンスに uiLoader という名前を付けます。
UILoader インスタンスの上に Label コンポーネントのインスタンスを配置して uiLoaderLabel という名前を付けます。
このコードを FLA ファイルと同じディレクトリに UILoaderExample.as という名前で保存します。
FLA ファイル内の Document クラスを UILoaderExample に設定します。

package
{
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.ProgressEvent;
    import flash.net.URLRequest;

    public class UILoaderExample extends Sprite
    {
        private var sampleImagePath:String = "test.jpg";
        
        public function UILoaderExample() {
            var request:URLRequest = new URLRequest(sampleImagePath);
            uiLoader.scaleContent = false;
            uiLoader.addEventListener(Event.COMPLETE,loadComplete);
            uiLoader.addEventListener(ProgressEvent.PROGRESS,loadProgress);            
            uiLoader.load(request);
        }
        private function loadProgress(e:ProgressEvent):void {
            uiLoaderLabel.text = String(e.target.percentLoaded);
        }
        private function loadComplete(e:Event):void {
            uiLoaderLabel.text = "Load Complete";    
        }
    }
}

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/fl/containers/UILoader.html

ActionScript 3.0 コンポーネントリファレンスガイド		すべてのパッケージ \| すべてのクラス \| 言語エレメント \| 索引 \| 付録 \| 規則 \| フレームフレームなし
UILoader	プロパティ \| メソッド \| イベント \| スタイル \| 例

パッケージ	fl.containers
クラス	public class UILoader
継承	UILoader UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object