CDC::ExtTextOut

Chame essa função de membro para gravar uma Cadeia de Caracteres dentro de uma região retangular usando a fonte selecionada no momento.

virtual BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   LPCTSTR lpszString,
   UINT nCount,
   LPINT lpDxWidths 
);
BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   const CString& str,
   LPINT lpDxWidths 
);

Parâmetros

  • x
    Especifica a lógica coordenada x da célula caracteres para o primeiro caractere na Cadeia de Caracteres especificada.

  • y
    Especifica a lógica coordenada y da parte superior da célula caracteres para o primeiro caractere na Cadeia de Caracteres especificada.

  • nOptions
    Especifica o tipo de Retangular.Esse parâmetro pode ser um, ambos ou nenhum dos seguintes valores:

    • ETO_CLIPPED especifica que o texto é cortado ao Retangular.

    • ETO_OPAQUE especifica que a Cor do plano de fundo atual preenche o Retangular.(Você pode definir e consultar a Cor do plano de fundo atual com o SetBkColor e GetBkColor funções de membro.)

  • lpRect
    Aponta para um RECT estrutura que determina as dimensões do Retangular.Esse parâmetro pode ser NULL.Você também pode passar um objeto de CRect para este parâmetro.

  • lpszString
    Aponta para a Cadeia de Caracteres especificado para serem desenhados.Você também pode passar um objeto de CString para este parâmetro.

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

  • lpDxWidths
    Aponta para uma matriz de valores que indicam a distância entre origens de células de caractere adjacente.For instance, lpDxWidths[i] logical units will separate the origins of character cell i and character cell i + 1.Se lpDxWidths for NULL, ExtTextOut usará o espaçamento padrão entre caracteres.

  • str
    Um objeto de CString que contém os caracteres especificados ser desenhado.

Valor de retorno

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

Comentários

A região retangular pode ser opaca (preenchida com a Cor do plano de fundo atual), e pode ser uma região de corte.

Se nOptions é 0 e lpRect é NULL, a função gravará texto para o contexto de dispositivo sem usar uma região retangular.Por padrão, a posição atual não é usada ou atualizada pela função.Se um aplicativo precisa atualizar a posição atual quando ele chama ExtTextOut, o aplicativo pode chamar o CDC membro função SetTextAlign com nFlags definido como TA_UPDATECP.Quando esse Sinalizar estiver definido, o Windows ignora x e y em chamadas subseqüentes a ExtTextOut e usa a posição atual em vez disso.Quando um aplicativo usa TA_UPDATECP para atualizar a posição atual, ExtTextOut define a posição atual para o final da linha anterior do texto ou para a posição especificada pelo último elemento da matriz apontado pelo lpDxWidths, que é maior.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::SetTextAlign

CDC::TabbedTextOut

CDC::TextOut

CDC::GetBkColor

CDC::SetBkColor

CDC::SetTextColor

ExtTextOut

RECT estrutura

Outros recursos

Membros do CDC