SET LIST PROPERTIES
SET LIST PROPERTIES ( list ; appearance {; icon {; lineHeight {; doubleClick {; multiSelections {; editable}}}}} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| list | Integer | → | リスト参照番号 |
| appearance | Integer | → | *** 廃止予定、常に0を指定してください *** |
| icon | Integer | → | *** 廃止予定、常に0を指定してください *** |
| lineHeight | Integer | → | 最小行高さ (ピクセル単位) |
| doubleClick | Integer | → | ダブルクリックでサブリストを展開/折り畳み 0 = Yes, 1= No |
| multiSelections | Integer | → | 複数行選択: 0 = No (デフォルト), 1 = Yes |
| editable | Integer | → | 0 = ユーザによるリスト編集不可, 1 = ユーザによるリスト編集可 (デフォルト) |
このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。
説明
SET LIST PROPERTIES コマンドは、list引数に渡された参照番号を持つ階層リストの行の高さとセレクションプロパティを設定します。
互換性に関する注意: appearance および icon 引数は廃止予定となり、これらは常に0を指定しなければなりません。
注: リスト内の各項目ごとのアイコンをカスタマイズしたい場合には、SET LIST ITEM PROPERTIES コマンドを使用してください。
lineHeight引数を渡さない場合、階層リストの行の高さはオブジェクトに使用されるフォントおよびフォントサイズによって決定されます。lineHeight 引数に階層リストの行の最小の高さを渡すこともできます。使用されるフォントおよびフォントサイズから継承される行の高さより大きな値を渡した場合、階層リストの行の高さは強制的に渡された値になります。デフォルトの高さを指定するためには0を渡してください。
オプションのdoubleClick引数により、親リスト項目をダブルクリックしてサブリストの展開/折りたたみを行うか、行わないかを定義できます。デフォルトでは親リスト項目をダブルクリックすることにより、子リストが開いたり閉じたりするようになっています。しかし、いくつかのユーザーインタフェイスではこの動作が起こらないようにする必要があります。そのためには、doubleClick引数を1に設定します。
ダブルクリックの動作だけが発生しなくなります。リストのノードをクリックすることによりサブリストの開閉ができます。
doubleClick 引数を省略するか0を渡すと、デフォルトの動作が適用されます。
オプションのmultiSelections引数を使用し、リストが複数項目の選択を受け入れるかどうかを指示することができます。
デフォルトでは以前のバージョンの4Dと同様、階層リストの項目を複数同時に選択することはできません。リストに対してこの機能を利用可能にしたい場合は、multiSelections引数に1を渡します。その場合、次の方法で複数選択機能を使用することができます:
- 手動の場合、連続した項目の選択にはShift+クリック、連続していない項目の選択にはCtrl+クリック(Windows)またはCommand+クリック(Mac OS)を使用します。
- プログラムを使用する場合、SELECT LIST ITEMS BY POSITION およびSELECT LIST ITEMS BY REFERENCE コマンドを使用します。
multiSelections引数に0を渡すか省略した場合、デフォルトの動作が適用されます。
オプションの引数editableを使用すると、データ入力中にリストがフィールドや変数に関連付けられた選択リストとして表示された際に、ユーザによる編集を可能にするかどうかを指示することができます。リストが編集可である場合、選択リストウインドウに変更ボタンが追加され、ユーザはエディタを用いて、値の追加や削除、並び替えを行うことができます。
editable引数に値1を渡すか省略すると、そのリストは編集可能になります。0を渡すと、リストを編集することはできません。
例題
ダブルクリックによるサブリストの展開/折りたたみを許可しない場合を考えます。フォームメソッドのように以下のように記述することができます:
Case of
:(Form event code=On Load) //v17 以前ではForm event を使用すること
hlCities:=Load list("Cities") //Citiesという選択リストをhlCitiesフォームオブジェクトに読み込みます
SET LIST PROPERTIES(hlCities;0;0;0;1) //ダブルクリックでの展開/折りたたみを禁止
End case
参照
GET LIST ITEM PROPERTIES
GET LIST PROPERTIES
SET LIST ITEM PROPERTIES