IPrintOemUni::OutputCharStr-Methode (prcomoem.h)

  • Artikel

Mit IPrintOemUni::OutputCharStr der Methode kann ein Rendering-Plug-In den Druck von Schriftart-Glyphen steuern.

Syntax

HRESULT OutputCharStr(
  PDEVOBJ     pdevobj,
  PUNIFONTOBJ pUFObj,
  DWORD       dwType,
  DWORD       dwCount,
  PVOID       pGlyph
);

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ-Struktur .

pUFObj

Vom Aufrufer bereitgestellter Zeiger auf eine UNIFONTOBJ-Struktur .

dwType

Vom Aufrufer bereitgestellter Wert, der den Typ des Glyphenbezeichnerarrays angibt, auf das von pGlyph verwiesen wird. Gültige Werte sind:

Wert Definition
TYPE_GLYPHHANDLE Die pGlyphen-Arrayelemente sind Glyphenhandles vom Typ HGLYPH.
TYPE_GLYPHID Die pGlyphen-Arrayelemente sind Glyphenbezeichner vom Typ DWORD.

dwCount

Vom Aufrufer bereitgestellter Wert, der die Anzahl der Glyphenbezeichner im Array darstellt, auf das von pGlyph verwiesen wird.

pGlyph

Vom Aufrufer bereitgestellter Zeiger auf ein Array von Glyphenbezeichnern, wobei der Arrayelementtyp durch dwType angegeben wird.

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::OutputCharStr -Methode wird zur Unterstützung von Druckern verwendet, die die von Unidrv unterstützten Zeichenausgabebefehle PCL, CAPSL oder PPDS nicht erkennen. Sein Zweck besteht darin, einem Rendering-Plug-In die Möglichkeit zu geben, den Druck der Glyphen einer Schriftart zu steuern und bei Bedarf Glyphenersetzungen bereitzustellen.

Wenn ein Rendering-Plug-In die IPrintOemUni::OutputCharStr -Methode implementiert, ruft Unidrv die -Methode jedes Mal auf, wenn eine Zeichenzeichenfolge zum Spooling bereit ist.

Die -Methode empfängt ein Array von Glyphenbezeichnern. Der für dwType empfangene Wert gibt den Bezeichnertyp an.

Wenn die angegebene Schriftart eine Geräteschriftart ist, enthält das Array Glyphenhandles. Die Handles müssen in Zeichencodes oder Befehle übersetzt und dann an den Druckspooler gesendet werden, damit Geräteglyphen gedruckt werden.

Wenn die angegebene Schriftart eine weiche Schriftart (TrueType) ist, enthält das Array Glyphenbezeichner. Die Bezeichner stellen zuvor heruntergeladene Glyphen dar, die gedruckt werden müssen.

Wenn es sich bei der angegebenen Schriftart um eine Geräteschriftart handelt, muss die -Methode Folgendes ausführen:

  1. Ordnen Sie eine GETINFO_GLYPHSTRING-Struktur zu, wobei dwTypeIn auf TYPE_GLYPHHANDLE und dwTypeOut auf TYPE_TRANSDATA festgelegt ist.
  2. Rufen Sie die UNIFONTOBJ_GetInfo-Funktion auf, und übergeben Sie die GETINFO_GLYPHSTRING-Struktur als Eingabe, um Glyphenübersetzungen als TRANSDATA-Strukturinhalt zu erhalten.
  3. Rufen Sie IPrintOemDriverUni::D rvWriteSpoolBuf auf, um TRANSDATA-Strukturinhalte an den Druckspooler zu senden, um die Glyphen zu drucken.
Wenn die angegebene Schriftart eine weiche Schriftart ist, kann die Methode einfach IPrintOemDriverUni::D rvWriteSpoolBuf aufrufen, um Befehle an den Druckspooler zu senden, die dazu führen, dass die angegebenen zuvor heruntergeladenen Glyphen gedruckt werden.

Die IPrintOemUni::OutputCharStr 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 "OutputCharStr" als Eingabe empfängt.

Weitere Informationen finden Sie unter Angepasste Schriftverwaltung.

Anforderungen

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