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 |
|
Biblioteca |
|
Confira também