# legend

Ajoute une légende aux axes.

## 📝 Syntaxe

* legend()
* legend(label1, ..., labelN)
* legend(labels)
* legend('off')
* legend('hide')
* legend('show')
* legend('toggle')
* legend('boxon')
* legend('boxoff')
* legend(ax, ...)
* legend(..., 'Location', lcn)
* legend(..., propertyName, propertyValue)
* L = legend(...)

## 📥 Argument d'entrée

* label1, ..., labelN - Définit les étiquettes de la légende : vecteurs ligne de caractères.
* labels - Cellule de vecteurs de caractères ou tableau de chaînes.
* 'off' - Supprime la légende.
* 'toggle' - Active/désactive la visibilité de la légende.
* 'hide' - Masque la légende.
* 'show' - Affiche la légende.
* 'boxon' - Affiche un encadré autour de la légende.
* 'boxoff' - Masque l'encadré autour de la légende.
* ax - Axes à rendre courant.
* lcn - Emplacement de la légende : une chaîne ('NE' par défaut).
* propertyName - Une chaîne scalaire ou un vecteur ligne de caractères.
* propertyValue - Une valeur.

## 📤 Argument de sortie

* L - Un objet graphique : type axes.

## 📄 Description

legend crée une légende dans la figure courante.

Emplacement de la légende sur le graphique :

'northeast' ou 'NE' : En haut à droite (par défaut).

'north' ou 'N' : En haut au centre.

'south' ou 'S' : En bas au centre.

'east' ou 'E' : Au milieu à droite.

'west' ou 'W' : Au milieu à gauche.

'northwest' ou 'NW' : En haut à gauche.

'southeast' ou 'SE' : En bas à droite.

'southwest' ou 'SW' : En bas à gauche.

## 💡 Exemple

```matlab
f = figure();
x = linspace(0,10);
y1 = sin(x);
y2 = cos(x);
ax = gca();
plot(ax, x, y1);
plot(ax, x, y2);
legend('sin(x)', 'cos(x)', 'Location', 'N')
```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-527d72c90577b80ff4c2d0371a0b1a1a3227a81c%2Flegend.svg?alt=media)

## 🔗 Voir aussi

[title](https://nelson-9.gitbook.io/Nelson/markdown/fr/graphics/title), [text](https://nelson-9.gitbook.io/Nelson/markdown/fr/graphics/text), [plot](https://nelson-9.gitbook.io/Nelson/markdown/fr/graphics/plot).

## 🕔 Historique

| Version | 📄 Description   |
| ------- | ---------------- |
| 1.0.0   | version initiale |
