NewGraph

• Utilisation: NewGraph(<chaine1>,<chaine2>[,<code>]).

• Description: cette fonction crée un élément graphique Utilisateur ayant pour nom: <chaine1> et défini par la commande: <chaine2>. Les deux arguments sont donc interprétés comme des chaînes de caractères. Cette fonction renvoie la valeur Nil. S'il existait déjà un élément graphique portant le même nom, alors celui-ci est écrasé. Cette fonction s'appelle aussi Creer. L'élément graphique est créé mais non dessiné, c'est la fonction ReDraw() qui permet de mettre l'affichage à jour.

  Le troisième paramètre <code> est un entier positif (optionnel), un clic gauche avec la souris sur l'élément graphique créé dans la liste des éléments graphiques, provoquera l'exécution de la macro spéciale ClicGraph(<code>), cette macro n'existe pas par défaut et peut-être créée par l'utilisateur, elle est utilisée en particulier dans le fichier modèle Mouse3.mod (dessin à la souris).

• Exemple(s): voici une macro ClicG() permettant la création "à la volée" de labels, on a créé auparavant une variable globale num initialisée à 1:

  Si(Input("Label="),
      [NewGraph( ["Label",num], ["Label(", %1,",", """",chaine(),""")"]), 
       ReDraw(), Inc(num,1)]
     )
  

  Supposons que l'utilisateur clique sur le point d'affixe 1+i, alors une fenêtre de dialogue s'ouvre avec le message Label= et une ligne de saisie à remplir. Supposons que l'utilisateur entre la chaîne Test et valide, alors la macro va créer un élément graphique utilisateur portant le nom Label1 et défini par la commande Label(1+i,"Test").

  On peut aussi utiliser la macro prédéfinie NewLabel et définir la macro ClicG() en écrivant simplement: NewLabel(%1) .