# get_figure_handle

Retorna o manipulador de uma figura a partir de seu id

## Seqüência de Chamamento

    f = get_figure_handle(figure_id)

## Parâmetros

figure_id

  inteiro, o id da figura a ser recuperada

f

  o manipulador da figura correspondente

## Descrição

`get_figure_handle` permite recuperar o manipulador de uma figura gráfica desde que se conheça o seu identificador. Se uma figura com o id especificado existir, ela é retornada. Em caso contrário, uma matriz vazia é retornada.

## Exemplos

    // criando algumas figuras
    scf(0);
    scf(5);
    scf(12);

    // obtendo o manipulador da figura com id 5
    f5 = get_figure_handle(5);
    // a figura corrente ainda é aquela com id 12
    gcf()
    // obtendo uma figura inexistente
    f42 = get_figure_handle(42);

## Ver Também

- set
- get
- gcf
- scf
- graphics_entities