4D Doc Center : LISTBOX Get row color

4D v14.3

LISTBOX Get row color


LISTBOX Get row color ( {* ;} object ; row {; colorType} ) -> 戻り値

引数	型	説明
*	演算子	指定時:objectはオブジェクト名(文字列)省略時:objectは変数
object	フォームオブジェクト	オブジェクト名(指定時)、または変数(省略時)
row	倍長整数	列番号
colorType	倍長整数	Listbox font color (デフォルト値) または Listbox background color
戻り値	倍長整数	カラーの値

説明

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

LISTBOX Get row colorコマンドは、 object と * によって指定されたリストボックス内の、行またはセルの色を返します。

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

object がリストボックス全体を指定している場合、コマンドは指定された行の色を返します。
object がリストボックス内の列を指定している場合、コマンドは単一のセルの色を返します。

row 引数にはカラーを取得したい行を番号で指定します。

注: このコマンドは行の表示/非表示の状態は無視します。

colorType 引数には、行の背景色を取得したいのかフォントカラーを取得したいのかによって、 Listbox background color または Listbox font color の定数のどちらかを渡します。省略時は、フォントカラーが返されます。

Warning: 行に割り当てられたカラーであっても、それが全てのセルに配色されるとは限りません(以下の例を参照のこと)。リストボックスまたはリストボックス列に対して矛盾する値がプロパティを使用して設定された場合、4D内部の優先順位が適用されます。詳細な情報に関しては Design Reference マニュアルを参照して下さい。

例題

以下に与えられたリストボックスについて考えます。

 vColor:=LISTBOX Get row color(*;"Col5";3)

 vColor2:=LISTBOX Get row color(*;"List Box";3)

 vColor3:=LISTBOX Get row color(*;"List Box";Listbox background color)

  // vColor contains 0xFFFF00 (yellow)

  // vColor2 contains 0x00FF (blue)

  // vColor3 contains 0x00FF0000 (red)