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

El IPrintOemUni::TextOutAsBitmap método permite que un complemento de representación cree una imagen de mapa de bits de una cadena de texto, en caso de que una fuente descargable no esté disponible.

Sintaxis

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

Puntero a una estructura SURFOBJ que describe la superficie en la que se va a escribir.

pstro

Puntero a una estructura STROBJ que define los glifos que se van a representar y las posiciones en las que colocarlos.

pfo

Puntero a una estructura FONTOBJ desde la que se va a recuperar información sobre la fuente y sus glifos.

pco

Puntero a una estructura CLIPOBJ que define la región del clip a través de la cual se debe realizar toda la representación. El controlador no puede afectar a ningún píxel fuera de la región del clip.

prclExtra

Puntero a una estructura RECTL. GDI siempre establece este parámetro en NULL en llamadas a esta función. El controlador debe omitirlo.

prclOpaque

Puntero a una estructura RECTL que representa un único rectángulo opaco. Este rectángulo es exclusivo de la parte inferior derecha. Los píxeles dentro de este rectángulo (los que no están en primer plano y no recortados) se representarán con el pincel opaco. Este rectángulo siempre enlaza el texto que se va a dibujar. Si este parámetro es NULL, no se van a representar píxeles opacos.

pboFore

Puntero a una estructura BRUSHOBJ que representa el objeto brush que se va a usar para los píxeles de primer plano. Este pincel siempre será un pincel de color sólido.

pboOpaque

Puntero a una estructura BRUSHOBJ que representa los píxeles opacos. Se supone que los modos de combinación de primer y segundo plano para este pincel son R2_COPYPEN. A menos que el controlador establezca el bit de funcionalidades de GCAPS_ARBRUSHOPAQUE en el miembro flGraphicsCaps de la estructura DEVINFO, siempre se llamará con un pincel de color sólido.

pptlOrg

Puntero a una estructura POINTL que define el origen del pincel para ambos pinceles.

mix

Operaciones de trama en primer plano y en segundo plano (modos de combinación) para pboFore.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no está implementado.

Comentarios

Se IPrintOemUni::TextOutAsBitmap llama al método desde el método IPrintOemDriverUni::D rvUniTextOut de Unidrv, si ese método no puede crear la cadena de texto mediante fuentes descargables, ya sea porque la fuente no está disponible o se gira. IPrintOemUni::TextOutAsBitmap debe crear una imagen de mapa de bits del texto y enviarlo al dispositivo de impresión.

El IPrintOemUni::TextOutAsBitmap método es opcional. Si un complemento de representación implementa este método, el método IPrintOemUni::GetImplementedMethod del complemento debe devolver S_OK cuando recibe "TextOutAsBitmap" como entrada.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)

Consulte también

IPrintOemDriverUni::D rvUniTextOut

IPrintOemUni

IPrintOemUni::GetImplementedMethod