パッケージ | fl.controls |
クラス | public class List |
継承 | List SelectableList BaseScrollPane UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
実装 | IFocusManagerComponent |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.0 |
List コンポーネントは、アイテム、行、およびデータプロバイダーで構成されます。それぞれの詳細を以下に示します。
- アイテム:通常は説明的な
label
プロパティと、そのアイテムに関連付けられるデータを格納するdata
プロパティを含む ActionScript オブジェクトです。 - 行:アイテムの表示に使用されるコンポーネントです。
- データプロバイダー:List コンポーネントが表示するアイテムのモデルを作成するコンポーネントです。
デフォルトで、List コンポーネントは CellRenderer クラスを使用して、リストアイテムが表示される行を提供します。これらの行をプログラムで作成できます。これは、通常 CellRenderer クラスをサブクラス化することで行います。CellRenderer クラスは、ICellRenderer インターフェイスを実装します。List コンポーネントは、このインターフェイスが提供するプロパティやメソッドを使用して、行を操作したり、表示のためにデータや状態情報を各行に送信することができます。これには、サイズ変更や選択に関する情報が含まれています。
List コンポーネントは、データプロバイダーに作用する、addItem()
や removeItem()
などのメソッドを提供します。これらのメソッドやその他のメソッドを使用して、同じフレーム内に List コンポーネントとして存在する配列のデータを操作し、変更を複数のビューにブロードキャストできます。List コンポーネントに外部データプロバイダーが提供されていない場合、これらのメソッドは自動的にデータプロバイダーのインスタンスを作成し、List.dataProvider
プロパティを使用して公開します。List コンポーネントは、ICellRenderer インターフェイスを実装する Sprite を使用して各行をレンダリングします。このレンダラーを指定するには、List.cellRenderer
プロパティを使用します。独自に作成した Array インスタンスや、サーバーから取得した Array インスタンスを、リスト、コンボボックス、データグリッドなど複数のコンポーネントでデータモデルとして使用することもできます。
プロパティ | 定義元 | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
この InteractiveObject インスタンスの現在のアクセシビリティの実装(AccessibilityImplementation)です。 | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。 | DisplayObject | ||
allowMultipleSelection : Boolean
複数のリストアイテムを一度に選択できるかどうかを示すブール値を取得します。 | SelectableList | ||
alpha : Number
指定されたオブジェクトのアルファ透明度値を示します。 | DisplayObject | ||
blendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。 | DisplayObject | ||
blendShader : Shader [書き込み専用]
前景と背景のブレンドに使用するシェーダーを設定します。 | DisplayObject | ||
buttonMode : Boolean
このスプライトのボタンモードを指定します。 | Sprite | ||
cacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash ランタイムにキャッシュされます。 | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
null 以外の場合、この Matrix オブジェクトは、cacheAsBitmap を true に設定したときの表示オブジェクトのレンダリング方法を定義します。 | DisplayObject | ||
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
contextMenu : NativeMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。 | InteractiveObject | ||
dataProvider : DataProvider
表示されるアイテムのリストのデータモデルを取得または設定します。 | SelectableList | ||
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 | ||
horizontalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが水平方向にスクロールする移動量を取得または設定します。 | BaseScrollPane | ||
horizontalPageScrollSize : Number
水平スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。 | BaseScrollPane | ||
horizontalScrollBar : ScrollBar [読み取り専用]
水平スクロールバーへの参照を取得します。 | BaseScrollPane | ||
horizontalScrollPolicy : String
水平スクロールバーの状態を示す値を取得または設定します。 | BaseScrollPane | ||
horizontalScrollPosition : Number
スクロールパネル内での水平スクロールバーの位置をピクセル単位で示す値を取得または設定します。 | BaseScrollPane | ||
iconField : String
アイテムにアイコンを提供するアイテムフィールドを取得または設定します。 | List | ||
iconFunction : Function
アイテムのアイコンの取得に使用される関数を取得または設定します。 | List | ||
labelField : String
TextInput フィールドとドロップダウンリストのラベルとして表示される dataProvider オブジェクトのフィールドの名前を取得または設定します。 | List | ||
labelFunction : Function
アイテムのラベルの取得に使用される関数を取得または設定します。 | List | ||
length : uint [読み取り専用]
データプロバイダーに含まれているアイテムの数を取得します。 | SelectableList | ||
loaderInfo : LoaderInfo [読み取り専用]
この表示オブジェクトが属するファイルの読み込み情報を含む LoaderInfo オブジェクトを返します。 | DisplayObject | ||
mask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。 | DisplayObject | ||
maxHorizontalScrollPosition : Number [オーバーライド]
horizontalScrollPolicy プロパティが ScrollPolicy.ON に設定されているときに、リストを右方向にスクロールするピクセル数を取得または設定します。 | SelectableList | ||
maxVerticalScrollPosition : Number [読み取り専用]
現在のコンテンツの垂直スクロール位置の最大値(ピクセル単位)を取得します。 | BaseScrollPane | ||
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 | ||
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 | ||
rowCount : uint [オーバーライド]
リスト内に少なくとも部分的に表示される行数を取得または設定します。 | List | ||
rowHeight : Number
リスト内の各行の高さを取得または設定します(ピクセル単位)。 | List | ||
scale9Grid : Rectangle
現在有効な拡大 / 縮小グリッドです。 | DisplayObject | ||
scaleX : Number [オーバーライド]
コンポーネントの現在の幅に縮尺率を乗算します。 | UIComponent | ||
scaleY : Number [オーバーライド]
コンポーネントの現在の高さに縮尺率を乗算します。 | UIComponent | ||
scaleZ : Number
オブジェクトの基準点から適用されるオブジェクトの奥行きスケール(パーセンテージ)を示します。 | DisplayObject | ||
scrollRect : Rectangle
表示オブジェクトのスクロール矩形の境界です。 | DisplayObject | ||
selectable : Boolean
リスト内のアイテムを選択できるかどうかを示すブール値を取得または設定します。 | SelectableList | ||
selectedIndex : int
単一選択リストで選択されたアイテムのインデックスを取得または設定します。 | SelectableList | ||
selectedIndices : Array
複数選択リストから選択されたアイテムを含む配列を取得または設定します。 | SelectableList | ||
selectedItem : Object
単一選択リストから選択されたアイテムを取得または設定します。 | SelectableList | ||
selectedItems : Array
複数選択リストから選択されたアイテムのオブジェクトを含む配列を取得または設定します。 | SelectableList | ||
softKeyboard : String
ソフトキーボードの外観を制御します。 | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
ソフトキーボードが表示されたときに画面に表示したままにする領域を定義します(iOS では使用不可)。 | InteractiveObject | ||
soundTransform : flash.media:SoundTransform
このスプライト内のサウンドを制御します。 | Sprite | ||
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 | ||
useBitmapScrolling : Boolean
true に設定すると、cacheAsBitmap プロパティによるコンテンツのスクロールが true に設定されます。false に設定すると、この値はオフになります。 | BaseScrollPane | ||
useHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にポインターが移動したときに、指差しハンドポインター(ハンドカーソル)を表示するかどうかを示すブール値です。 | Sprite | ||
verticalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが垂直方向にスクロールするピクセル数を取得または設定します。 | BaseScrollPane | ||
verticalPageScrollSize : Number
垂直スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。 | BaseScrollPane | ||
verticalScrollBar : ScrollBar [読み取り専用]
垂直スクロールバーへの参照を取得します。 | BaseScrollPane | ||
verticalScrollPolicy : String
垂直スクロールバーの状態を示す値を取得または設定します。 | BaseScrollPane | ||
verticalScrollPosition : Number
スクロールパネル内での垂直スクロールバーの位置をピクセル単位で示す値を取得または設定します。 | BaseScrollPane | ||
visible : Boolean [オーバーライド]
現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。 | UIComponent | ||
width : Number [オーバーライド]
コンポーネントの幅を取得または設定します(ピクセル単位)。 | UIComponent | ||
x : Number [オーバーライド]
親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。 | UIComponent | ||
y : Number [オーバーライド]
親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。 | UIComponent | ||
z : Number
3D 親コンテナを基準にした、DisplayObject インスタンスの z 軸に沿った z 座標位置を示します。 | DisplayObject |
メソッド | 定義元 | ||
---|---|---|---|
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 | ||
[静的]
現在のコンポーネントのデフォルトスタイルマップを取得します。 | List | ||
point オブジェクトをステージ(グローバル)座標から表示オブジェクトの(ローカル)座標に変換します。 | DisplayObject | ||
ステージ(グローバル)座標の 2 次元のポイントを 3 次元の表示オブジェクトの(ローカル)座標に変換します。 | DisplayObject | ||
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
表示オブジェクトの境界ボックスを評価して、obj 表示オブジェクトの境界ボックスと重複または交差するかどうかを調べます。 | DisplayObject | ||
表示オブジェクトを評価して、x および y パラメーターで指定されたポイントと重複または交差するかどうかを調べます。 | DisplayObject | ||
プロパティが無効であることを示し、指定がない限り、コンポーネントを次のフレームに再描画します。 | UIComponent | ||
特定のアイテムレンダラーを無効化します。 | SelectableList | ||
指定のインデックス位置にあるアイテムのレンダラーを無効化します。 | SelectableList | ||
リスト全体を無効化し、リストアイテムを強制的に再描画します。 | SelectableList | ||
指定されたアイテムがリストで選択されているかどうかを確認します。 | SelectableList | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
指定されたアイテムオブジェクトの ICellRenderer が存在すれば取得します。 | SelectableList | ||
[オーバーライド]
labelField プロパティと labelFunction プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを取得します。 | List | ||
3 次元の表示オブジェクトの(ローカル)座標の 3 次元のポイントをステージ(グローバル)座標の 2 次元のポイントに変換します。 | DisplayObject | ||
point オブジェクトを表示オブジェクトの(ローカル)座標からステージ(グローバル)座標に変換します。 | DisplayObject | ||
[静的]
複数のクラスのスタイルを 1 つのオブジェクトに結合します。 | UIComponent | ||
親の内部の指定された位置にコンポーネントを移動します。 | UIComponent | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
リストからすべてのアイテムを削除します。 | SelectableList | ||
DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。 | DisplayObjectContainer | ||
DisplayObjectContainer の子リストの指定された index 位置から子 DisplayObject を削除します。 | DisplayObjectContainer | ||
DisplayObjectContainer インスタンスの子リストから、すべての child DisplayObject インスタンスを削除します。 | DisplayObjectContainer | ||
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | ||
指定されたアイテムをリストから削除します。 | SelectableList | ||
指定したインデックス位置のアイテムを削除します。 | SelectableList | ||
指定されたインデックス位置にあるアイテムを別のアイテムで置き換えます。 | SelectableList | ||
仮想キーボードを前面に表示します。 | InteractiveObject | ||
[オーバーライド]
指定されたインデックス位置にあるアイテムまでリストをスクロールします。 | List | ||
selectedIndex プロパティの現在の値で示される位置にあるアイテムまでリストをスクロールします。 | SelectableList | ||
表示オブジェクトコンテナの既存の子の位置を変更します。 | DisplayObjectContainer | ||
現在扱っているコンポーネントにフォーカスを設定します。 | UIComponent | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
リスト内のレンダラーにスタイルを設定します。 | SelectableList | ||
コンポーネントのサイズを、指定した幅と高さに設定します。 | UIComponent | ||
このコンポーネントインスタンスのスタイルプロパティを設定します。 | UIComponent | ||
現在のデータプロバイダーのエレメントを並べ替えます。 | SelectableList | ||
現在のデータプロバイダーのエレメントを 1 つまたは複数のフィールドで並べ替えます。 | SelectableList | ||
指定されたスプライトをユーザーがドラッグできるようにします。 | Sprite | ||
指定されたスプライトを、ユーザーがタッチ対応デバイス上でドラッグできるようにします。 | Sprite | ||
このオブジェクトでルート指定されているすべての MovieClip のタイムラインでの実行を再帰的に停止します。 | DisplayObjectContainer | ||
startDrag() メソッドを終了します。 | Sprite | ||
タッチ対応デバイスで使用する startTouchDrag() メソッドを終了します。 | Sprite | ||
指定された 2 つの子オブジェクトの z 順序(重ね順)を入れ替えます。 | DisplayObjectContainer | ||
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序(重ね順)を入れ替えます。 | DisplayObjectContainer | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのストリング表現を返します。 | Object | ||
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。 | UIComponent | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object | ||
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher |
スタイルには共通スタイルと特定のテーマに関連するスタイルがあります。共通スタイルは、任意のテーマと共に使用できます。特定のテーマに関連するスタイルは、アプリケーションがそのテーマを使用する場合にのみ使用できます。
iconField | プロパティ |
iconField:String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.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
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.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
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.0 |
TextInput フィールドとドロップダウンリストのラベルとして表示される dataProvider
オブジェクトのフィールドの名前を取得または設定します。
デフォルトで、コンポーネントは label
プロパティを各 dataProvider
アイテムのプロパティとして表示します。dataProvider
アイテムに label
プロパティが含まれない場合は、別のプロパティを使用するように labelField
プロパティを設定できます。
注意:labelField
プロパティは、labelFunction
プロパティがコールバック関数に設定されている場合は使用されません。
デフォルト値: "label"。
実装
public function get labelField():String
public function set labelField(value:String):void
関連する API エレメント
例 ( この例の使用方法 )
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
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.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
[オーバーライド] 言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.0 |
リスト内に少なくとも部分的に表示される行数を取得または設定します。
実装
override public function get rowCount():uint
override 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 | プロパティ |
List | () | コンストラクター |
public function List()
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.0 |
List コンポーネントの新しいインスタンスを作成します。
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 — デフォルトスタイルのオブジェクトです。
|
関連する API エレメント
例 ( この例の使用方法 )
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 | () | メソッド |
override public function itemToLabel(item:Object):String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flash CS3 |
ランタイムバージョン: | Flash Player 9.0.28.0, AIR 1.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 | () | メソッド |
- ライブラリに List、Button および Label クラスを追加します。
- このコードを FLA と同じディレクトリに ListExample.as という名前で保存します。
- FLA 内の DocumentClass を ListExample に設定します。
package { import flash.display.Sprite public class ListExample extends Sprite { import flash.events.*; import fl.data.DataProvider; import fl.controls.List import fl.controls.Label import fl.controls.Button 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); } } }
Tue Jun 12 2018, 10:34 AM Z