CDC::DrawTextEx

Artigo
08/25/2010

Formata o texto no retângulo de determinado.

virtual int DrawTextEx(
   LPTSTR lpszString,
   int nCount,
   LPRECT lpRect,
   UINT nFormat,
      LPDRAWTEXTPARAMS lpDTParams
);
int DrawTextEx(
   const CString& str,
   LPRECT lpRect,
   UINT nFormat,
      LPDRAWTEXTPARAMS lpDTParams
);

Parâmetros

lpszString
Aponta para a seqüência de caracteres a ser desenhada.If nCount é – 1, a cadeia de caracteres deve ser terminada nula.
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 bit a bit OR operador):

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.

lpDTParams
Ponteiro para um DRAWTEXTPARAMS estrutura que especifica as opções de formatação adicionais.Esse parâmetro pode ser NULO.

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 e lpDTParams. Para obter mais informações, consulte CDC::DrawText and DrawTextEx in the Windows SDK.

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