# get_figure_handle

Retrouve une figure graphique à partir de son identifiant.

## Séquence d'appel

    f = get_figure_handle(figure_id)

## Paramètres

figure_id

  Entier, identifiant de la figure à retrouver.

f

  Handle de la figure correspondante.

## Description

La function `get_figure_handle` permet de retrouver le handle d'une figure graphique à partir de son identifiant. Si une figure avec l'identifiant spécifié en argument existe, alors elle est renvoyée par la fonction. Sinon, la fonction renvoie une matrice vide.

## Exemples

    // Création de quelques figures.
    scf(0);
    scf(5);
    scf(12);

    // Recherche de la figure dont l'identifiant est 5.
    f5 = get_figure_handle(5);
    // La figure courante est toujours celle d'identifiant 12.
    gcf()
    // Essaie de retrouver une figure qui n'existe pas.
    f42 = get_figure_handle(42);

## Voir aussi

- set
- get
- gcf
- scf
- graphics_entities