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

Artikel
08/07/2023

Die IPrintOemDriverUni::DrvUniTextOut -Methode wird vom Unidrv-Treiber bereitgestellt, sodass ein Rendering-Plug-In mithilfe einer geräteverwalteten Zeichnungsoberfläche problemlos Textzeichenfolgen 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 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.

pptlBrushOrg

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 IPrintOemDriverUni::DrvUniTextOut -Methode wird von Unidrv zur Verwendung durch Rendern von Plug-Ins bereitgestellt, die eine geräteverwaltete Zeichnungsoberfläche unterstützen. Solche Rendering-Plug-Ins müssen die DrvTextOut-Funktion von Unidrv einbinden, und die IPrintOemDriverUni::DrvUniTextOut Methode soll von dieser Hookingfunktion aufgerufen werden. Die Hookingfunktion muss Textbereichsausschnitte und Textrotationsvorgänge ausführen. Anschließend kann er aufrufen IPrintOemDriverUni::DrvUniTextOut , um Unidrv anzufordern, die Textzeichenfolge mit herunterladbaren Schriftarten zu erstellen (und glyphenbasiertes Ausschneiden durchzuführen).

Wenn IPrintOemDriverUni::DrvUniTextOut die Textzeichenfolge nicht erstellt werden kann, wird die IPrintOemUni::TextOutAsBitmap-Methode des Rendering-Plug-Ins aufgerufen, die die Textzeichenfolge als Bitmap zeichnet.

Weitere Informationen finden Sie unter Behandeln Device-Managed Surfaces.

Anforderungen

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

Freigeben über