CDC::ExtTextOut

Artigo
08/25/2010

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.