階層リストボックスの管理

ホーム

4D v16.3

ランゲージリファレンス

リストボックス

階層リストボックスの管理

4Dで階層リストボックスを使用できます。階層リストボックスとは、一列目の内容が階層形式で表示されるリストボックスのことです。このタイプの表現は繰り返される値や、( 国、地域、都市など) 階層的に表現される値を含む情報の表示に使用されます。

配列タイプのリストボックスのみが階層になることができます。

階層リストボックスはデータを表示する特別な方法ですが、データの構造 (配列) を変更することはありません。階層リストボックスは通常のリストボックスとまったく同様に管理されます (リストボックスオブジェクトの管理を参照)。

階層リストボックスを指定するには、2つの異なる方法があります:

フォームエディタのプロパティリストやリストボックス管理ポップアップメニューを使用して、手作業で階層要素を指定する。この方法はDesign Referenceで説明します。
LISTBOX SET HIERARCHYとLISTBOX GET HIERARCHYコマンドを使用する。

階層リストボックスを含むフォームが最初に開かれるとき、デフォルトですべての行が展開されて表示されます。
配列中で値が繰り返されているとき、ブレーク行と階層ノードが自動でリストボックスに追加されます。例えば国、地域、名前、そして人口データを持つ市区が、リストボックスに4 つの配列で含まれているとします:

このリストボックスが階層形式で表示されると、最初の3つの配列は階層に含まれ、以下のように表示されます:

階層が構築される前に配列はソートされていません。例えばもし配列がデータAAABBAACCで構成されていると、取得される階層は以下のようになります:

> A
> B
> A
> C

階層ノードを展開あるいは折りたたむにはノードをクリックします。Alt+click (Windows) あるいは Option+click (Mac OS) を行うとすべてのサブ要素が展開されたり折りたたまれたりします。これらの操作はLISTBOX EXPAND と LISTBOX COLLAPSEコマンドを使用してプログラムで行うこともできます。

選択行とその位置の管理

階層リストボックスはノードの展開/ 折りたたみ状態により、スクリーン上に表示される行数が変わります。しかし配列の行数が変わるわけではありません。表示が変わるだけでデータに変更はありません。

この原則を理解することは重要です。階層リストボックスに対するプログラムによる管理は常に配列データに対して行われるのであり、表示されたデータに対して行われるわけではないからです。特に、自動で追加されるブレーク行は、表示オプション配列では考慮されません (後述ブレーク行の管理参照)。

例として以下の配列を見てみましょう:

これらの配列が階層的に表示されると、2 つのブレーク行が追加されるため、"Quimper" 行は2 行目ではなく4 行目に表示されます:

階層であってもなくても、リストボックスにどのようにデータが表示されているかにかかわらず、"Quimper" が含まれる行を太字にしたい場合はステートメントStyle{2} = bold を使用しなければなりません。配列中の行の位置のみが考慮されます。

この原則は以下のものを管理する内部的な配列に適用されます:

カラー
背景色
スタイル
非表示行
選択行

例えばRennesを含む行を選択したい場合、以下のように書きます:

->MyListbox{3}:=True

非階層表示:

階層表示:

注: 親が折りたたまれているために行が隠されていると、それらは選択されなくなります。(直接あるいはスクロールで) 表示されている行のみを選択できます。言い換えれば行を選択かつ隠された状態にすることはできません。

選択と同様、LISTBOX GET CELL POSITION コマンドは階層リストボックスと非階層リストボックス同じ値を返します。つまり以下の両例題で、LISTBOX GET CELL POSITION は同じ位置 (3;2) を返します。

非階層表示:

階層表示:

ブレーク行の管理

ユーザがブレーク行を選択すると、LISTBOX GET CELL POSITIONは対応する配列の最初のオカレンスを返します。以下のケースで:

LISTBOX GET CELL POSITIONは (2;4) を返します。プログラムでブレーク行を選択するにはLISTBOX SELECT BREAKコマンドを使用します。

ブレーク行はリストボックスのグラフィカルな表示 (スタイルやカラー) を管理する内部的な配列では考慮されません。しかしオブジェクトのグラフィックを管理するオブジェクト(フォーム)テーマのコマンドを使用してブレーク行の表示を変更できます。階層を構成する配列に対して、適切なコマンドを実行します。

以下のリストボックスを例題とします (割り当てた配列名は括弧内に記載しています):

非階層表示:

階層表示:

階層モードではtStyleやtColors配列で変更されたスタイルは、ブレーク行に適用されません。ブレークレベルでカラーやスタイルを変更するには、以下のステートメントを実行します:

 OBJECT SET RGB COLORS(T1;0x0000FF;0xB0B0B0)

 OBJECT SET FONT STYLE(T2;Bold)

注: このコンテキストでは、配列は割り当てられたオブジェクトがないため、配列変数を使用したシンタックスのみがオブジェクトプロパティコマンドで動作します。

結果:

非表示行

サブ階層のすべての行が隠されているとき、ブレーク行は自動で隠されます。先の例題で1から3行目までが隠されていると、"Brittany"ブレーク行は表示されません。

展開/折りたたみ管理の最適化

On Expand や On Collapse フォームイベントを使用して階層リストボックスの表示を最適化できます。

階層リストボックスはその配列の内容から構築されます。そのためこれらの配列すべてがメモリにロードされる必要があります。大量のデータから (SELECTION TO ARRAYを使用して) 生成される配列を元に階層リストボックスを構築するには、表示速度だけでなくメモリ利用量の観点からも困難が伴います。

On Expand と On Collapse フォームイベントを使用してこの制限を回避できます。例えばユーザーのアクションを元に階層の一部だけを表示したり、必要に応じて配列をロード/アンロードできます。

これらのイベントのコンテキストでは、LISTBOX GET CELL POSITIONコマンドは、行を展開/折りたたむためにユーザーがクリックしたセルを返します。

この場合、開発者がコードを使用して配列を空にしたり値を埋めたりしなければなりません。実装すべき原則は:

リストボックスが表示される際、先頭の配列のみ値を埋めます。しかし2番目の配列を空の値で生成し、リストボックスに展開/折りたたみアイコンが表示されるようにしなければなりません:
ユーザーが展開アイコンをクリックするとOn Expand イベントが生成されます。LISTBOX GET CELL POSITION コマンドはクリックされたセルを返すので、適切な階層を構築します: 先頭の配列に繰り返しの値を設定し、2番目の配列には SELECTION TO ARRAY コマンドから得られる値を設定します。そしてLISTBOX INSERT ROWSコマンドを使用して必要なだけ行を挿入します。
ユーザーが折りたたみアイコンをクリックすると On Collapse イベントが生成されます。LISTBOX GET CELL POSITION コマンドはクリックされたセルを返すので、 LISTBOX DELETE ROWS コマンドを使用してリストボックスから必要なだけ行を削除します。

参照

LISTBOX GET HIERARCHY
LISTBOX SELECT BREAK
LISTBOX SET HIERARCHY
リストボックスオブジェクトの管理