4D v14.3

LISTBOX INSERT COLUMN FORMULA

ホーム

 
4D v14.3
LISTBOX INSERT COLUMN FORMULA

LISTBOX INSERT COLUMN FORMULA 


 

LISTBOX INSERT COLUMN FORMULA ( {* ;} object ; colPosition ; colName ; formula ; dataType ; headerName ; headerVariable {; footerName ; footerVar} )  
引数   説明
演算子 in 指定時, objectはオブジェクト名 (文字列) 省略時, objectは変数
object  フォームオブジェクト in オブジェクト名 (* 指定時) または 変数 (* 省略時)
colPosition  倍長整数 in 列挿入位置
colName  文字 in 列オブジェクト名
formula  文字 in 列に関連付ける4Dフォーミュラ
dataType  倍長整数 in フォーミュラの結果型
headerName  文字 in 列ヘッダーオブジェクト名
headerVariable  整数変数 in 列ヘッダー変数
footerName  文字 in 列フッターオブジェクト名
footerVar  変数 in 列フッター変数

説明   

LISTBOX INSERT COLUMN FORMULAコマンドは、object引数および * で指定されたリストボックスに列を挿入します。

LISTBOX INSERT COLUMN FORMULAコマンドはLISTBOX INSERT COLUMNコマンドと同様の動作を行いますが、列のコンテンツとしてフォーミュラを指定可能な点が異なります。

このタイプのコンテンツはリストボックスの"データソース"プロパティがカレントセレクションまたは命名セレクションに設定されている場合にのみ使用できます (この点に関する詳細はリストボックスオブジェクトの管理を参照してください)。

注: このコマンドは階層モードで表示されているリストボックスの最初の列に適用されてもなにも行いません。

オプションの引数 * を渡すことにより、object引数がオブジェクト名(文字列)であることを示します。この引数を渡さない場合、object引数が変数であることを示します。この場合、文字列ではなく変数参照を指定します。オブジェクト名についての詳細はオブジェクトプロパティを参照してください。

新しい列は、colPosition引数で指定された列の直前に挿入されます。colPosition引数の値が列の合計数よりも大きい場合、最後の列の後ろにカラムが追加されます。

colName 引数には挿入する列のオブジェクト名を渡します。

formula 引数には有効なフォーミュラを渡します。例えば:

  • 命令
  • フォーミュラエディタで生成したフォーミュラ
  • 4D コマンドの呼び出し
  • プロジェクトメソッドの呼び出し

コマンドが呼び出される際、formulaは解析・実行されます。

注: フォーミュラが4Dコマンドを呼び出す場合、アプリケーションのローカライズの影響を受けないようにするため、Command nameを使用してください。

dataType 引数は、フォーミュラを実行した結果の型を指定するために使用します。Field and Variable Typesテーマの以下の定数の1つを渡さなければなりません:

定数
Is Boolean 倍長整数 6
Is date 倍長整数 4
Is picture 倍長整数 3
Is real 倍長整数 1
Is text 倍長整数 2
Is time 倍長整数 11

formula の結果が期待するデータ型に対応しない場合、エラーが生成されます。

headerNameheaderVarには、挿入される列のヘッダーのオブジェクト名および変数を渡します。

footerNamefooterVarにも、挿入される列のフッターのオブジェクト名および変数を渡すことができます。

注: オブジェクト名は、フォーム内で重複してはいけません。colNameheaderNamefooterNameに渡される名前が既に使用されていないことを確認してください。重複した名前を指定すると、列は作成されず、エラーが生成されます。

例題  

リストボックスの右に列を追加し、従業員の年齢を計算するフォーミュラを関連付けます:

 vAge:="Today's Date-[Employees]BirthDate)\365"
 $last:=Get number of listbox columns(*;"ListBox1")+1
 LISTBOX INSERT COLUMN FORMULA(*;"ListBox1";$last;"ColFormula";vAge;Is real;"Age";HeaderVar)

 
プロパティ 

プロダクト: 4D
テーマ: リストボックス
番号: 970

 
履歴 

初出: 4D v11 SQL
名称変更: 4D v12
変更: 4D v13

 
参照 

LISTBOX INSERT COLUMN

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v13.5)
ランゲージリファレンス ( 4D v14.3)

Inherited from : LISTBOX INSERT COLUMN FORMULA ( 4D v12.4)
Parent of : LISTBOX INSERT COLUMN FORMULA ( 4D v14 R3)