CDC::ExtTextOut

Artigo
02/25/2013

Chamar essa função de membro para gravar uma cadeia de caracteres dentro de uma área retangular usando a fonte selecionada.

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 coordenada x lógica da célula de caracteres para o primeiro caractere na cadeia de caracteres especificada.
s
Especifica a coordenada y lógica da parte superior da célula de caracteres para o primeiro caractere na cadeia de caracteres especificada.
nOptions
Especifica o tipo do retângulo.Este parâmetro pode ser um, ou nenhum dos seguintes valores:
- ETO_CLIPPED especifica que o texto é recortado ao retângulo.
- ETO_OPAQUE especifica que o preenche cor do plano de fundo atual o retângulo.(Você pode definir e ver a cor do plano de fundo atual com as funções de membro de SetBkColor e de GetBkColor .)
lpRect
Pontos a estrutura de RECT que determina as dimensões do retângulo.Este parâmetro pode ser NULO.Você também pode passar um objeto de CRect para esse parâmetro.
lpszString
Pontos a cadeia de caracteres especificada a ser desenhada.Você também pode passar um objeto de CString para esse parâmetro.
nCount
Especifica o número de caracteres na cadeia de caracteres.
lpDxWidths
Aponta para uma matriz de valores que indica a distância entre fontes de células de caracteres adjacentes.Por exemplo, as unidades lógicas de lpDxWidths[i] separarão fontes da célula de caractere i e da célula de caractere i + 1.Se lpDxWidths é NULO, ExtTextOut usa o espacejamento entre caracteres padrão.
str
Um objeto de CString que contém caracteres especificados a ser desenhados.

Valor de retorno

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

Comentários

A área retangular pode ser opaca (preenchido com a cor do plano de fundo atual), e pode ser uma região de corte.

Se nOptions é 0 e lpRect é NULO, a função escrever texto no contexto de dispositivo sem usar uma área retangular.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 ExtTextOut, o aplicativo pode chamar a função de membro SetTextAlign de CDC com nFlags definido como TA_UPDATECP.Quando esse sinalizador é definido, o windows ignoram x e y em chamadas subseqüentes a ExtTextOut e usam a posição atual em vez de isso.Quando um aplicativo usa TA_UPDATECP para atualizar a posição atual, ExtTextOut define a posição atual para o final da linha de texto anterior ou posição especificada pelo último elemento da matriz apontada por lpDxWidths, qualquer é maior.