# xlfont

carrega uma fonte em um contexto gráfico ou pergunta a fonte carregada

## Seqüência de Chamamento

    xlfont(font-name)
                xlfont(font-filename)
                xlfont('reset')
                xlfont(font-name,font-id)
                xlfont(font-filename,font-id)
                xlfont(font-name,font-id,bold)
                xlfont(font-name,font-id,bold,italic)
                fonts=xlfont('AVAILABLE_FONTS')
                fonts=xlfont()

## Parâmetros

font-name

  string, nome da família da fonte

font-filename

  string, nome do arquivo de uma fonte true type

font-id

  inteiro >= 0 .

fonts

  um vetor coluna de nomes de fontes

bold

  um booleano, %t para negrito

italic

  um booleano, %t para itálico

## Descrição

Sem argumentos, `xlfont()` retorna a lista das fontes correntemente carregadas.

xlfont('AVAILABLE_FONTS') retorna a lista de fontes disponíveis no seu sistema.

xlfont('reset') reajusta para o índice de fontes inicial.

Com argumentos, `xlfont` é usado para carregar uma nova fonte em tamanhos diferentes no contexto gráfico.

As famílias de fonte padrões são "Monospaced" (0), "Symbol" (1), "Serif" (2), "Serif Italic" (3), "Serif Bold" (4), "Serif Bold Italic" (5), "SansSerif" (6), "SansSerif Italic" (7), "SansSerif Bold" (8), "SansSerif Bold Italic" (9). Estas fontes são automaticamente carregadas quando necessário, então `xlfont` não é necessariamente requerido para elas. Na verdade `xlfont` é essencialmente útil para carregar uma nova fonte.

## Exemplos

    xlfont('reset');
    xlfont()

    // este exemplo pode não funcionar se seu sistema não possuir a fonte Monospaced.
    xlfont("Monospaced",10,%t,%t);
    xstring(1,0,'A title');
    figure_entity = gcf();
    axes_entity = figure_entity.children;
    title_entity = axes_entity.children;
    title_entity.font_style = 10;

    xlfont()

    xlfont(SCI+'/thirdparty/fonts/scilabsymbols.ttf')
    title_entity.font_style = 11; // utilizando a fonte scilabsymbols.ttf
    title_entity.font_size  = 4; // tamanho da fonte scilabsymbols.ttf

    xlfont()

    xlfont('reset');

## Ver Também

- getfont