Função ExtTextOutWrap

[ExtTextOutWrap está disponível por meio do Windows XP com Service Pack 2 (SP2). Ele pode estar alterado ou indisponível em versões subsequentes. É recomendável usar o ExtTextOut diretamente em vez disso.]

Desenha texto usando a fonte, a cor da tela de fundo e a cor do texto selecionadas no momento. Opcionalmente, você pode fornecer dimensões a serem usadas para recorte, opacidade ou ambos. Essa função encapsula uma chamada para ExtTextOut.

Sintaxe

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

Parâmetros

hdc [in]

Tipo: HDC

Um identificador para o contexto do dispositivo.

X [in]

Tipo: int

A coordenada x, em coordenadas lógicas, do ponto de referência usado para posicionar a cadeia de caracteres.

Y [in]

Tipo: int

A coordenada y, em coordenadas lógicas, do ponto de referência usado para posicionar a cadeia de caracteres.

uOptions [in]

Tipo: UINT

Valores que especificam como usar o retângulo definido pelo aplicativo. Consulte ExtTextOut para obter uma lista completa de opções.

lprc [in]

Tipo: const RECT*

Um ponteiro para uma estrutura RECT opcional que especifica as dimensões, em coordenadas lógicas, de um retângulo usado para recorte, opacidade ou ambos.

lpString [in]

Tipo: LPCTSTR

Um ponteiro para um buffer que contém o texto a ser desenhado. A cadeia de caracteres não precisa ser terminada em zero, pois cbCount especifica o comprimento da cadeia de caracteres.

cbCount [in]

Tipo: UINT

O comprimento da cadeia de caracteres, em bytes, apontado por lpString.

lpDx [in]

Tipo: const INT*

Um ponteiro para uma matriz opcional de valores que indicam a distância entre as origens das células de caractere adjacentes. Por exemplo, as unidades lógicas lpDx[x] separam as origens da célula x do caractere e da célula de caractere (x + 1).

Valor retornado

Tipo: BOOL

Retorna um valor diferente de zero se a cadeia de caracteres for desenhada com êxito. No entanto, se a versão ANSI de ExtTextOut for chamada com ETO_GLYPH_INDEX, a função retornará TRUE mesmo que a função não faça nada.

Se a função falhar, o valor retornado será zero.

Para obter informações de erro estendidas, chame GetLastError.

Comentários

ExtTextOutWrap não é exportado por nome ou declarado em um arquivo de cabeçalho público. Para usá-lo, você deve usar GetProcAddress e solicitar o ordinal 417 de ComCtl32.dll para obter um ponteiro de função.

Para comentários adicionais, consulte ExtTextOut.

Requisitos