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
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também