Método IPrintOemDriverUni::D rvUniTextOut (prcomoem.h)

Artigo
02/07/2025

O método IPrintOemDriverUni::DrvUniTextOut é fornecido pelo driver Unidrv para que um plug-in de renderização usando uma superfície de desenho gerenciada pelo dispositivo possa facilmente gerar cadeias de caracteres de texto.

Sintaxe

HRESULT DrvUniTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlBrushOrg,
  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 nas quais colocá-los.

pfo

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

pco

Ponteiro para uma estrutura CLIPOBJ que define a região do clipe por meio da qual toda a renderização deve ser feita. O driver não pode afetar nenhum pixel fora da região do clipe.

prclExtra

Ponteiro para uma estrutura RECTL. A GDI sempre define esse parâmetro como NULL em chamadas para essa função. Ele deve ser ignorado pelo motorista.

prclOpaque

Ponteiro para uma estrutura RECTL que representa um único retângulo opaco. Este retângulo é exclusivo no canto inferior direito. 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 vincula o texto a ser desenhado. Se esse parâmetro for NULL, nenhum pixel opaco deverá 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 os pixels opacos. Os modos de combinação de plano de fundo e de primeiro plano para esse pincel são considerados R2_COPYPEN. A menos que o driver defina o bit GCAPS_ARBRUSHOPAQUE funcionalidades no flGraphicsCaps membro da estrutura DEVINFO, ele sempre será chamado com um pincel de cor sólido.

pptlBrushOrg

Ponteiro para uma estrutura POINTL que define a origem do pincel para ambos os pincéis.

mix

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

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

O método IPrintOemDriverUni::DrvUniTextOut é fornecido pelo Unidrv para uso renderizando plug-ins que dão suporte a uma superfície de desenho gerenciada pelo dispositivo. Esses plug-ins de renderização devem conectar a função DrvTextOut da Unidrv e o método IPrintOemDriverUni::DrvUniTextOut deve ser chamado dessa função de conexão. A função de conexão deve executar operações de recorte de região de texto e rotação de texto. Em seguida, ele pode chamar IPrintOemDriverUni::DrvUniTextOut para solicitar Unidrv para criar a cadeia de caracteres de texto usando fontes baixáveis (e para executar recorte baseado em glifo).

Se IPrintOemDriverUni::DrvUniTextOut não puder criar a cadeia de caracteres de texto, porque a fonte não está disponível ou girada, ela chama o método IPrintOemUni::TextOutAsBitmap do plug-in de renderização, que desenha a cadeia de caracteres de texto como um bitmap.

Para obter mais informações, consulte Tratamento Device-Managed Surfaces.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Compartilhar via