Função EngTextOut (winddi.h)

Artigo
08/27/2023

A função EngTextOut faz com que o GDI renderize um conjunto de glifos em posições especificadas.

Sintaxe

ENGAPI BOOL EngTextOut(
       SURFOBJ  *pso,
       STROBJ   *pstro,
       FONTOBJ  *pfo,
       CLIPOBJ  *pco,
       RECTL    *prclExtra,
       RECTL    *prclOpaque,
       BRUSHOBJ *pboFore,
       BRUSHOBJ *pboOpaque,
       POINTL   *pptlOrg,
  [in] MIX      mix
);

Parâmetros

pso

Ponteiro para uma estrutura SURFOBJ que descreve a superfície na qual gravar.

pstro

Ponteiro para uma estrutura STROBJ que define os glifos a serem renderizados e as posições em que devem ser colocados.

pfo

Ponteiro para uma estrutura FONTOBJ usada para recuperar informações sobre a fonte e seus glifos.

pco

Ponteiro para uma estrutura CLIPOBJ que define a região de clipe por meio da qual a renderização deve ser feita. Nenhum pixel pode ser afetado fora dessa região de clipe.

prclExtra

Ponteiro para uma estrutura RECTL . Esse parâmetro sempre deve ser NULL.

prclOpaque

Ponteiro para uma estrutura RECTL que identifica um único retângulo opaco exclusivo do canto inferior direito. Os pixels dentro desse retângulo (aqueles que não estão em primeiro plano e não são recortados) devem ser renderizados com o pincel opaco. Esse retângulo sempre limita o texto a ser desenhado. Se esse parâmetro for NULL, nenhum pixel opaco será renderizado.

pboFore

Ponteiro para uma estrutura BRUSHOBJ que representa o objeto brush a ser usado para os pixels de primeiro plano. Esse pincel sempre será um pincel de cor sólida.

pboOpaque

Ponteiro para uma estrutura BRUSHOBJ que representa o objeto brush para os pixels opacos. Presume-se que os modos de combinação em primeiro plano e de segundo plano para esse pincel sejam R2_COPYPEN. A menos que o driver defina o bit GCAPS_ARBRUSHOPAQUE funcionalidades no membro flGraphicsCaps da estrutura DEVINFO , ele sempre será chamado com um pincel de cor sólido.

pptlOrg

Ponteiro para uma estrutura POINTL que define a origem do pincel para ambos os pincéis. Se esse parâmetro for definido como 0 quando EngTextOut for chamado, alguns drivers de impressora poderão imprimir imagens coloridas incorretamente. Para obter mais informações, consulte Comentários.

[in] mix

Especifica operações de raster em primeiro plano e em segundo plano (modos de combinação) para pboFore.

Valor retornado

O valor retornado será TRUE se a função for bem-sucedida. Caso contrário, ele é FALSE e um código de erro é registrado.

Comentários

O driver deve chamar EngTextOut quando ele tiver fisgado DrvTextOut e não puder renderizar os glifos.

Nota O driver não poderá fazer punt para EngTextOut se ele tiver fisgado DrvTextOut para uma superfície gerenciada do dispositivo.

Os parâmetros de entrada para EngTextOut definem dois conjuntos de pixels: primeiro plano e opaco. O driver deve renderizar a superfície para que o resultado seja idêntico a um processo em que os pixels opacos são renderizados primeiro com o pincel opaco e, em seguida, os pixels de primeiro plano são renderizados com o pincel de primeiro plano. Cada uma dessas operações é limitada pelo recorte.

Quando o parâmetro pptlOrg dessa função é definido como 0, alguns drivers de impressora imprimem imagens coloridas incorretamente no Microsoft Windows Server 2003 (versão japonesa). Definir pptlOrg como 0, um valor de ponteiro NULL , é interpretado para significar que nenhuma origem de pincel é definida. Para evitar esse problema, inicialize pptlOrg com o endereço de uma estrutura POINTL cujos membros estão definidos como (0,0), antes da chamada para EngTextOut.

Os pixels opacos e em primeiro plano são considerados como uma tela por meio da qual a cor é escovada na superfície. Os glifos da fonte não têm cor em si mesmos.

Os parâmetros de entrada para EngTextOut definem o conjunto de pixels de glifo, o conjunto de retângulos extras, o retângulo opaco e a região do clipe. O driver deve calcular e renderizar o conjunto de pixels opacos e em primeiro plano.

O modo de combinação define como o padrão de entrada deve ser misturado com os dados já na superfície do dispositivo. O tipo de dados MIX consiste em dois valores ROP2 empacotados em um único ULONG. O byte de baixa ordem define a operação de raster em primeiro plano; o próximo byte define a operação de raster em segundo plano. Para obter mais informações sobre códigos de operação de raster, consulte a documentação do SDK do Microsoft Windows.

Requisitos


Cliente mínimo com suporte	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Universal
Cabeçalho	winddi.h (inclua Winddi.h)
Biblioteca	Win32k.lib
DLL	Win32k.sys