CDC::DrawText
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):Dica
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.
Requisitos
Cabeçalho: afxwin.h