ExtTextOut

9/8/2008

Essa função desenha um seqüência de caracteres usando a fonte selecionada no momento. Você pode fornecer um opcional retângulo que ExtTextOut pode usar para recorte, opaquing ou ambos.

Syntax

BOOL ExtTextOut(
  HDC hdc, 
  int X, 
  int Y, 
  UINT fuOptions, 
  const RECT* lprc, 
  LPCTSTR lpString, 
  UINT cbCount, 
  const int* lpDx
); 

Parameters

• hDC
  [no] Identificador para o contexto dispositivo (DC).

• X
  [no] Número inteiro que especifica o x lógica - coordenar de apontar a referência usada para posição a seqüência de caracteres.

• Y
  [no] Número inteiro que especifica a y lógica - coordenar de apontar a referência usada para posição a seqüência de caracteres.

• fuOptions
  [no] Inteiro sem sinal que especifica como usar o retângulo Application-defined. A seguinte tabela mostra os valores possíveis, o qual você pode combinar.

  Valor	Descrição
  ETO_CLIPPED	Clipes o texto para o retângulo.
  ETO_OPAQUE	Usa o atual cor do plano de fundo para preencher o retângulo.
  ETO_RTLREADING	Se esse valor for especificado e uma fonte hebraico ou árabe estiver selecionada no contexto de dispositivo, o seqüência de caracteres é saída usando ordem de leitura right-to-left. Se esse valor não for especificado, o seqüência de caracteres será saída na esquerda - para - direito ordem. O mesmo efeito pode ser alcançado com configuração de valor TA_RTLREADING em SetTextAlign.

• lprc
  [no] Ponteiro longo para um opcional estrutura RECT que especifica as dimensões de um retângulo que ExtTextOut Usa para recorte, opaquing ou ambos.

• lpString
  [no] Ponteiro longo para o seqüência de caracteres que desejar para desenhar. O seqüência de caracteres não precisa ser finalizado porque zero cbCount Especifica o comprimento da seqüência de caracteres.

• cbCount
  [no] Inteiro sem sinal que especifica o número de caracteres na seqüência de caracteres.

• lpDx
  [no] Ponteiro longo para um opcional matriz de valores que indicam a distância entre origens do adjacente células caractere. Por exemplo lpDx[i indica o número de unidades lógicas separar as origens de célula caractere i e célula caractere i + 1.

Return Value

Nonzero indica que ExtTextOut Drew a seqüência de caracteres. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

O atual Configurações Text–Alignment para o contexto especificado dispositivo determinam como ExtTextOut Usa o apontar de referência a posição de texto.

Se a pasta lpDx parâmetro é NULL, o ExtTextOut função usa o espaçamento entre caracteres usar como padrão. As origens Character–Cell e o conteúdo da matriz apontado pelo lpDx parâmetro são fornecidos em unidades lógicas. Uma origem Character–Cell é a upper-left corner de célula de caractere.

Por padrão, ExtTextOut Não use ou atualização de atual posição.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

SetTextAlign

Other Resources