| メソッド | プロパティ | エフェクト | イベント | スタイル | 例 | フレームあり | フレームなし |
Tree コントロールを使用すると、展開表示可能なツリー形式に整理された階層データをユーザーが表示できます。ツリー内の各アイテムはノードと呼ばれ、ノードにはリーフノードとブランチノードがあります。リーフノードとは、ツリー内の各末端にあるノードです。ブランチノードとは、リーフノードまたはブランチノードを含んだノードです。
デフォルトでは、リーフは、ファイルアイコンの横のテキストラベルで表されます。ブランチは、フォルダアイコンの横のテキストラベルで表されます。ブランチにはユーザーが開いて子を表示できる展開用矢印が付いています。
ツリーのノードは、TreeDataProvider コントロールによって表されます。ツリー内の各ノードについて、TreeDataProvider コントロールに次のプロパティを定義できます。
MXML シンタックス
<mx:Tree> タグは、親クラスのすべてのプロパティと、次のプロパティを継承します。
<mx:Tree例を参照するにはここをクリックしてください
alternatingRowColors="No default."
dataProvider="No default."
defaultLeafIcon="No default."
depthColors="No default."
firstVisibleNode="No default."
folderOpenIcon="No default."
folderClosedIcon="No default."
indentation="8"
openDuration="250"
openEasing="No default."
rollOverColor="0xE3FFD6"
selectedNode="No default."
selectionColor=#0xCDFFC1"
cellEdit="Event handler; no default."
cellFocusIn="Event handler; no default."
cellFocusOut="Event handler; no default."
cellPress="Event handler; no default."
change="Event handler; no default."
nodeClose="Event handler; no default."
nodeOpen="Event handler; no default."
/>
関連項目
treeclasses.TreeDataProvider
| メソッド | |
| addTreeNode( labelOrNode, data)
ツリーの最上位にノードを追加します。 |
| addTreeNodeAt( index, labelOrNode, data)
ツリーの最上位ノードの指定されたインデックスに子ノードを追加します。 |
| calculateWidths( count)
コントロール内のコンテンツに基づいて、コントロールの推奨される幅を返します。 |
| getDisplayIndex( node)
ツリー内で現在開いているノードと閉じているノードの状態に基づいて、指定したノードがツリー内の何行目にあるかを返します。 |
| getDropParent( )
: Objectドラッグ & ドロップ操作時にドロップ位置の親ノードを返します。 |
| getIsBranch( node)
指定したノードがブランチノードの場合は true を返します。 |
| getIsOpen( node)
指定したノードのブランチが開いている (子が表示されている) 場合は true を返します。 |
| getNodeDisplayedAt( index)
ツリーの現在の状態に基づいて、指定したインデックス位置のノードを返します。 |
| getTreeNodeAt( index)
ツリーの最上位にある指定したインデックス位置のノードを返します。 |
| removeAll( )
ツリーからすべてのノードを削除します。 |
| removeTreeNodeAt( index)
ツリーの最上位から指定したノードを削除します。 |
| setIcon( node, iconID, iconID2)
ノードに関連付けるアイコンを設定します。 |
| setIsBranch( node, branch)
ノードがブランチノードかどうかを指定します。 |
| setIsOpen( node, open, animate, fireEvent)
ブランチノードを開きます。 |
| mx.core.ScrollView クラスから継承されるメソッド |
childLoaded createChildren createChildWithStyles getViewMetrics init layoutChildren setScrollProperties |
| mx.core.UIComponent クラスから継承されるメソッド |
drawFocus getFocus getFocusManager setEnabled setFocus |
| プロパティ | |
| cellEditor:MovieClip セルエディタへの参照です (存在する場合)。 |
| dataProvider:Object 表示されるオブジェクトの階層構造を表す TreeDataProvider または XMLTreeDataProvider です。 |
| firstVisibleNode:varツリーの一番上の行に現在表示されているノードです。 |
| focusedCell:Object指定したノードに cellEditor を作成します。 |
| maxHPosition:Number ツリーの hPosition の最大値です。 |
| selectedNode:varツリー内で選択されているノードです。 |
| selectedNodes:Array選択されているノードです。 |
static | version:Stringこのクラスのバージョンを表すストリングです。 |
| mx.controls.List クラスから継承されるプロパティ |
version |
| mx.core.ScrollView クラスから継承されるプロパティ |
className hPosition hScrollPolicy liveScrolling maxHPosition maxVPosition scrollTipFunction showScrollTips version vPosition vScrollPolicy |
| mx.core.View クラスから継承されるプロパティ |
baselinePosition className numChildren version |
| mx.core.UIComponent クラスから継承されるプロパティ |
enabled errorString tabEnabled tabIndex version |
| エフェクト |
| mx.core.UIComponent クラスから継承されるエフェクト |
focusInEffect focusOutEffect |
| mx.core.UIObject クラスから継承されるエフェクト |
creationCompleteEffect hideEffect mouseDownEffect mouseOutEffect mouseOverEffect mouseUpEffect moveEffect resizeEffect showEffect |
| イベント | |
cellEdit | セルの値がセルエディタによって変更されたときにブロードキャストします。セルまたは列が編集可能の場合にのみブロードキャストします。このイベントオブジェクトには、次のプロパティが含まれます。 - itemIndex : 選択されたアイテムのインデックスです。 - columnIndex : 選択された列のインデックスです。 - oldValue : セルの以前の値です。 - target : イベントをトリガしたコンポーネントへの参照です。 - type : イベントの名前 cellEdit です。 |
cellFocusIn | 特定のセルがフォーカスを受け取ったときにブロードキャストします。これは、ユーザーがセルをクリックした場合や、キーボードで特定のセルへと移動した場合に発生します。このイベントオブジェクトには、次のプロパティが含まれます。 - itemIndex : 選択されたアイテムのインデックスです。 - columnIndex : 選択された列のインデックスです。 - target : イベントをトリガしたコンポーネントへの参照です。 - type : イベントの名前 cellFocusIn です。 |
cellFocusOut | 特定のセルがフォーカスを失ったときにブロードキャストします。これは、ユーザーが別のセルをクリックした場合や、キーボードで別のセルやグリッドの外へと移動した場合に発生します。このイベントオブジェクトには、次のプロパティが含まれます。 - itemIndex : 選択されたアイテムのインデックスです。 - columnIndex : 選択された列のインデックスです。 - target : イベントをトリガしたコンポーネントへの参照です。 - type : イベントの名前 cellFocusOut です。 |
cellPress | ユーザーがセルをクリックし、そのセルを編集することを示したときにブロードキャストします。セルまたは列が編集可能の場合にのみブロードキャストします。このイベントオブジェクトには、次のプロパティが含まれます。 - itemIndex : 選択されたアイテムのインデックスです。 - columnIndex : 選択された列のインデックスです。 - view : 現在選択されているオブジェクトです。 - target : イベントをトリガしたコンポーネントへの参照です。 - type : イベントの名前 cellPress です。 |
change | ユーザーがツリーのアイテムを選択したときにブロードキャストします。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 change が設定されます。 |
nodeClose | ブランチが閉じられた (畳まれた) ときにブロードキャストします。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 nodeClose が設定されます。イベントオブジェクトの node プロパティには、閉じられたノードを表すオブジェクトが含まれます。XML データから Tree を設定する場合は、ノードの label プロパティおよび data プロパティには次のようにアクセスします。 eventobj.node.attributes.label eventobj.node.attributes.data TreeDataProvider API を使用して、プログラムにより Tree データプロバイダにアイテムを追加する場合、label プロパティおよび data プロパティには次のようにアクセスします。 eventobj.node.getData() |
nodeOpen | ブランチが開かれた (展開された) ときにブロードキャストします。イベントオブジェクトの target プロパティには、このイベントをトリガしたコンポーネントへの参照が設定されます。イベントオブジェクトの type プロパティには、イベント名 nodeOpen が設定されます。イベントオブジェクトの node プロパティには、開かれたノードを表すオブジェクトが含まれます。XML データから Tree を設定する場合は、ノードの label プロパティおよび data プロパティには次のようにアクセスします。 eventobj.node.attributes.label eventobj.node.attributes.data TreeDataProvider API を使用して、プログラムにより Tree データプロバイダにアイテムを追加する場合、label プロパティおよび data プロパティには次のようにアクセスします。 eventobj.node.getData() |
| mx.controls.listclasses.ScrollSelectList クラスから継承されるイベント |
change itemRollOut itemRollOver |
| mx.core.ScrollView クラスから継承されるイベント |
scroll |
| mx.core.View クラスから継承されるイベント |
childCreated childDestroyed childIndexChanged |
| mx.core.UIComponent クラスから継承されるイベント |
focusIn focusOut invalid keyDown keyUp valid valueCommitted |
| スタイル | |
alternatingRowColors | 型 : Array CSS の継承 : あり切り替えパターンで行を表示する場合に使用する色です。値には、複数の色の配列を指定します。これは、backgroundColor が指定されていない場合にのみ使用します。 |
defaultLeafIcon | 型 : String 形式 : EmbeddedFile CSS の継承 : なしリーフノードのデフォルトのアイコンを指定します。MXML では、次のシンタックスを使用してこのプロパティを設定できます。defaultLeafIcon="@Embed('c.jpg');" |
depthColors | 型 : Array CSS の継承 : ありTree コントロールで使用されるカラーの配列です (降順)。 |
folderClosedIcon | 型 : String 形式 : EmbeddedFile CSS の継承 : なしツリーのブランチノードで使用する、フォルダが閉じた状態のアイコンを指定します。MXML では、次のシンタックスを使用してこのプロパティを設定できます。folderClosedIcon="@Embed('b.jpg');" |
folderOpenIcon | 型 : String 形式 : EmbeddedFile CSS の継承 : なしツリーのブランチノードで使用する、フォルダが開いた状態のアイコンを指定します。MXML では、次のシンタックスを使用してこのプロパティを設定できます。folderOpenIcon="@Embed('a.jpg');" |
indentation | 型 : Number CSS の継承 : なしツリーの各レベルのインデントです (ピクセル単位)。デフォルト値は 8 です。 |
openDuration | 型 : Number 形式 : Time CSS の継承 : なし開いた状態や閉じた状態へのトランジションにかかる時間の長さです (ミリ秒単位)。デフォルト値は 250 です。 |
openEasing | 型 : String 形式 : Time CSS の継承 : なしコンポーネントトゥイーンを制御するためのイージング関数です。 |
rollOverColor | 型 : Number 形式 : Color CSS の継承 : ありマウスポインタが置かれているときのリンクの背景色です。デフォルト値は 0xE3FFD6 です。 |
selectionColor | 型 : Number 形式 : Color CSS の継承 : ありユーザーがリンクを選択したときのリンクの背景色です。デフォルト値は 0xCDFFC1 です。 |
| mx.core.UIObject クラスから継承されるスタイル |
color fontFamily fontSize fontStyle fontWeight horizontalGap leading marginLeft marginRight textAlign textDecoration textIndent verticalGap |
| メソッドの詳細 |
addTreeNode( labelOrNode, data)
パラメータ
labelOrNode - 作成するノードのラベル、またはノードとしてラップするオブジェクトを表します。ストリングを渡すと、新しいノードの label プロパティにそのストリングが割り当てられます。メモ : Tree の labelField を label 以外のプロパティに設定した場合は、正しい値を使用してこのノードで setProperty を呼び出す必要があります。呼び出さない場合、labelOrNode 引数がコピーされません。Object を渡すと、オブジェクトであるプロパティ (ストリング、数値、ブール値ではないプロパティ) はすべて子として表示されます。このパラメータは必須です。
data - 追加するデータです。このデータには getData() を使用していつでもアクセスできます。このパラメータはオプションです。
戻り値
新規ノードです。
addTreeNodeAt( index, labelOrNode, data)
パラメータ
index - ノードの位置です。インデックス 0 が最上位ノードを表します。
labelOrNode - 作成するノードのラベル、またはノードとしてラップするオブジェクトを表します。ストリングを渡すと、新しいノードの label プロパティにそのストリングが割り当てられます。メモ : Tree の labelField を label 以外のプロパティに設定した場合は、正しい値を使用してこのノードで setProperty を呼び出す必要があります。呼び出さない場合、labelOrNode 引数がコピーされません。Object を渡すと、オブジェクトであるプロパティ (ストリング、数値、ブール値ではないプロパティ) はすべて子として表示されます。このパラメータは必須です。
data - 追加するデータです。このデータには getData() を使用していつでもアクセスできます。このパラメータはオプションです。
戻り値
新規ノードです。
calculateWidths( count)
calculateWidth(count)
パラメータ
count - 測定するノードの数です。
getDisplayIndex( node)
パラメータ
node - 調べるノードです。
戻り値
ツリーの表示リストのインデックスです。
getDropParent( )
: Object
getDropParent().addTreeNodeAt(getDropLocation(), myNode);
getIsBranch( node)
パラメータ
node - 調べるノードです。
戻り値
ブランチの場合は true、そうでない場合は false です。
getIsOpen( node)
パラメータ
node - 調べるノードです。
戻り値
開いている場合は true、そうでない場合は false です。
getNodeDisplayedAt( index)
パラメータ
index - ツリー内に表示されるノードの行位置です。
戻り値
ノードです。
getTreeNodeAt( index)
パラメータ
index - ノードの位置です。インデックス 0 が最上位ノードを表します。
戻り値
ノードです。
removeAll( )
removeTreeNodeAt( index)
パラメータ
index - ノードの位置です。インデックス 0 が最上位ノードを表します。
戻り値
ノードです。
setIcon( node, iconID, iconID2)
パラメータ
node - 設定の対象とするノードです。
iconID - 閉じた状態のアイコン (またはリーフのアイコン) のリンケージ識別子です。
iconID2 - 開いた状態のアイコン (またはリーフのアイコン) のリンケージ識別子です。
setIsBranch( node, branch)
パラメータ
node - 設定の対象とするノードです。
branch - ブランチの場合は true、そうでない場合は falseです。
setIsOpen( node, open, animate, fireEvent)
パラメータ
node - 設定の対象とするノードです。
open - 開く場合は true、閉じる場合は false です。
animate - トランジションをアニメーション化する場合は true、そうでない場合は false です。
fireEvent - 開くアニメーションの終了後に、開くイベントを発行するかどうかを制御します。
| プロパティの詳細 |
cellEditor:MovieClip
dataProvider:Object
firstVisibleNode:var
focusedCell:Object
maxHPosition:Number
selectedNode:var
selectedNodes:Array
static version:String
| 例 |
| TreeExample.mxml |
|