4D v13.4FORM GET NAMES |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v13.4
FORM GET NAMES
|
FORM GET NAMES ( {aTable ;} arrNames {; filter}{; *} ) | ||||||||
引数 | 型 | 説明 | ||||||
aTable | テーブル |
![]() |
テーブル参照 | |||||
arrNames | テキスト配列 |
![]() |
フォーム名の配列 | |||||
filter | テキスト |
![]() |
名前のフィルター | |||||
* | 演算子 |
![]() |
指定時 = コンポーネントで実行されたとき、コマンドはホストデータベースに適用される (コンポーネントのコンテキスト以外ではこの引数は無視されます) | |||||
FORM GET NAMESコマンドはアプリケーション中のフォーム名をarrNames配列に返します。
aTable引数を渡すと、コマンドはそのテーブルに属するテーブルフォームの名前を返します。この引数を省略するとデータベースプロジェクトフォーム名が返されます。
filter引数に比較文字列を渡すことでフォームのリストを制限できます。この場合、フィルターにマッチする名前を持つフォームだけが返されます。"@"をワイルドカードとして使用することができます。空の文字列を渡した場合、filter引数は無視されます。
コマンドがコンポーネント内で実行された場合、デフォルトではコンポーネントのプロジェクトフォーム名が返されます。* 引数を渡すとホストデータベースのフォーム名を受け取ることができます。
注: ゴミ箱内のフォームは返されません。
典型的な使用例:
// データベース中すべてのプロジェクトフォームを取得
FORM GET NAMES(arr_Names)
// [Employees]テーブルのフォームを取得
FORM GET NAMES([Employees] ;arr_Names)
// [Employees]テーブル中"input_"で始まるフォームを取得
FORM GET NAMES([Employees] ;arr_Names;"input_@")
// データベース中で"dialogue_"から始まるプロジェクトフォームを取得
FORM GET NAMES(arr_Names;"dialogue_@")
// コンポーネントからホストのテーブルフォームを取得
// テーブル名が不明なためポインターを使用
FORM GET NAMES(tablePtr->;arr_Names;*)
プロダクト: 4D
テーマ: デザインオブジェクトアクセス
番号:
1167
初出: 4D v13