LISTBOX SET AUTO ROW HEIGHT

LISTBOX SET AUTO ROW HEIGHT ( {* ;} object ; selector ; value ; unit )

引数	型		説明
*	演算子	→	指定時, Objectはオブジェクト名 (文字列) 省略時, Objectは変数
object	any	→	オブジェクト名 (* 指定時), または 変数 (* 省略時)
selector	Integer	→	設定する高さの値:lk row min height あるいは lk row max height
value	Integer	→	行の高さの最小値、あるいは最大値
unit	Integer	→	高さの値の単位: 0=ピクセル単位、1=行単位

このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。

説明

LISTBOX SET AUTO ROW HEIGHT コマンドは、object 引数および * 引数を使用して指定したリストボックスオブジェクトの行の高さの最小値あるいは最大値を、value 引数で設定します。

注: このコマンドはリストボックスが自動行高モード(自動行高)に設定されている場合にのみ考慮されます。このモードは"コレクションまたはエンティティセレクション"型および"配列型"のリストボックスにおいてのみ利用可能です。そうでない場合には、何の効力も持ちません。

任意のオプションの * 引数を指定した場合、object はオブジェクト名です (文字列) 。オプションの * 引数を省略すると、object は変数です。この場合、文字列ではなく変数参照を指定します。オブジェクト名に関する詳細はオブジェクトプロパティ の節を参照してください。

selector 引数には、設定する値の型を渡します。List Box テーマ内にある、以下の定数のどれか一つを使用することができます:

定数	型	値
lk row max height	倍長整数	33
lk row min height	倍長整数	32

value 引数には、unit 引数で指定した単位に適切な範囲で対応する値を渡します。

unit 引数はList Box テーマ内にある、以下の定数のどれか一つを使用することができます:

定数	型	値	コメント
lk lines	倍長整数	1	高さを行数で指定。4Dはフォント設定に応じて高さを計算します。
lk pixels	倍長整数	0	高さをピクセルで指定 (デフォルト)。

注: コマンドは最小値と最大値の整合性をチェックしません。しかしながら、ランタイムにおいて、最小値と最大値の矛盾があった場合には、最小値が両方の値に対して適用されます。例えば、最小値が5行であり、最大値が3行であった場合、そろリストボックスの行に適用される最大の高さは、5行となります。

例題

自動行高が設定されているリストボックスに対して、最小値と最大値を設定したい場合を考えます:

 LISTBOX SET AUTO ROW HEIGHT(*;"LB";lk row min height;60;lk pixels) // 最小値に60ピクセル
 LISTBOX SET AUTO ROW HEIGHT(*;"LB";lk row max height;100;lk pixels) //最大値に100ピクセル

参照

LISTBOX Get auto row height
LISTBOX SET ROW HEIGHT
LISTBOX SET ROWS HEIGHT