# Set String (文字列を設定)

セルに含まれている編集ボックスコントロールを、指定した文字列に設定します。編集ボックスは、EditString タイプである必要があります。

注: EditString の上限を超える文字列を含む Set String (文字列を設定) コマンドを送信した場合、コマンドの戻り値が送信の成功を示す 1 であっても、セルは更新されません。ネイティブモードコマンドは、最小値、最大値、値、文字列制限などセル固有の制限の影響を受けません。

## Set String (文字列を設定) の入力

シンタックス:SS[タグ名][スペース][テキスト]

## Set String (文字列を設定) の出力

ステータスコード | 説明
--- | ---
1 | コマンドは正常に実行されました。
0 | 認識されないコマンドが送信されました。
-1 | タグ名が無効です。
-2 | 入力文字列が、EditString 関数で指定されている文字列の最大長を超えているか、セルに EditString 関数が含まれていません。
-3 | 読み取り専用タグを設定できません。
-4 | 引数の型が正しくありません。
-6 | ユーザはコマンドを実行するためのフルアクセスのアクセス権を持っていません。

## Set String (文字列を設定) の例

1. セル B2 には、次が格納されていると仮定します。

   B2 = EditString(20)

   セル B2 は、Math_1_A1 という名前で公開されています。

   EditString コントロールには、現在、Before SS というテキストが含まれています。Easy Builder には次のように表示されます。

2. Set String (文字列を設定) ネイティブモードコマンドを使用して、このテキストを After SS に変更するには、次の Telnet クライアントウィンドウに示すように、コマンド SSMath_1_A1 After SS を発行します。

   In-Sight センサは、1 を返すことにより、コマンドが正常に実行されたことを示します。EditString コントロールは、Before SS から After SS に正常に変更されました。