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

O IPrintOemDriverUni::DrvUniTextOut método é 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 de clipe por meio da qual toda a renderização deve ser feita. O driver não pode afetar nenhum pixel fora da região de 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. 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 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.

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.

Retornar valor

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

Código de retorno	Descrição
S_OK	A operação foi realizada com êxito.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não está implementado.

Comentários

O IPrintOemDriverUni::DrvUniTextOut método é fornecido pelo Unidrv para uso por meio da renderização de plug-ins que dão suporte a uma superfície de desenho gerenciada pelo dispositivo. Esses plug-ins de renderização devem enganchar a função DrvTextOut da Unidrv e o IPrintOemDriverUni::DrvUniTextOut método deve ser chamado dessa função de conexão. A função de gancho 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, seja 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 Manipulando superfícies de Device-Managed.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	prcomoem.h (inclua Prcomoem.h)