IPrintOemUni::TextOutAsBitmap-Methode (prcomoem.h)

Mit der IPrintOemUni::TextOutAsBitmap-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 der 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

Zeigen Sie auf eine FONTOBJ- Struktur, aus der Informationen über die Schriftart und ihre Glyphen abgerufen werden sollen.

pco

Zeigen Sie auf eine CLIPOBJ- Struktur, die den Clipbereich definiert, über den das gesamte Rendering ausgeführt werden muss. Der Treiber kann keine Pixel außerhalb des Clipbereichs beeinflussen.

prclExtra

Zeiger auf eine RECTL-Struktur. GDI legt diesen Parameter immer auf NULL- in Aufrufen dieser Funktion 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 vordergrund- und nicht abgeschnitten sind) werden mit dem undurchsichtigen Pinsel gerendert. Dieses Rechteck begrenzt immer den zu zeichnenden Text. Wenn dieser Parameter NULL-ist, werden keine undurchsichtigen Pixel gerendert.

pboFore

Zeigen Sie auf eine BRUSHOBJ- Struktur, die das Pinselobjekt darstellt, das für die Vordergrundpixel verwendet werden soll. Dieser Pinsel ist immer ein Pinsel mit Volltonfarbe.

pboOpaque

Zeiger auf eine BRUSHOBJ-Struktur, die die undurchsichtigen Pixel darstellt. Für diesen Pinsel wird davon ausgegangen, dass sowohl der Vordergrund- als auch der Hintergrundmixmodus R2_COPYPEN werden. Wenn der Treiber das bit der GCAPS_ARBRUSHOPAQUE-Funktionen im flGraphicsCaps Member der DEVINFO-Struktur festlegt, wird er immer mit einem Volltonfarbpinsel aufgerufen.

pptlOrg

Zeiger auf eine POINTL--Struktur, die den Pinselursprung für beide Pinsel definiert.

mix

Die Vordergrund- und Hintergrundrastervorgänge (Mixmodi) für pboFore.

Rückgabewert

Die Methode muss einen der folgenden Werte zurückgeben.

Bemerkungen

Die IPrintOemUni::TextOutAsBitmap-Methode wird von unidrv's IPrintOemDriverUni::D rvUniTextOut-Methode aufgerufen, wenn diese Methode die Textzeichenfolge nicht mit herunterladbaren Schriftarten erstellen kann, entweder weil die Schriftart nicht verfügbar oder gedreht ist. 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 S_OK zurückgeben, wenn es "TextOutAsBitmap" als Eingabe empfängt.

Anforderungen

Siehe auch

IPrintOemDriverUni::D rvUniTextOut

IPrintOemUni

IPrintOemUni::GetImplementedMethod