Compartilhar via


CDC::TextOut

Grava uma Cadeia de Caracteres no local especificado usando a fonte selecionada no momento.

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 lógica coordenada x do ponto de partida do texto.

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

  • lpszString
    Aponta para a Cadeia de Caracteres a serem desenhados.

  • nCount
    Especifica o número de bytes na Cadeia de Caracteres.

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

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Comentários

Origens de caracteres estão no canto superior Esquerda canto da célula caracteres.Por padrão, a posição atual não é usada ou atualizada pela função.

Se um aplicativo precisar atualizar a posição atual quando ele chama TextOut, o aplicativo pode chamar a função de membro de SetTextAlign com nFlags definido como TA_UPDATECP.Quando esse Sinalizar estiver definido, o Windows ignora o x e y parâmetros em chamadas subseqüentes a TextOut, usando a posição atual em seu lugar.

Exemplo

Consulte o exemplo de CDC::BeginPath.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut

Outros recursos

Membros do CDC