4D Doc Center : LISTBOX Get array

4D v14.3

LISTBOX Get array


LISTBOX Get array ( {* ;} object ; arrType ) -> 戻り値

引数	型	説明
*	演算子	指定時:objectはオブジェクト名(文字列)省略時:objectは変数
object	フォームオブジェクト	オブジェクト名(* 指定時)、または変数(* 省略時)
arrType	倍長整数	配列のタイプ
戻り値	ポインター	プロパティに関連付けられた配列へのポインター

説明

注: このコマンドは配列型のリストボックスに対してのみ有効です。

LISTBOX Get arrayコマンドは、 object と * によって指定されたリストボックスまたはリストボックスコラムの、スタイルまたは色に関連付けられた配列へのポインターを返します。

スタイル、カラー、背景色の配列は、デザインモードのプロパティリストを使用するか、新しいコマンド LISTBOX SET ARRAY 使用することで配列型のリストボックスと関連付けすることができます。

任意の * 演算子を渡した場合、 object 引数でオブジェクト名を文字列で指定します。省略時には object 引数で変数を指定します。対象がリストボックスなのか列なのかを、 object 引数で指定します。

arrType 引数には、取得したいプロパティの配列の型を渡します。 "List Box" テーマ内にある以下の定数を使用することができます。

定数	型	値
Listbox background color array	倍長整数	1
Listbox font color array	倍長整数	0
Listbox style array	倍長整数	2

戻り値は以下のどれかになります:

要求されたプロパティの配列がそのリストボックスまたは列に関連付けされていない場合、Nilが返ってきます。
ユーザーによって定義されたプロパティの配列へのポインター
LISTBOX SET ROW COLOR や LISTBOX SET ROW FONT STYLE コマンドを使用して設定されたプロパティの配列へのポインター

例題

典型的な使用例:

 vPtr:=LISTBOX Get array(*;"MyLB";Listbox font color array)

  // "MyLB" というリストボックスに関連付けされた

  // フォントカラー配列を返します。

 

 vPtr:=LISTBOX Get array(*;"Col4";Listbox style array)

  // "Col4" リストボックスの列に関連付けされた

  // フォントスタイル配列を返します。