リファレンスで 初期化 と言っているのでそのままタイトルにしたが
要は インスタンス化 。

[as3]var myXML:XML =











;[/as3] 　

XML 文字列から生成する手法

[as3]var myString:String =











;
var myXML:XML = new XML(myString);[/as3] 　

変数から生成する手法

こんなこともできるんだねぇ。
ちょっと驚いた。 😆

[as3]var tagname:String = “item”;
var attributename:String = “id”;
var attributevalue:String = “5”;
var content:String = “Chicken”;
var x:XML = <{tagname} {attributename}={attributevalue}>{content};
trace(x.toXMLString())

// Output: Chicken[/as3] 　

外部ファイルを読み込む手法

　
Flash 用 ActionScript 3.0 のプログラミング：XML 変数の初期化

Tree コンポーネントの各ノードの外観や昨日を変更するには
Tree コンポーネントの itemRenderer プロパティを用いる。

itemRenderer は、Tree コンポーネントの全体ではなく
ノード１つ分、つまり１行分を設定するようなシステムである。

この、ノード１つ分を決めてやることで、各ノードにその設定が反映され
独自の Tree コンポーネントが出来上がる。
　

MXML エディタに上記のように打ち込むと、itemRenderer の作成サポートが表示される。
　
これを選択すると左のようなダイアログが表示される。

パッケージ は、参照からフォルダを辿ってもよいし、
自ら入力すればフォルダが存在しない場合はフォルダを自動生成してくれる。

終了 をクリックすれば、以下のような MXML ファイルが自動生成される。

[mxml]

[/mxml]

これを見るとデフォルトの itemRenderer が分かる。

ステート

normal、hovered（マウスオーバー時）、selected（クリック時） の３つのステートがある。
　

itemEditor

itemRenderer に搭載される各コンポーネントのことを itemEditor という。

Tree コンポーネントの itemEditor は５つ（？）。
getChildAt(0)：インデント用の Rect
getChildAt(1)：disclosureIcon 用の Group
getChildAt(2)：disclosureIcon 用の BitmapImage
getChildAt(3)：icon 用の BitmapImage
getChildAt(4)：Label
上記５つのうち、3 の icon 用の BitmapImage 以外は、確かめていないので怪しい。

いずれにせよ、ここに CheckBox なり RadioButton なり配置すれば、表示することができる。

データバインディング
また、バインドされているデータのところを見ると {treeListData.indent} のようになっている。

ここから見て、indent, icon, label は予め設定してあるようでこのまま使えるようだ。
Tree コンポーネントの iconField プロパティや lableField プロパティに XML データの属性を設定した結果、そのまま使えた。

しかしそれ以外の属性データを使いたい場合は
{treeListData.@hoge} ではなく {data.@hoge} としてやることで読み込んでくれた。

課題
ただ、残念ながら icon は上手くいかなかった。
固定アイコンは問題なかったのだが、@icon 属性に表示したい icon へのパスをセットし
source=”{treeListData.disclosureIcon}”
や
source=”@Embed source='{treeListData.disclosureIcon}'”
こんな風にしてみても反映されなかった。
　

AS で作成する手法

アシアルブログ：【Flex3】「Flex3の、こんなときどうするの？？」
ここの６番。　6. ツリーに文字列以外のものを表示したい
これを参考にさせていただいた。
[mxml]



).node; ]]>

[/mxml]

TreeItemRenderer クラスを継承したクラスを新たに作成する。
[as3onfx4]package components
{
import mx.binding.utils.BindingUtils;
import mx.controls.CheckBox;
import mx.controls.treeClasses.TreeItemRenderer;
import mx.controls.treeClasses.TreeListData;

public class Hoge extends TreeItemRenderer
{
[Bindable] public var checkBox:CheckBox;

public function Hoge()
{
super();
}

override public function set data(value:Object):void {
super.data = value;
}

override protected function createChildren():void{
super.createChildren();

checkBox = new CheckBox();
checkBox.setStyle(“verticalAlign”,”middle”);
BindingUtils.bindSetter(setSelected, checkBox, ‘selected’);
this.addChild(checkBox);
}

override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void {
var treeListData:TreeListData = TreeListData(super.listData);

super.updateDisplayList(unscaledWidth,unscaledHeight);

if(super.data)
{
if (data.@selected.toString() == ‘true’)
{
checkBox.selected = true;
}
else
{
checkBox.selected = false;
}

checkBox.x = super.label.x;
checkBox.y = ( unscaledHeight – checkBox.height ) /2;
label.x = checkBox.x + checkBox.width + 20;
}
}

private function setSelected(selected:Boolean):void
{
if (data)
{
data.@selected = selected.toString();
}
}
}
}[/as3onfx4]

別途、こんな例も見つけた。
FXUG：Re: Treeのアイコンを動的に変更したい
[as3onfx4] import flash.display.DisplayObject;

import mx.collections.*;
import mx.controls.Image;
import mx.controls.treeClasses.*;

public class TreeItemRendererEx extends TreeItemRenderer {
private var img:Image = new Image();

public function TreeItemRendererEx() {
super();
this.addChild(this.img as DisplayObject);
}

override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void {
super.updateDisplayList(unscaledWidth, unscaledHeight);

if(data!=null) {
this.label.x += 5;
this.img.x = this.getChildAt(3).x;
this.img.y = this.getChildAt(3).y – 5;
this.img.width = 24;
this.img.height = 24;

this.img.source = data.iconPath;

this.getChildAt(3).visible = false;
}
}
}
[/as3onfx4] この方法だと、上記 MXML による itemRenderer の実装時に問題となった
全ノード異なるアイコンを表示する　という作業も上手くいった。

しかしこちらの方法だと Label を二段にする　という作業は上手くできなかった。

Tree コンポーネントの各ノードの開閉を制御したい。

expandItem() メソッドを用いることで実現できる。

開く場合は、第２引数を true に、閉じる場合は、第２引数を false に。

　
[as3onfx4]public function expandItem(
item:Object,
open:Boolean,
animate:Boolean = false,
dispatchEvent:Boolean = false,
cause:Event = null
):void[/as3onfx4]

Adobe® Flex® 4.1 リファレンスガイド：Tree expandItem() メソッド
　

今のところ、XMLListCollection の方法しかわからない。

しかも、場所を自由に選ぶ方法がわからない。

詳細は、以下の 特定のノードの開閉 を参照。
　

今のところ、起動時に固定フォルダを開く方法しか試していない。
　

[as3onfx4]var myXML:XML = new XML(event.result);
myTree.dataProvider = new XMLListCollection( new XMLList(myXML) );

myTree.validateNow();
treeFavorit.expandItem(myXML.children()[0], true, true);[/as3onfx4]

これはルートを表示しない方式の Tree で、１番目のフォルダをデフォルトで開いた状態にしている。

４行目に関しては

dataProvider を設定し、その直後に expandItem() を呼び出した場合は、不適切な動作が起こる可能性があります。
コンポーネントが検証されるまで待つか、validateNow() を呼び出します。

リファレンスのこの指示に従ったまでである。
　

Tree コンポーネントには、indexToItemRenderer() メソッドというものがあり
インデックスから当該アイテムレンダラを取得できる。

ただこのインデックスは曲者で、現在の状態で上から何番目 というものらしく
ノードの開閉状態によって コロコロ変化する ようだ。

さりながら、メインフォルダであればルートを表示していれば 1 。
ルートを表示してなければ 0 になる。

これを利用して以下のようにすることで、メインフォルダに関してだけは成功した。
[as3onfx4]var myXML:XML = new XML(event.result);
myTree.dataProvider = new XMLListCollection( new XMLList(myXML) );

myTree.validateNow();
var renderer:IListItemRenderer = myTree.indexToItemRenderer(0);
if (renderer)
{
var myXML:XML = renderer.data as XML;
myTree.expandItem(myXML, true);
}[/as3onfx4]

Flash Builder 4 -> コレクションオブジェクト
ここでも触れたが、FB4 には XML 系オブジェクトとして３種類存在する。
XML オブジェクト、XMLList オブジェクト、XMLListCollection オブジェクト

それぞれの意義自体もまだよく分かってないが
それに纏わるプロパティ、メソッドとなると尚更だ。

そこで、気が付く毎に何となく列挙していくことにした。

length プロパティは存在する。
[as3onfx4]XML.length[/as3onfx4] これは、当然の如く必ず 1 が戻り値。
なぜって？　XML オブジェクトとは、ルートが１つのものだから。
　

子供の数を知りたければ
[as3onfx4]XML.children().length()[/as3onfx4] このように children() と length() メソッド を用いる。

特定の子供の数を知りたければ
[as3onfx4]XML.child(“hoge”).length()[/as3onfx4] このように child() メソッド と length() メソッド を用いる。

また、child() メソッドにはワイルドカードが使えるようで
[as3onfx4]XML.child(“*”).length()[/as3onfx4] これで全ての子の数が拾えるようだ。
　

XMLList オブジェクトには、length プロパティは 存在しない ようだ。
　

[as3onfx4]XMLList.length()[/as3onfx4] これは、XMLList のプロパティの数が戻り値。
　

[読み取り専用] このビュー内のアイテムの数です。

意味不明・・・。
　

XMLListCollection オブジェクトには、length() メソッドは 存在しない ようだ。
　
　
実際に動かしてみないとよくわからないね。
暇を見てチャレンジしてみることにしよう。
　
Adobe® Flex® 4.1 リファレンスガイド
XML、XMLList、XMLListCollection

Flash 用 ActionScript 3.0 のプログラミング：XML の操作

D&D によって変更されたフォルダ構成を DB へ反映させるためには
ドラッグしたアイテムとドロップ先アイテムの情報を取得しなければならない。

幸い、よい参考サイトが見つかった。
FXUG：ドラッグ＆ドロップ（treeからpanel）
Re: Treeのアイテム移動の制御

まずはドラッグしているアイテム（ノード）の情報について。

これはとても単純。
しかし、上記参考サイトにも載っているが、以下のようにするとエラーが出る。
[as3onfx4]var dragInitiatorData:Object = event.dragSource.dataForFormat(‘treeItems’);
Alert.show(dragInitiatorData.@label);[/as3onfx4]

これは、変数 data が単純な Object 型 だと思っていたら Array 型 だったという罠。

そういうわけなので、下記のようにするのが正解。
[as3onfx4]var dragInitiatorData:Object = event.dragSource.dataForFormat(‘treeItems’);
Alert.show(dragInitiatorData[0].@label);[/as3onfx4]

また、これも上記サイトに書いてあるが、複数行選択を許可した場合はまだ工夫が必要なようだ。
　

これも 前回 同様、上記参考サイトのコードをそのままいただいた。
[as3onfx4]var tree:Tree = event.currentTarget as Tree;
var n:int = tree.calculateDropIndex(event);
var dropTargetRenderer:IListItemRenderer = tree.indexToItemRenderer(n);
if (dropTargetRenderer)
{
// ドロップ先のXML情報
var targetXML:XML = dropTargetRenderer.data as XML;
// ドロップ先の親のXML情報
var parentXML:XML = targetXML.parent();
// ドロップ先の親の子供情報
var childrenXMLList:XMLList = parentXML.children();
}[/as3onfx4]

　

ところが、この方法だと、私がやりたいことの場合は曖昧であることがわかった。

このような Tree コンポーネントがあるとする。

Folder 3 を Folder 12 と Folder 2 の間に入れる場合は、以下の２パターン存在する。
傍線の長さに注目。

そして、それぞれの結果はこうなる。

この場合、上記の手法、即ち calculateDropIndex を利用する手法だと、
共に 3 を得ることになる。

calculateDropIndex とは、現時点で開いている、
つまり 見えている状態で上から何番目 という判断をするらしく
全体の中での 正確な情報ではない 上に、パターン１とパターン２の 区別がつかない 。

そこで他を当たっていたら以下を見つけた。
FXUG：DataGridからTreeへのドラッグアンドドロップ時のドロップ先情報について

ここに載っている mx_internal::_dropData というのを用いると
[as3onfx4]var dropTargetData:Object = tree.mx_internal::_dropData;
// ドロップ先の親のXML情報
var parentXML:XML = dropTargetData.parent as XML;[/as3onfx4] パターン１では root を親とし
パターン２では Folder 2 を親としてくれた。

ホッとしながらも、mx_internal についてグーグル先生に聞いてみると
DROP.FACTORY：［＠Flex]プロパティやメソッドの可視性

「mx_internal」は過去の遺物らしいです。
使用には十分注意しましょう、とゆーことか。

ということらしい。

確かに Adobe® Flex® 4.1 リファレンスガイド の索引には見当たらない・・・。

ん～、それでは正しい情報はどこからもらえるんだろう・・・。

また、こちらのサイトの他、あちこちのサイトに書いてある
[as3onfx4]import mx.core.mx_internal;
use namespace mx_internal;[/as3onfx4] こちらの２行は、私の環境では書かなくても利用可能であった。

Tree コンポーネントを触っていて
Windows エクスプローラ ライクに D&D をしたくなる。

Tree コンポーネントの場合、D&D だけなら簡単だ。

[mxml][/mxml] 上記の如く、dragEnabled と dropEnabled プロパティを true に設定すればいい。

dragMoveEnabled プロパティに関しては、Tree コンポーネントの場合はデフォルトで true なので、
設定の必要はない。
　

個々に設定

ところが、１つの Tree コンポーネントの中で、
ドラッグ禁止やらドロップ禁止を個々に設けたい場合がある。

その際は、Tree コンポーネントのイベントを利用する。

Flash Builder -> Tree with Spring Loaded Folders
で、よいサンプルを見つけたものの、Flex 2 用で上手く動かなかったので
これを見つつ、以下を大いに参考にして、カーソル変更も付加した結果がこれだ。
FXUG：Re: Treeのアイテム移動の制御
[mxml][/mxml]

上記のように、目的別にイベントを設定し、
そのイベント内容を関数にすることで、目的の処理をする。
[as3onfx4]import mx.controls.listClasses.IListItemRenderer;
import mx.events.DragEvent;

import net.lifebird.ui.cursor.*;
import net.lifebird.ui.cursor.plugins.*;

// D&D 処理が完全に終了した時点
private function myTree_dragCompleteHandler(event:DragEvent):void
{
Cursors.cursor(CursorType.DEFAULT);
}

// ドロップした時点
private function myTree_dragDropHandler(event:DragEvent):void
{
Cursors.cursor(CursorType.DEFAULT);

if (!isDropEnabled(event))
event.preventDefault();
}

// Tree コンポーネントより外へマウスが出た時点
private function myTree_dragExitHandler(event:DragEvent):void
{
Cursors.cursor(CursorType.REJECT);
}

// Tree コンポーネント内でドラッグされている間
private function myTree_dragOverHandler(event:DragEvent):void
{
if (!isDropEnabled(event)) {
var tree:Tree = event.currentTarget as Tree;
tree.hideDropFeedback(event);
event.preventDefault();
Cursors.cursor(CursorType.REJECT);
}
else {
Cursors.cursor(CursorType.DEFAULT);
}
}

// ドラッグ開始時点
private function myTree_dragStartHandler(event:DragEvent):void
{
if (!isDragEnabled(event))
event.preventDefault();

Cursors.cursor(CursorType.DEFAULT);
}

// マウスカーソルが乗ったアイテムのドラッグ可否関数
private function isDragEnabled(event:DragEvent):Boolean
{
var tree:Tree = event.currentTarget as Tree;
var n:int = tree.calculateDropIndex(event);
var renderer:IListItemRenderer = tree.indexToItemRenderer(n);
if (renderer)
{
var xml:XML = renderer.data as XML;
if (xml.@acceptDrag == “false”)
return false;
}
return true;
}

// マウスカーソルが乗ったアイテムのドロップ可否関数
private function isDropEnabled(event:DragEvent):Boolean
{
var tree:Tree = event.currentTarget as Tree;
var n:int = tree.calculateDropIndex(event);
var renderer:IListItemRenderer = tree.indexToItemRenderer(n);
if (renderer)
{
var xml:XML = renderer.data as XML;
if (xml.@acceptDrop == “false”)
return false;
}
return true;
}[/as3onfx4]

This movie requires Flash Player 9.0.0

カーソルの変更については以下を参照。
Flash Builder 4 -> net.lifebird.ui.cursor

ActionScript 3.0 言語およびコンポーネントリファレンス：Array

push() メソッド を用いる。
[as3]var myArray:Array = new Array(“Jun”, “Feb”, “Mar”);
myArray.pushu(“Apr”, “May”);[/as3]

ActionScript 3.0 言語およびコンポーネントリファレンス：push() メソッド
　

indexOf() メソッドを用いる。
[as3]var myArray:Array = new Array(“Jun”, “Feb”, “Mar”);
var myIndex:int = myArray.indexOf(“Mar”);
trace(myIndex);

// 2[/as3]

ActionScript 3.0 言語およびコンポーネントリファレンス：indexOf() メソッド

丸っきりの書きかけ項目は Not found になる。

1. データ型

1. ***
2. Tips
1. 関数パラメータ
2. 配列操作
3. 文字列操作
1. 文字列の検索・置換
2. 正規表現

1. ***
1. XML（XMLList）
1. E4X
2. 初期化（インスタンス化）
3. XML の操作
2. Tips

1. Tips
1. ActionScript と PHP の連携

ActionScript 3.0 言語およびコンポーネントリファレンス

参考サイト

その他各参考サイトについては、各エントリーにて。

+ 演算子を用いる。
[as3]var myString1:String = “アカサ”;
var myString2:String = “カサカス”;
var myString:String = myString1 + myString2;
trace(myString);

// アカサカサカス

var myInt:int = 3;
myString = myString1 + myInt;
trace(myString);

// アカサ3
[/as3]

文字列と数字を結合すると文字列 になる。

split メソッドを用いる。

AS3 function split(delimiter:*, limit:Number = 0x7fffffff):Array

ランタイムバージョン: AIR 1.0 Flash Player 9

指定された delimiter パラメータがある各位置で String オブジェクトをサブストリングの配列に分割します。

ActionScript 3.0 言語およびコンポーネントリファレンス：split() メソッド

　

indexOf メソッドは、検索文字列が最初に現れるインデックスを返す。
大文字と小文字が区別される 。
[as3]var str:String = “The moon, the stars, the sea, the land”;
trace(str.indexOf(“the”)); // output: 10[/as3]

第２引数には、開始位置を。
　

lastIndexOf メソッドは、検索文字列が最後に現れるインデックスを返す。
第２引数には、開始位置を。
先頭に向かって検索する。

Flash 用 ActionScript 3.0 のプログラミング：一致するサブストリングの文字の位置の検索
　

先頭の文字 は ０番目（０文字目） であることに注意。

charAt は、１文字 抽出。

AS3 function charAt(index:Number = 0):String

ランタイムバージョン: AIR 1.0 Flash Player 9

index パラメータで指定された位置にある文字を返します。 index に指定された値が 0 ～ string.length – 1 の範囲外にある場合は、空のストリングを返します。

このメソッドは String.charCodeAt() に似ていますが、16 ビット整数の文字コードではなく文字が返される点が異なります。

ActionScript 3.0 言語およびコンポーネントリファレンス：charAt() メソッド

[as3]var str:String = “Hello! World.”;
trace( str.charAt(7) );

// W[/as3] 　

substr は、開始位置から長さ で抽出。

AS3 function substr(startIndex:Number = 0, len:Number = 0x7fffffff):String

ランタイムバージョン: AIR 1.0 Flash Player 9

startIndex で指定された位置から len で指定された長さの文字を含むサブストリングを返します。
元のストリングは変更されません。

ActionScript 3.0 言語およびコンポーネントリファレンス：substr() メソッド

[as3]var str:String = “Hello! World.”;
trace( str.substr(3, 2) );

// lo[/as3] 　

substring は、開始位置 と 終了位置 で抽出。

AS3 function substring(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String

ランタイムバージョン: AIR 1.0 Flash Player 9

startIndex で指定された位置から endIndex – 1 までにあるすべての文字を含むストリングを返します。
endIndex が指定されていない場合、String.length が使用されます。
startIndex の値が endIndex の値と等しい場合、空のストリングが返されます。
startIndex の値が endIndex の値より大きい場合、関数を実行する前にパラメータが自動的に入れ替わります。
元のストリングは変更されません。

ActionScript 3.0 言語およびコンポーネントリファレンス：substring() メソッド

[as3]var str:String = “Hello! World.”;
trace( str.substring(3, 5) );
trace( str.substring(3) );

// lo
// lo! World.[/as3]

第２引数 endIndex は入らない ことに注意。
つまり、endIndex – startIndex 文字抽出される。

endIndex を省略すれば、startIndex より後ろ全部が抽出される。
　

length プロパティを用いる。
[as3]var str:String = “Hello! World.”;
trace(str.length);

// 13[/as3]

0 文字目の H から 12 文字目の . までの 13 文字。

ActionScript 3.0 言語およびコンポーネントリファレンス：length プロパティ

StringUtil クラスは文字列のユーティリティらしい。

使用の際はインスタンス化の必要がない代わりに、StringUtil と一体で用いる 。

Adobe® Flex® 4.1 リファレンスガイド：StringUtil

trim メソッドは、文字列の前後のスペースを全て削除するもの。

[as3onfx4]import mx.utils.StringUtil;

myString = StringUtil.trim(myString);[/as3onfx4]

しか～し！　この trim メソッドは 全角スペースには無効 。

なので、一旦全てのスペースを半角に変換してから trim ！
[as3onfx4]var pattern:RegExp = /\u3000/g;
myString = myString.replace(pattern, ” “);
myString = StringUtil.trim(myString);[/as3onfx4]

文字列の途中の全角スペースはそのまま残したい。
なんていう場合は・・・そのときがきたら考えようっと。 😎
　
＜参考元＞
PHP,MySQL,Flexな日々＋イラストとか：Flex(ActionScript3.0)でのtrim