Compartilhar via


CDC::TextOut

Grava uma cadeia de caracteres no local especificado usando a fonte selecionada.

virtual BOOL TextOut(
   int x,
   int y,
   LPCTSTR lpszString,
   int nCount 
);
BOOL TextOut(
   int x,
   int y,
   const CString& str 
);

Parâmetros

  • x
    Especifica a coordenada x do ponto de partida lógica de texto.

  • s
    Especifica a coordenada y lógica de ponto de partida de texto.

  • lpszString
    Pontos a cadeia de caracteres a ser desenhada.

  • nCount
    Especifica o número de bytes na cadeia de caracteres.

  • str
    Um objeto de CString que contém os caracteres a ser desenhados.

Valor de retorno

Diferente de zero se a função é com êxito; se não 0.

Comentários

As fontes de caracteres estão no canto superior esquerdo da célula de caracteres.Por padrão, a posição atual não é usado ou não é atualizado pela função.

Se um aplicativo precisar atualizar a posição atual quando chama TextOut, o aplicativo pode chamar a função de membro de SetTextAlign com nFlags definido como TA_UPDATECP.Quando esse sinalizador é definido, o windows ignora os parâmetros de x e y em chamadas subseqüentes a TextOut, usando a posição atual em vez de isso.

Exemplo

Consulte o exemplo para CDC::BeginPath.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut