[V3] メニュー／ツリービュー型セル – Forguncy サポート

※Forguncy 6以降のプラグインについては、各バージョンのオンラインヘルプをご確認ください。

セル型に「メニュー」および「ツリービュー」が使用できるようになり、データをメニュー形式のように表示したり、ツリー構造で階層化して表示したりできます。

※本ページは、Forguncy 3用の説明です。メニュー／ツリービュー型セルは、Forguncy 4ではプリインストールプラグインになりました。詳細については、以下のオンラインヘルプを参照してください。

ダウンロード

1.0.2.3（Forguncy 4用）	MenuTreeview_1_0_2_3.zip (150 KB)
1.0.0.3（Forguncy 3用）	FGC3_MenuTreeview_1_0_0_3.zip (80 KB)

インストール

ダウンロードしたプラグインを「プラグインを追加する」を参照してインストールすると、以下が「プラグインの管理」に表示されます。インストール後にForguncyの再起動が必要なことに注意してください。

使い方（ツリービュー）メニューの使い方はこちら

任意のセルの領域にツリービュー型セルを割り当てます。
ツリービューを表示する領域を選択して、［ホーム］→［セル型］のドロップダウンリストから［ツリービュー］を選択します。
ツリービュー型セルの詳細を設定します。
右ペイン下部の［セル型］タブをクリックして、ツリービュー型セルの設定を行います。

コマンド…	既定値を変更したい時にコマンドを設定します。画面に表示されているツリービューの項目が選択されると、設定したコマンドが実行されます。詳細は、セル型のコマンドを参照してください。また、ツリービュー型セルを参照することで、ツリービューのどの項目が選択されているかを取得できます。
テーブルからデータを取得	チェックされている場合、データベースからツリーノードのデータを取得します。取得するデータは、「ツリーノードのデータ連結設定…」から指定します。チェックしていない場合、「ツリーノード…」をクリックすることで、独自のツリーノードを作成できます。
ツリーノードのデータ連結設定…	次の画面が表示され、ここでデータベースの連結設定を行います。「データ連結モード」で、ツリービューに表示するデータを以下の２つから選択します。「固定階層」を選択すると、固定した任意の階層を作成し、その階層ごとにテーブルのフィールドと関連付けることができます。またその階層ごとにクエリー条件や並び替えの設定ができます。詳細は、「固定階層」を参照してください。「動的階層」を選択すると、指定したテーブルの１つのフィールドを自動的に階層判断して、階層表示します。詳細は「動的階層」を参照してください。
ツリーノード…	次の画面が表示され、ここで独自のツリーノードを作成します。上記画面の左側のリストツリーの階層を表します。追加したい場合は「＋」、削除したい場合は「−」をクリックします。階層を移動する場合は、をクリックします。階層上で右クリックして表示される次のメニューでも同様のことが行なえます。名前ノードの名前を入力します。値ノードに表示する値を入力します。
規定の展開状態	ページを表示した時に、ツリーノードを展開して表示するか折りたたんで表示するかを指定します。展開して表示したい時は「すべて展開」を選択してください。折りたたんで表示したいは「すべて折りたたんだ状態」を選択してください。
ツリースタイル	次の画面が表示され、ツリーノードを選択した時のスタイルを指定します。選択時背景色ツリーノードを選択した時の背景色を指定します。選択時文字色ツリーノーを選択した時の文字色を指定します。

セルの値

ツリービュー型セルを参照することで、ツリービューのどの項目が選択されているかを取得できます。セルの参照時に取得できる値は以下の通り。

テーブルから値を取得しない場合	ツリーノードダイアログの「値」に設定した値が「_」（アンダースコア）で区切られて設定されます。たとえば、「ノード1」の子ノードの「ノード11」を選択している場合、セルの値は「ノード1_ノード11」になります。
テーブルから値を取得する場合（固定階層）	セルの値は各階層の「レコード位置を表すフィールド」に指定したフィールドの値が「_」で区切られて設定されます。
テーブルから値を取得する場合（動的階層）	セルの値は「レコード位置を表すフィールド」に指定したフィールドの値になります。

［ツリーノードのデータ連結設定…］の「データ連結モード」について

固定階層

「データ連結モード」が固定階層の時、次の画面が表示されます。固定した任意の階層を作成し、その階層ごとにテーブルのフィールドと関連付けることができます。またその階層ごとにクエリー条件や並び替えの設定ができます。画面左のエリアにある「＋」や「−」で階層の追加や削除が行えます。左のエリアで選択している階層に関連付ける情報を、右のエリアで指定します。
※クエリー条件は階層ごとに指定できますが、親の階層で指定したクエリー結果が０件の場合、子の階層は表示されません。

例１：次の画面のようなツリーノードを作成する例をもとにして、設定値を説明します。

実行結果：

テーブル：都道府県テーブルを作成しておきます。

テーブル：市区町村テーブルを作成しておきます。
「都道府県ID」は、都道府県テーブルの「ID」と関連性があるものとします。なお、関連するフィールドの型は必ず同じにしてください。「都道府県ID」の値は、階層としてぶら下がりたい「親のレコードID」の値が記載されている必要があります。図では都道府県テーブルの「東京都」にぶら下がりたい場合、そのIDが「2」のため、「都道府県ID」の値は「2」になります。

ツリーノードのデータ連結設定：
ツリーのルートとなる「階層名」を「ツリー階層１」という名称で定義します。
ルートに表示するデータをどのテーブルから表示させるかを「テーブル」で指定します。
テーブルのどのフィールドを表示するかを「表示フィールド」で指定します。
「レコード位置を示すフィールド」は、固定階層のルートの場合のみ、ルート上に表示するデータの基準値を指定します。つまりこの例でいえば「ID」フィールドを指定しているため、IDの値が違えば表示フィールドで指定した「都道府県」フィールドがすべて表示されます。もし都道府県テーブルの４レコード目に「東京都」が再度あった場合でも、IDの値が違うため「東京都」は２つ表示されます。「ID」フィールドではなく「都道府県」フィールドを指定すると「東京都」は１つ表示されます。しかしこの場合、子が正しく表示されないため階層化する場合は一意になる値を設定してください。

子ノードは親のルートのどのフィールドに関連づけられているかを「親レコードの位置を保持するフィールド」で指定します。そのレコードが、階層としてぶら下がりたい親のレコード位置が書かれたフィールドを指定します。

例２：選択したツリーノードに関連する情報を一緒に表示する設定例を示します。

実行結果：
次の画像では、ツリーノードで「港区」をクリックすると、「港区」に存在する店舗のみを「店舗テーブル」に表示しています。さらに、選択した港区の階層を示す数値を、ツリーノードの上部（背景色が青の部分）に表示しています。
ここで使用したサンプルはこちらからダウンロードできます。

上記の設定方法：
例１の設定に続けて以下を設定します。

店舗テーブルを作成します。
市区町村テーブルに数式フィールドを追加します。これは階層のレベルを数値化（ここでは“１_2”というようにアンダーバーで表現）して表示するためのフィールドです。
ここまでで、市区町村テーブルに「階層の数式」フィールドが追加されたことを確認できます。
テーブルの関連付けを設定します。
店舗テーブルの市町村IDと市区町村テーブルのIDを関連付けます。

同様に市区町村テーブルの都道府県IDと都道府県テーブルのIDを関連付けます。
各テーブルの値を表示するリンクテーブルをページに作成し、それぞれフィールドを連結表示させます。
B3セルを選択し、ノードが選択された時に実行されるコマンドを次のように指定します。
「セルプロパティの設定」で現在選択されているノードの階層をB2セルに表示させるように指定します。

「クエリー」で現在選択されているノードにマッチするデータだけを、店舗テーブルのリンクテーブルに表示させるように指定します。
実行すると、実行結果の画面が表示されます。

動的階層

「データ連結モード」が動的階層の時、次の画面が表示されます。動的階層は、テーブルの１つのフィールドを自動的に階層判断して、階層を表示します。

テーブル	対象となるテーブルを指定します。
レコード位置を示すフィールド	レコードを識別できる一意のデータのフィールドを指定します。
表示フィールド	階層化して実際に表示したいデータが格納されているフィールドを指定します。
親レコードの位置を保持するフィールド	階層化を判断するために必要となる情報が格納されているフィールドを指定します。この判断が必要となる情報とは、そのレコードが、階層としてぶら下がりたい親のレコード位置情報（上記の「表示フィールド」で指定したフィールドに書かれた値）です。設定例として「階層表示用ID」フィールドと「ID」フィールドの関係性を下記に示します。テーブル実行結果この実行結果は「並び替え」で以下の設定をしています。優先の高いものから指定することで並び替えができます。「クエリ条件」でデータベースから該当レコードを抽出する条件を指定することができます。例えば、以下のように指定すると都道府県フィールドに「みやぎけん」が含まれているレコードのみ階層表示されます。実行結果：宮城県だけが表示されます。ここで使用したサンプルはこちらからダウンロードできます。

使い方（メニュー）ツリービューの使い方はこちら

任意のセルの領域にメニュー型セルを割り当てます。
メニューを表示する領域を選択して、［ホーム］→［セル型］のドロップダウンリストから［メニュー］を選択します。
メニュー型セルの詳細を設定します。
右ペイン下部の［セル型］タブをクリックして、メニュー型セルの設定を行います。

メニュー項目...	メニュー項目を作成します。上記画面の左側のリストメニューを表します。メニュー項目を追加したい場合は「＋」、削除したい場合は「−」をクリックします。メニュー項目を移動する場合は、をクリックします。また、ドラッグでメニューの上下関係を変更できます。これらは、右クリックして表示される次のメニューでも同様のことが行なえ、また兄弟メニューやサブメニューを追加することができます。コマンド… メニュー項目をクリックした時に実行されるコマンドを設定します。詳細は、セル型のコマンドを参照してください。名前左のリスト内でフォーカスされているメニュー項目の値を入力できます。また、左のリスト内を右クリックして表示される上記メニューの「名前の変更」からも同様のことが行なえます。アイコンメニューに表示する任意のアイコンを選択します。権限設定メニュー項目ごとに、異なるロールに対して異なる権限を設定できます。デフォルトは「匿名ユーザー」で、誰でもメニュー項目を利用できます。「匿名ユーザー」のチェックを外して「ログインユーザー」を指定すると、ログインしたユーザー全員がメニュー項目を利用できます。「匿名ユーザー」と「ログインユーザー」のチェックを外して任意のロールを指定すると、そのロールに所属していて、かつログインしたユーザーのみメニュー項目を利用できます。親メニューにアクセスできない場合、そこに属するすべてのサブメニューにもアクセスすることはできません。
レイアウト	メニューを水平レイアウトか垂直レイアウトのどちらにするかを設定します。
規定の展開状態	ページを表示した時に、メニューを展開して表示するか折りたたんで表示するかを指定します。展開して表示したい時は「すべて展開」を選択してください。折りたたんで表示したいは「すべて折りたたんだ状態」を選択してください。
カラーテーマ	メニューのテーマカラー。
メニュースタイル...	色とフォントを含むメニューのスタイルを設定します。メニュー階層：選択したメニュー階層のスタイルを設定します。背景色：メニュー項目の背景色。文字色：メニュー項目の文字色。選択時背景色：メニュー項目の選択時の背景色。選択時文字色：メニュー項目の選択時の文字色。ホバー時背景色：マウスが上に置かれた時のメニュー項目の背景色。ホバー時文字色：マウスが上に置かれた時のメニュー項目の文字色。フォント：メニュー項目のフォント名。太字：チェック時に太字。フォントサイズ：メニュー項目のフォントサイズ（pt単位）高さ：高さ（pt単位）アイコンサイズ：アイコンの幅と高さ（pt単位）

セル型を設定できる箇所

	メニュー	ツリービュー
通常のページ	●	●
マスターページ	●	●
モバイルページ	●	●
モバイルマスターページ	●	●
リストビュー	×	×
モバイルリストビュー	×	×

使用できるForguncyのバージョン

プラグインのバージョン	使用できるForguncyのバージョン
1.0.2.3（Forguncy 4用）	4.0.104.0以降（Forguncy 4のみ）
1.0.0.3（Forguncy 3用）	3.0.105.0以降（Forguncy 3のみ）

更新履歴

1.0.2.3（2018/11/28 リリース）
Forguncy 4用公開
1.0.0.3（2018/4/3 リリース）
Forguncy 3用初版公開