Método ID3DXFont::D rawText

Desenha texto formatado. Esse método dá suporte a cadeias de caracteres ANSI e Unicode.

Sintaxe

INT DrawText(
  [in] LPD3DXSPRITE pSprite,
  [in] LPCTSTR      pString,
  [in] INT          Count,
  [in] LPRECT       pRect,
  [in] DWORD        Format,
  [in] D3DCOLOR     Color
);

Parâmetros

pSprite [in]

Tipo: LPD3DXSPRITE

Ponteiro para um objeto ID3DXSprite que contém a cadeia de caracteres. Pode ser NULL; nesse caso, o Direct3D renderizará a cadeia de caracteres com seu próprio objeto sprite. Para melhorar a eficiência, um objeto sprite deverá ser especificado se DrawText for chamado mais de uma vez em uma linha.

pString [in]

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres a ser desenhada. Se o parâmetro Count for -1, a cadeia de caracteres deverá ser terminada em nulo.

Contagem [in]

Tipo: INT

Especifica o número de caracteres na cadeia de caracteres. Se Count for -1, o parâmetro pString será considerado um ponteiro para uma cadeia de caracteres terminada em nulo e DrawText calculará a contagem de caracteres automaticamente.

pRect [in]

Tipo: LPRECT

Ponteiro para uma estrutura RECT que contém o retângulo, em coordenadas lógicas, em que o texto deve ser formatado. O valor da coordenada do lado direito do retângulo deve ser maior que o do lado esquerdo. Da mesma forma, o valor da coordenada da parte inferior deve ser maior que o da parte superior.

Formatar [in]

Tipo: DWORD

Especifica o método de formatação do texto. Pode ser qualquer combinação dos valores seguintes:

Valor	Significado
DT_BOTTOM	Justifica o texto na parte inferior do retângulo. Esse valor deve ser combinado com DT_SINGLELINE.
DT_CALCRECT	Determina a largura e a altura do retângulo. Se houver várias linhas de texto, DrawText usará a largura do retângulo apontado pelo parâmetro pRect e estenderá a base do retângulo para associar a última linha de texto. Se houver apenas uma linha de texto, DrawText modificará o lado direito do retângulo para que ele limite o último caractere na linha. Em ambos os casos, DrawText retorna a altura do texto formatado, mas não desenha o texto.
DT_CENTER	Centraliza o texto horizontalmente no retângulo.
DT_EXPANDTABS	Amplia os caracteres da guia. O número padrão de caracteres por guia é oito.
DT_LEFT	Alinha o texto à esquerda.
DT_NOCLIP	Desenha sem recorte. DrawText é um pouco mais rápido quando DT_NOCLIP é usado.
DT_RIGHT	Alinha o texto à direita.
DT_RTLREADING	Exibe texto na ordem de leitura da direita para a esquerda para texto bidirecional quando uma fonte hebraica ou árabe é selecionada. A ordem de leitura padrão para todo o texto é da esquerda para a direita.
DT_SINGLELINE	Exibe texto somente em uma única linha. Retornos de carro e alimentações de linha não quebram a linha.
DT_TOP	A parte superior justifica o texto.
DT_VCENTER	Centraliza o texto verticalmente (somente linha única).
DT_WORDBREAK	Quebra palavras. As linhas serão divididas automaticamente entre palavras se uma palavra se estender além da borda do retângulo especificada pelo parâmetro pRect. Uma sequência de retorno de carro/alimentação de linha também quebra a linha.

 

Cor [in]

Tipo: D3DCOLOR

Cor do texto. Para obter mais informações, consulte D3DCOLOR.

Valor retornado

Tipo: INT

Se a função for bem-sucedida, o valor retornado será a altura do texto em unidades lógicas. Se DT_VCENTER ou DT_BOTTOM for especificado, o valor retornado será o deslocamento de pRect (de cima para baixo) do texto desenhado. Se a função falhar, o valor retornado será zero.

Comentários

Os parâmetros desse método são muito semelhantes aos da função DrawText GDI.

Esse método dá suporte a cadeias de caracteres ANSI e Unicode.

Esse método deve ser chamado dentro de um BeginScene ... Bloco EndScene . A única exceção é quando um aplicativo chama DrawText com DT_CALCRECT para calcular o tamanho de um determinado bloco de texto.

A menos que o formato de DT_NOCLIP seja usado, esse método corta o texto para que ele não apareça fora do retângulo especificado. Supõe-se que toda a formatação tenha várias linhas, a menos que o formato DT_SINGLELINE seja especificado.

Se a fonte selecionada for muito grande para o retângulo, esse método não tentará substituir uma fonte menor.

Esse método dá suporte apenas a fontes cujo escape e orientação são zero.

Requisitos

Requisito	Valor
parâmetro	D3dx9core.h
Biblioteca	D3dx9.lib

Confira também

ID3DXFont