リファレンス > スクリプトステップリファレンス > フィールドに関連するスクリプトステップ > テキストを挿入
 
テキストを挿入
目的 
現在のレコードにあるフィールドまたは変数にテキスト値を貼り付けます。
参照 
構文 
テキストを挿入 [選択 ; <テーブル::フィールド> ; "<テキスト>"]
オプション 
[内容全体を選択] オプションを選択すると、フィールドまたは変数の内容が置き換えられます。このオプションが選択されていない場合、次のようになります。
フィールドの場合、アクティブなフィールドで選択されている部分のみが置き換えられるか、または挿入ポイントにデータが挿入されます。選択されている部分がない場合は、挿入ポイントに結果が挿入されます。デフォルトの挿入ポイントはフィールド内のデータの末尾です。
オブジェクトデータがない変数の場合、変数の現在の値の末尾にデータが挿入されます。オブジェクトデータがある変数の場合、変数の内容が置き換えられます。
[ターゲット] では、貼り付ける情報を受け取るフィールドまたは設定する変数を指定します。変数が存在しない場合は、このスクリプトステップによって変数が作成されます (変数の使用を参照)。
[<テキスト>] は、置き換える正確な値です。
互換性 
 
スクリプトステップを実行する場所 
サポート 
FileMaker Pro 
はい 
FileMaker Server 
はい 
FileMaker Go 
はい 
カスタム Web 公開 
はい 
FileMaker WebDirect 
はい 
Runtime ソリューション 
はい 
起点 
FileMaker Pro 6.0 以前のバージョン
説明 
このスクリプトステップを実行する前に、ターゲット変数を指定するか、現在のレイアウト上でターゲットフィールドを指定するか、フィールドをクリックするか、またはフィールドへ移動 スクリプトステップを使用します。[ターゲット] を指定していない場合は、アクティブなフィールドにデータが配置されます。それ以外の場合は、このスクリプトステップはエラーコードを返します。このエラーコードは Get (最終エラー) 関数を使用して処理することができます。
メモ 
このスクリプトステップは、フィールドタイプにテキストを貼り付けるためのものです。他のフィールドタイプに別のタイプのデータを挿入する場合は、計算結果を挿入 スクリプトステップまたはフィールド設定 スクリプトステップを使用します。
FileMaker WebDirect では、このスクリプトステップを実行する前に手動でフィールドデータを選択した場合でも、スクリプトステップは選択が行われなかった場合と同様に実行されます。FileMaker WebDirect でこのスクリプトステップを実行する前にフィールドデータを選択するには、選択範囲を設定 スクリプトステップを使用します。
例 1 
「ステータス」フィールドに「下書き」を挿入します。
テキストを挿入 [選択; 請求書::ステータス;「下書き」]
例 2 
「支払日」フィールドの値に応じて「支払い済み」または「未払い」のいずれかを挿入します。
If [IsEmpty ( 請求書::支払日 )]
テキストを挿入 [選択; 請求書::ステータス; "未払い"]
Else
テキストを挿入 [選択; 請求書::ステータス; "支払い済み"]
End If
例 3 
「ステータス」フィールドに「下書き」を挿入します。現在のレイアウトに「ステータス」がない場合はダイアログボックスを表示します。
テキストを挿入 [選択; 請求書::ステータス;「下書き」]
If [Get (最終エラー) = 102 ]
カスタムダイアログを表示 ["現在のレイアウトに「ステータス」フィールドがありません"]
End If
関連項目 
スクリプトステップリファレンス (名前順)
スクリプトステップリファレンス (種類順)