Tree は、データに関する情報について、データ記述子に委任します。次に、このデータはデータソースに関する解析と移動のために使用されます。

このプロパティを MXML の属性として指定する場合、記述子のストリング名ではなく、データ記述子への参照を使用する必要があります。次の形式のプロパティを使用します。

<mx:Tree id="tree" dataDescriptor="{new MyCustomTreeDataDescriptor()}"/>>

また、次の例に示すように、ネストしたサブタグとして MXML のプロパティを指定できます。

<mx:Tree>
     <mx:dataDescriptor>
     <myCustomTreeDataDescriptor>

デフォルト値は、DefaultDataDescriptor クラスの内部インスタンスです。

表示するデータを含むオブジェクトです。このプロパティに値を割り当てると、Tree クラスにより次のようにソースデータオブジェクトが処理されます。

• 有効な XML テキストを含むストリングが XMLListCollection に変換されます。
• また XMLNode は XMLListCollection に変換されます。
• また XMLList は、XMLListCollection に変換されます。
• ICollectionView インターフェイスを実装するすべてのオブジェクトが ICollectionView にキャストされます。
• Array は ArrayCollection に変換されます。
• 他のタイプのオブジェクトは、Array 内でその単一エントリとしてラップされます。

デフォルト値ヌル (null).

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

ドラッグ & ドロップ操作の一部として、アイテムを Tree コントロールから単にコピーするのではなく移動できることを示します。

デフォルト値true.

ツリーの一番上の行に現在表示されているアイテムです。ブランチが開閉およびスクロールされた状態に応じて、たとえば、現在表示可能なアイテムのうちリスト内では 9 番目であったり、ルートのひ孫にあたるようなアイテムであっても、一番上の行に表示されることがあります。このプロパティを設定することは、List コントロールの verticalScrollPosition を設定するのに似ています。現在表示可能な状態にないアイテム (たとえば、展開されていないアイテムの下にあるアイテムなど) に対しては、このプロパティを設定しても効果はありません。

メモ : Flex 1.0 では、このプロパティは実際には XMLNode または TreeNode のいずれかでしたが、XMLNode として型付けされていました。2.0 では、これは汎用タイプの Object になり、dataProvider に含まれているデータと同じタイプのオブジェクトが返されるようになりました。

デフォルト値は Tree コントロール内の最初のアイテムです。

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

現在の dataProvider にルートアイテム (例 : 階層構造の単一の最上位ノード) があることを示します。XML および Object は、ルートがあるタイプの例です。リストと配列には、ルートがありません。

関連項目

アイテムのアイコンを指定するオブジェクトです。オブジェクトの各エントリには、アイテム UID であるフィールド名と次の形式のオブジェクトである値があります。

      {iconID: Class, iconID2: Class}
      

このプロパティでは、アイテムアイコンの初期化を許可することが想定されています。初期化後のこの配列への変更は自動的に検出されません。アイコンを動的に変更するには setItemIcon() メソッドを使用します。

デフォルト値undefined.

関連項目

Tree コントロールの maxHorizontalScrollPosition プロパティの最大値です。このプロパティは、List コントロールの maxHorizontalScrollPosition プロパティとは異なり、アイテムが開閉したとき、およびそれ以外の場合にツリーのアイテムが表示または非表示になったときに (たとえばスクロールなど)、Tree コントロールにより変更されます。

このプロパティを dataProvider 内で既知の最も幅の広いアイテムを設定すると、たとえそのアイテムが 4 段階下のレベルにあるような場合でも、ユーザーがスクロールしてアイテムを表示できるように値が調整されます。この結果、maxHorizontalScrollPosition プロパティの値を読み込むと、設定したのと同じ値が読み込まれますが、その値は必ずしも Tree コントロールが実際に使用する値とは限りません。

デフォルト値0.

開かれた状態のアイテムまたは開くように設定されたアイテムです。

デフォルト値ヌル (null).

ルートアイテムの可視性を設定します。dataProvider データにルートノードがあるときに、false に設定された場合、Tree コントロールはルートアイテムを表示しません。ルートアイテムの子孫だけが表示されます。 このフラグは、リストや配列などのルートを持たない dataProviders では無効です。

デフォルト値true.

関連項目

コンストラクタです。

DragEvent.DRAG_COMPLETE イベントを処理します。 デフォルトでは、DragManager.MOVE ドラッグアクションのみサポートされます。DragManager.COPY ドラッグアクションをサポートするには、Tree データのコピーを実装している dragDropHandler() カスタムメソッドを、その構造に基づいて記述する必要があります。

DragEvent.DRAG_DROP events を処理します。このメソッドは、hideDropFeedback() メソッドを呼び出して UI フィードバックを非表示にします。 デフォルトでは、DragManager.MOVE ドラッグアクションのみサポートされます。DragManager.COPY ドラッグアクションをサポートするには、Tree データのコピーを実装している dragDropHandler() カスタムメソッドを、その構造に基づいて記述する必要があります。

指定したアイテムの配下にあるすべてのツリーを開くか、または閉じます。 dataProvider を設定し、その直後に expandChildrenOf() を呼び出した場合は、不適切な動作が起こる可能性があります。コンポーネントが検証されるまで待つか、validateNow() メソッドを呼び出します。

ブランチアイテムを開くまたは閉じます。ブランチアイテムを開くと、子ブランチが既に開かれている場合は、子ブランチの開閉の状態が復元されます。 dataProvider を設定し、その直後に expandItem() を呼び出した場合は、不適切な動作が起こる可能性があります。コンポーネントが検証されるまで待つか、validateNow() を呼び出します。

子アイテムの既知の親を返します。このメソッドは、アイテムが表示されていたかまたは現在表示されている場合のみ、値を返します。最上位アイテムは null 値の親を持ちます。

ツリーアイテムレンダラーが使用する TreeListData オブジェクトを初期化します。

指定したアイテムのブランチが開いている (子が表示されている) 場合は true を返します。

新しい TreeListData インスタンスを作成し、入力されたデータプロバイダアイテムに基づいてフィールドに値を格納します。

アイテムに関連付けるアイコンを設定します。このメソッドを呼び出すと、アイテムがリーフアイテムである場合にその iconField プロパティおよび iconFunction プロパティがオーバーライドされます。ブランチアイテムでは、iconField プロパティおよび iconFunction プロパティを使用しません。このノードでは、folderOpenIcon プロパティおよび folderClosedIcon プロパティを使用します。

ブランチが閉じられた (畳まれた) ときに送出します。

TreeEvent.ITEM_CLOSE イベント型定数は、ツリーのブランチが閉じた (畳まれた) 状態であることを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。

ブランチが開かれた (展開された) ときに送出します。

TreeEvent.ITEM_OPEN イベント型定数は、ツリーのブランチが開かれた (展開された) 状態であることを示します。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。

ブランチが開かれたときまたは閉じられたときに送出します。

TreeEvent.ITEM_OPENING イベントタイプ定数は、ツリーの開閉直前に送出されます。

このイベントタイプのイベントオブジェクトの各プロパティには次の値が設定されています。イベントの種類によっては無効なプロパティもあります。詳細については、各プロパティの説明を参照してください。