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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| DLL |
|