mx.collections.ArrayCollection (Flex™ 2 リファレンスガイド)

パッケージ	mx.collections
	public class ArrayCollection
継承	ArrayCollection ListCollectionView Proxy Object
Implements	IExternalizable

ArrayCollection クラスは、ICollectionView または IList インターフェイスのメソッドとプロパティを使用して、アクセスおよび操作できるコレクションとして配列を公開するラッパークラスです。ArrayCollection インスタンスに対する操作はデータソースを変更します。たとえば、ArrayCollection で removeItemAt() メソッドを使用した場合、元になる Array からアイテムが削除されます。

MXML シンタックス expanded

MXML シンタックスの非表示

The <mx:ArrayCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

 <mx:ArrayCollection Properties source="null" />

デフォルトの MXML プロパティsource

例
次のコードを使用すると、単一のオブジェクトエレメントを持つ配列にアクセスし、この配列を操作する単純な ArrayCollection オブジェクトが作成されます。このコードは、IList インターフェイスの getItemAt メソッド、およびこのコードが ICollectionView の createCursor メソッドを使用して取得する IViewCursor オブジェクトを使用してエレメントを取得します。

  var myCollection:ArrayCollection = new ArrayCollection([{first: 'Matt', last: 'Matthews'}]);
  var myCursor:IViewCursor = myCollection.createCursor();
  var firstItem:Object = myCollection.getItemAt(z0);
  var firstItemFromCursor:Object = myCursor.current;
  if (firstItem == firstItemFromCursor) {
     //doCelebration();
  }

関連項目

データプロバイダおよびコレクションの使用

パブリックプロパティ

継承されるパブリックプロパティの非表示

継承されるパブリックプロパティの表示

	プロパティ		定義
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		filterFunction : Function 関数の条件に一致しないアイテムを削除するためにビューが使用する関数です。	ListCollectionView
		length : int このビュー内のアイテムの数です。	ListCollectionView
		list : IList このコレクションビューが囲む IList です。	ListCollectionView
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		sort : Sort ICollectionView に適用されるソートです。	ListCollectionView
		source : Array ArrayCollection 内のデータのソースです。	ArrayCollection

Protectedプロパティ

継承される Protected プロパティの非表示

継承される Protected プロパティの表示

	プロパティ		定義
		localIndex : Array ビューにソートまたはフィルタを適用すると、そのビュー (ソートによりアイテムの順序が変更されたか、またはフィルタによりアイテム数が減ったビュー) に含まれているアイテムの配列が `localIndex` プロパティにソート順に格納されます。	ListCollectionView

パブリック Methods

継承されるパブリックメソッドの非表示

継承されるパブリックメソッドの表示

	メソッド		定義
		ArrayCollection(source:Array = null) コンストラクタです。	ArrayCollection
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void リスナーがイベントの通知を受け取るように、イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録します。	ListCollectionView
		addItem(item:Object):void 指定されたアイテムをリストの末尾に追加します。	ListCollectionView
		addItemAt(item:Object, index:int):void 指定されたインデックス位置にアイテムを追加します。	ListCollectionView
		contains(item:Object):Boolean ビューに指定されたオブジェクトを含めるかどうかを返します。	ListCollectionView
		createCursor():IViewCursor このビューに対して使用する新しい IViewCursor を作成します。	ListCollectionView
		disableAutoUpdate():void コレクション自体およびコレクション内のアイテムの変更がビューから送出されないようにします。	ListCollectionView
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	ListCollectionView
		enableAutoUpdate():void 自動更新を有効にします。	ListCollectionView
		getItemAt(index:int, prefetch:int = 0):Object 指定されたインデックス位置にあるアイテムを取得します。	ListCollectionView
		getItemIndex(item:Object):int アイテムがリスト内にあり、getItemAt(index) == アイテムになるような場合は、アイテムのインデックスを返します。	ListCollectionView
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	ListCollectionView
		hasOwnProperty(name:String):Boolean 指定されたプロパティがオブジェクトに定義されているかどうかを示します。	Object
		initialized(document:Object, id:String):void MXML タグを使用して ListCollectionView を作成したときに、MXML コンパイラによって自動的に呼び出されます。	ListCollectionView
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void アイテムが更新されたビューを通知します。	ListCollectionView
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		refresh():Boolean ビューにソートとフィルタを適用します。	ListCollectionView
		removeAll():void リストからすべてのアイテムを削除します。	ListCollectionView
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	ListCollectionView
		removeItemAt(index:int):Object 指定されたインデックス位置にあるアイテムを削除し、返します。	ListCollectionView
		setItemAt(item:Object, index:int):Object 指定されたインデックス位置にアイテムを配置します。	ListCollectionView
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toArray():Array IList 実装と同じ順で指定された配列を返します。	ListCollectionView
		toString():String このビューの内容をストリングにプリティプリントし、返します。	ListCollectionView
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	ListCollectionView

Protected Methods

継承される Protected メソッドの表示

	メソッド		定義
		callProperty(name:, ... rest): 関数として呼び出し可能なオブジェクトプロパティの動作を上書きします。	Proxy
		deleteProperty(name:*):Boolean プロパティを削除する要求を上書きします。	Proxy
		getDescendants(name:): `descendant` 演算子の使用をオーバーライドします。	Proxy
		getProperty(name:): プロパティの値に対する要求を上書きします。	Proxy
		hasProperty(name:*):Boolean オブジェクトが特定のプロパティを持っているかどうかを名前ごとにチェックする要求を上書きします。	Proxy
		isAttribute(name:*):Boolean 指定された QName が属性としてマークされているかどうかを確認します。	Proxy
		nextName(index:int):String インデックス番号を使用して、プロキシになるオブジェクトのプロパティを列挙してプロパティ名を取得できます。	Proxy
		nextNameIndex(index:int):int インデックス番号を使用して、プロキシになるオブジェクトのプロパティを列挙できます。	Proxy
		nextValue(index:int):* インデックス番号を使用して、プロキシになるオブジェクトのプロパティを列挙してプロパティ値を取得できます。	Proxy
		setProperty(name:, value:):void プロパティの値を変更する呼び出しを上書きします。	Proxy

イベント

継承されるイベントの非表示

継承されるイベントの表示

	イベント		一覧	定義
		collectionChange	ICollectionView が何らかの方法で更新されると送出されます。	ListCollectionView

プロパティの詳細

source

プロパティ

source:Array [read-write]

ArrayCollection 内のデータのソースです。ArrayCollection オブジェクトは、ソース配列に直接加えた変更を表しません。コレクションを変更するには、常に ICollectionView メソッドまたは IList メソッドを使用します。

このプロパティはデータバインディングのソースとして使用できます。

実装
public function get source():Array
public function set source(value:Array):void

コンストラクタの詳細

ArrayCollection

()

コンストラクタ

public 関数 ArrayCollection(source:Array = null)

コンストラクタです。

指定されたソース配列を使用して新しい ArrayCollection を作成します。配列が指定されていない場合は、空の配列が使用されます。

パラメータ

source:Array (default = null)

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class ArrayCollection	プロパティ \| メソッド \| イベント