Método ID3DX10Font::D rawText

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

Sintaxe

INT DrawText(
  [in] LPD3DX10SPRITE pSprite,
  [in] LPCTSTR        pString,
  [in] INT            Count,
  [in] LPRECT         pRect,
  [in] UINT           Format,
  [in] D3DXCOLOR      Color
);

Parâmetros

pSprite [in]

Tipo: LPD3DX10SPRITE

Ponteiro para um objeto ID3DX10Sprite que contém a cadeia de caracteres que você deseja desenhar. 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 ID3DX10Font::D rawText for chamado mais de uma vez em uma linha.

pString [in]

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres a ser desenhada. Se UNICODE for definido, esse tipo de parâmetro será resolvido para um LPCWSTR; caso contrário, o tipo será resolvido para um LPCSTR. Se o parâmetro Count for -1, a cadeia de caracteres deverá ser terminada em NULL .

Contagem [in]

Tipo: INT

O número de caracteres na cadeia de caracteres. Se Count for -1, o parâmetro pString será considerado um ponteiro para um sprite que contém uma cadeia de caracteres terminada em NULL e ID3DX10Font::D rawText computa 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. Assim como acontece com qualquer objeto RECT, 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: UINT

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

Item	Descrição
DT_BOTTOM	Justifique o texto na parte inferior do retângulo. Esse valor deve ser combinado com DT_SINGLELINE.
DT_CALCRECT	Diga a DrawText para calcular automaticamente a largura e a altura do retângulo com base no comprimento da cadeia de caracteres que você diz para desenhar. Se houver várias linhas de texto, ID3DX10Font::D rawText 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, ID3DX10Font::D rawText modificará o lado direito do retângulo para que ele limite o último caractere na linha. Em ambos os casos, ID3DX10Font::D rawText retorna a altura do texto formatado, mas não desenha o texto.
DT_CENTER	Centralize o texto horizontalmente no retângulo.
DT_EXPANDTABS	Expanda caracteres de tabulação. O número padrão de caracteres por guia é oito.
DT_LEFT	Alinhe o texto à esquerda.
DT_NOCLIP	Desenhar sem recorte. ID3DX10Font::D rawText é um pouco mais rápido quando DT_NOCLIP é usado.
DT_RIGHT	Alinhe o texto à direita.
DT_RTLREADING	Exiba o texto na ordem de leitura da direita para a esquerda para texto bidirecional quando uma fonte hebraica ou árabe estiver selecionada. A ordem de leitura padrão para todo o texto é da esquerda para a direita.
DT_SINGLELINE	Exibir texto apenas em uma única linha. Retornos de carro e alimentações de linha não quebram a linha.
DT_TOP	Texto de justificativa superior.
DT_VCENTER	Centralizar o texto verticalmente (somente linha única).
DT_WORDBREAK	Quebrar 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: D3DXCOLOR

Cor do texto. Consulte D3DXCOLOR.

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.

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

Confira também

ID3DX10Font

D3DX Interfaces