Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
mx.core 

IRepeater  - AS3 Flex

パッケージmx.core
インターフェイスpublic interface IRepeater
実装者 Repeater

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

IRepeater インターフェイスは、Repeater オブジェクトのパブリック API を定義します。



パブリックプロパティ
 プロパティ定義元
  container : IContainer
[読み取り専用] この Repeater を含むコンテナであり、ここでこの Repeater が子を作成します。
IRepeater
  count : int
この Repeater を実行する回数です。
IRepeater
  currentIndex : int
[読み取り専用] この Repeater の実行中、現在処理されている dataProvider 内のアイテムのインデックスです。
IRepeater
  currentItem : Object
[読み取り専用] この Repeater の実行中、現在処理されている dataProvider 内のアイテムです。
IRepeater
  dataProvider : Object
この Repeater が、子の繰り返しインスタンスを作成するために使用するデータプロバイダーです。
IRepeater
  recycleChildren : Boolean
この Repeater が前に作成した子を再使用するのか、新しい子を作成するのかを示す Boolean フラグです。
IRepeater
  startingIndex : int
この Repeater が子の作成を開始する dataProvider へのインデックスです。
IRepeater
パブリックメソッド
 メソッド定義元
  
この Repeater が作成したすべての UIComponent へのバインディングを実行します。
IRepeater
  
新規の Repeater オブジェクトを初期化します。
IRepeater
プロパティの詳細

container

プロパティ
container:IContainer  [読み取り専用]

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater を含むコンテナであり、ここでこの Repeater が子を作成します。



実装
    public function get container():IContainer

count

プロパティ 
count:int

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater を実行する回数です。

Repeater が実行中にデータプロバイダーの最後に達した場合、実際の実行回数は要求されたカウントよりも少なくなります。



実装
    public function get count():int
    public function set count(value:int):void

currentIndex

プロパティ 
currentIndex:int  [読み取り専用]

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater の実行中、現在処理されている dataProvider 内のアイテムのインデックスです。

Repeater が実行を終了した後は、このプロパティの値は -1 になります。 ただし、繰り返しコンポーネントのインスタンスの repeaterIndex プロパティは、作成元の dataProvider アイテムのインデックスを記憶しています。 ネストされた Repeater の場合は、repeaterIndices 配列を使用できます。



実装
    public function get currentIndex():int

関連する API エレメント

currentItem

プロパティ 
currentItem:Object  [読み取り専用]

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater の実行中、現在処理されている dataProvider 内のアイテムです。

Repeater が実行を終了した後は、このプロパティの値は null になります。 ただしこの場合は、繰り返しコンポーネントのインスタンスの getRepeaterItem() メソッドを呼び出して、作成元の dataProvider アイテムを取得できます。



実装
    public function get currentItem():Object

関連する API エレメント

dataProvider

プロパティ 
dataProvider:Object

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater が、子の繰り返しインスタンスを作成するために使用するデータプロバイダーです。

dataProvider プロパティを参照すると、常に ICollectionView オブジェクトか、または null が取得されます。 dataProvider プロパティを null 以外の値に設定すると、その値は以下の規則に従って ICollectionView オブジェクトに変換されます。

  • Array に設定すると、ArrayCollection に変換されます。
  • ICollectionView に設定すると、変換は実行されません。
  • IList に設定すると、ListCollectionView に変換されます。
  • XML または XMLList に設定すると、XMLListCollection に変換されます。
  • それ以外の場合は、単一エレメントの ArrayCollection に変換されます。

Repeater コンポーネントを実行するには、dataProvider プロパティの値を指定する必要があります。



実装
    public function get dataProvider():Object
    public function set dataProvider(value:Object):void

recycleChildren

プロパティ 
recycleChildren:Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater が前に作成した子を再使用するのか、新しい子を作成するのかを示す Boolean フラグです。

true の場合、この Repeater の dataProviderstartingIndex または count が変更されると、新規データを既存の子にバインドすることにより、既存の子が再利用されます。 追加の子が必要な場合は、作成され、追加されます。 子が多すぎる場合には、余分な子が削除され、ガベージコレクションされます。

false の場合、この Repeater の dataProviderstartingIndex または count が変更されると、この Repeater は前に作成した子を削除し、新しいデータアイテムから新たに子を作成して、追加します。

このプロパティのデフォルト値は false です。 true に設定するとパフォーマンスが向上しますが、この設定がどのような状況においても適切であるとは限りません。 例えば、前に作成した子がユーザー入力のテキストなどの状態情報を持っている場合、この状態は子が再使用されたときにリセットされません。



実装
    public function get recycleChildren():Boolean
    public function set recycleChildren(value:Boolean):void

startingIndex

プロパティ 
startingIndex:int

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater が子の作成を開始する dataProvider へのインデックスです。



実装
    public function get startingIndex():int
    public function set startingIndex(value:int):void
メソッドの詳細

executeChildBindings

()メソッド
public function executeChildBindings():void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

この Repeater が作成したすべての UIComponent へのバインディングを実行します。

このメソッドは、Flex フレームワークによって呼び出されます。開発者がこのメソッドを呼び出す必要はありません。

initializeRepeater

()メソッド 
public function initializeRepeater(container:IContainer, recurse:Boolean):void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

新規の Repeater オブジェクトを初期化します。

このメソッドは、Flex フレームワークによって呼び出されます。開発者がこのメソッドを呼び出す必要はありません。

パラメーター

container:IContainer — この Repeater を含むコンテナであり、ここでこの Repeater が子を作成します。
 
recurse:Boolean — この Repeater がその子のすべての下位要素を作成するかどうかを示す Boolean フラグです。





[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。