LISTBOX Get property
LISTBOX Get property ( {* ;} object ; property ) : any
| 引数 | 型 | 説明 | |
|---|---|---|---|
| * | 演算子 | → | 指定時、object はオブジェクト名(文字列)。 省略時、object は変数。 |
| object | any | → | オブジェクト名 (* 指定時) または変数 (* 省略時) |
| property | Integer | → | 値を取得したいプロパティ |
| 戻り値 | Integer, Text | ← | カレントの値 |
説明
LISTBOX Get property コマンドは、object 引数および * 引数を使用して指定したリストボックスまたはリストボックスカラムの、 property で指定したプロパティの値を返します。
オプションの引数 * を渡すことにより、object 引数がオブジェクト名(文字列)であることを示します。 この引数を渡さない場合、object 引数が変数であることを示します。 この場合、文字列ではなく変数参照を指定します。 オブジェクト名についての詳細は オブジェクトプロパティ を参照してください。
注: object および * で指定されたリストボックスまたはカラムが存在しない場合には、LISTBOX Get property コマンドはプロパティの種類により -1 (数値の場合) または空文字列 (文字列の場合) を返します。
property 引数には、取得しようとするプロパティを表す定数を渡します。 この引数には“List Box” テーマの次の定数のいずれかを使用することができます:
| 定数 | 値 | 説明 |
|---|---|---|
| lk allow wordwrap | 14 | ワードラップ プロパティ 適用対象: カラム * 取り得る値: lk no (0) lk yes (1) |
| lk auto row height | 31 | 配列型リストボックスの 自動行高 プロパティ 適用対象: リストボックスあるいはカラム 取りうる値: lk no (0) lk yes (1) |
| lk background color expression | 22 | セレクション型、コレクションまたはエンティティセレクション型リストボックスの 背景色式 プロパティ 適用対象: リストボックスあるいはカラム |
| lk cell horizontal padding | 36 | 横方向パディング プロパティ セル内の横方向パディング(ピクセル単位、左右のパディングで同じ値) 敵意用対象: リストボックス、カラム、ヘッダー、フッター |
| lk cell vertical padding | 37 | 縦方向パディング プロパティ セルの縦方向パディング(ピクセル単位、上下のパディングで同じ値) 適用対象: リストボックス、カラム、ヘッダー、フッター |
| lk column max width | 26 | 最大幅 プロパティ 適用先: カラム * |
| lk column min width | 25 | 最小幅 プロパティ 適用対象: カラム * |
| lk column resizable | 15 | リサイズ可 プロパティ 適用対象: カラム * 取り得る値: lk no (0) lk yes (1) |
| lk detail form name | 19 | セレクション型リストボックスの 詳細フォーム名 プロパティ 適用対象: リストボックス |
| lk display footer | 8 | フッターを表示 プロパティ 適用対象: リストボックス 取り得る値: lk no (0): 非表示 lk yes (1): 表示 |
| lk display header | 0 | ヘッダーを表示 プロパティ 適用対象: リストボックス 取り得る値: lk no (0): 非表示 lk yes (1): 表示 |
| lk display type | 21 | 数値カラムに対しての 表示タイプ プロパティ 適用対象: カラム * 取り得る値: lk numeric format (0): 値を数値フォーマットで表示 lk three states checkbox (1): 値を3ステートチェックボックスとして表示 |
| lk double click on row | 18 | セレクション型リストボックスの 行をダブルクリック プロパティ 適用対象: リストボックス 取り得る値: lk do nothing (0): どの自動アクションもトリガーしない lk edit record (1): 対応するレコードを読み書き可能モードで表示 lk display record (2): 対応するレコードを読み込みのみモードで表示 |
| lk extra rows | 13 | 余分な空白行を隠す プロパティ 適用対象: リストボックス 取り得る値: lk display (0) lk hide (1) |
| lk font color expression | 23 | セレクション型、コレクションまたはエンティティセレクション型リストボックスの フォントカラー式 プロパティ 適用対象: リストボックスあるいはカラム |
| lk font style expression | 24 | セレクション型、コレクションまたはエンティティセレクション型リストボックスの スタイル式 プロパティ 適用対象: リストボックスあるいはカラム |
| lk hide selection highlight | 16 | セレクションハイライトを非表示 プロパティ 適用対象: リストボックス 取り得る値: lk no (0) lk yes (1) |
| lk highlight set | 27 | セレクション型リストボックスの セットをハイライト プロパティ 適用対象: リストボックス |
| lk hor scrollbar height | 3 | 高さ(ピクセル単位) |
| lk meta expression | 34 | コレクションまたはエンティティセレクション型リストボックスの メタ情報式 プロパティ 適用対象: リストボックス |
| lk movable rows | 35 | 配列型リストボックスの 行の移動可 プロパティ 適用対象: リストボックス(ただし階層モードを除く) 取り得る値: lk no (0): 行はランタイムに移動させられない lk yes (1): 行はランタイムに移動させられる(デフォルト) |
| lk multi style | 30 | マルチスタイル のプロパティ 適用対象: カラム* 取り得る値: lk no (0) lk yes (1) |
| lk named selection | 28 | セレクション型リストボックスの 命名セレクション プロパティ 適用対象: リストボックス |
| lk resizing mode | 11 | カラムの自動リサイズ プロパティ 適用対象: リストボックス 取り得る値: lk manual (0) lk automatic (2) |
| lk row height unit | 17 | 行の高さ プロパティの単位 適用対象: リストボックス 取り得る値: lk lines (1) lk pixels (0) |
| lk selection mode | 10 | 選択モード プロパティ 適用対象: リストボックス 取り得る値: lk none (0) lk single (1) lk multiple (2) |
| lk single click edit | 29 | シングルクリック編集 プロパティ 適用対象: リストボックス 取り得る値: lk no (0) lk yes (1) |
| lk sortable | 20 | ソート可 プロパティ 適用対象: リストボックス 取り得る値: lk no (0) lk yes (1) |
| lk truncate | 12 | エリプシスで省略 プロパティ 適用対象: リストボックスあるいはカラム 取り得る値: lk without ellipsis (0) lk with ellipsis (1) |
| lk ver scrollbar width | 5 | 幅(ピクセル単位) |
| lk current item expression | 38 | カレントの項目 プロパティ 適用対象: リストボックス(コレクション / エンティティセレクション) |
| lk current item pos expression | 39 | カレントの項目の位置 プロパティ 適用対象: リストボックス(コレクション / エンティティセレクション) |
| lk selected items expression | 40 | 選択された項目 プロパティ 適用対象: リストボックス(コレクション / エンティティセレクション) |
*印が付いているプロパティはリストボックスカラム専用のものです。このプロパティ群の定数をリストボックスとともに引数として受け渡すと、LISTBOX Get property は property に指定したプロパティの種類に応じて -1、あるいは空文字列を返します。
通常、無効な結果を表すためには LISTBOX Get property は、数値型の値を持つプロパティに対しては-1 を、または空の文字列を返します。ただしこのときエラーは生成されません。 具体的には次の場合が該当します:
- 存在しない property を渡した場合
- property に受け渡した定数が指定のリストボックスおよびカラムにおいて利用できないプロパティである。例: lk font color expression を配列型リストボックスと一緒に指定した場合
- カラムを引数として渡したが指定した property の適用対象がリストボックスである、あるいは逆にリストボックスを引数として渡したが指定した property の適用対象がカラムである(上記の * 印の注記参照)
また、複数のカラムからの値を同時に返すことはできません。例えば、"@" 記号を利用して複数の類似した名称を持つカラムを一括で指定しようとしても、 LISTBOX Get property は最初に条件に合致したカラムについてのみ、値を返します。そのため、この戻り値は信頼できるものではありません。
Note:
- 定数 lk display footer および lk display header はフォーム上のリストボックスエリアの実サイズを計算するのに便利です。
例題 1
"MyListbox"というリストボックスがあったとき、以下のステートメントを実行すると:
$Value:=LISTBOX Get property(*;"MyListbox";lk selection mode) // 返された値は選択モードを表します
この場合、返される値は複数行が選択可能かどうかを表します。
例題 2
"MyListbox"というリストボックスがある場合、以下のステートメントを実行すると:
$resizable:=LISTBOX Get property(*;"MyListbox";lk column resizable)
LISTBOX Get property は-1を返します。なぜならlk column resizable プロパティはカラムに適用される一方で、引数として渡されたのはリストボックスだからです。
参照
LISTBOX SET GRID
LISTBOX SET PROPERTY
OBJECT SET SCROLLBAR
プロパティ
| コマンド番号 | 917 |
| スレッドセーフ | ✗ |