UILoader

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

UILoader クラスを使用すれば、実行時にコンテンツをロードしてその進行状況を監視するように設定できます。このクラスはまた、ロードしたコンテンツのサイズ変更にも使用します。コンテンツを別のドメイン（サンドボックス）からロードする場合、セキュリティ上の理由からそのコンテンツのプロパティにはアクセスできない場合もあります。詳しくは、ProLoader クラスを参照してください。

UILoader クラスのプロパティを ActionScript で設定すると、プロパティインスペクターやコンポーネントインスペクターで設定した同じ名前のパラメーターの値よりも優先されます。

このコンポーネントは fl.display.ProLoader をラップします。実際のロードは、すべて ProLoader クラスによって処理され、UILoader は、ProLoader オブジェクトにビジュアル表示を提供するだけです。

注意：コンテンツを別のドメインまたはサンドボックスからロードする場合、セキュリティ上の理由からそのコンテンツのプロパティにはアクセスできない場合もあります。ロードプロセスがドメインセキュリティによってどのような影響を受けるかについては、ProLoader クラスの説明を参照してください。

関連する API エレメント

パブリックプロパティ

	プロパティ		定義元
		accessibilityImplementation : AccessibilityImplementation この InteractiveObject インスタンスの現在のアクセシビリティの実装（AccessibilityImplementation）です。	InteractiveObject
		accessibilityProperties : AccessibilityProperties この表示オブジェクトの現在のアクセシビリティオプションです。	DisplayObject
		alpha : Number 指定されたオブジェクトのアルファ透明度値を示します。	DisplayObject
		autoLoad : Boolean UILoader インスタンスで指定したコンテンツを自動的にロードするかどうかを指定する値を取得または設定します。	UILoader
		blendMode : String 使用するブレンドモードを指定する BlendMode クラスの値です。	DisplayObject
		blendShader : Shader [書き込み専用] 前景と背景のブレンドに使用するシェーダーを設定します。	DisplayObject
		buttonMode : Boolean このスプライトのボタンモードを指定します。	Sprite
		bytesLoaded : uint [読み取り専用] それまでにロードしたコンテンツのバイト数を取得します。	UILoader
		bytesTotal : uint [読み取り専用] ロードされるコンテンツのバイト数を取得します。	UILoader
		cacheAsBitmap : Boolean true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash ランタイムにキャッシュされます。	DisplayObject
		cacheAsBitmapMatrix : Matrix null 以外の場合、この Matrix オブジェクトは、cacheAsBitmap を true に設定したときの表示オブジェクトのレンダリング方法を定義します。	DisplayObject
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		content : DisplayObject [読み取り専用] load() メソッドまたは source プロパティを使用してロードされた SWF ファイルや（JPEG、PNG、GIF などの形式の）イメージファイルのルート表示オブジェクトが含まれます。	UILoader
		contextMenu : NativeMenu このオブジェクトに関連付けられたコンテキストメニューを指定します。	InteractiveObject
		doubleClickEnabled : Boolean オブジェクトが doubleClick イベントを受け取るかどうかを指定します。	InteractiveObject
		dropTarget : DisplayObject [読み取り専用] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。	Sprite
		enabled : Boolean コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。	UIComponent
		filters : Array 表示オブジェクトに現在関連付けられている各フィルターオブジェクトが格納されているインデックス付きの配列です。	DisplayObject
		focusEnabled : Boolean ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示すブール値を取得または設定します。	UIComponent
		focusManager : IFocusManager このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得または設定します。	UIComponent
		focusRect : Object このオブジェクトがフォーカス矩形を表示するかどうかを指定します。	InteractiveObject
		graphics : Graphics [読み取り専用] ベクターの描画コマンドが発生するこのスプライトに属する Graphics オブジェクトを指定します。	Sprite
		height : Number [オーバーライド] コンポーネントの高さを取得または設定します（ピクセル単位）。	UIComponent
		hitArea : Sprite スプライトのヒット領域となる別のスプライトを指定します。	Sprite
		loaderInfo : LoaderInfo [読み取り専用] この表示オブジェクトが属するファイルの読み込み情報を含む LoaderInfo オブジェクトを返します。	DisplayObject
		maintainAspectRatio : Boolean 元のイメージの縦横比を維持するか、またはイメージのサイズを UILoader コンポーネントの現在の幅と高さに合わせるかどうかを示す値を取得または設定します。	UILoader
		mask : DisplayObject 呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。	DisplayObject
		metaData : Object メタデータが PlaceObject4 タグによってこの DisplayObject のインスタンスと一緒に SWF ファイル内に保存されている場合に、DisplayObject インスタンスのメタデータオブジェクトを取得します。	DisplayObject
		mouseChildren : Boolean オブジェクトの子がマウスまたはユーザー入力デバイスに対応しているかどうかを判断します。	DisplayObjectContainer
		mouseEnabled : Boolean このオブジェクトでマウスまたはその他のユーザー入力メッセージを受け取るかどうかを指定します。	InteractiveObject
		mouseFocusEnabled : Boolean ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示す値を取得または設定します。	UIComponent
		mouseX : Number [読み取り専用] マウスまたはユーザー入力デバイスの x 軸の位置をピクセルで示します。	DisplayObject
		mouseY : Number [読み取り専用] マウスまたはユーザー入力デバイスの y 軸の位置をピクセルで示します。	DisplayObject
		name : String DisplayObject のインスタンス名を示します。	DisplayObject
		needsSoftKeyboard : Boolean この InteractiveObject インスタンスがフォーカスを受け取ったときに、仮想キーボード（画面上のソフトキーボード）を表示するかどうかを指定します。	InteractiveObject
		numChildren : int [読み取り専用] このオブジェクトの子の数を返します。	DisplayObjectContainer
		opaqueBackground : Object 表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。	DisplayObject
		parent : DisplayObjectContainer [読み取り専用] この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。	DisplayObject
		percentLoaded : Number [読み取り専用] ロード済みのコンテンツのパーセンテージを示す 0 から 100 までの数値を取得します。	UILoader
		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
		scale9Grid : Rectangle 現在有効な拡大 / 縮小グリッドです。	DisplayObject
		scaleContent : Boolean UILoader インスタンスのサイズに合わせてイメージのサイズを自動的に拡大 / 縮小するかどうかを指定する値を取得または設定します。	UILoader
		scaleX : Number [オーバーライド] コンポーネントの現在の幅に縮尺率を乗算します。	UIComponent
		scaleY : Number [オーバーライド] コンポーネントの現在の高さに縮尺率を乗算します。	UIComponent
		scaleZ : Number オブジェクトの基準点から適用されるオブジェクトの奥行きスケール（パーセンテージ）を示します。	DisplayObject
		scrollRect : Rectangle 表示オブジェクトのスクロール矩形の境界です。	DisplayObject
		softKeyboard : String ソフトキーボードの外観を制御します。	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle ソフトキーボードが表示されたときに画面に表示したままにする領域を定義します（iOS では使用不可）。	InteractiveObject
		soundTransform : flash.media:SoundTransform このスプライト内のサウンドを制御します。	Sprite
		source : Object ロードする SWF ファイルやイメージファイルの場所を示す絶対 URL または相対 URL、ライブラリ内のムービークリップのクラス名、表示オブジェクトを指す参照、コンポーネントと同じレベルにあるムービークリップのインスタンス名のいずれかを取得または設定します。	UILoader
		stage : Stage [読み取り専用] 表示オブジェクトのステージです。	DisplayObject
		tabChildren : Boolean オブジェクトの子に対してタブが有効かどうかを調べます。	DisplayObjectContainer
		tabEnabled : Boolean このオブジェクトがタブ順序に含まれるかどうかを指定します。	InteractiveObject
		tabIndex : int SWF ファイル内のオブジェクトのタブ順序を指定します。	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [読み取り専用] この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。	DisplayObjectContainer
		transform : flash.geom:Transform 表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。	DisplayObject
		useHandCursor : Boolean buttonMode プロパティが true に設定されたスプライト上にポインターが移動したときに、指差しハンドポインター（ハンドカーソル）を表示するかどうかを示すブール値です。	Sprite
		visible : Boolean [オーバーライド] 現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。	UIComponent
		width : Number [オーバーライド] コンポーネントの幅を取得または設定します（ピクセル単位）。	UIComponent
		x : Number [オーバーライド] 親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。	UIComponent
		y : Number [オーバーライド] 親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。	UIComponent
		z : Number 3D 親コンテナを基準にした、DisplayObject インスタンスの z 軸に沿った z 座標位置を示します。	DisplayObject

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		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 ProLoader インスタンスに対して現在進行中の 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 [静的] 現在のコンポーネントのデフォルトスタイルマップを取得します。	UILoader
		globalToLocal(point:Point):Point point オブジェクトをステージ（グローバル）座標から表示オブジェクトの（ローカル）座標に変換します。	DisplayObject
		globalToLocal3D(point:Point):Vector3D ステージ（グローバル）座標の 2 次元のポイントを 3 次元の表示オブジェクトの（ローカル）座標に変換します。	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
		local3DToGlobal(point3d:Vector3D):Point 3 次元の表示オブジェクトの（ローカル）座標の 3 次元のポイントをステージ（グローバル）座標の 2 次元のポイントに変換します。	DisplayObject
		localToGlobal(point:Point):Point point オブジェクトを表示オブジェクトの（ローカル）座標からステージ（グローバル）座標に変換します。	DisplayObject
		mergeStyles(... list):Object [静的] 複数のクラスのスタイルを 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 の子リストの指定された index 位置から子 DisplayObject を削除します。	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void DisplayObjectContainer インスタンスの子リストから、すべての child DisplayObject インスタンスを削除します。	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		requestSoftKeyboard():Boolean 仮想キーボードを前面に表示します。	InteractiveObject
		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
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void 指定されたスプライトを、ユーザーがタッチ対応デバイス上でドラッグできるようにします。	Sprite
		stopAllMovieClips():void このオブジェクトでルート指定されているすべての MovieClip のタイムラインでの実行を再帰的に停止します。	DisplayObjectContainer
		stopDrag():void startDrag() メソッドを終了します。	Sprite
		stopTouchDrag(touchPointID:int):void タッチ対応デバイスで使用する startTouchDrag() メソッドを終了します。	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 指定された 2 つの子オブジェクトの z 順序（重ね順）を入れ替えます。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序（重ね順）を入れ替えます。	DisplayObjectContainer
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		unload():void この UILoader オブジェクトの子（load() メソッドまたは source プロパティを使用してロードされたもの）を削除します。	UILoader
		validateNow():void 必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。	UIComponent
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

プロテクトメソッド

継承されるプロテクトメソッドを隠す

継承されるプロテクトメソッドを表示

	メソッド		定義元
		getStyleValue(name:String):Object グローバルレベル、コンポーネントレベルおよびインスタンスレベルで設定されたすべてのスタイルを考慮して、コンポーネントに対して指定されたスタイルを返します。	UIComponent

イベント

イベントの詳細についてはここをクリックしてください

継承されるイベントを隠す

継承されるイベントを表示

	概要	定義元
activate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
added	表示オブジェクトが表示リストに追加されたときに送出されます。	DisplayObject
addedToStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。	DisplayObject
clear	ユーザーがコンテキストメニューから「削除」を選択した場合に送信されます。	InteractiveObject
click	ユーザーが同じ InteractiveObject 上でポインティングデバイスのメインボタンを押して離すと送出されます。	InteractiveObject
complete	コンテンツのロードが完了したときに送出されます。	UILoader
contextMenu	AIR アプリケーションでこのインタラクティブオブジェクトに関連付けられているコンテキストメニューをユーザージェスチャがトリガーすると送出されます。	InteractiveObject
copy	ユーザーがコピー操作のためにプラットフォーム固有のアクセラレーターキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「コピー」を選択した場合に送出されます。	InteractiveObject
cut	ユーザーがカット操作のためにプラットフォーム固有のアクセラレーターキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「カット」を選択した場合に送出されます。	InteractiveObject
deactivate	[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
doubleClick	オブジェクトの doubleClickEnabled フラグが true に設定されている場合にユーザーが InteractiveObject をポインティングデバイスのメインボタンで 2 回続けてすばやくクリックすると送出されます。	InteractiveObject
enterFrame	[ブロードキャストイベント] 再生ヘッドが新しいフレームに入るときに送出されます。	DisplayObject
exitFrame	[ブロードキャストイベント] 再生ヘッドが現在のフレームを終了するときに送出されます。	DisplayObject
focusIn	表示オブジェクトがフォーカスを取得した後に送出されます。	InteractiveObject
focusOut	表示オブジェクトがフォーカスを失った後に送出されます。	InteractiveObject
frameConstructed	[ブロードキャストイベント] フレーム表示オブジェクトのコンストラクターが実行した後で、かつフレームスクリプトが実行される前に送出されます。	DisplayObject
gestureDirectionalTap	ユーザーが InteractiveObject インスタンスでタッチサーフェスの端に沿って接触点を作成したとき（例えば、Apple TV の Siri Remote でタッチサーフェスの端に沿ってタップしたときなど）に送出されます。デバイスによっては、この接触を複数のタッチイベントの組み合わせと解釈する可能性もあります。	InteractiveObject
gestureLongPress	タッチ対応デバイスで、ユーザーが同じ InteractiveObject インスタンス上の 2 つの接触位置を押したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの表示オブジェクト上を、2 本の指で押したり離したりする場合など）。	InteractiveObject
gesturePan	タッチ対応デバイスで、ユーザーが InteractiveObject インスタンス上の接触位置でタッチポイントを移動したときに送出されます（例えば、タッチスクリーン搭載の携帯電話やタブレットの表示オブジェクト上で、指を左から右に動かす場合など）。	InteractiveObject
gestureRotate	InteractiveObject インスタンスとの接触位置で、ユーザーが回転ジェスチャを実行したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面に 2 本指で触れ、その指を表示オブジェクト上で回転させる場合など）。	InteractiveObject
gestureSwipe	InteractiveObject インスタンスとの接触位置で、ユーザーがスワイプジェスチャを実行したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面に 3 本指で触れてから、表示オブジェクト上でその 3 本の指をそろえて動かした場合など）。	InteractiveObject
gestureTap	タッチ対応デバイス上で、ユーザーが InteractiveObject インスタンスとの接触位置を形成してからタップしたときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面で、表示オブジェクト上に複数の指を置いてメニューを開いてから、1 本の指でタップしてメニューアイテムを選択する場合など）。	InteractiveObject
gestureZoom	InteractiveObject インスタンスとの接触位置で、ユーザーがズームジェスチャを実行したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面に 2 本指で触れてから、表示オブジェクト上でその 2 本の指をすばやく広げた場合など）。	InteractiveObject
hide	コンポーネントの可視性が可視から不可視に変化した後に送出されます。	UIComponent
imeStartComposition	このイベントは、IME でインライン入力をサポートしているすべてのクライアントアプリケーションに送出されます。	InteractiveObject
init	ロードされた SWF ファイルのプロパティおよびメソッドにアクセスできる場合に送出されます。	UILoader
ioError	入出力エラーが発生すると送出されます。	UILoader
keyDown	ユーザーがキーを押したときに送出されます。	InteractiveObject
keyFocusChange	ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。	InteractiveObject
keyUp	ユーザーがキーを離したときに送出されます。	InteractiveObject
middleClick	ユーザーが同じ InteractiveObject 上でポインティングデバイスの中央ボタンを押して離すと送出されます。	InteractiveObject
middleMouseDown	ユーザーが InteractiveObject インスタンス上でポインティングデバイスの中央ボタンを押したときに送出されます。	InteractiveObject
middleMouseUp	ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを離したときに送出されます。	InteractiveObject
mouseDown	ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを押したときに送出されます。	InteractiveObject
mouseFocusChange	ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。	InteractiveObject
mouseMove	InteractiveObject の上で、ユーザーがポインティングデバイスを移動させたときに送出されます。	InteractiveObject
mouseOut	ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。	InteractiveObject
mouseOver	ユーザーが InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。	InteractiveObject
mouseUp	ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを離したときに送出されます。	InteractiveObject
mouseWheel	マウスホイールが InteractiveObject インスタンス上を回転するときに送出されます。	InteractiveObject
move	コンポーネントが移動された後に送出されます。	UIComponent
nativeDragComplete	ユーザーがドラッグジェスチャを止めると、ドラッグイニシエータ InteractiveObject から送出されます。	InteractiveObject
nativeDragDrop	ドラッグされたオブジェクトがターゲットにドロップされ、そのドロップ操作が DragManager.acceptDragDrop() の呼び出しで受け入れられた場合に、ターゲットの InteractiveObject から送出されます。	InteractiveObject
nativeDragEnter	ドラッグジェスチャが境界に入ると、InteractiveObject から送出されます。	InteractiveObject
nativeDragExit	ドラッグジェスチャが境界を出ると、InteractiveObject から送出されます。	InteractiveObject
nativeDragOver	ドラッグジェスチャが境界の範囲内で行われている間、InteractiveObject から継続的に送出されます。	InteractiveObject
nativeDragStart	ドラッグ操作の開始時に、DragManager.doDrag() 呼び出しのドラッグイニシエータとして指定されている InteractiveObject から送出されます。	InteractiveObject
nativeDragUpdate	ドラッグ操作が行われている間に、DragManager.doDrag() 呼び出しのドラッグイニシエータとして指定されている InteractiveObject から送出されます。	InteractiveObject
open	ネットワーク操作が開始したときに送出されます。	UILoader
paste	ユーザーがペースト操作のためにプラットフォーム固有のアクセラレーターキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「ペースト」を選択した場合に送出されます。	InteractiveObject
progress	コンテンツのロード中に送出されます。	UILoader
proximityBegin	画面の類似性検出しきい値を超えて、ユーザーがアクティブなスタイラスを降ろしたときに送出されます。	InteractiveObject
proximityEnd	画面の類似性検出しきい値を超えて、ユーザーがアクティブなスタイラスを持ち上げたときに送出されます。	InteractiveObject
proximityMove	類似性検出しきい値の範囲内で、ユーザーがアクティブなスタイラスを画面上に移動したときに送出されます。	InteractiveObject
proximityOut	画面の類似性検出しきい値の範囲内で、ユーザーがこの InteractiveObject からアクティブなスタイラスを離したときに送出されます。	InteractiveObject
proximityOver	画面の類似性検出しきい値の範囲内で、ユーザーがこの InteractiveObject の真上にアクティブなスタイラスを移動したときに送出されます。	InteractiveObject
proximityRollOut	画面の類似性検出しきい値の範囲内で、ユーザーがこの InteractiveObject やそのいずれかの子からアクティブなスタイラスを離したときに送出されます。	InteractiveObject
proximityRollOver	（画面の類似性検出しきい値の範囲内で）ユーザーがアクティブなスタイラスを表示リスト内のオブジェクトの子孫ツリーの外側から InteractiveObject 上に移動したときに送出されます。	InteractiveObject
releaseOutside	ユーザーが最初に InteractiveObject インスタンス上でポインティングデバイスのボタンを押し、次にポインティングデバイスをその InteractiveObject インスタンス以外の場所に移動した後、ボタンを離したときに送出されます。	InteractiveObject
removed	表示オブジェクトが表示リストから削除されようとしているときに送出されます。	DisplayObject
removedFromStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。	DisplayObject
render	[ブロードキャストイベント] 表示リストが更新およびレンダリングされようとしているときに送出されます。	DisplayObject
resize	コンポーネントのサイズが変更された後に送出されます。	UILoader
rightClick	ユーザーが同じ InteractiveObject 上でポインティングデバイスの右ボタンを押して離すと送出されます。	InteractiveObject
rightMouseDown	ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを押したときに送出されます。	InteractiveObject
rightMouseUp	ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを離したときに送出されます。	InteractiveObject
rollOut	ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。	InteractiveObject
rollOver	ユーザーが InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。	InteractiveObject
securityError	コンテンツのロード中にセキュリティエラーが発生したときに送出されます。	UILoader
selectAll	ユーザーがすべて選択操作のためにプラットフォーム固有のアクセラレーターキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「すべて選択」を選択した場合に送出されます。	InteractiveObject
show	コンポーネントの可視性が不可視から可視に変化した後に送出されます。	UIComponent
softKeyboardActivate	ソフトキーボードが前面に表示された直後に送出されます。	InteractiveObject
softKeyboardActivating	ソフトキーボードが前面に表示される直前に送出されます。	InteractiveObject
softKeyboardDeactivate	ソフトキーボードが背後に移動して非表示になった直後に送出されます。	InteractiveObject
tabChildrenChange	オブジェクトの tabChildren フラグの値が変更されたときに送出されます。	InteractiveObject
tabEnabledChange	オブジェクトの tabEnabled フラグが変更されたときに送出されます。	InteractiveObject
tabIndexChange	オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。	InteractiveObject
textInput	テキストの文字を入力すると送出されます。	InteractiveObject
touchBegin	タッチ対応デバイスにユーザーが初めて接触したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面に指で触れる場合など）。	InteractiveObject
touchEnd	タッチ対応デバイスで、ユーザーが接触を解除したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面から指を離す場合など）。	InteractiveObject
touchMove	ユーザーがデバイスにタッチしたときに送出され、接触ポイントがなくなるまで継続的に送出されます。	InteractiveObject
touchOut	タッチ対応デバイスで、ユーザーが接触位置を InteractiveObject インスタンスの外に移動したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットで、1 つの表示オブジェクトから別の表示オブジェクトに指をドラッグする場合など）。	InteractiveObject
touchOver	タッチ対応デバイスで、ユーザーが InteractiveObject インスタンス上で接触位置を移動したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットで、表示オブジェクトの外にある位置から表示オブジェクト上に指をドラッグする場合など）。	InteractiveObject
touchRollOut	ユーザーがタッチ対応デバイスの InteractiveObject インスタンス外に接触点を動かしたとき（例えば、タッチスクリーンを備えた携帯電話やタブレットで、表示オブジェクトから表示オブジェクト外に指をドラッグしたとき）に送出されます。	InteractiveObject
touchRollOver	タッチ対応デバイスで、ユーザーが InteractiveObject インスタンス上で接触位置を移動したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットで、表示オブジェクトの外にある位置から表示オブジェクト上に指をドラッグする場合など）。	InteractiveObject
touchTap	タッチ対応デバイスで、ユーザーが接触を開始した InteractiveObject インスタンスの同じ位置から指を離したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの表示オブジェクト上の 1 点を、指で押したり離したりする場合など）。	InteractiveObject

スタイル

スタイルには共通スタイルと特定のテーマに関連するスタイルがあります。共通スタイルは、任意のテーマと共に使用できます。特定のテーマに関連するスタイルは、アプリケーションがそのテーマを使用する場合にのみ使用できます。

共通スタイル

スタイルの詳細についてはここをクリックしてください

継承されるスタイルを隠す

継承されるスタイルを表示

	説明	定義元
disabledTextFormat	型: flash.text.TextFormat 言語バージョン: ActionScript 3.0 製品バージョン: Flash CS3 ランタイムバージョン: Flash9.0.28.0, AIR 1.0 ボタンが無効な場合に、コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです.	UIComponent
focusRectPadding	型: Number 形式: Length 言語バージョン: ActionScript 3.0 製品バージョン: Flash CS3 ランタイムバージョン: Flash9.0.28.0, AIR 1.0 コンポーネント領域の外側とフォーカスインジケーター領域のエッジを区切るパディングです（ピクセル単位）.	UIComponent
focusRectSkin	型: Class 言語バージョン: ActionScript 3.0 製品バージョン: Flash CS3 ランタイムバージョン: Flash9.0.28.0, AIR 1.0 フォーカスインジケーターの表示に使用されるスキンです.	UIComponent
textFormat	型: flash.text.TextFormat 言語バージョン: ActionScript 3.0 製品バージョン: Flash CS3 ランタイムバージョン: Flash9.0.28.0, AIR 1.0 コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです.	UIComponent

パブリック定数

継承されるパブリック定数を隠す

継承されるパブリック定数を表示

	定数		定義元
		version : String = "3.0.3.1" コンポーネントのバージョン番号。	UIComponent

プロパティの詳細

autoLoad

プロパティ

autoLoad:Boolean

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

デフォルト値： true。

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

関連する API エレメント

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 [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

デフォルト値： 0。

実装
public function get bytesLoaded():uint

関連する API エレメント

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 [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

デフォルト値： 0。

実装
public function get bytesTotal():uint

関連する API エレメント

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 [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

デフォルト値： null。

実装
public function get content():DisplayObject

関連する API エレメント

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

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

デフォルト値： true。

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

関連する API エレメント

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 [読み取り専用]

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

デフォルト値： 0。

実装
public function get percentLoaded():Number

関連する API エレメント

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

デフォルト値： true。

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

関連する API エレメント

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

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

デフォルト値： null。

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

関連する API エレメント

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

コンストラクターの詳細

()

コンストラクター

public function UILoader()

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

メソッドの詳細

close

()

メソッド

public function close():void

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

例外

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

関連する API エレメント

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

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.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

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.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

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

パラメーター

	`bytes:ByteArray` — ProLoader クラスでサポートされるファイル形式（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` プロパティが、許可されていないドメインのものであった場合。

例 ( この例の使用方法 )

次の例では、未処理のバイトである 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

()

メソッド

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

コンポーネントのサイズを指定のサイズに変更します。scaleContent プロパティが true に設定されている場合、UILoader のサイズは変更されません。

パラメーター

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

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

関連する API エレメント

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

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

関連する API エレメント

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 = flash.events.Event.COMPLETE

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

Event.COMPLETE 定数は、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);
}

関連する API エレメント

progress

init

イベント

イベントオブジェクトの型: flash.events.Event
プロパティ Event.type = flash.events.Event.INIT

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

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

Event.INIT 定数は、type プロパティ（init イベントオブジェクト）の値を定義します。

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

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

ioError

イベント

イベントオブジェクトの型: flash.events.IOErrorEvent
プロパティ IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

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

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

プロパティ	値
`bubbles`	`false`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`errorID`	特定のエラーに関連付けられた参照番号です（AIR のみ）。
`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 = flash.events.Event.OPEN

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.0

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

Event.OPEN 定数は、type プロパティ（open イベントオブジェクト）の値を定義します。

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

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

progress

イベント

イベントオブジェクトの型: flash.events.ProgressEvent
プロパティ ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.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);
}

関連する API エレメント

complete

resize

イベント

イベントオブジェクトの型: fl.events.ComponentEvent
プロパティ ComponentEvent.type = fl.events.ComponentEvent.RESIZE

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.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 = flash.events.SecurityErrorEvent.SECURITY_ERROR

言語バージョン:

ActionScript 3.0

製品バージョン:

Flash CS3

ランタイムバージョン:

Flash Player 9.0.28.0, AIR 1.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 内の DocumentClass を UILoaderExample に設定します。

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

    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";    
        }
    }
}

法律上の注意 | プライバシーポリシー

UILoader - AS3 Flash

クラス x

autoLoad

bytesLoaded

bytesTotal

content

maintainAspectRatio

percentLoaded

scaleContent

source

UILoader

close

getStyleDefinition

load

loadBytes

setSize

unload

complete

init

ioError

open

progress

resize

securityError