パッケージfl.controls
クラスpublic class List
継承List Inheritance SelectableList Inheritance BaseScrollPane Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
実装 IFocusManagerComponent

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

List コンポーネントは、リストベースの情報を表示し、情報の配列の表示に最適化されます。

List コンポーネントは、アイテム、行、およびデータプロバイダで構成されます。これらは、次に示します。

デフォルトで、List コンポーネントは CellRenderer クラスを使用して、リストアイテムが表示される行を提供します。これらの行をプログラムで作成できます。これは、通常 CellRenderer クラスをサブクラス化することで行います。CellRenderer クラスは、ICellRenderer インターフェイスを実装します。List コンポーネントは、このインターフェイスが提供するプロパティやメソッドを使用して、行を操作したり、表示のためにデータや状態情報を各行に送信することができます。これには、サイズ変更や選択に関する情報が含まれています。

List コンポーネントは、データプロバイダに作用する、addItem()removeItem() などのメソッドを提供します。これらのメソッドやその他のメソッドを使用して、同じフレーム内に List コンポーネントとして存在する配列のデータを操作し、変更を複数のビューにブロードキャストできます。List コンポーネントに外部データプロバイダが提供されていない場合、これらのメソッドは自動的にデータプロバイダのインスタンスを作成し、List.dataProvider プロパティを使用して公開します。List コンポーネントは、ICellRenderer インターフェイスを実装する Sprite を使用して各行をレンダリングします。このレンダラーを指定するには、List.cellRenderer プロパティを使用します。独自に作成した Array インスタンスや、サーバーから取得した Array インスタンスを、リスト、コンボボックス、データグリッドなど複数のコンポーネントでデータモデルとして使用することもできます。

例を表示



パブリック プロパティ
 プロパティ定義元
 InheritedaccessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。
DisplayObject
 InheritedallowMultipleSelection : Boolean
複数のリストアイテムを一度に選択できるかどうかを示すブール値を取得します。
SelectableList
 Inheritedalpha : Number
指定されたオブジェクトのアルファ透明度値を示します。
DisplayObject
 InheritedblendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。
DisplayObject
 InheritedbuttonMode : Boolean
このスプライトのボタンモードを指定します。
Sprite
 InheritedcacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。
DisplayObject
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcontextMenu : ContextMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。
InteractiveObject
 InheriteddataProvider : DataProvider
表示されるアイテムのリストのデータモデルを取得または設定します。
SelectableList
 InheriteddoubleClickEnabled : Boolean
オブジェクトが doubleClick イベントを受け取るかどうかを指定します。
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。
Sprite
 Inheritedenabled : Boolean
コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。
UIComponent
 Inheritedfilters : Array
表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。
DisplayObject
 InheritedfocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示すブール値を取得または設定します。
UIComponent
 InheritedfocusManager : IFocusManager
このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得または設定します。
UIComponent
 InheritedfocusRect : Object
このオブジェクトがフォーカス矩形を表示するかどうかを指定します。
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] ベクターの描画コマンドが発生する、このスプライトに属する Graphics オブジェクトを指定します。
Sprite
 Inheritedheight : Number
コンポーネントの高さを取得または設定します (ピクセル単位)。
UIComponent
 InheritedhitArea : Sprite
スプライトのヒット領域となる別のスプライトを指定します。
Sprite
 InheritedhorizontalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが水平方向にスクロールする移動量を取得または設定します。
BaseScrollPane
 InheritedhorizontalPageScrollSize : Number
水平スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。
BaseScrollPane
 InheritedhorizontalScrollBar : ScrollBar
[read-only] 水平スクロールバーへの参照を取得します。
BaseScrollPane
 InheritedhorizontalScrollPolicy : String
水平スクロールバーの状態を示す値を取得または設定します。
BaseScrollPane
 InheritedhorizontalScrollPosition : Number
スクロールパネル内での水平スクロールバーの位置をピクセル単位で示す値を取得または設定します。
BaseScrollPane
  iconField : String
アイテムにアイコンを提供するアイテムフィールドを取得または設定します。
List
  iconFunction : Function
アイテムのアイコンの取得に使用される関数を取得または設定します。
List
  labelField : String
TextInput フィールドとドロップダウンリストのラベルとして表示される dataProvider オブジェクトのフィールドの名前を取得または設定します。
List
  labelFunction : Function
アイテムのラベルの取得に使用される関数を取得または設定します。
List
 Inheritedlength : uint
[read-only] データプロバイダに含まれているアイテムの数を取得します。
SelectableList
 InheritedloaderInfo : LoaderInfo
[read-only] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。
DisplayObject
 Inheritedmask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。
DisplayObject
 InheritedmaxHorizontalScrollPosition : Number
horizontalScrollPolicy プロパティが ScrollPolicy.ON に設定されているときに、リストを右方向にスクロールするピクセル数を取得または設定します。
SelectableList
 InheritedmaxVerticalScrollPosition : Number
[read-only] 現在のコンテンツの垂直スクロール位置の最大値 (ピクセル単位) を取得します。
BaseScrollPane
 InheritedmouseChildren : Boolean
オブジェクトの子に対してマウスが有効かどうかを調べます。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
このオブジェクトがマウスメッセージを受け取るかどうかを指定します。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示す値を取得または設定します。
UIComponent
 InheritedmouseX : Number
[read-only] マウス位置の x 座標を示します (ピクセル単位)。
DisplayObject
 InheritedmouseY : Number
[read-only] マウス位置の y 座標を示します (ピクセル単位)。
DisplayObject
 Inheritedname : String
DisplayObject のインスタンス名を示します。
DisplayObject
 InheritednumChildren : int
[read-only] このオブジェクトの子の数を返します。
DisplayObjectContainer
 InheritedopaqueBackground : Object
表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。
DisplayObject
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedroot : DisplayObject
[read-only] ロードされた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。
DisplayObject
 Inheritedrotation : Number
DisplayObject インスタンスの元の位置からの回転角を度単位で示します。
DisplayObject
  rowCount : uint
リスト内に少なくとも部分的に表示される行数を取得または設定します。
List
  rowHeight : Number
リスト内の各行の高さを取得または設定します (ピクセル単位)。
List
 Inheritedscale9Grid : Rectangle
現在有効な拡大 / 縮小グリッドです。
DisplayObject
 InheritedscaleX : Number
コンポーネントの現在の幅に縮尺率を乗算します。
UIComponent
 InheritedscaleY : Number
コンポーネントの現在の高さに縮尺率を乗算します。
UIComponent
 InheritedscrollRect : Rectangle
表示オブジェクトのスクロール矩形の境界です。
DisplayObject
 Inheritedselectable : Boolean
リスト内のアイテムを選択できるかどうかを示すブール値を取得または設定します。
SelectableList
 InheritedselectedIndex : int
単一選択リストで選択されたアイテムのインデックスを取得または設定します。
SelectableList
 InheritedselectedIndices : Array
複数選択リストから選択されたアイテムを含む配列を取得または設定します。
SelectableList
 InheritedselectedItem : Object
単一選択リストから選択されたアイテムを取得または設定します。
SelectableList
 InheritedselectedItems : Array
複数選択リストから選択されたアイテムのオブジェクトを含む配列を取得または設定します。
SelectableList
 InheritedsoundTransform : SoundTransform
このスプライト内のサウンドを制御します。
Sprite
 Inheritedstage : Stage
[read-only] 表示オブジェクトのステージです。
DisplayObject
 InheritedtabChildren : Boolean
オブジェクトの子に対してタブが有効かどうかを調べます。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
このオブジェクトがタブ順序に含まれるかどうかを指定します。
InteractiveObject
 InheritedtabIndex : int
SWF ファイル内のオブジェクトのタブ順序を指定します。
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[read-only] この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。
DisplayObjectContainer
 Inheritedtransform : Transform
表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。
DisplayObject
 InheriteduseBitmapScrolling : Boolean
true に設定すると、cacheAsBitmap プロパティによるコンテンツのスクロールが true に設定されます。false に設定すると、この値はオフになります。
BaseScrollPane
 InheriteduseHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。
Sprite
 Inheritedversion : String = "3.0.0.15"
コンポーネントのバージョン番号。
UIComponent
 InheritedverticalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが垂直方向にスクロールするピクセル数を取得または設定します。
BaseScrollPane
 InheritedverticalPageScrollSize : Number
垂直スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。
BaseScrollPane
 InheritedverticalScrollBar : ScrollBar
[read-only] 垂直スクロールバーへの参照を取得します。
BaseScrollPane
 InheritedverticalScrollPolicy : String
垂直スクロールバーの状態を示す値を取得または設定します。
BaseScrollPane
 InheritedverticalScrollPosition : Number
スクロールパネル内での垂直スクロールバーの位置をピクセル単位で示す値を取得または設定します。
BaseScrollPane
 Inheritedvisible : Boolean
現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。
UIComponent
 Inheritedwidth : Number
コンポーネントの幅を取得または設定します (ピクセル単位)。
UIComponent
 Inheritedx : Number
親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。
UIComponent
 Inheritedy : Number
親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。
UIComponent
パブリック メソッド
 メソッド定義元
  
List()
List コンポーネントの新しいインスタンスを作成します。
List
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
アイテムのリストの末尾にアイテムを追加します。
SelectableList
 Inherited
addItemAt(item:Object, index:uint):void
指定されたインデックス位置のリストにアイテムを挿入します。
SelectableList
 Inherited
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。
DisplayObjectContainer
 Inherited
clearRendererStyle(name:String, column:int = -1):void
リスト内のレンダラーに設定されたスタイルをクリアします。
SelectableList
 Inherited
リスト内で現在選択されているアイテムをクリアし、selectedIndex プロパティを -1 に設定します。
SelectableList
 Inherited
このコンポーネントインスタンスからスタイルプロパティを削除します。
UIComponent
 Inherited
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。
DisplayObjectContainer
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
このコンポーネントのフォーカスインジケータを表示または非表示にします。
UIComponent
 Inherited
invalidateNow とは異なり、すべてを無効化せずに直ちに描画を開始します。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
DisplayObject
 Inherited
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。
DisplayObjectContainer
 Inherited
指定された名前に一致する子表示オブジェクトを返します。
DisplayObjectContainer
 Inherited
子 DisplayObject インスタンスのインデックス位置を返します。
DisplayObjectContainer
 Inherited
現在フォーカスを持っているオブジェクトを取得します。
UIComponent
 Inherited
指定されたインデックス位置のアイテムを取得します。
SelectableList
 Inherited
getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):int
dataProvider 内で、ラベルの最初の文字が指定した文字に一致するアイテムの次のアイテムのインデックスを返します。
SelectableList
 Inherited
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。
DisplayObject
 Inherited
getRendererStyle(name:String, column:int = -1):Object
リスト内のレンダラーに設定されるスタイルを取得します。
SelectableList
 Inherited
コンポーネントのスタイル参照チェーンに設定されているスタイルプロパティを取得します。
UIComponent
  
[static] 現在のコンポーネントのデフォルトスタイルマップを取得します。
List
 Inherited
point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。
DisplayObject
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
表示オブジェクトを評価して、obj 表示オブジェクトと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
プロパティが無効であることを示し、指定がない限り、コンポーネントを次のフレームに再描画します。
UIComponent
 Inherited
特定のアイテムレンダラーを無効化します。
SelectableList
 Inherited
指定のインデックス位置にあるアイテムのレンダラーを無効化します。
SelectableList
 Inherited
リスト全体を無効化し、リストアイテムを強制的に再描画します。
SelectableList
 Inherited
指定されたアイテムがリストで選択されているかどうかを確認します。
SelectableList
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたアイテムオブジェクトの ICellRenderer が存在すれば取得します。
SelectableList
  
labelField プロパティと labelFunction プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを取得します。
List
 Inherited
point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。
DisplayObject
 Inherited
[static] 複数のクラスのスタイルを 1 つのオブジェクトに結合します。
UIComponent
 Inherited
親の内部の指定された位置にコンポーネントを移動します。
UIComponent
 Inherited
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
 Inherited
リストからすべてのアイテムを削除します。
SelectableList
 Inherited
DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。
DisplayObjectContainer
 Inherited
DisplayObjectContainer の子リストの指定されたインデックス位置から子 DisplayObject を削除します。
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
指定されたアイテムをリストから削除します。
SelectableList
 Inherited
指定したインデックス位置のアイテムを削除します。
SelectableList
 Inherited
指定されたインデックス位置にあるアイテムを別のアイテムで置き換えます。
SelectableList
  
scrollToIndex(newCaretIndex:int):void
指定されたインデックス位置にあるアイテムまでリストをスクロールします。
List
 Inherited
selectedIndex プロパティの現在の値で示される位置にあるアイテムまでリストをスクロールします。
SelectableList
 Inherited
表示オブジェクトコンテナの既存の子の位置を変更します。
DisplayObjectContainer
 Inherited
現在扱っているコンポーネントにフォーカスを設定します。
UIComponent
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
setRendererStyle(name:String, style:Object, column:uint = 0):void
リスト内のレンダラーにスタイルを設定します。
SelectableList
 Inherited
setSize(width:Number, height:Number):void
コンポーネントのサイズを、指定した幅と高さに設定します。
UIComponent
 Inherited
setStyle(style:String, value:Object):void
このコンポーネントインスタンスのスタイルプロパティを設定します。
UIComponent
 Inherited
sortItems(... sortArgs):*
現在のデータプロバイダのエレメントを並べ替えます。
SelectableList
 Inherited
sortItemsOn(field:String, options:Object = null):*
現在のデータプロバイダのエレメントを 1 つまたは複数のフィールドで並べ替えます。
SelectableList
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
指定されたスプライトをユーザーがドラッグできるようにします。
Sprite
 Inherited
startDrag() メソッドを終了します。
Sprite
 Inherited
指定された 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。
UIComponent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited 表示オブジェクトが表示リストに追加されたときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。DisplayObject
 Inherited リストで別のアイテムが選択されたときに送出されます。SelectableList
 Inherited ユーザーが InteractiveObject をポインティングデバイスのメインボタンでクリックしたときに送出されます。InteractiveObject
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited オブジェクトの doubleClickEnabled フラグが true に設定されている場合にユーザーが InteractiveObject をポインティングデバイスのメインボタンで 2 回続けてすばやくクリックすると送出されます。InteractiveObject
 Inherited 再生ヘッドが新しいフレームに入るときに送出されます。DisplayObject
 Inherited 表示オブジェクトがフォーカスを取得したときに送出されます。InteractiveObject
 Inherited 表示オブジェクトがフォーカスを失ったときに送出されます。InteractiveObject
 Inherited コンポーネントの可視性が可視から不可視に変化した後に送出されます。UIComponent
 Inherited ユーザーがコンポーネント内のアイテムをクリックしたときに送出されます。SelectableList
 Inherited ユーザーがコンポーネント内のアイテムを連続してすばやく 2 回クリックしたときに送出されます。SelectableList
 Inherited ユーザーがコンポーネント内のアイテムからポインタを離したときに送出されます。SelectableList
 Inherited ユーザーがコンポーネント内のアイテムにポインタを置いたときに送出されます。SelectableList
 Inherited ユーザーがキーを押したときに送出されます。InteractiveObject
 Inherited ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーがキーを離したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でユーザーがポインティングデバイスのボタンを押すと送出されます。InteractiveObject
 Inherited ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject の上でポインティングデバイスを移動させたときに送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスの上でポインティングデバイスのボタンを解放したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でマウスホイールを回転させたときに送出されます。InteractiveObject
 Inherited コンポーネントが移動された後に送出されます。UIComponent
 Inherited 表示オブジェクトが表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示リストが更新およびレンダリングされようとしているときに送出されます。DisplayObject
 Inherited コンポーネントのサイズが変更された後に送出されます。UIComponent
 Inherited ユーザーがコンポーネントからポインタを離したときに送出されます。SelectableList
 Inherited ユーザーがコンポーネント上にマウスポインタを移動させたときに送出されます。SelectableList
 Inherited ユーザーが水平方向または垂直方向にスクロールしたときに送出されます。SelectableList
 Inherited コンポーネントの可視性が不可視から可視に変化した後に送出されます。UIComponent
 Inherited オブジェクトの tabChildren フラグの値が変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabEnabled フラグが変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。InteractiveObject
スタイル
 スタイル 説明 定義元
 Inherited データ型: Class
コンポーネント内の各アイテム用のセルレンダラーを指定するクラスです。
SelectableList
 Inherited データ型: Number   形式: Length
リストとリストのコンテンツを区切るパディングです (ピクセル単位)。
SelectableList
 Inherited データ型: Number
enabled プロパティが false の場合に、リストに設定されるアルファの値です。
SelectableList
 Inherited データ型: flash.text.TextFormat
ボタンが無効な場合に、コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
 Inherited データ型: Class
スクロールバーの下矢印ボタンが無効になったときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの下矢印ボタンをクリックしたときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの下矢印ボタンにマウスポインタを合わせたときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Number   形式: Length
コンポーネント領域の外側とフォーカスインジケータ領域のエッジを区切るパディングです (ピクセル単位)。
UIComponent
 Inherited データ型: Class
フォーカスインジケータの表示に使用されるスキンです。
UIComponent
 Inherited データ型: Number   形式: Time
buttonDown イベントが最初に送出されてから 2 番目の buttonDown イベントを送出するまでの待機時間です (ミリ秒単位)。
BaseScrollPane
 Inherited データ型: Number   形式: Time
buttonDown イベントを再送出するまでの待機時間を repeatDelay スタイルに指定します (ミリ秒単位)。
BaseScrollPane
 Inherited データ型: Class
コンポーネントの背景用のスキンを指定するクラスです。
SelectableList
 Inherited データ型: flash.text.TextFormat
コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
 Inherited データ型: Class
サムの無効状態を示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
サムをクリックしたときに、スクロールバーのサムのスキンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
スクロールバーのサムのアイコンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
スクロールバーのサムにマウスポインタを合わせたときに、そのサムのスキンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
スクロールバーのサムのスキンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
無効なトラックを示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
無効なスキンのダウン状態を示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
スクロールトラック上にマウスが配置されていることを示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
スクロールトラックのマウスのアップ状態を示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンが無効になったときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンをクリックしたときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンにマウスポインタを合わせたときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
プロパティの詳細
iconFieldプロパティ
iconField:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムにアイコンを提供するアイテムフィールドを取得または設定します。

メモ : iconField は、iconFunction プロパティがコールバック関数に設定されている場合は使用されません。

デフォルト値 : "icon".


実装
    public function get iconField():String
    public function set iconField(value:String):void



次の例では、各アイテムのアイコンが表示されるリストを作成します。RedBox という名前のシンボルがライブラリに存在し、シンボルのプロパティで [ActionScript に書き出し] がオンになっている必要があります。
import fl.data.DataProvider;
import fl.controls.List;

var dp:DataProvider = new DataProvider();
dp.addItem( { iconSource:RedBox, label:"Item 1" } );
dp.addItem( { iconSource:RedBox, label:"Item 2" } );
dp.addItem( { iconSource:RedBox, label:"Item 3" } );

var list:List = new List();
list.iconField = "iconSource";
list.dataProvider = dp;
addChild(list);
iconFunctionプロパティ 
iconFunction:Function  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムのアイコンの取得に使用される関数を取得または設定します。

メモ : iconField は、iconFunction プロパティがコールバック関数に設定されている場合は使用されません。

デフォルト値 : null.


実装
    public function get iconFunction():Function
    public function set iconFunction(value:Function):void



次の例では、iconFunction プロパティを使用して、アイコンを提供するリスト内のアイテム数を制限します。この例を正しく実行するには、RedBox という名前のシンボルがライブラリに存在し、シンボルのプロパティで [ActionScript に書き出し] がオンになっている必要があります。
import fl.data.DataProvider;
import fl.controls.List;

var dp:DataProvider = new DataProvider();
dp.addItem( { label:"Item 1" } );
dp.addItem( { label:"Item 2" } );
dp.addItem( { label:"Item 3" } );

var list:List = new List();
list.iconFunction = determineIcon;
list.dataProvider = dp;
addChild(list);

function determineIcon(item:Object):String {
    if(item.label == "Item 2") {
        return "RedBox";
    }
    else {
        return null;
    }
}
labelFieldプロパティ 
labelField:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

TextInput フィールドとドロップダウンリストのラベルとして表示される dataProvider オブジェクトのフィールドの名前を取得または設定します。

デフォルトで、コンポーネントは label プロパティを各 dataProvider アイテムのプロパティとして表示します。dataProvider アイテムに label プロパティが含まれない場合は、別のプロパティを使用するように labelField プロパティを設定できます。

メモ : labelField プロパティは、labelFunction プロパティがコールバック関数に設定されている場合は使用されません。

デフォルト値 : "label".


実装
    public function get labelField():String
    public function set labelField(value:String):void

関連項目




次の例では、リストの各アイテムを abbreviatedLabel プロパティを使用して表示します。デフォルトでは、label プロパティで表示されます。
import fl.data.DataProvider;
import fl.controls.List;

var dp:DataProvider = new DataProvider();
dp.addItem( { abbreviatedLabel:"NY", label:"New York" } );
dp.addItem( { abbreviatedLabel:"CA", label:"California" } );
dp.addItem( { abbreviatedLabel:"WA", label:"Washington" } );
dp.addItem( { abbreviatedLabel:"CT", label:"Connecticut" } );
dp.addItem( { abbreviatedLabel:"VT", label:"Vermont" } );

var list:List = new List();
list.setSize(40,100);
list.labelField = "abbreviatedLabel"
list.dataProvider = dp;
addChild(list);
labelFunctionプロパティ 
labelFunction:Function  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムのラベルの取得に使用される関数を取得または設定します。

デフォルトで、コンポーネントは label プロパティを dataProvider アイテムのプロパティとして表示します。ただし、一部のデータセットには、label がない場合や、値を変更しないでラベルとして使用できるフィールドがない場合があります。たとえば、指定されたデータセットは完全名を格納しますが、lastName フィールドと firstName フィールドで維持します。この場合には、このプロパティを使用して、lastName フィールドと firstName フィールドの値を連結し、表示される完全名のストリングにするコールバック関数を設定できます。

メモ : labelField プロパティは、labelFunction プロパティがコールバック関数に設定されている場合は使用されません。

デフォルト値 : null.


実装
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void



この例では、リストの labelFunction プロパティを各セルに表示されるストリングをフォーマットする関数に設定します。
import fl.data.DataProvider;
import fl.controls.List;

var myDataProvider:DataProvider = new DataProvider();
myDataProvider.addItem({name:"User A", price:0.43});
myDataProvider.addItem({name:"User B", price:0.34});

var users:List = new List();
users.dataProvider = myDataProvider;
users.labelFunction = myLabelFunction;
addChild(users);

function myLabelFunction(item:Object):String {
    return  item.name + " ($" + item.price.toFixed(2) + ")";
}
rowCountプロパティ 
rowCount:uint  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

リスト内に少なくとも部分的に表示される行数を取得または設定します。


実装
    public function get rowCount():uint
    public function set rowCount(value:uint):void



この例では、リストのサイズを設定し、rowCount プロパティをトレースして、表示可能な行数を判断します。

import fl.data.DataProvider;
import fl.controls.List;

var dp:DataProvider = new DataProvider();
var i:uint;
for(i=0; i<100; i++) {
    dp.addItem( { label: "Item " + i } );
}

var list:List = new List();
list.setSize(100,300);
list.dataProvider = dp;
addChild(list);

trace(list.rowCount); // 15

次の例では、現在のスライダ値に基づいて、rowCount を使用して List コンポーネントのサイズを設定します。

import fl.controls.Slider;
import fl.controls.List;
import fl.data.DataProvider;
import fl.events.SliderEvent;

var dp:DataProvider = new DataProvider();
var i:int;
for (i=0; i<8; i++) {
    dp.addItem({label:"Item " + i});
}

var mySlider:Slider = new Slider();
mySlider.move(10, 10);
mySlider.tickInterval = 1;
mySlider.snapInterval = 1;
mySlider.minimum = 2;
mySlider.maximum = 9;
mySlider.liveDragging = true;
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

var myList:List = new List();
myList.dataProvider = dp;
myList.move(mySlider.x, mySlider.y + 20);
myList.setSize(100, 50);
addChild(myList);

function changeHandler(event:SliderEvent):void {
    myList.rowCount = event.value;
}
rowHeightプロパティ 
rowHeight:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

リスト内の各行の高さを取得または設定します (ピクセル単位)。

デフォルト値 : 20.


実装
    public function get rowHeight():Number
    public function set rowHeight(value:Number):void
コンストラクタの詳細
List()コンストラクタ
public function List()

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

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

メソッドの詳細
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;
}
itemToLabel()メソッド 
public override function itemToLabel(item:Object):String

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

labelField プロパティと labelFunction プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを取得します。

メモ : labelField は、labelFunction プロパティがコールバック関数に設定されている場合は使用されません。

パラメータ

item:Object — レンダリングされるオブジェクトです。

戻り値
String — データに応じて表示されるストリングです。



次の例は、リストアイテムのラベルをマウスでポイントしたときに、それを特定する方法を示します。
import fl.controls.List;
import fl.data.DataProvider;
import fl.events.ListEvent;

var myDataProvider:DataProvider = new DataProvider();
myDataProvider.addItem({label:"Carrot", price:0.43});
myDataProvider.addItem({label:"Tomato", price:0.34});
myDataProvider.addItem({label:"Blueberry", price:0.72});
myDataProvider.addItem({label:"Turnip", price:0.24});

var myList:List = new List();
myList.setSize(300,80);
myList.dataProvider = myDataProvider;
myList.labelFunction = myLabelFunction;
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, announceLabel);
addChild(myList);

function myLabelFunction(item:Object):String {
    return item.label + " - Current price: ($" + item.price.toFixed(2) + ")";
}

function announceLabel(e:ListEvent):void {
    var list:List = e.target as List;
    var item:Object = e.item;
    trace("Label: " + item.label);
    trace("Label displayed: " + list.itemToLabel(item));
}
scrollToIndex()メソッド 
public override function scrollToIndex(newCaretIndex:int):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたインデックス位置にあるアイテムまでリストをスクロールします。インデックスが範囲外の場合、スクロール位置は変更されません。

パラメータ

newCaretIndex:int — スクロールするインデックス位置です。

例の使用法
ListExample.as

この例は、List を作成し、その選択を他の List インスタンスに設定する方法を示します。

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

  1. ライブラリに List、Button、および Label コンポーネントを追加します。
  2. このコードを ListExample.as として FLA ファイルと同じディレクトリに保存します。
  3. FLA ファイルのドキュメントクラスを ListExample に設定します。
package
{
    import flash.display.Sprite
    
    public class ListExample extends Sprite
    {
        import fl.controls.Button;
        import fl.controls.Label;
        import fl.controls.List;
        import fl.data.DataProvider;
        import flash.events.*;
        
        private var clearButton:Button;
        private var availableItems:List;
        private var selectedItemList:List;
        private var selectedItemsList:List;

        public function ListExample() {
            createComponents();
            setupComponents();
        }

        private function setupComponents():void {
            var dp:Array = new Array();
            var i:uint;
            var count:uint = availableItems.rowCount * 2;
            
            for (i = 0; i < count; i++) {
                dp.push({label:"Item " + i});
            }
            
            availableItems.allowMultipleSelection = true;
            availableItems.dataProvider = new DataProvider(dp);
            availableItems.addEventListener(Event.CHANGE, updateLists);
            clearButton.addEventListener(MouseEvent.CLICK, clearHandler);            
        }
        
        private function clearHandler(event:MouseEvent):void {
            availableItems.clearSelection();
            // clear data providers
            selectedItemList.dataProvider = new DataProvider();
            selectedItemsList.dataProvider = new DataProvider();
        }
        
        private function updateLists(e:Event):void {
            selectedItemList.dataProvider = availableItems.selectedItem ? new DataProvider([availableItems.selectedItem]) : new DataProvider();
            selectedItemsList.dataProvider = new DataProvider(availableItems.selectedItems);
        }

        private function createComponents():void {
            clearButton = new Button();
            availableItems = new List();
            selectedItemList = new List();
            selectedItemsList = new List();
            var availableItemsLabel:Label = new Label();
            var selectedItemListLabel:Label = new Label();
            var selectedItemsListLabel:Label = new Label();
            
            clearButton.move(10,142);
            availableItems.move(10,32);
            selectedItemList.move(120,32);
            selectedItemsList.move(230,32);
            availableItemsLabel.move(10,10);
            selectedItemListLabel.move(120,10);
            selectedItemsListLabel.move(230,10);
            
            clearButton.label = "Clear Selection"
            availableItemsLabel.text = "Available Items";
            selectedItemListLabel.text = "Selected Item";
            selectedItemsListLabel.text = "All Selected Items";
            
            addChild(clearButton);
            addChild(availableItems);
            addChild(selectedItemList);
            addChild(selectedItemsList);
            addChild(availableItemsLabel);
            addChild(selectedItemListLabel);
            addChild(selectedItemsListLabel);
        }
    }
}




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

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