| パッケージ | fl.controls |
| クラス | public class List |
| 継承 | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 実装 | IFocusManagerComponent |
| 言語バージョン : | ActionScript 3.0 |
| Player のバージョン : | Flash Player 9.0.28.0 |
List コンポーネントは、アイテム、行、およびデータプロバイダで構成されます。これらは、次に示します。
label プロパティと、そのアイテムに関連付けられるデータを格納する data プロパティを含む ActionScript オブジェクトです。 デフォルトで、List コンポーネントは CellRenderer クラスを使用して、リストアイテムが表示される行を提供します。これらの行をプログラムで作成できます。これは、通常 CellRenderer クラスをサブクラス化することで行います。CellRenderer クラスは、ICellRenderer インターフェイスを実装します。List コンポーネントは、このインターフェイスが提供するプロパティやメソッドを使用して、行を操作したり、表示のためにデータや状態情報を各行に送信することができます。これには、サイズ変更や選択に関する情報が含まれています。
List コンポーネントは、データプロバイダに作用する、addItem() や removeItem() などのメソッドを提供します。これらのメソッドやその他のメソッドを使用して、同じフレーム内に List コンポーネントとして存在する配列のデータを操作し、変更を複数のビューにブロードキャストできます。List コンポーネントに外部データプロバイダが提供されていない場合、これらのメソッドは自動的にデータプロバイダのインスタンスを作成し、List.dataProvider プロパティを使用して公開します。List コンポーネントは、ICellRenderer インターフェイスを実装する Sprite を使用して各行をレンダリングします。このレンダラーを指定するには、List.cellRenderer プロパティを使用します。独自に作成した Array インスタンスや、サーバーから取得した Array インスタンスを、リスト、コンボボックス、データグリッドなど複数のコンポーネントでデータモデルとして使用することもできます。
| プロパティ | 定義元 | ||
|---|---|---|---|
![]() | accessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。
| DisplayObject | |
![]() | allowMultipleSelection : Boolean
複数のリストアイテムを一度に選択できるかどうかを示すブール値を取得します。
| SelectableList | |
![]() | alpha : Number
指定されたオブジェクトのアルファ透明度値を示します。
| DisplayObject | |
![]() | blendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。
| DisplayObject | |
![]() | buttonMode : Boolean
このスプライトのボタンモードを指定します。
| Sprite | |
![]() | cacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。
| DisplayObject | |
![]() | constructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
| Object | |
![]() | contextMenu : ContextMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。
| InteractiveObject | |
![]() | dataProvider : DataProvider
表示されるアイテムのリストのデータモデルを取得または設定します。
| SelectableList | |
![]() | doubleClickEnabled : Boolean
オブジェクトが doubleClick イベントを受け取るかどうかを指定します。
| InteractiveObject | |
![]() | dropTarget : DisplayObject
[read-only]
スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。
| Sprite | |
![]() | enabled : Boolean
コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。
| UIComponent | |
![]() | filters : Array
表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。
| DisplayObject | |
![]() | focusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示すブール値を取得または設定します。
| UIComponent | |
![]() | focusManager : IFocusManager
このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得または設定します。
| UIComponent | |
![]() | focusRect : Object
このオブジェクトがフォーカス矩形を表示するかどうかを指定します。
| InteractiveObject | |
![]() | graphics : Graphics
[read-only]
ベクターの描画コマンドが発生する、このスプライトに属する Graphics オブジェクトを指定します。
| Sprite | |
![]() | height : Number
コンポーネントの高さを取得または設定します (ピクセル単位)。
| UIComponent | |
![]() | hitArea : Sprite
スプライトのヒット領域となる別のスプライトを指定します。
| Sprite | |
![]() | horizontalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが水平方向にスクロールする移動量を取得または設定します。
| BaseScrollPane | |
![]() | horizontalPageScrollSize : Number
水平スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。
| BaseScrollPane | |
![]() | horizontalScrollBar : ScrollBar
[read-only]
水平スクロールバーへの参照を取得します。
| BaseScrollPane | |
![]() | horizontalScrollPolicy : String
水平スクロールバーの状態を示す値を取得または設定します。
| BaseScrollPane | |
![]() | horizontalScrollPosition : Number
スクロールパネル内での水平スクロールバーの位置をピクセル単位で示す値を取得または設定します。
| BaseScrollPane | |
| iconField : String
アイテムにアイコンを提供するアイテムフィールドを取得または設定します。
| List | ||
| iconFunction : Function
アイテムのアイコンの取得に使用される関数を取得または設定します。
| List | ||
| labelField : String
TextInput フィールドとドロップダウンリストのラベルとして表示される dataProvider オブジェクトのフィールドの名前を取得または設定します。
| List | ||
| labelFunction : Function
アイテムのラベルの取得に使用される関数を取得または設定します。
| List | ||
![]() | length : uint
[read-only]
データプロバイダに含まれているアイテムの数を取得します。
| SelectableList | |
![]() | loaderInfo : LoaderInfo
[read-only]
この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。
| DisplayObject | |
![]() | mask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。
| DisplayObject | |
![]() | maxHorizontalScrollPosition : Number
horizontalScrollPolicy プロパティが ScrollPolicy.ON に設定されているときに、リストを右方向にスクロールするピクセル数を取得または設定します。
| SelectableList | |
![]() | maxVerticalScrollPosition : Number
[read-only]
現在のコンテンツの垂直スクロール位置の最大値 (ピクセル単位) を取得します。
| BaseScrollPane | |
![]() | mouseChildren : Boolean
オブジェクトの子に対してマウスが有効かどうかを調べます。
| DisplayObjectContainer | |
![]() | mouseEnabled : Boolean
このオブジェクトがマウスメッセージを受け取るかどうかを指定します。
| InteractiveObject | |
![]() | mouseFocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示す値を取得または設定します。
| UIComponent | |
![]() | mouseX : Number
[read-only]
マウス位置の x 座標を示します (ピクセル単位)。
| DisplayObject | |
![]() | mouseY : Number
[read-only]
マウス位置の y 座標を示します (ピクセル単位)。
| DisplayObject | |
![]() | name : String
DisplayObject のインスタンス名を示します。
| DisplayObject | |
![]() | numChildren : int
[read-only]
このオブジェクトの子の数を返します。
| DisplayObjectContainer | |
![]() | opaqueBackground : Object
表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。
| DisplayObject | |
![]() | parent : DisplayObjectContainer
[read-only]
この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。
| DisplayObject | |
![]() | prototype : Object
[static]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
| Object | |
![]() | root : DisplayObject
[read-only]
ロードされた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。
| DisplayObject | |
![]() | rotation : Number
DisplayObject インスタンスの元の位置からの回転角を度単位で示します。
| DisplayObject | |
| rowCount : uint
リスト内に少なくとも部分的に表示される行数を取得または設定します。
| List | ||
| rowHeight : Number
リスト内の各行の高さを取得または設定します (ピクセル単位)。
| List | ||
![]() | scale9Grid : Rectangle
現在有効な拡大 / 縮小グリッドです。
| DisplayObject | |
![]() | scaleX : Number
コンポーネントの現在の幅に縮尺率を乗算します。
| UIComponent | |
![]() | scaleY : Number
コンポーネントの現在の高さに縮尺率を乗算します。
| UIComponent | |
![]() | scrollRect : Rectangle
表示オブジェクトのスクロール矩形の境界です。
| DisplayObject | |
![]() | selectable : Boolean
リスト内のアイテムを選択できるかどうかを示すブール値を取得または設定します。
| SelectableList | |
![]() | selectedIndex : int
単一選択リストで選択されたアイテムのインデックスを取得または設定します。
| SelectableList | |
![]() | selectedIndices : Array
複数選択リストから選択されたアイテムを含む配列を取得または設定します。
| SelectableList | |
![]() | selectedItem : Object
単一選択リストから選択されたアイテムを取得または設定します。
| SelectableList | |
![]() | selectedItems : Array
複数選択リストから選択されたアイテムのオブジェクトを含む配列を取得または設定します。
| SelectableList | |
![]() | soundTransform : SoundTransform
このスプライト内のサウンドを制御します。
| Sprite | |
![]() | stage : Stage
[read-only]
表示オブジェクトのステージです。
| DisplayObject | |
![]() | tabChildren : Boolean
オブジェクトの子に対してタブが有効かどうかを調べます。
| DisplayObjectContainer | |
![]() | tabEnabled : Boolean
このオブジェクトがタブ順序に含まれるかどうかを指定します。
| InteractiveObject | |
![]() | tabIndex : int
SWF ファイル内のオブジェクトのタブ順序を指定します。
| InteractiveObject | |
![]() | textSnapshot : TextSnapshot
[read-only]
この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。
| DisplayObjectContainer | |
![]() | transform : Transform
表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。
| DisplayObject | |
![]() | useBitmapScrolling : Boolean
true に設定すると、cacheAsBitmap プロパティによるコンテンツのスクロールが true に設定されます。false に設定すると、この値はオフになります。
| BaseScrollPane | |
![]() | useHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。
| Sprite | |
![]() | version : String = "3.0.0.15"
コンポーネントのバージョン番号。
| UIComponent | |
![]() | verticalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが垂直方向にスクロールするピクセル数を取得または設定します。
| BaseScrollPane | |
![]() | verticalPageScrollSize : Number
垂直スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。
| BaseScrollPane | |
![]() | verticalScrollBar : ScrollBar
[read-only]
垂直スクロールバーへの参照を取得します。
| BaseScrollPane | |
![]() | verticalScrollPolicy : String
垂直スクロールバーの状態を示す値を取得または設定します。
| BaseScrollPane | |
![]() | verticalScrollPosition : Number
スクロールパネル内での垂直スクロールバーの位置をピクセル単位で示す値を取得または設定します。
| BaseScrollPane | |
![]() | visible : Boolean
現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。
| UIComponent | |
![]() | width : Number
コンポーネントの幅を取得または設定します (ピクセル単位)。
| UIComponent | |
![]() | x : Number
親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。
| UIComponent | |
![]() | y : Number
親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。
| UIComponent | |
| メソッド | 定義元 | ||
|---|---|---|---|
|
List()
List コンポーネントの新しいインスタンスを作成します。
| List | ||
![]() |
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
| DisplayObjectContainer | |
![]() |
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
| DisplayObjectContainer | |
![]() |
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
| EventDispatcher | |
![]() |
アイテムのリストの末尾にアイテムを追加します。
| SelectableList | |
![]() |
指定されたインデックス位置のリストにアイテムを挿入します。
| SelectableList | |
![]() |
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。
| DisplayObjectContainer | |
![]() |
リスト内のレンダラーに設定されたスタイルをクリアします。
| SelectableList | |
![]() |
リスト内で現在選択されているアイテムをクリアし、selectedIndex プロパティを -1 に設定します。
| SelectableList | |
![]() |
このコンポーネントインスタンスからスタイルプロパティを削除します。
| UIComponent | |
![]() |
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。
| DisplayObjectContainer | |
![]() |
イベントをイベントフローに送出します。
| EventDispatcher | |
![]() |
このコンポーネントのフォーカスインジケータを表示または非表示にします。
| UIComponent | |
![]() |
invalidateNow とは異なり、すべてを無効化せずに直ちに描画を開始します。
| UIComponent | |
![]() |
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
| DisplayObject | |
![]() |
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。
| DisplayObjectContainer | |
![]() |
指定された名前に一致する子表示オブジェクトを返します。
| DisplayObjectContainer | |
![]() |
子 DisplayObject インスタンスのインデックス位置を返します。
| DisplayObjectContainer | |
![]() |
現在フォーカスを持っているオブジェクトを取得します。
| UIComponent | |
![]() |
指定されたインデックス位置のアイテムを取得します。
| SelectableList | |
![]() |
dataProvider 内で、ラベルの最初の文字が指定した文字に一致するアイテムの次のアイテムのインデックスを返します。
| SelectableList | |
![]() |
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。
| DisplayObjectContainer | |
![]() |
シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。
| DisplayObject | |
![]() |
リスト内のレンダラーに設定されるスタイルを取得します。
| SelectableList | |
![]() |
コンポーネントのスタイル参照チェーンに設定されているスタイルプロパティを取得します。
| UIComponent | |
|
[static]
現在のコンポーネントのデフォルトスタイルマップを取得します。
| List | ||
![]() |
point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。
| DisplayObject | |
![]() |
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
| EventDispatcher | |
![]() |
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
| Object | |
![]() |
表示オブジェクトを評価して、obj 表示オブジェクトと重複または交差するかどうかを調べます。
| DisplayObject | |
![]() |
表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。
| DisplayObject | |
![]() |
プロパティが無効であることを示し、指定がない限り、コンポーネントを次のフレームに再描画します。
| UIComponent | |
![]() |
特定のアイテムレンダラーを無効化します。
| SelectableList | |
![]() |
指定のインデックス位置にあるアイテムのレンダラーを無効化します。
| SelectableList | |
![]() |
リスト全体を無効化し、リストアイテムを強制的に再描画します。
| SelectableList | |
![]() |
指定されたアイテムがリストで選択されているかどうかを確認します。
| SelectableList | |
![]() |
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
| Object | |
![]() |
指定されたアイテムオブジェクトの ICellRenderer が存在すれば取得します。
| SelectableList | |
|
labelField プロパティと labelFunction プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを取得します。
| List | ||
![]() |
point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。
| DisplayObject | |
![]() |
[static]
複数のクラスのスタイルを 1 つのオブジェクトに結合します。
| UIComponent | |
![]() |
親の内部の指定された位置にコンポーネントを移動します。
| UIComponent | |
![]() |
指定されたプロパティが存在し列挙できるかどうかを示します。
| Object | |
![]() |
リストからすべてのアイテムを削除します。
| SelectableList | |
![]() |
DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。
| DisplayObjectContainer | |
![]() |
DisplayObjectContainer の子リストの指定されたインデックス位置から子 DisplayObject を削除します。
| DisplayObjectContainer | |
![]() |
EventDispatcher オブジェクトからリスナーを削除します。
| EventDispatcher | |
![]() |
指定されたアイテムをリストから削除します。
| SelectableList | |
![]() |
指定したインデックス位置のアイテムを削除します。
| SelectableList | |
![]() |
指定されたインデックス位置にあるアイテムを別のアイテムで置き換えます。
| SelectableList | |
|
指定されたインデックス位置にあるアイテムまでリストをスクロールします。
| List | ||
![]() |
selectedIndex プロパティの現在の値で示される位置にあるアイテムまでリストをスクロールします。
| SelectableList | |
![]() |
表示オブジェクトコンテナの既存の子の位置を変更します。
| DisplayObjectContainer | |
![]() |
現在扱っているコンポーネントにフォーカスを設定します。
| UIComponent | |
![]() |
ループ処理に対するダイナミックプロパティの可用性を設定します。
| Object | |
![]() |
リスト内のレンダラーにスタイルを設定します。
| SelectableList | |
![]() |
コンポーネントのサイズを、指定した幅と高さに設定します。
| UIComponent | |
![]() |
このコンポーネントインスタンスのスタイルプロパティを設定します。
| UIComponent | |
![]() |
現在のデータプロバイダのエレメントを並べ替えます。
| SelectableList | |
![]() |
現在のデータプロバイダのエレメントを 1 つまたは複数のフィールドで並べ替えます。
| SelectableList | |
![]() |
指定されたスプライトをユーザーがドラッグできるようにします。
| Sprite | |
![]() |
startDrag() メソッドを終了します。
| Sprite | |
![]() |
指定された 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
| DisplayObjectContainer | |
![]() |
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
| DisplayObjectContainer | |
![]() |
指定されたオブジェクトのストリング表現を返します。
| Object | |
![]() |
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。
| UIComponent | |
![]() |
指定されたオブジェクトのプリミティブな値を返します。
| Object | |
![]() |
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
| EventDispatcher | |
| 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); // 15rowCount を使用して 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 — スクロールするインデックス位置です。
|
例を実行するには、次の手順に従います。
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