CDC::DrawText 

virtual int DrawText ( LPCTSTR lpszString, int nCount, LPRECT lpRect, UINT nFormat );

int Dr&awText (const CStringamp;StrLPRECTlpRectUINTnFormat );

Valor de retorno

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

Parâmetros

lpszString

Aponta para a Cadeia de caracteres a ser desenhado. Se nCount é – 1, a Cadeia de caracteres deve ser terminada por caractere nulo.

nCount

Especifica o número de caracteres na cadeia de caracteres. Se nCount é – 1, então lpszString é considerado que um ponteiro longo para um seqüência de caracteres terminada por caractere nulo e DrawText calcula automaticamente o número de caracteres.

lpRect

Aponta para um RECT estrutura ou CRect objeto que contém o Retangular (nas coordenadas lógicos) em que o texto deve ser formatado.

str

 Um objeto de CString que contém os caracteres especificados ser desenhado.

nFormat

Especifica o método de formatação de texto. Pode ser qualquer combinação dos seguintes valores (combinar usando o operador OR bit a bit):

&Notenbsp;Os valores DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPe DT_NOPREFIX não podem ser usados com o valor DT_TABSTOP.

Observações

Chame essa função de membro para formatar o texto no Retangular fornecido. Formata texto expandindo tabulações em espaços apropriados, alinhando o texto para a esquerda, à direita ou centralizar do Retangular determinado, e dividindo o texto em linhas que se encaixam dentro o Retangular fornecido. O tipo de formatação é especificado por nFormat.

Esta função de membro usa o contexto de dispositivo fonte selecionada, cor do texto e cor de fundo para desenhar o texto. A menos que o Formatarar DT_NOCLIP é usado, DrawText clipes o texto para que o texto não apareça fora do retângulo determinado. Toda formatação assume-se ter várias linhas, a menos que o formato DT_SINGLELINE é fornecido.

Se a fonte selecionada for muito grande para o Retangular especificado, a função de membro DrawText não tenta substituir uma fonte menor.

Se o Sinalizar DT_CALCRECT for especificado, o Retangular especificado por lpRect será atualizado para refletir a largura e altura necessária para desenhar o texto.

Se o Sinalizar de alinhamento de texto TA_UPDATECP tiver sido definido (consulte CDC::SetTextAlign), DrawText exibirá texto começando na posição atual, em vez de na parte esquerda do Retangular fornecido. DrawText não vai quebrar o texto quando o Sinalizar de TA_UPDATECP tiver sido definido (ou seja, o sinalizador DT_WORDBREAK não terá efeito).

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

Visão geral do CDCMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut, CDC::TextOut, :: DrawText, RECT, CDC::SetTextAlign

Index