get_figure_handle Retorna o manipulador de uma figura a partir de seu id (obsolete)

## 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

This function is obsolete and will be removed in Scilab 6.1.x. Please use findobj("figure_id",n) instead.

`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

## Histórico

6.1.0 get_figure_handle(n) is declared obsolete. findobj("figure_id",n) is used instead.