Método IPrintOemUni::TextOutAsBitmap (prcomoem.h)
El método IPrintOemUni::TextOutAsBitmap 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 de STROBJ que define los glifos que se van a representar y las posiciones en las que colocarlos.
pfo
Puntero a una FONTOBJ estructura desde la que recuperar información sobre la fuente y sus glifos.
pco
Puntero a una estructura de 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 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 representarán 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 las funcionalidades de GCAPS_ARBRUSHOPAQUE bit en el flGraphicsCaps miembro 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
Las 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 |
|---|---|
|
La operación se realizó correctamente. |
|
Error en la operación. |
|
El método no se implementa. |
Observaciones
Se llama al método IPrintOemUni::TextOutAsBitmap desde el método IPrintOemDriverUni::D rvUniTextOut método, 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 método IPrintOemUni::TextOutAsBitmap es opcional. Si un complemento de representación implementa este método, el método IPrintOemUni::GetImplementedMethod debe devolver S_OK cuando recibe "TextOutAsBitmap" como entrada.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | prcomoem.h (include Prcomoem.h) |