CDC::DrawText

Artigo
08/25/2010

Chame essa função de membro para formatar o texto no retângulo de determinado.Para especificar opções de formatação adicionais, 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
Aponta para a seqüência de caracteres a ser desenhada.If nCount é – 1, a cadeia de caracteres deve ser terminada por caractere nulo.
nCount
Especifica o número de caracteres na seqüência de caracteres.If nCount é – 1, em seguida lpszString é considerado um ponteiro longo para uma seqüência de caracteres terminada com caractere nulo e DrawText calcula automaticamente o número de caracteres.
lpRect
Aponta para um RECT a estrutura ou CRect objeto que contém o retângulo (em coordenadas lógicas) na qual o texto é a ser formatado.
str
A CString objeto que contém os caracteres especificados ser desenhado.

nFormat
Especifica o método de formatação de texto.Ele pode ser qualquer combinação dos valores descritos para o uFormat parâmetro em DrawText in the Windows SDK. (agrupar com o operador bit a bit ou):

Observação:
Alguns uFormat sinalizar combinações podem fazer com que a seqüência de caracteres passada a ser modificado. Usando DT_MODIFYSTRING com qualquer um dos DT_END_ELLIPSIS or DT_PATH_ELLIPSIS pode causar a seqüência de caracteres a ser modificado, causando uma declaração no CString Substitua. Os valores de DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, e DT_NOPREFIX não pode ser usado com o DT_TABSTOP valor.

Alguns uFormat sinalizar combinações podem fazer com que a seqüência de caracteres passada a ser modificado. Usando DT_MODIFYSTRING com qualquer um dos DT_END_ELLIPSIS or DT_PATH_ELLIPSIS pode causar a seqüência de caracteres a ser modificado, causando uma declaração no CString Substitua. Os valores de DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, e DT_NOPREFIX não pode ser usado com o DT_TABSTOP valor.

Valor de retorno

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

Comentários

Formata o texto, expandindo tabulações para espaços apropriados, alinhar texto à esquerda, à direita, ou no centralizar do retângulo determinado e dividindo a texto em linhas que ajustem o retângulo especificado.O tipo de formatação é especificado por nFormat.

Essa função de membro usa a fonte selecionada o contexto de dispositivo, cor do texto e cor do plano de fundo para desenhar o texto.A menos que o DT_NOCLIP o formato é usado, DrawText corta o texto, de modo que o texto não seja exibida fora do retângulo especificado. Supõe-se toda a formatação que possui várias linhas, a menos que o DT_SINGLELINE formato é fornecido.

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

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

Se o TA_UPDATECP sinalizar de alinhamento de texto tiver sido conjunto (consulte CDC::conjuntoTextAlign), DrawText exibirão texto começando na posição corrente, em vez de à esquerda do retângulo especificado. DrawText não irá dispor o texto quando o TA_UPDATECP sinalizar foi definido (ou seja, a DT_WORDBREAK sinalizar não terá nenhum efeito).

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