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):

• DT_BOTTOMnbsp;  Especifica o texto justificado à parte inferior. Esse valor deve ser combinada com DT_SI&NGLELINE.
  
  
• DT_CALCRECT   Determina a largura e a altura do Retangular. Se houver várias linhas de texto, DrawText usará a largura do retângulo apontado pelo lpRect e alargar a base do retângulo para ligado a última linha de texto. Se houver apenas uma linha de texto, DrawText irá modificar o lado direito do retângulo que circunda o último caractere na linha. Em qualquer caso, DrawText retorna a altura do texto formatado, mas não desenhar o texto.
  
  
• DT_CE&NTERnbsp;  Centraliza o texto horizontalmente.
  
  
• DT_E&ND_ELLIPSIS ou DT_PATH_ELLIPSISnbsp;Substitui parte de determinada Cadeia de caracteres com elipses, se necessário, para que o resultado caiba no Retangular especificado. A seqüência de caracteres não é modificada, a menos que o sinalizador DT_MODIFYSTRING for especificada.

  Você pode especificar DT_END_ELLIPSIS para substituir caracteres no final da Cadeia de caracteres, ou DT_PATH_ELLIPSIS para substituir caracteres no meio da seqüência de caracteres. Se a Cadeia de caracteres contiver caracteres de barra invertida (\), DT_PATH_ELLIPSIS preserva tanto quanto possível do texto após a última barra invertida.

• DT_EXPA&NDTABSnbsp;  Expande caracteres de Guiaulação. O número de caracteres por guia padrão é oito.
  
  
• DT_EXTER&NALLEADINGnbsp;  Inclui líderes externo da fonte a altura da linha. Normalmente, líderes externo não consta a altura de uma linha de texto.
  
  
• DT_LEFT   Alinha o texto à esquerda de liberação.
  
  
• DT_MODIFYSTRI&NGnbsp;Modifica a seqüência de caracteres para corresponder o texto exibido. Este sinalizador não tem efeito a menos que o sinalizador DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS é especificado.

  Observação Algumas combinações de Sinalizar uFormat podem causar a seqüência de caracteres passada ser modificada. Usando o DT_MODIFYSTRING com DT_END_ELLIPSIS ou DT_PATH_ELLIPSIS pode causar a seqüência de caracteres a ser modificado, causando uma declaração no CString substituir.

• DT_&NOCLIPnbsp;  Desenha sem recorte. DrawText é um pouco mais rápido quando DT_NOCLIP é usado.
  
  
• DT_NOPREFIXnbsp;  Desativa o processamento de caracteres de prefixo. Normalmente, DrawText interpreta o caractere de prefixo de mneumônico de e comercial (&) como uma diretiva para sublinhado o caractere que segue e o dois "e" comercial (& &) caracteres mneumônico-prefixo como uma diretiva para imprimir um único e comercial. Especificando DT_NOPREFIX, esse processamento está desativado.
  
  
• DT_PATH_ELLIPSISnbsp; & nbsp;
  
  
• DT_RIGHT   Alinha o texto liberado-direito.
  
  
• DT_SI&NGLELINEnbsp;  Especifica somente linha única. Retornos de carro e alimentações de linha não quebra de linha.
  
  
• DT_TABSTOP   Define paradas de tabulação. O alto byte ordem de nFormat é o número de caracteres para cada guia. O número de caracteres por guia padrão é oito.
  
  
• DT_TOP   Especifica o texto justificado top (simples linha somente).
  
  
• DT_VCE&NTERnbsp;  Especifica o texto verticalmente centralizado (simples linha somente).
  
  
• DT_WORDBREAK   Especifica a quebra de palavras. As linhas são automaticamente quebradas entre as palavras se uma palavra estendem ultrapassou a borda do Retangular especificado por lpRect. Uma seqüência de return – linefeed de carro também vai quebrar a linha.

&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 CDC |  Membros de classe | Gráfico de hierarquia

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