# Boîte de dialogue Modifier le script

## Présentation

La boîte de dialogue Modifier le script s’ouvre lorsque la cellule de la feuille de calcul contenant la fonction Script est entrée et est utilisée pour créer, modifier et tester le code source JavaScript. Par défaut, à la première ouverture de la boîte de dialogue Modifier le script, un exemple de script et des arguments sont chargés. L’exemple de script peut être utilisé comme modèle de création de scripts personnalisés.

Remarque : Pour plus d’informations sur la modification et l’écriture de scripts, accédez à la fonction Script et consultez la rubrique Fonctions de script.

## Affichage de la boîte de dialogue Modifier le script

Il existe deux méthodes pour afficher la boîte de dialogue Modifier le script :

- Ajoutez une fonction Script dans une cellule vide.
- Effectuez un double-clic sur une fonction Script existante.

## Volets et contrôles de la boîte de dialogue Modifier le script

La boîte de dialogue Modifier le script est composée de trois volets différents : Zone de texte Arguments, Éditeur de code et Dernier résultat.

En plus des volets, la boîte de dialogue Modifier le script contient les éléments de menu et les boutons de contrôle suivants :

- Script : Permet d’accéder à diverses actions pour modifier le script :

  - Tester le script : Exécute le script. (Exécute la même action que le bouton Tester le script.)
  - Importer le script : Ouvre la boîte de dialogue Importer le script, qui affiche tous les fichiers de script enregistrés (désignés par l’extension de fichier .js). L’importation d’un script remplace le script actuel dans l’éditeur de code.
  - Exporter le script : Ouvre la boîte de dialogue Exporter le script pour enregistrer un fichier script (avec l’extension de fichier .js).
  - Annuler les changements : Restaure l’état initial du script, avant l’ouverture de la boîte de dialogue Modifier le script.
  - Fermer : Ferme la boîte de dialogue Modifier le script. Le logiciel vous demande si vous voulez enregistrer les modifications apportées.

- Modifier : Permet de modifier le code source dans l’Éditeur de code à l’aide de plusieurs actions :

  - Annuler : Annule la dernière modification apportée au script dans l’éditeur de code.
  - Rétablir : Rétablit la dernière modification annulée dans l’éditeur de code.
  - Copier : Copie, dans le presse-papiers, le texte sélectionné dans l’éditeur de code.
  - Couper : Coupe et copie, dans le presse-papiers, le texte sélectionné dans l’éditeur de code.
  - Coller : Colle le contenu du presse-papiers dans l’éditeur de code.
  - Rechercher : Ouvre l’onglet Rechercher de la boîte de dialogue Rechercher et remplacer, pour repérer du texte dans le code.
  - Remplacer : Ouvre l’onglet Remplacer de la boîte de dialogue Rechercher et remplacer, pour repérer du texte dans le code et le remplacer par un autre texte.
  - Atteindre : Ouvre la boîte de dialogue Atteindre la ligne, permettant d’accéder directement à un numéro de ligne spécifique dans le code.
- Tester le script : Applique le code source JavaScript actuel à la cellule contenant la fonction, et exécute la cellule et toutes ses dépendances.
- Enregistrer : Applique le code source JavaScript actuel à la cellule contenant la fonction, exécute la cellule et toutes ses dépendances, et ferme la boîte de dialogue.
- Annuler : Restaure l’état initial de la cellule, avant l’ouverture de la boîte de dialogue Modifier le script.

## Zone de texte Arguments

Le volet Arguments affiche les arguments d’entrée utilisés par la fonction Script, modifiables directement dans la zone de texte. Les arguments du script sont enregistrés lors de l’enregistrement du script.

## Éditeur de code

L’éditeur de code affiche le code source JavaScript et permet de créer et de modifier des scripts. L’éditeur comporte la coloration syntaxique, des numéros de ligne et des fonctionnalités de base d’édition de texte (annuler/rétablir, copier/couper/coller, par exemple).

Remarque :

- Si aucun texte n’est sélectionné et que l’opération Couper est appelée, la ligne entière où se trouve le curseur est coupée.
- Le langage JavaScript prend en charge et utilise les caractères Unicode : ces derniers sont pris en charge dans l’éditeur de code. Par conséquent, la plupart des caractères internationaux peuvent être insérés dans le code JavaScript. Les chaînes transmises aux fonctions Script comme arguments et renvoyées par les fonctions Script et Get peuvent également contenir des caractères Unicode.

- Sortie de la console : Le volet Sortie affiche les messages de journal envoyés à l’objet console pour tous les scripts.
  Pour afficher le volet Sortie, cliquez sur Sortie dans le menu Affichage.

## Raccourcis

Dans l’éditeur de code, les raccourcis suivants sont disponibles :

- Ctrl + A : Sélectionne tout le texte dans le code.
- Ctrl + C : Copie le texte sélectionné.
- Ctrl + F : Ouvre l’onglet Rechercher de la boîte de dialogue Rechercher et remplacer, pour repérer des instances de valeurs dans le code.
- Ctrl + G : Ouvre la boîte de dialogue Atteindre la ligne, permettant d’accéder directement à un numéro de ligne spécifique dans le code.
- Ctrl + H : Ouvre l’onglet Remplacer de la boîte de dialogue Rechercher et remplacer, pour repérer des instances de valeurs dans le code et les remplacer par d’autres valeurs.
- Ctrl + L : Supprime la ligne où se trouve le curseur.
- Ctrl + V : Colle le texte sélectionné.
- Ctrl + T : Échange le caractère où se trouve le curseur et le caractère qui le suit.
- Ctrl + W : Sélectionne le mot à côté de l’emplacement du curseur.
- Ctrl + X : Coupe le texte sélectionné et le copie dans le presse-papiers.
- Ctrl + Z : Annule la dernière action.

## Dernier résultat

Le volet Derniers résultats affiche la dernière valeur renvoyée par la fonction run() du script. Appuyez sur le bouton Tester le script pour actualiser la valeur affichée.