[Grid] の変数ノード
[Grid] の変数ノードには、次のプロパティがあります:
[Name]: グリッドの変数の名前です。このプロパティは、フォーム、ルール、およびイベント内で識別するために必要です。
[Description]: グリッド変数のデスクリプションです。グリッド内の変数の列タイトルを示します。[Grid] の項目属性の [Description] プロパティと同じ意味です (この例を表示するには、[Grid] の項目属性ノードを開いてください)。
[Domain/Attribute]: 変数が基づくドメインまたは項目属性を指定します。このプロパティは、生成されたオブジェクト内で変数を定義するために必要です ([Transaction]、[Selection]、[View] など)。
[Load Code]: この変数をロードするために、Grid の Load Event 内で設定されるコードを指定します。ユーザーには、必要に応じてロードに関連した操作を行う柔軟性が与えられます。たとえば、変数はプロシージャー (call または udp) を呼び出すことで割り当てることができ、項目属性の値から、または項目属性や数学演算などの連結の結果として割り当てることができます。
[Sortable By Title]: 列をクリックすることによって、並べ替えを実行するかどうかを指定します。この並べ替えはサーバー側で実行されるので、表示されているレコードだけでなく、すべてのレコードの並べ替えが実行されます。このプロパティの値には次のものがあります:
- <default>: 値は、[WorkWithPlus Settings] -> >[Grid] -> [Sortable By Titles] プロパティから取得されます。
- [True]: 列をクリックすることで、その項目属性によってレコードの順序を昇順または降順に並べ替えることを可能にします。
- [True (＜項目属性名＞)]: 列をクリックすることで、その [Order] によってレコードの順序を昇順または降順に並べ替えることを可能にします。[Order] は、[Orders] の子ノードです。たとえば、[PersonFullName] には次のようなオプションがあります:
タイトルでの並べ替えは、GeneXus グリッド、ColumnsSelector グリッド、または GXUI グリッドで使用できます。
タイトルでの並べ替えの画像例の表示、および詳細については、次のリンクを参照してください:タイトルでの並べ替え <
[Conditional Formatting]: その列に別々の書式を適用するための条件を指定します。「[Grid] の項目属性ノード」に、このプロパティの使用例があります。この機能の詳細については、次のリンクを参照してください: 条件付き書式
その列に別々のタグを適用するための条件を指定します。
項目属性に設定する集計値の種類 (合計、平均、なし) を指定します。有効な値は次のとおりです:
[Sum] または [Average] を設定した場合は、実行時にどのように表示されるかプレビューできます:
[Form]
[Theme class]: 変数のテーマクラスです。
[Description Theme class]: グリッド変数のデスクリプションには適用されません。
[Visible]: 変数がそのグリッド内に表示されるかどうかを指定します。
[Control Info]
[Control info based on]: 項目属性のコントロール情報が基づくドメインまたは項目属性を指定します。
[Conditions (Dynamic controls)]: コントロールに追加される条件を指定します (コントロールが [Dynamic Combo]、[Listbox]、または [Suggest] の場合のみ)。
[General]
[Width]: 変数が表示される列の幅を指定します。値を「0」にした場合は、項目属性/ドメインの定義内の [Autoresize] プロパティに基づいた値になります。これは、編集可能な変数と読み取り専用の変数に適用されますが、ColumnsSelector グリッド内には適用されません。次のリンクに、このプロパティの例を示します: Grid attribute
[Title Category]: この項目属性を含めるカテゴリの名前を指定します。次のリンクに、例を示します: Grid Category
[Responsive Customization]
[Visible (Extra Small)]、[Visible (Small)]、[Visible (Medium)]、[Visible (Large)]:
これらのプロパティでは、さまざまな大きさのブラウザーで変数を表示するかどうかを設定できます。たとえば、ブラウザーが Large サイズの場合はその変数を表示し、ブラウザーが Extra Small サイズの場合は非表示にするように設定できます。これらのプロパティでは [True] または [False] の値を指定できます。
[Columns selector]
[Visible by default]: 既定で変数がグリッド内に表示されるかどうかを指定します。つまり、ページが初めてロードされる際に、変数が表示されるかどうかを指定します (例: WWPerson)。[Columns selector] プロパティを含んでいるノードの場合、そのプロパティが [True] の場合にのみ、Selection および Grid tab のオブジェクトに適用されます。項目属性の [Visible] プロパティが [False] の場合、項目属性が表示されないため、このプロパティは有効ではありません。
このプロパティは、[Grid] の項目属性の [Visible by default] プロパティと同じ意味です(この例を表示するには、[Grid] の項目属性ノードを開いてください)。
[Export]
[Include In Export]: 変数が Excel のエクスポートに含まれるかどうかを指定します。
このオブジェクトに [StandardAction (Export)] が有効な場合にのみ適用されます。
[Export Report]
[Include In Export Report]: 変数が PDF レポートに含まれるかどうかを指定します。このオブジェクトに [StandardAction (Export Report)] が有効な場合にのみ適用されます。
[Export CSV]
[Include in Export CSV]: 変数が CSV ファイルに含まれるかどうかを指定します。このオブジェクトに [StandardAction (Export CSV)] が有効な場合にのみ適用されます。
[Include in Export]、[Include in Export Report]、および [Include in Export CSV] の各プロパティに設定できる値は、[<default>]、[True]、および [False] です。<default> 値の場合は、以前のバージョンと同じ動作になります (グリッド内で表示される場合にのみ含まれます)。このプロパティが [True] の場合は項目属性/変数が含まれ、[False] の場合は含まれません。
[Title Filter]
[Include Title Filter]: この変数の列タイトルフィルタを含めるかどうかを指定します。有効な値は次のとおりです:
[True] の場合は、変数のタイトルフィルタを設定するための新しいプロパティセットが表示されます:
[Search Box]: その変数で、タイトルフィルタ内に検索ボックスを含めるかどうかを指定します。有効な値は次のとおりです:
[Search Box Condition]: その列レコードにフィルタを適用するのに使用する条件を指定します。変数の場合、検索ボックスを含めるために条件を定義する必要があります。これによって使用する条件が定義されます。
[Data List]: 項目属性の列タイトルに、適用可能な値のリストを設定するかどうかを指定します。このプロパティのオプションは次のとおりです:
[Selected Item Condition]: エンドユーザーがデータリストからアイテムを選択する際に適用する条件を指定します。この条件の設定は必須です。この条件を設定しないと、変数のリストのアイテムをクリックしてもグリッドでフィルタが適用されません。通常、アイテムをクリックしたときの条件は等価 (<SomeAttribute> = &variable) です。
[Data List Include Total Records]: データアイテムの横に、その値を持つレコードの数を含めるかどうかを指定します。[Data List] が [Dynamic] の場合にのみ適用されます。
[Data List Update Minimum Characters]: 動的リストの値を更新するために検索ボックスに入力する必要がある最小文字数を指定します。値が 0 の場合、検索ボックスは空白にすることができ、その場合も動的リストは表示され、更新されます。[Data List] が [Dynamic] の場合にのみ適用されます。
[Data List Max Values]: 動的データリストに表示するアイテムの最大数を指定します。
[Fixed value filters]: タイトルフィルタに追加する、固定値の含まれたフィルタを指定します。これは [Grid] の項目属性内の同じプロパティと似ています。「[Grid] の項目属性ノード」には、このプロパティの例があります。