ツリー表示コンポーネントリファレンス

ツリー表示コンポーネントで表示するツリー全体を表す要素です。

属性：

width

ツリー表示コンポーネントの幅を設定する属性です。ピクセル単位かパーセント単位の正の数値で記述します。

省略された場合、値は設定されていないものとみなされます。幅はツリーの状態によって変化します。

height

ツリー表示コンポーネントの高さを設定する属性です。ピクセル単位かパーセント単位の正の数値で記述します。

省略された場合、値は設定されていないものとみなされます。高さはツリーの状態によって変化します。

default-expanded-icon

子ノードを持つノードでサブツリーが表示されているときに表示するアイコンの、デフォルトのアイコンを設定する属性です。URI参照で記述します。

Javaがサポートしている形式のアイコンファイルを使用できます。また、アイコン画像の実際の大きさにかかわらず、縦横ともに16ピクセルで表示されます。

省略された場合、アイコンは設定されていないものと見なされます。

default-collapsed-icon

子ノードを持つノードでサブツリーが表示されていないときに表示するアイコンの、デフォルトのアイコンを設定する属性です。URI参照で記述します。

Javaがサポートしている形式のアイコンファイルを使用できます。また、アイコン画像の実際の大きさにかかわらず、縦横ともに16ピクセルで表示されます。

省略された場合、アイコンは設定されていないものと見なされます。

default-leaf-icon

子ノードを持たないノードに表示するアイコンの、デフォルトのアイコンを設定する属性です。URI参照で記述します。

Javaがサポートしている形式のアイコンファイルを使用できます。また、アイコン画像の実際の大きさにかかわらず、縦横ともに16ピクセルで表示されます。

省略された場合、アイコンは設定されていないものと見なされます。

show-line

各ノードを結ぶ線を表示するかしないかを設定する属性です。真偽値で記述します。trueを指定すると、ノードを結ぶ線が表示されます。falseを指定すると、ノードを結ぶ線は表示されません。

省略された場合、trueが設定されたものと見なされます。

expand-enabled

サブツリーを表示するかしないかを切り替える展開アイコンを、最上位のノードに表示するかしないかを設定する属性です。真偽値で記述します。trueを指定すると、展開アイコンが表示されます。falseを指定すると、展開アイコンは表示されません。

省略された場合、trueが設定されたものと見なされます。

font-size

ノードのラベルを表示するときに使用するフォントのサイズを設定する属性です。ポイント値で記述します。

省略された場合、12ポイントで描画されます。

readonly

ノードのラベルをその場で編集する、インライン編集機能を無効にするかしないかを設定する属性です。真偽値で記述します。trueを指定すると、インライン編集を無効にします。falseを指定すると、インライン編集を有効にします。

省略された場合、trueが設定されたものと見なされます。

内容：

tree:tree要素内には以下の要素を記述します。

• tree:node要素
  必要に応じて、任意の数だけ記述できます。省略可能です。

ツリーを構成するノードを表現するために使用する要素です。

属性：

label

ノードのラベルを設定する属性です。任意の文字列で記述します。

省略された場合、"???"と表示されます。

expanded-icon

子ノードを持つノードでサブツリーが表示されているときに表示するアイコンを設定する属性です。URI参照で記述します。

Javaがサポートしている形式のアイコンファイルを使用できます。また、アイコン画像の実際の大きさにかかわらず、縦横ともに16ピクセルで表示されます。

省略された場合、値は設定されていないものと見なされます。この場合、デフォルトのアイコンが設定されていれば、そのアイコンが表示されます。設定されていなければ、アイコンは表示されません。

collapsed-icon

子ノードを持つノードでサブツリーが表示されていないときに表示するアイコンを設定する属性です。URI参照で記述します。

Javaがサポートしている形式のアイコンファイルを使用できます。また、アイコン画像の実際の大きさにかかわらず、縦横ともに16ピクセルで表示されます。

省略された場合、値は設定されていないものと見なされます。この場合、デフォルトのアイコンが設定されていれば、そのアイコンが表示されます。設定されていなければ、アイコンは表示されません。

leaf-icon

子ノードを持たないノードに表示するアイコンを設定する属性です。URI参照で記述します。

Javaがサポートしている形式のアイコンファイルを使用できます。また、アイコン画像の実際の大きさにかかわらず、縦横ともに16ピクセルで表示されます。

省略された場合、値は設定されていないものと見なされます。この場合、デフォルトのアイコンが設定されていれば、そのアイコンが表示されます。設定されていなければ、アイコンは表示されません。

color

ラベルの文字色を設定する属性です。次の形式で指定します。

• CSSで使用されるキーワード色
• 16進数（#rrggbbまたは#rgb）

省略された場合、値は設定されていないものと見なされ、xfyユーザーエージェントで設定されている標準の文字色が使用されます。

background-color

ラベルが描画される領域の背景色を設定する属性です。次の形式で指定します。

• CSSで使用されるキーワード色
• 16進数（#rrggbbまたは#rgb）

省略された場合、値は設定されていないものと見なされ、背景には何も描画されません。

font-weight

ラベルの文字の太さを設定する属性です。CSSのfont-weightプロパティに指定する値のうち、次の値を使用できます。

• 100から900までの100間隔の数値。
• normal
• bold

省略された場合、normalが設定されたものと見なされます。

内容：

tree:node要素内には以下の要素を記述します。

• tree:node要素
  必要に応じて、任意の数だけ記述できます。省略可能です。
  このノードの子ノードと見なされます。

ノードがユーザーに選択されたときに、選択されたノードへ発行されるイベント要素です。

属性：

属性はありません。

内容：

tree:selected要素は、空要素です。

ノードのサブツリーが表示されるときに、表示されるノードへ発行されるイベント要素です。このイベントが処理された場合、ツリーのデフォルトの動作は実行されません。

属性：

属性はありません。

内容：

tree:expanding要素は、空要素です。

ノードのサブツリーが非表示にされるときに、非表示にされるノードへ発行されるイベント要素です。このイベントが処理された場合、ツリーのデフォルトの動作は実行されません。

属性：

属性はありません。

内容：

tree:collapsing要素は、空要素です。

ノードのラベルをインライン編集するモードへ移行するときに、編集対象のノードへ発行されるイベント要素です。このイベントが処理された場合、ツリーのデフォルトの動作は実行されません。

属性：

trigger （必須）

インライン編集するモードへ移行するきっかけとなったユーザー操作が設定される属性です。文字列で記述されます。次の値で設定されます。

F2

F2キーが押されてインライン編集モードへ移行するときに設定されます。

clicked

ノードのラベルがクリックされてインライン編集モードへ移行するときに設定されます。

内容：

tree:entering-editing要素は空要素です。

ノードのラベルをインライン編集するモードを終了した後に、編集対象だったノードへ発行されるイベント要素です。インライン編集の結果を反映する場合は、このイベントを受け取って適切に処理する必要があります。

属性：

trigger （必須）

インライン編集するモードを終了するきっかけとなったユーザー操作が設定される属性です。文字列で記述されます。次の値で設定されます。

ENTER

Enterキーが押されてインライン編集モードを終了したときに設定されます。

ESCAPE

Escキーが押されてインライン編集モードを終了したときに設定されます。

focus-lost

入力フォーカスを失ったためにインライン編集モードを終了したときに設定されます。

new-label （必須）

インライン編集で確定された値が設定される属性です。文字列で記述されます。

内容：

tree:exited-editing要素は、空要素です。

指定したノードに子ノードがあるときに、ノードのサブツリーを非表示にするコマンドです。サブツリーが非表示の場合は、何もしません。

一連の処理中にこのコマンドを複数回呼び出す場合は、 instruction:callコマンドインストラクションではなく、 instruction:postコマンドインストラクションを使用する必要があります。一連の処理中で１回だけ呼び出す場合は、instruction:callコマンドインストラクションを使用できます。

パラメータ：

node-set select

サブツリーを非表示にするノードを指定します。

指定したノードに子ノードがあるときに、ノードのサブツリーを表示するコマンドです。サブツリーが表示されている場合は、何もしません。

一連の処理中にこのコマンドを複数回呼び出す場合は、 instruction:callコマンドインストラクションではなく、 instruction:postコマンドインストラクションを使用する必要があります。一連の処理中で１回だけ呼び出す場合は、instruction:callコマンドインストラクションを使用できます。

パラメータ：

node-set select

サブツリーを表示するノードを指定します。

ノードのラベルをインライン編集するモードに移行するコマンドです。

パラメータ：

node-set select

インライン編集するノードを指定します。

string text

インライン編集を開始するときに、編集画面に設定する初期文字列を指定します。

省略された場合、ノードのラベルが初期文字列として設定されます。

number maxlength

入力できる文字列の最大の長さを指定します。正の整数値で記述します。

省略された場合、入力できる文字列の長さに制限はありません。