Compartilhar via


Método IPrintOemUni::TextOutAsBitmap (prcomoem.h)

O IPrintOemUni::TextOutAsBitmap método permite que um plug-in de renderização crie uma imagem de bitmap de uma cadeia de caracteres de texto, caso uma fonte baixável não esteja disponível.

Sintaxe

HRESULT TextOutAsBitmap(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  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.

pptlOrg

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 IPrintOemUni::TextOutAsBitmap método é chamado do método IPrintOemDriverUni::D rvUniTextOut da Unidrv, se esse método não puder criar a cadeia de caracteres de texto usando fontes baixáveis, porque a fonte não está disponível ou é girada. IPrintOemUni::TextOutAsBitmap deve criar uma imagem bitmap do texto e enviá-la para o dispositivo de impressão.

O IPrintOemUni::TextOutAsBitmap método é opcional. Se um plug-in de renderização implementar esse método, o método IPrintOemUni::GetImplementedMethod do plug-in deverá retornar S_OK quando receber "TextOutAsBitmap" como entrada.

Requisitos

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

Confira também

IPrintOemDriverUni::D rvUniTextOut

IPrintOemUni

IPrintOemUni::GetImplementedMethod