| 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