UIComponentクラス: oracle.adf.view.rich.component.rich.data.RichTreeTable
コンポーネントのタイプ: oracle.adf.RichTreeTable
ネーミング・コンテナ: 該当。このコンポーネントの子(partialTriggers、findComponent()
など)を参照するときは、その子のIDに接頭辞としてこのコンポーネントのIDおよびコロン(:)を設定する必要があります。サポートされていないエージェント: pda
TreeTableは、階層形式で構成されるデータを表示する場合に使用します。このコンポーネントは、表に似たUIで階層を表示するもので、Treeコンポーネントよりも複雑です。TreeTableでは、階層のツリー・ノードごとにデータ列を表示するようにサポートされています。TreeTableの機能には、(メイン・ツリー内で)サブ・ツリーをフォーカスするメカニズムや階層の要素の展開および縮小のメカニズムが含まれます。
TreeTableコンポーネントはモデルを使用し、基礎となる階層データにアクセスします。固有モデルのクラスはorg.apache.myfaces.trinidad.model.TreeModel
です。BeanのJava Listのラップまたはorg.apache.myfaces.trinidad.model.TreeModel
の実装でのマップを行うユーティリティ・クラスを使用できます(org.apache.myfaces.trinidad.model.ChildPropertyTreeModel
を参照してください)。
Table同様、TreeTableの子はColumnコンポーネントである必要があります(表の列を参照してください)。Tree同様、TreeTableには「オブジェクト名」列をレンダリングするnodeStampファセットが含まれます。「オブジェクト名」列は、階層の要素のプライマリ識別子を含みます。たとえば、従業員の組織図では、「オブジェクト名」列は従業員の名前になります。
表のヘッダーを参照してください。
表の選択を参照してください。
表のグリッド線およびバンディングを参照してください。
表の列グループを参照してください。
表のソートを参照してください。Tableとは異なり、TreeTableでは自動ソートがサポートされません。基礎となるTreeModelでは、TreeModelのsetSortCriteria(List criteria)
メソッドでソート・ロジックを実装して、ソートをサポートする必要があります。
表のフェッチ・サイズを参照してください。
表のCSSスタイル制限を参照してください。
ツリーの階層セレクタを参照してください。
<section name="Geometry_Management">
</section>
型 | フェーズ | 説明 |
---|---|---|
org.apache.myfaces.trinidad.event.RowDisclosureEvent | リクエスト値の適用、 アプリケーションの起動 |
表の拡張イベントは、行の詳細ファセットを展開または縮小すると生成されます。treeまたはtreeTableの場合は、ツリー・ノードを展開または縮小すると拡張イベントが生成されます。 |
org.apache.myfaces.trinidad.event.SelectionEvent | リクエスト値の適用、 アプリケーションの起動 |
選択イベントは、表選択が変わると配信されます。 |
org.apache.myfaces.trinidad.event.FocusEvent | リクエスト値の適用、 アプリケーションの起動 |
ユーザーが特定の要素の子サブツリーをクリックしてフォーカスする(ズーム・インする)と配信されるイベント。TreeTableは、focusPathプロパティを適切に変更して、このイベントに応答します。その後、登録されているFocusListenerインスタンスがすべて呼び出されます。 |
org.apache.myfaces.trinidad.event.AttributeChangeEvent | アプリケーションの起動、 リクエスト値の適用 |
属性変更を記述するために配信されるイベント。属性変更イベントは、プロパティに対するプログラム的な変更については配信されません。アプリケーションの特定のリクエストなしにレンダラによってプロパティが変更される場合にのみ配信されます。属性変更イベントの例には、クライアント側のサイズ変更をサポートしていた列の幅などがあります。 |
名前 | 説明 |
---|---|
bodyContextMenu | 表本体内で行以外の場所を右クリックすると表示されるコンテキスト・メニューを備えたポップアップ・コンポーネント。コンテキスト・メニューを表示するには、af:popupにaf:menuが含まれている必要があります。 |
contextMenu | 表の行を右クリックすると表示されるコンテキスト・メニューを備えたポップアップ・コンポーネント。コンテキスト・メニューを表示するには、af:popupにaf:menuが含まれている必要があります。 |
footer | 表フッターをレンダリングするのに使用されるコンポーネント。このファセットは10.1.3に存在しましたが、現在、RichTableおよびRichTreeTableではサポートされていません。 |
header | 表ヘッダーをレンダリングするのに使用されるコンポーネント。このファセットは10.1.3に存在しましたが、現在、RichTableおよびRichTreeTableではサポートされていません。 |
nodeStamp | ツリーの各要素にタイムスタンプを設定するのに使用するコンポーネント。一部のタイプのコンポーネントのみがサポートされています。動作を伴わないコンポーネントはすべてサポートされており、EditableValueHolderインタフェースまたはActionSourceインタフェースを実装するコンポーネントもほとんどがサポートされています。treeTableでは、列である必要があります。 |
pathStamp | 階層セレクタをクリックしたときにフォーカス・パスの各ステップにタイムスタンプを設定するためのコンポーネント。 |
名前 | 型 | ELのサポート | 説明 |
---|---|---|---|
attributeChangeListener | javax.el.MethodExpression | ELのみ | 属性変更リスナーへのメソッド・リファレンス。属性変更イベントは、プロパティに対するプログラム的な変更については配信されません。アプリケーションの特定のリクエストなしにレンダラによってプロパティが変更される場合にのみ配信されます。属性変更イベントの例には、クライアント側のサイズ変更をサポートしていた列の幅などがあります。 |
binding | oracle.adf.view.rich.component.<wbr/>rich.data.RichTreeTable | ELのみ | コンポーネント・インスタンスをBean上に格納するELリファレンス。これは、バッキングBeanからコンポーネントへのプログラム的なアクセスを提供するため、またはコンポーネントの作成をバッキングBeanに移動するために使用できます。 |
bodyContextMenuId | String | あり | 表本体内で行以外の場所をクリックすると表示されるコンテキスト・メニューを備えたポップアップ・コンポーネントを特定するための検索式。式はこの表コンポーネントに対して相対的であり、NamingContainerで構成されている必要があります(たとえば、tableおよびpanelCollectionはNamingContainerコンポーネントです)。単一のコロンを付加するとルートから検索を開始でき、複数のコロンを付加するとNamingContainerを上方向に移動できます。たとえば、::を前に置くと、1つのNamingContainer(コンポーネントがtableのようなネーミング・コンテナである場合にはそのコンポーネント自体も含まれます)から出てそこから検索を開始します。:::を前に置くと、2つのNamingContainerから出てそこから検索を開始します。 次のレンダーキットではサポートされていません。org.apache.myfaces.trinidad.core |
clientComponent | boolean | あり | クライアント側のコンポーネントが生成されるかどうか。このフラグを設定してもしなくてもコンポーネントは生成されますが、クライアントJavascriptがコンポーネント・オブジェクトを必要とする場合、コンポーネントの存在を保証するにはtrueに設定する必要があります。現在デフォルトで生成されるクライアント・コンポーネント・オブジェクトは、将来は存在しない可能性があります。このフラグを設定することがコンポーネントの存在を保証する唯一の方法であり、クライアントは暗黙的な動作に依存できません。ただし、このフラグの設定にはパフォーマンス・コストが伴うため、絶対に必要でないかぎり、クライアントではクライアント・コンポーネントを有効にすることを避ける必要があります。 |
columnBandingInterval | int | あり | 列バンディングの発生間隔。この値によって、表に列バンディングが表示されるかどうかが制御されます。たとえば、columnBandingInterval=1とすると、交互にバンディングされる列がグリッドに表示されます。 |
columnSelection | String | あり | 有効な値: none、single、multiple。 この表の列が選択可能であるかどうかを示します。 次のレンダーキットではサポートされていません。org.apache.myfaces.trinidad.core |
columnStretching | String | あり | 列に適用するストレッチングのタイプを示します。最適なパフォーマンスを得るには、none(デフォルト)オプションを使用してください。最後の列をストレッチしてビュー・ポート内の未使用領域を満たす場合は、lastオプションを使用します。空白列を自動的に挿入し、(行の背景色が表の幅全体にわたるように)その列をストレッチする場合は、blankオプションを使用します。特定の列をストレッチしてビュー・ポート内の未使用領域を満たす場合は、まずcolumn:と指定し、次にストレッチする列のIDを続けて、column:myColIdと指定します。行ヘッダーおよび固定列はストレッチされません。ストレッチすると、ユーザーが表のスクロール可能なデータ本体にアクセスできなくなる可能性が高くなるためです。 次のレンダーキットではサポートされていません。org.apache.myfaces.trinidad.core |
contentDelivery | String | あり | 有効な値: immediate、lazy コンポーネントを初めてレンダリングするときにデータをフェッチするかどうかを示します。contentDeliveryがimmediateであると、データはフェッチされてコンポーネント・クロムにインライン化されます。contentDeliveryがlazyであると、データはフェッチされて後続の要求でクライアントに配信されます。 |
contextMenuId | String | あり | 表の行を右クリックすると表示されるコンテキスト・メニューを備えたポップアップ・コンポーネントを特定するための検索式。式はこの表コンポーネントに対して相対的であり、NamingContainerで構成されている必要があります(たとえば、tableおよびpanelCollectionはNamingContainerコンポーネントです)。単一のコロンを付加するとルートから検索を開始でき、複数のコロンを付加するとNamingContainerを上方向に移動できます。たとえば、::を前に置くと、1つのNamingContainer(コンポーネントがtableのようなネーミング・コンテナである場合にはそのコンポーネント自体も含まれます)から出てそこから検索を開始します。:::を前に置くと、2つのNamingContainerから出てそこから検索を開始します。 次のレンダーキットではサポートされていません。org.apache.myfaces.trinidad.core |
contextMenuSelect | boolean | あり | 右クリックしてコンテキスト・メニューを表示するときに、クリックした行を実際に選択するかどうかを示します。デフォルトでは、まず行が選択状態になり、その後でコンテキスト・メニューが表示されます。ただし、contextMenuSelectがfalseである場合、ユーザーが行を右クリックすると、この新規の行が強調表示され、コンテキスト・メニューが表示されると、現在選択している行の強調表示が解除されます。コンテキスト・メニューを終了すると、現在選択している行の強調表示が復元されます。コンテキスト・メニューの表示中も、selectedRowKeys属性には選択した行が含まれたままとなることに注意してください。コンテキスト・メニュー項目に対してアクションを実行すると、強調表示された行キーが表の現在行として設定されます。表の現在行は、table.getRowKey()をコールして取得できます。 |
customizationId | String | あり | この属性は推奨されていません。永続的なカスタマイズを適用するには、id属性を使用する必要があります。この属性は、次のリリースでは削除されます。 |
disableColumnReordering | boolean | あり | 表で列の並替えを無効化するかどうかを示します。デフォルトでは有効になっています。 次のレンダーキットではサポートされていません。org.apache.myfaces.trinidad.core |
disclosedRowKeys | org.apache.myfaces.trinidad.model.RowKeySet | あり | このコンポーネントに対して表示される行のセット。セットの各エントリはrowKeyです。 |
displayRow | String | あり | 有効な値: first、last、selected 初めて表示するときに表に表示する行。有効な値は、最初の行を表示するfirst、最後の行を表示するlast、表で最初に選択した行を表示するselectedです。デフォルト値はnullで、最初の行が表示されることを意味します。ただし、合計行数が表モデルからわからない場合(model.getRowCount()==-1)には、このAPIを使用しても効果がありません。 |
displayRowKey | Object | あり | 初めて表示するときに表に表示するrowkey。この属性を指定すると、displayRow属性がオーバーライドされます。ただし、合計行数が表モデルからわからない場合(model.getRowCount()==-1)には、このAPIを使用しても効果がありません。 |
editingMode | String | あり | 有効な値: editAll、clickToEdit 表に編集可能なコンポーネントが含まれている場合に、その表の編集で使用するモードを示します。有効な値はclickToEditとeditAllです。editAllモードでは、編集可能なコンポーネントが全部まとめて表の表示領域に表示されます。clickToEditモードでは、一度に編集できる行は1つです。行を編集可能にするには、その行をダブルクリックします。ユーザーが[F2]を押すと、現在選択している行が編集可能になります。[Esc]を押すと、編集モードが解除されます。前後の行にナビゲートするには、[Tab]、[Shift]+[Tab]または[Enter]を使用します。 |
emptyText | String | あり | 空の表のテキスト。テキストを開始と終了のHTMLタグで囲むと、そのテキストは書式設定されます。書式設定の動作は、outputFormattedコンポーネントに似ています。開始と終了のHTMLタグで囲まない場合には書式設定されません。 |
expandAllEnabled | boolean | あり | 「すべて展開/すべて縮小」および「下をすべて展開/下をすべて縮小」メニュー項目をレンダリングするかどうかを示します。これらのメニュー項目はデフォルトでレンダリングされます。 |
fetchSize | int | あり | データ・フェッチ・ブロックの行数。 次のレンダーキットではサポートされていません。org.apache.myfaces.trinidad.core |
focusListener | javax.el.MethodExpression | ELのみ | フォーカス・リスナーへのメソッド・リファレンス |
focusRowKey | Object | あり | 現在フォーカスがある行のrowKey。フォーカス行の祖先行のrowKeysは、デフォルトではexpandedRowKeys RowKeySetに追加されます。 |
horizontalGridVisible | boolean | あり | 水平グリッド線を描くかどうかを示します。 |
id | String | なし | コンポーネントの識別子。識別子は、HTMLで許可される構文のサブセットに準拠している必要があります。
|
immediate | boolean | あり | このコンポーネントによってイベントが生成されたときに、データ検証(クライアント側またはサーバー側)を実行するかどうかを示します。immediateがtrueの場合、JavaServer Faces実装が備えるデフォルトのActionListenerが、アプリケーションの起動フェーズまで待機するのではなく、リクエスト処理ライフサイクルのリクエスト値の適用フェーズで実行されます。 |
initiallyExpanded | boolean | あり | 初めてレンダリングすると、フォーカス行のパスの下にある現在のサブツリーが展開されます。リスナーにその展開が正しく通知されるように、コンポーネントのエンコード開始からRowDisclosureEventがブロードキャストされます。 |
inlineStyle | String | あり | このコンポーネントに対して使用するCSSスタイル。これは、基本スタイルの変更用です。inlineStyleは、コンポーネントのルートDOM要素に適用されるCSSスタイルのセットです。inlineStyleのCSSプロパティが対象となるDOM要素に影響を与えない場合は、スキンを作成し、特定のDOM要素をターゲットにしたスキニング・キーを使用する必要があります(::label、::icon-styleなど)。 |
partialTriggers | String[] | あり | 部分更新をトリガーするコンポーネントのID。このコンポーネントは、トリガー・コンポーネント上でリスニングします。トリガー・コンポーネントの1つがなんらかの更新を発生させるイベントを受信した場合、このコンポーネントも更新されることをリクエストします。識別子はソース・コンポーネント(このコンポーネント)に対して相対的であり、NamingContainerで構成されている必要があります。コンポーネントがすでにネーミング・コンテナ内にある場合、単一のコロンを使用するとページのルートから検索を開始でき、複数のコロンを使用するとNamingContainerを上方向に移動できます。たとえば、::を前に置くと、コンポーネントのネーミング・コンテナ(または、コンポーネントがネーミング・コンテナである場合にはそのコンポーネント自体)から出てそこから検索を開始します。:::を前に置くと、2つのネーミング・コンテナ(コンポーネントがネーミング・コンテナである場合にはそのコンポーネント自体も含まれます)から出てそこから検索を開始します。 |
rangeChangeListener | javax.el.MethodExpression | ELのみ | 新しい範囲を選択するとコールされるrangeChangeリスナーへのメソッド・リファレンス。 |
rendered | boolean | あり | コンポーネントがレンダリングされるかどうか。falseに設定した場合、このコンポーネントについて出力は配信されません(コンポーネントはどのような方法でもレンダリングされず、クライアントで表示できません)。 |
rootNodeRendered | boolean | あり | ルート・ノードをレンダリングするかどうか。デフォルトはtrueです。 |
rowBandingInterval | int | あり | 行バンディングの発生間隔。この値によって、表に行バンディングが表示されるかどうかが制御されます。たとえば、rowBandingInterval=1とすると、交互にバンディングされる行がグリッドに表示されます。 |
rowDisclosureListener | javax.el.MethodExpression | ELのみ | ExpansionListenerへのメソッド・リファレンス。 |
rowSelection | String | あり | 有効な値: none、single、multiple この表の行が選択可能であるかどうかを示します。 |
rowsByDepth | int[] | あり | 一度に表示できるレコードの最大数(レンジ・サイズ)。ツリーの各深度レベルには、異なるレンジ・サイズを指定できます。配列の最初の数値は、ルート・コレクションのレンジ・サイズを設定します。後続の各数値は対応する深度のレンジ・サイズを設定します。最後の数値は後続の各深度レベルのデフォルトになります。ノードにレンジ・サイズよりも多く子が含まれる場合、ナビゲーション行が子ノードの上および下にレンダリングされます。 |
selectedRowKeys | org.apache.myfaces.trinidad.model.RowKeySet | あり | このコンポーネントの選択状態。 |
selectionListener | javax.el.MethodExpression | ELのみ | 選択リスナーへのメソッド・リファレンス。 |
shortDesc | String | あり | コンポーネントの短い説明。このテキストは、通常、ツールチップ・ヘルプ・テキストを表示するためにユーザー・エージェントによって使用されます。この場合、ツールチップの動作はユーザー・エージェントによって制御されます。たとえば、Firefox 2では長いツールチップは切り捨てられます。フォーム・コンポーネントの場合、shortDescはノート・ウィンドウに表示されます。 |
styleClass | String | あり | このコンポーネントに対して使用するCSSスタイル・クラス。スタイル・クラスは、jspxページまたはスキニングCSSファイルなどで定義できます。または、AFInstructionTextのようなパブリック・スタイル・クラスの1つを使用できます。 |
summary | String | あり | ユーザー・エージェントが非ビジュアル・メディアにレンダリングできるように、この表の目的および構造をまとめたものです。 |
value | Object | あり | ツリー・データの階層: タイプはorg.apache.myfaces.trinidad.model.TreeModelである必要があります。 |
var | String | なし | このコレクションの各要素を参照するために使用するEL変数の名前です。このコンポーネントのレンダリングが完了すると、この変数は削除されます(またはその前の値に戻ります)。 |
varStatus | String | なし | varStatus情報の各要素を参照するために使用するEL変数の名前です。このコンポーネントのレンダリングが完了すると、この変数は削除されます(またはその前の値に戻ります)。VarStatusによって、コンポーネントの状態に関する情報がEL式に提供されます。反復するコンポーネントの場合、varStatusではループ・カウント情報も提供されます。varStatusの具体的なプロパティについては、このコンポーネントのドキュメントを参照してください。varStatusの共通プロパティは、次のとおりです。
|
verticalGridVisible | boolean | あり | 垂直グリッド線を描くかどうかを示します。 |
visible | boolean | あり | コンポーネントの可視性。falseの場合、コンポーネントはクライアント上で非表示となります。renderedとは異なり、これはサーバーでのライフサイクルには影響を与えません(コンポーネントに実行済バインディングがある、など)。コンポーネントの可視性は、クライアント上で切り替えるか、PPRを使用して切り替えることができます。renderedがfalseの場合、コンポーネントはどのような方法でもレンダリングされず、クライアントで表示できません。ほとんどの場合、visibleプロパティのかわりにrenderedプロパティを使用します。 次のレンダーキットではサポートされていません。 org.apache.myfaces.trinidad.core |
width | String | あり | このコンポーネントの幅。デフォルト値は300PXです。 |