CDC::DrawText

Artigo
02/25/2013

Chamar essa função de membro para formatar o texto no retângulo especificado.Para especificar opções adicionais de formatação, use CDC::DrawTextEx.

virtual int DrawText(
   LPCTSTR lpszString,
   int nCount,
   LPRECT lpRect,
   UINT nFormat 
);
int DrawText(
   const CString& str,
   LPRECT lpRect,
   UINT nFormat 
);

Parâmetros

lpszString
Pontos a cadeia de caracteres a ser desenhada.Se nCount é – 1, a cadeia de caracteres NULL- deve ser encerrado.
nCount
Especifica o número de chares na cadeia de caracteres.Se nCount é – 1, então lpszString é assumido como um ponteiro ao longo uma cadeia de caracteres NULL- finalizada e DrawText calcula o número de caracteres automaticamente.
lpRect
Os pontos a RECT estrutura ou objetos de CRect que contém o retângulo (em coordenadas lógicas) em que o texto deve ser formatado.
str
Um objeto de CString que contém caracteres especificados a ser desenhados.

nFormat
Especifica o método de formatação de texto.Pode ser qualquer combinação de valores descritos para o parâmetro de uFormat em DrawText em Windows SDK.(inicia usando o operador OR bit a bit):

Observação
Algumas combinações de sinalizador de uFormat podem causar a cadeia de caracteres passada a ser modificada.Usar DT_MODIFYSTRING com DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS pode causar a cadeia de caracteres a ser modificada, causando uma declaração na substituição de CString .Os valores DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, e DT_NOPREFIX não podem ser usados com o valor de DT_TABSTOP .

Algumas combinações de sinalizador de uFormat podem causar a cadeia de caracteres passada a ser modificada.Usar DT_MODIFYSTRING com DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS pode causar a cadeia de caracteres a ser modificada, causando uma declaração na substituição de CString .Os valores DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, e DT_NOPREFIX não podem ser usados com o valor de DT_TABSTOP .

Valor de retorno

A altura do texto se a função é bem-sucedida.

Comentários

Formata o texto expandir guias em espaços apropriados, alinhar o texto a esquerda, direita, ou ao centro do retângulo determinado, e quebrando o texto em linhas que ajustaram dentro do retângulo especificado.o tipo de formatação é especificado por nFormat.

Essa função de membro usa a fonte do contexto de dispositivo, a cor do texto, e a cor do plano de fundo selecionadas para desenhar texto.A menos que o formato de DT_NOCLIP é usado, DrawText recorta o texto para que o texto não publica para fora do retângulo especificado.Qualquer formatação é suposot várias linhas a menos que o formato de DT_SINGLELINE é determinado.

Se a fonte selecionada é muito grande para o retângulo especificado, a função de membro de DrawText não tenta substituir uma fonte menor.

Se o sinalizador de DT_CALCRECT for especificado, o retângulo especificado por lpRect será atualizado para refletir a largura e altura necessárias para desenhar texto.

Se o parâmetro do texto - alinhamento de TA_UPDATECP foi definido (consulte) CDC::SetTextAlign, DrawText exibirá o texto que começa na posição atual, em vez de no lado esquerdo do retângulo especificado.DrawText não será disposto o texto quando o sinalizador de TA_UPDATECP foi definido (isto é, o sinalizador de DT_WORDBREAK não terá efeito.)

A cor do texto pode ser definida por CDC::SetTextColor.