IPrintOemDriverUni::D rvUniTextOut-Methode (prcomoem.h)

Die IPrintOemDriverUni::DrvUniTextOut-Methode wird vom Unidrv-Treiber bereitgestellt, sodass ein Rendering-Plug-In mit einer geräteverwalteten Zeichnungsoberfläche textzeichenfolgen problemlos ausgeben kann.

Syntax

HRESULT DrvUniTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlBrushOrg,
  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.

pptlBrushOrg

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.

Rückgabecode	Beschreibung
S_OK	Der Vorgang war erfolgreich.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Bemerkungen

Die IPrintOemDriverUni::DrvUniTextOut-Methode wird von Unidrv zur Verwendung durch Render-Plug-Ins bereitgestellt, die eine geräteverwaltete Zeichnungsoberfläche unterstützen. Solche Rendering-Plug-Ins müssen unidrv's DrvTextOut--Funktion verbinden, und die IPrintOemDriverUni::DrvUniTextOut-Methode soll von dieser Hooking-Funktion aufgerufen werden. Die Hooking-Funktion muss Textbereichsausschnitte und Textdrehungsvorgänge ausführen. Anschließend kann IPrintOemDriverUni::DrvUniTextOut aufgerufen werden, um Unidrv anzufordern, die Textzeichenfolge mit herunterladbaren Schriftarten zu erstellen (und um Glyphen-basierte Beschneidung durchzuführen).

Wenn IPrintOemDriverUni::DrvUniTextOut die Textzeichenfolge nicht erstellen können, entweder weil die Schriftart nicht verfügbar oder gedreht ist, ruft sie die IPrintOemUni::TextOutAsBitmap- Methode auf, die die Textzeichenfolge als Bitmap zeichnet.

Weitere Informationen finden Sie unter Handling Device-Managed Surfaces.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	prcomoem.h (einschließlich Prcomoem.h)