メソッド | プロパティ | エフェクト | イベント | スタイル | 例 フレームあり | フレームなし

mx.controls
Loader クラス

継承を示す線継承を示す線継承を示す線
直接の既知のサブクラス
           mx.controls.Image

Loader クラス
mx.core.View の拡張

Loader コントロールには、指定した SWF ファイルまたは JPG ファイルのコンテンツが表示されます。このコントロールには、コンテンツの拡大 / 縮小や、コントロール自身のサイズ設定のためのプロパティがあります。また、コンテンツのサイズに合わせてコントロール自身が拡大 / 縮小することもできます。デフォルトでは、Loader コントロールのサイズに合わせてコンテンツが拡大 / 縮小されます。また、プログラムを使って要求時にコンテンツをロードし、ロードの進行状況を監視できます。イメージをロードする場合は Image タグが適していますが、Loader タグでも可能です。

Loader コンポーネントはフォーカスを取得できません。ただし、Loader コンポーネント内にロードしたコンテンツ自体は、フォーカスの取得やフォーカス操作が可能です。Loader は本質的にコントロールですが、View コンテナを拡張します。

MXML シンタックス

<mx:Loader> タグは、親クラスのすべてのプロパティと、次のプロパティを継承します。

 <mx:Loader
   autoLoad="true|false"
   brokenImage="No default."
   source="No default."
   horizontalAlign="left|center|right"
   scaleContent="true|false"
   verticalAlign="top|middle|bottom"
   complete="Event handler; no default."
   progress="Event handler; no default." 
 />

例を参照するにはここをクリックしてください

メソッド
       load( url:String) :  Void
イメージまたは SWF ファイルのロードを開始します。

mx.core.View クラスから継承されるメソッド
childLoaded   constructObject2   createChild   createChildren   destroyAllChildren   destroyChild   destroyChildAt   draw   getBorderMetrics   getChildAt   getChildIndex   getViewMetrics   init   layoutChildren   layoutChrome   setChildIndex  

mx.core.UIComponent クラスから継承されるメソッド
drawFocus   getFocus   getFocusManager   setEnabled   setFocus  

mx.core.UIObject クラスから継承されるメソッド
addEventListener   applyProperties   buildDepthTable   commitProperties   constructObject2   createAccessibilityImplementation   createChildAtDepth   createChildren   createClassChildAtDepth   createClassObject   createEmptyObject   destroyObject   dispatchEvent   doLater   draw   drawRect   executeBindings   fillRect   findNextAvailableDepth   getRepeaterItem   getStyle   handleEvent   init   invalidate   invalidateLayout   invalidateProperties   invalidateSize   invalidateStyle   layoutChildren   measure   move   redraw   removeEventListener   setDepthAbove   setDepthBelow   setMask   setSize   setSizeNoLayout   setStyle   swapDepths  



プロパティ
       autoLoad:Boolean
true の場合、コンテンツが自動的にロードされます。
       brokenImage:String
ロードが失敗した場合に表示されるイメージです。
       bytesLoaded:Number    [読み取り専用]
既にロードされたイメージまたは SWF ファイルのバイト数です。
       bytesTotal:Number    [読み取り専用]
イメージまたは SWF ファイルの合計サイズです。
       content:mx.core.UIComponent    [読み取り専用]
Loader のコンテンツです。
       percentLoaded:Number    [読み取り専用]
イメージまたは SWF ファイルのロードが何パーセント完了したかを示します。
       scaleContent:Boolean
true の場合、Loader に合わせてコンテンツが拡大 / 縮小されます。
       source:String
 コンテンツのロード元の場所を指定します。
staticversion:String
このクラスのバージョンを表すストリングです。

mx.core.View クラスから継承されるプロパティ
baselinePosition   className   numChildren   version  

mx.core.UIComponent クラスから継承されるプロパティ
enabled   errorString   tabEnabled   tabIndex   version  

mx.core.UIObject クラスから継承されるプロパティ
alpha   baselinePosition   className   depth   documentDescriptor   height   heightFlex   id   instanceIndices   isDocument   kStretch   layoutHeight   layoutWidth   maxHeight   maxWidth   minHeight   minWidth   mouseX   mouseY   nestLevel   oldHeight   oldWidth   oldX   oldY   parent   parentApplication   parentDocument   percentHeight   percentWidth   preferredHeight   preferredWidth   repeaterIndices   scaleX   scaleY   styleName   tabEnabled   toolTip   version   visible   width   widthFlex   x   y  



エフェクト

mx.core.UIComponent クラスから継承されるエフェクト
focusInEffect   focusOutEffect  

mx.core.UIObject クラスから継承されるエフェクト
creationCompleteEffect   hideEffect   mouseDownEffect   mouseOutEffect   mouseOverEffect   mouseUpEffect   moveEffect   resizeEffect   showEffect  



イベント
completeコンテンツのロードが完了したときにブロードキャストされます。このイベントは、ロードが autoload によってトリガされたか、明示的な load() 呼び出しによってトリガされたかにかかわらず、ブロードキャストされます。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 complete が設定されます。
progressコンテンツのロード中にブロードキャストされます。このイベントは、ロードが autoload によってトリガされたか、明示的な load() 呼び出しによってトリガされたかにかかわらず、ブロードキャストされます。
メモ : progress イベントの送出は保証されていません。progress イベントが 1 つも送出されないまま complete イベントを受け取る場合もあります。これは、ローカルファイルをロードする場合によく発生します。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 progress が設定されます。

mx.core.View クラスから継承されるイベント
childCreated  childDestroyed  childIndexChanged 

mx.core.UIComponent クラスから継承されるイベント
focusIn  focusOut  invalid  keyDown  keyUp  valid  valueCommitted 

mx.core.UIObject クラスから継承されるイベント
creationComplete  dragComplete  dragDrop  dragEnter  dragExit  dragOver  draw  effectEnd  effectStart  hide  hideToolTip  initialize  load  mouseChangeSomewhere  mouseDown  mouseDownSomewhere  mouseMove  mouseMoveSomewhere  mouseOut  mouseOver  mouseUp  mouseUpSomewhere  move  resize  show  showToolTip  unload 



スタイル
horizontalAlignCSS の継承 : なし
縦横比が 1 対 1 でないときのイメージの水平方向の配置です。デフォルト値は left です。有効な値は、left、center、および right です。
verticalAlignCSS の継承 : なし
縦横比が 1 対 1 でないときのイメージの垂直方向の配置です。デフォルト値は top です。有効な値は top、middle、および bottom です。

mx.core.UIComponent クラスから継承されるスタイル
backgroundAlpha   backgroundColor   backgroundDisabledColor   backgroundImage   backgroundSize   barColor   borderCapColor   borderColor   borderSides   borderStyle   borderThickness   cornerRadius   disabledColor   dropShadow   errorColor   fillColors   highlightColor   modalTransparency   scrollTrackColor   selectedFillColors   shadowCapColor   shadowColor   shadowDirection   shadowDistance   symbolBackgroundColor   symbolBackgroundDisabledColor   symbolBackgroundPressedColor   symbolColor   symbolDisabledColor   themeColor  

mx.core.UIObject クラスから継承されるスタイル
color   fontFamily   fontSize   fontStyle   fontWeight   horizontalGap   leading   marginLeft   marginRight   textAlign   textDecoration   textIndent   verticalGap  



メソッドの詳細

load

load( url:String) :  Void

イメージまたは SWF ファイルのロードを開始します。url パラメータからは SWF または JPG イメージのみを指し示すことができます。

パラメータ
    url:String - ロードする JPG または SWF ファイルの絶対 URL または相対 URL です。



プロパティの詳細

autoLoad

autoLoad:Boolean  

true の場合、コンテンツが自動的にロードされます。false の場合、load メソッドを呼び出す必要があります。デフォルト値は true です。

brokenImage

brokenImage:String  

ロードが失敗した場合に表示されるイメージです。このイメージはすぐには表示されず、表示されるまで数分かかることがあります。

bytesLoaded

bytesLoaded:Number   [読み取り専用]

既にロードされたイメージまたは SWF ファイルのバイト数です。

bytesTotal

bytesTotal:Number   [読み取り専用]

イメージまたは SWF ファイルの合計サイズです。

content

content:mx.core.UIComponent   [読み取り専用]

Loader のコンテンツです。このプロパティには、ロードされたコンテンツを表すオブジェクトが設定されます。たとえば、SWF を指定した場合、このプロパティには MovieClip が設定されます。

percentLoaded

percentLoaded:Number   [読み取り専用]

イメージまたは SWF ファイルのロードが何パーセント完了したかを示します。

scaleContent

scaleContent:Boolean  

true の場合、Loader に合わせてコンテンツが拡大 / 縮小されます。false の場合、コンテンツに合わせて Loader が拡大 / 縮小されます。デフォルト値は true です。

source

source:String  

コンテンツのロード元の場所を指定します。source プロパティは次の形式をとります。
source="relativeOrAbsoluteURL"
参照されるファイルは、Flex によって実行時にロードされます。生成される SWF ファイルの一部としてパッケージ化されることはありません。したがって、source プロパティでは JPEG イメージと SWF ファイルのロードのみがサポートされています。

version

static  version:String  

このクラスのバージョンを表すストリングです。


例
SimpleLoader.mxml 
<?xml version="1.0"?>
<!-- Loader コントロールの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">

<mx:Panel title="Loader Panel">

<mx:Loader id="Load" source="@Embed('icecreampint.jpg')" height="150" width="150"/>

</mx:Panel>

</mx:Application>