IPrintOemUni::TextOutAsBitmap-Methode (prcomoem.h)

  • Artikel

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
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL
 Fehler beim Vorgang.
E_NOTIMPL
 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)

Weitere Informationen

IPrintOemDriverUni::D rvUniTextOut

IPrintOemUni

IPrintOemUni::GetImplementedMethod