# title

Exibe um título em uma janela gráfica

## Seqüência de Chamamento

    title(my_title)
                title(my_title,<Property>)
                title(<axes_handle>,<my_title>,<Property>)

## Parâmetros

my_title

  string, o título a ser exibido

<Property>

  argumento opcional, representa um par de declarações `{PropertyName,PropertyValue}`que definem propriedades de objetos globais aplicadas o título criado.

<axes_handle>

  este argumento opcional força o título a parecer dentro dos eixos selecionados dados por `axes_handle` ao invés dos eixos correntes (ver gca).

## Descrição

`title` exibe um título numa janela de gráficos.

Os argumentos Property (propriedade) devem ser usados para customizar o título. Aqui está uma lista completa das opções disponíveis.

Property :

  `backgroundcolor :` este campo contém a cor utilizada para preencher a caixa, se houver. Seu valor deve ser um índice de cor (relativo ao mapa de cores corrente).

  `color :` este campo contém a cor a ser utilizada para exibir o texto de título. Seu valor deve ser um índice de cor (relativo ao mapa de cores corrente).

  `edgecolor :`este campo contém a cor usada para exibir a linha ao redor da caixa, se houver alguma. Seu valor deve ser um índice de cor (relativo ao mapa de cores corrente).

  `fontname :` sete fontes diferentes estão disponíveis: "Courrier", "Symbol", "Times", "Times Italic", "Times Bold", "Definida pelo Usuário". A propriedade font_size é um índice no intervalo [0 6] que é associado a um dos nomes anteriores.

  `fontsize :` a propriedade é utilizada para selecionar o tipo de tamanho do título. Seu valor deve ser um inteiro entre 0 e 5 que significa 8pt, 10pt, 12pt, 14pt, 18pt e 24pt.

  `position :` este vetor 2d permite que você posicione manualmente o título na tela. A posição é armazenada nas unidades de dados dos eixos.

  `rotation :` escalar que permite que você gire o título. A fonte é girada em sentido anti-horário com o ângulo dado em graus.

  `visible :` este campo contém o valor da propriedade visible para o título. Pode ser "on" ou "off". Por padrão, o título é visível, a propriedade é "on" . Se "off" , o título não é exibido na tela.

## Exemplos

    // exibindo um título com várias propriedades
    title('meu título');
    // mudando a cor de fonte do título
    title('meu título','color','blue');
    // mudando a cor ao redor da caixa
    title('meu título','edgecolor','red');
    // mudando a posição do título
    title('meu título','position',[0.3 0.8]);
    // mudando o tamanho da fonte
    title('meu título','fontsize',3);
    // dando uma rotação
    title('meu título','rotation',90);

    // podemos realizar todas essas modificações apenas pela instrução abaixo:
    title('meu título','color','blue','edgecolor','red','fontsize',3,'rotation',90,'position',[0.3 0.8]);

## Ver Também

- label_properties
- titlepage
- xtitle