IPrintOemUni::TextOutAsBitmap-Methode (prcomoem.h)
Mit IPrintOemUni::TextOutAsBitmap der Methode kann ein Rendering-Plug-In ein Bitmapbild einer Textzeichenfolge erstellen, falls keine herunterladbare Schriftart verfügbar ist.
Syntax
HRESULT TextOutAsBitmap(
SURFOBJ *pso,
STROBJ *pstro,
FONTOBJ *pfo,
CLIPOBJ *pco,
RECTL *prclExtra,
RECTL *prclOpaque,
BRUSHOBJ *pboFore,
BRUSHOBJ *pboOpaque,
POINTL *pptlOrg,
MIX mix
);
Parameter
pso
Zeiger auf eine SURFOBJ-Struktur , die die Oberfläche beschreibt, auf die geschrieben werden soll.
pstro
Zeiger auf eine STROBJ-Struktur , die die zu rendernden Glyphen und die Positionen definiert, an denen sie platziert werden sollen.
pfo
Zeiger auf eine FONTOBJ-Struktur , aus der Informationen über die Schriftart und ihre Glyphen abgerufen werden sollen.
pco
Zeiger auf eine CLIPOBJ-Struktur , die den Clipbereich definiert, über den das gesamte Rendering erfolgen muss. Der Treiber kann keine Pixel außerhalb des Clipbereichs beeinflussen.
prclExtra
Zeiger auf eine RECTL-Struktur. GDI legt diesen Parameter in Aufrufen dieser Funktion immer auf NULL fest. Sie sollte vom Treiber ignoriert werden.
prclOpaque
Zeiger auf eine RECTL-Struktur , die ein einzelnes undurchsichtiges Rechteck darstellt. Dieses Rechteck ist unten rechts exklusiv. Pixel innerhalb dieses Rechtecks (die nicht im Vordergrund und nicht abgeschnitten sind) müssen mit dem undurchsichtigen Pinsel gerendert werden. Dieses Rechteck gebundene immer den zu zeichnenden Text. Wenn dieser Parameter NULL ist, werden keine undurchsichtigen Pixel gerendert.
pboFore
Zeiger auf eine BRUSHOBJ-Struktur , die das Pinselobjekt darstellt, das für die Vordergrundpixel verwendet werden soll. Dieser Pinsel ist immer ein Einfarbigpinsel.
pboOpaque
Zeiger auf eine BRUSHOBJ-Struktur, die die undurchsichtigen Pixel darstellt. Es wird davon ausgegangen, dass sowohl der Vordergrund- als auch der Hintergrundmixmodus für diesen Pinsel R2_COPYPEN sind. Sofern der Treiber das GCAPS_ARBRUSHOPAQUE-Funktionenbit im flGraphicsCaps-Member der DEVINFO-Struktur nicht festlegt, wird es immer mit einem Volltonpinsel aufgerufen.
pptlOrg
Zeiger auf eine POINTL-Struktur , die den Pinselursprung für beide Pinsel definiert.
mix
Die Vordergrund- und Hintergrundrastervorgänge (Mischmodi) für pboFore.
Rückgabewert
Die -Methode muss einen der folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Fehler beim Vorgang. |
|
Die Methode ist nicht implementiert. |
Hinweise
Die IPrintOemUni::TextOutAsBitmap -Methode wird von unidrvs IPrintOemDriverUni::D rvUniTextOut-Methode aufgerufen, wenn diese Methode die Textzeichenfolge nicht mit herunterladbaren Schriftarten erstellen kann, da die Schriftart nicht verfügbar ist oder gedreht wird. IPrintOemUni::TextOutAsBitmap sollte ein Bitmapbild des Texts erstellen und an das Druckgerät senden.
Die IPrintOemUni::TextOutAsBitmap Methode ist optional. Wenn ein Rendering-Plug-In diese Methode implementiert, muss die IPrintOemUni::GetImplementedMethod-Methode des Plug-Ins S_OK zurückgeben, wenn es "TextOutAsBitmap" als Eingabe empfängt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | prcomoem.h (einschließlich Prcomoem.h) |