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

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

  • lpszString
    Aponta para a cadeia de caracteres a ser desenhada.

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

  • str
    Um objeto 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

As origens do caractere estão no canto superior esquerdo da célula do caractere. Por padrão, a posição atual não é usada nem atualizada pela função.

Se um aplicativo precisar atualizar a posição atual quando chamar TextOut, o aplicativo poderá chamar a função membro SetTextAlign com nFlags definido como TA_UPDATECP. Quando esse sinalizador é definido, o Windows ignora os parâmetros x e y em chamadas subsequentes para TextOut, usando a posição atual no lugar.

Exemplo

Veja o exemplo de CDC::BeginPath.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico da hierarquia

CDC::ExtTextOut

CDC::GetTextExtent

CDC::SetTextAlign

CDC::SetTextColor

CDC::TabbedTextOut

TextOut