# [スクリプトの編集] ダイアログ

## 概要

[スクリプトの編集] ダイアログは、スクリプト 関数が含まれているスプレッドシートセルに入力を行ったり、このセルを使用して JavaScript ソースコードを作成、編集、テストしたりする場合に表示されます。デフォルトでは、[スクリプトの編集] ダイアログを初めて開く際、サンプルスクリプトと引数がロードされます。このサンプルスクリプトは、カスタムスクリプトを作成するためのテンプレートとして使用できます。

注 : スクリプトの編集および記述については、スクリプト 関数のトピックおよび「スクリプト関数」トピックを参照してください。

## [スクリプトの編集] ダイアログを表示するには

[スクリプトの編集] ダイアログを開くには 2 つの方法があります。

- Script 関数を空のセルに追加します。
- 既存の Script 関数をダブルクリックします。

## [スクリプトの編集] ダイアログのペインとコントロール

[スクリプトの編集] ダイアログは、[引数] テキストボックス、[コードエディタ]、[最終結果] の 3 つのペインで構成されています。

これらのペインに加え、[スクリプトの編集] ダイアログには、以下のメニュー項目およびボタンコントロールが含まれています。

- [スクリプト]:さまざまな操作を使用してスクリプトを修正できます。

  - [スクリプトのテスト]:スクリプトを実行します。([スクリプトのテスト] ボタンと同じ操作が実行されます。)
  - [スクリプトのインポート]:保存済みのスクリプトファイル (.js ファイル拡張子が付いています) が表示される [スクリプトのインポート] ダイアログが開きます。スクリプトをインポートすると、[コードエディタ] の現在のスクリプトが置き換えられます。
  - [スクリプトのエクスポート]:スクリプトファイルを (.js ファイル拡張子を付けて) 保存するための [スクリプトのエクスポート] ダイアログを開きます。
  - [変更を元に戻す]:スクリプトを、[スクリプトの編集] ダイアログを開く前の状態に復元します。
  - [閉じる]:[スクリプトの編集] ダイアログを閉じます。変更を行った場合は、ダイアログを閉じる前に変更を保存するように求めるメッセージが表示されます。

- [編集]:さまざまな操作を使用して [コードエディタ] でソースコードを修正できます。

  - [取り消し]:[コードエディタ] を使用してスクリプトに対して直前に行った変更を取り消します。
  - [やり直し]:[コードエディタ] を使用してスクリプトに対して行った直前の変更の取り消しをやり直します。
  - [コピー]:[コードエディタ] で選択しているテキストをクリップボードにコピーします。
  - [切り取り]:[コードエディタ] で選択したテキストを切り取ってクリップボードにコピーします。
  - [貼り付け]:クリップボードの内容を [コードエディタ] に貼り付けます。
  - [検索]:[検索と置換] ダイアログの [検索] タブを起動し、コード内のテキストを検索します。
  - [置換]:[検索と置換] ダイアログの [置換] タブを起動し、コード内のテキストを検索し、他のテキストに置換します。
  - [進む]:[ラインへ移動] ダイアログを起動します。このダイアログを使用すると、コード内の特定の行番号に移動できます。
- [スクリプトのテスト]:現在の JavaScript ソースコードを、関数を含んでいるセルに適用し、このセルとその依存関係を実行します。
- [保存]:現在の JavaScript ソースコードを、関数を含んでいるセルに適用し、セルとその依存関係を実行してダイアログを閉じます。
- [キャンセル]:セルを、[スクリプトの編集] ダイアログを開く前の状態に復元します。

## [引数] テキストボックス

[引数] ペインには、Script 関数に対するスクリプト入力引数が表示されます。引数はこのテキストボックスから直接編集できます。スクリプトを保存すると、スクリプト引数も保存されます。

## [コードエディタ]

[コードエディタ] には JavaScript のソースコードが表示され、スクリプトを作成したり編集したりできます。[コードエディタ] には､構文のハイライト、行番号および基本的なテキスト編集機能 (取り消し/やり直し、コピー/切り取り/貼り付けなど) が用意されています。

注 :

- テキストを選択していない状態で切り取り操作を呼び出すと、カーソルが置かれている行全体が切り取られます。
- JavaScript 言語では Unicode 文字がサポートされて使用されます。[コードエディタ] では、Unicode 文字がサポートされています。したがって、ほとんどの国際文字を JavaScript コードに挿入できます。Script 関数に引数として渡され、Script 関数と Get 関数から返される文字列には、Unicode 文字を含めることもできます。

- [コンソール出力]:出力 ペインには、すべてのスクリプトのコンソールオブジェクトに送信されたログ記録済みメッセージが表示されます。
  出力 ペインを表示するには、[表示] メニューから [出力] を選択します。

## ショートカット

[コードエディタ] では、次のショートカットを使用できます。

- Ctrl + A:コード内のすべてのテキストを選択します。
- Ctrl + C:選択したテキストをコピーします。
- Ctrl + F:[検索と置換] ダイアログの [検索] タブを起動し、コード内の値のインスタンスを検索します。
- Ctrl + G:[ラインへ移動] ダイアログを起動します。このダイアログを使用すると、コード内の特定の行番号に移動できます。
- Ctrl + H:[検索と置換] ダイアログの [置換] タブを起動し、コード内の値のインスタンスを検索し、代替値に置換します。
- Ctrl + L:カーソルが置かれている行を削除します。
- Ctrl + V:コピーしたテキストを貼り付けます。
- Ctrl + T:カーソルが置かれている文字を、その後の文字と置き換えます。
- Ctrl + W:カーソル位置の横にある単語を選択します。
- Ctrl + X:選択したテキストを切り取ってクリップボードにコピーします。
- Ctrl + Z:直前に実行された操作を取り消します。

## [最終結果]

[最終結果] ペインには、スクリプトの run() 関数によって返された最終値が表示されます。[スクリプトのテスト] ボタンを押すと、表示された値が更新されます。