パッケージ | mx.collections |
クラス | public class ArrayList |
継承 | ArrayList EventDispatcher Object |
実装 | IList, IExternalizable, IPropertyChangeNotifier |
サブクラス | Conflicts |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 4 |
ランタイムバージョン: | Flash Player 10, AIR 1.5 |
IList
インターフェイスのメソッドとプロパティを使用します。ArrayList インスタンスに対して操作を行うと、データソースが変更されます。例えば、ArrayList の removeItemAt()
メソッドを使用すると、基になる Array からアイテムが削除されます。この基本クラスは、ItemPendingErrors をスローしませんが、サブクラスはスローする場合があります。
<mx:ArrayList Properties source="null" />
デフォルトの MXML プロパティsource
プロパティ | 定義元 | ||
---|---|---|---|
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
length : int [読み取り専用]
リスト内のアイテムの数を取得します。 | ArrayList | ||
source : Array
この ArrayList のソース配列。 | ArrayList | ||
uid : String
このリストの一意の ID へのアクセスを提供します。 | ArrayList |
メソッド | 定義元 | ||
---|---|---|---|
指定された配列をそのソースとして使用して、新しい ArrayList を作成します。 | ArrayList | ||
アイテムのリストを現在のリストに追加し、渡される順序でリストの末尾に配置します。 | ArrayList | ||
アイテムのリストを現在のリストに追加し、関数に渡されるインデックス位置に配置します。 | ArrayList | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。 | EventDispatcher | ||
指定されたアイテムをリストの末尾に追加します。 | ArrayList | ||
指定されたインデックス位置にアイテムを追加します。 | ArrayList | ||
イベントをイベントフローに送出します。 | EventDispatcher | ||
指定されたインデックス位置にあるアイテムを取得します。 | ArrayList | ||
アイテムがリスト内にある場合、インデックスを返します(getItemAt(index) == item)。 | ArrayList | ||
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。 | EventDispatcher | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void
アイテムが更新されたビューを通知します。 | ArrayList | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
リストからすべてのアイテムを削除します。 | ArrayList | ||
EventDispatcher オブジェクトからリスナーを削除します。 | EventDispatcher | ||
指定されたアイテムをリストから削除します(存在する場合)。 | ArrayList | ||
指定されたインデックス位置にあるアイテムを削除し、返します。 | ArrayList | ||
指定されたインデックス位置にアイテムを配置します。 | ArrayList | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
IList 実装と同じ順序で指定された配列を返します。 | ArrayList | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
[オーバーライド]
この ArrayList のコンテンツをストリングに出力して、返します。 | ArrayList | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object | ||
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。 | EventDispatcher |
メソッド | 定義元 | ||
---|---|---|---|
リストに含まれるアイテムが ObjectChange イベントを送出すると呼び出されます。 | ArrayList | ||
アイテムが IEventDispatcher の場合は、それが更新されていないかどうかを監視します。 | ArrayList | ||
アイテムが IEventDispatcher の場合は、それが更新されていないかどうかの監視を停止します。 | ArrayList |
イベント | 概要 | 定義元 | ||
---|---|---|---|---|
[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | |||
IList が何らかの方法で更新されると送出されます。 | ArrayList | |||
[ブロードキャストイベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher |
length | プロパティ |
length:int
[読み取り専用] 言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
リスト内のアイテムの数を取得します。ArrayList は、-1 を返さないように常にその長さを認識している必要があります。ただし、サブクラスがその動作をオーバーライドする場合があります。
このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 collectionChange
イベントが送出されます。
実装
public function get length():int
source | プロパティ |
source:Array
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
この ArrayList のソース配列。IList インターフェイスを通じて行った変更はすべて、ソース配列に反映されます。ソース配列が指定されなかった場合、ArrayList は、ソース配列を内部的に作成します。基になる配列に対して直接変更を加えても(例えば、List.source.pop()
の呼び出しなど)、CollectionEvents
は送出されません。
実装
public function get source():Array
public function set source(value:Array):void
uid | プロパティ |
ArrayList | () | コンストラクター |
addAll | () | メソッド |
addAllAt | () | メソッド |
addItem | () | メソッド |
addItemAt | () | メソッド |
public function addItemAt(item:Object, index:int):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたインデックス位置にアイテムを追加します。このインデックス位置の後にあったすべてのアイテムは、1 つだけ移動されます。
パラメーター
item:Object — インデックス位置に配置するアイテム
| |
index:int — アイテムを配置するインデックス位置
|
例外
RangeError — インデックスが 0 未満であるか、または長さより大きい場合
|
getItemAt | () | メソッド |
public function getItemAt(index:int, prefetch:int = 0):Object
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたインデックス位置にあるアイテムを取得します。
パラメーター
index:int — アイテムを取得するリストのインデックス
| |
prefetch:int (default = 0 ) — アイテムがローカルでない場合に要求時に取得するアイテムの方向と量を示す int 値です。
|
Object — そのインデックス位置にあるアイテムです。アイテムがない場合は null です
|
例外
Error — そのインデックスのデータをリモートからロードする必要がある場合
| |
RangeError — index < 0 または index >= length の場合
|
getItemIndex | () | メソッド |
itemUpdated | () | メソッド |
public function itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
アイテムが更新されたビューを通知します。これは、ビューのコンテンツが IEventDispatcher
を実装しない場合に便利です。プロパティを指定すると、ビューは通知メカニズムを最適化できます。 プロパティを指定しないと、ビュー全体の単純な更新が選択されます。
パラメーター
item:Object — 更新されたビュー内のアイテムです。
| |
property:Object (default = null ) — 更新されたプロパティを指定する String、QName または int です。
| |
oldValue:Object (default = null ) — そのプロパティの古い値です。 プロパティが null の場合はアイテムの古い値を指定できます。
| |
newValue:Object (default = null ) — そのプロパティの新しい値です。 プロパティが null の場合、アイテムは新しい値と見なされるので、指定する必要はありません。
|
関連する API エレメント
itemUpdateHandler | () | メソッド |
protected function itemUpdateHandler(event:PropertyChangeEvent):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
リストに含まれるアイテムが ObjectChange イベントを送出すると呼び出されます。CollectionEventKind.UPDATE
オブジェクトでそれをラップします。
パラメーター
event:PropertyChangeEvent — ObjectChange イベントのイベントオブジェクトです。
|
removeAll | () | メソッド |
public function removeAll():void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
リストからすべてのアイテムを削除します。
removeItem | () | メソッド |
removeItemAt | () | メソッド |
public function removeItemAt(index:int):Object
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたインデックス位置にあるアイテムを削除し、返します。このインデックスより後にあったアイテムは、インデックスが 1 つずつ前になります。
パラメーター
index:int — アイテムが削除されるインデックスです。
|
Object — 削除されたアイテムです。
|
例外
RangeError — index < 0 または index >= length の場合。
|
setItemAt | () | メソッド |
public function setItemAt(item:Object, index:int):Object
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
指定されたインデックス位置にアイテムを配置します。アイテムが既にそのインデックス位置にある場合は、新しいアイテムに置き換えられ、インデックス位置にあったアイテムが返されます。
パラメーター
item:Object — インデックスの新しい値
| |
index:int — アイテムを配置するインデックス位置
|
Object — 置き換えられたアイテムです。アイテムがない場合は null です
|
例外
RangeError — インデックスが 0 未満であるか、または長さ以上の場合
|
startTrackUpdates | () | メソッド |
stopTrackUpdates | () | メソッド |
protected function stopTrackUpdates(item:Object):void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
アイテムが IEventDispatcher の場合は、それが更新されていないかどうかの監視を停止します。このメソッドは removeItemAt()
メソッドと removeAll()
メソッドによって呼び出され、新しいソースが割り当てられる前に呼び出されます。
パラメーター
item:Object — removeItemAt() メソッドに渡されるアイテムです。
|
toArray | () | メソッド |
toString | () | メソッド |
collectionChange | イベント |
mx.events.CollectionEvent
プロパティ CollectionEvent.type =
mx.events.CollectionEvent.COLLECTION_CHANGE
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
IList が何らかの方法で更新されると送出されます。
CollectionEvent.COLLECTION_CHANGE 定数は、コレクションが変更されたときに送出されるイベントのイベントオブジェクトのtype
プロパティ値を定義します。
イベントオブジェクトの各プロパティには次の値が設定されています。 イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | false |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
items | イベントの影響を受けるアイテムの情報を持つオブジェクトの配列です。 このフィールドの内容はイベントの種類に応じて異なります。詳細については、items プロパティを参照してください。 |
kind | イベントの種類です。 有効な値が定数として CollectionEventKind クラスに定義されます。 |
location | items プロパティで指定されたアイテムのターゲットコレクション内における位置です。 |
oldLocation | items プロパティで指定されたアイテムのコレクション内における以前の位置です。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | CollectionEvent.COLLECTION_CHANGE |
Tue Jun 12 2018, 10:34 AM Z