IPrintOemUni::D ownloadCharGlyph-Methode (prcomoem.h)

Mit der IPrintOemUni::DownloadCharGlyph-Methode kann ein Rendering-Plug-In für Unidrv eine Zeichenglyphe für eine angegebene weiche Schriftart an den Drucker senden.

Syntax

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ- Struktur.

pUFObj

Vom Aufrufer bereitgestellter Zeiger auf eine UNIFONTOBJ--Struktur.

hGlyph

Vom Anrufer bereitgestellter Glyphenziehpunkt.

pdwWidth

Vom Aufrufer bereitgestellter Zeiger, um die vom Methode bereitgestellte Breite des Zeichens zu empfangen.

[out] pdwResult

Empfängt einen von der Methode bereitgestellten Wert, der die Menge des Druckerspeichers in Byte darstellt, die zum Speichern der Zeichenglyphe erforderlich ist. Wenn der Vorgang fehlschlägt, sollte der zurückgegebene Wert null sein.

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 IPrintOemUni::DownloadCharGlyph-Methode wird verwendet, um weiche Schriftarten auf Druckern zu unterstützen, die PCL--Befehle nicht akzeptieren. Der Zweck besteht darin, ein Rendering-Plug-In zum Senden einer Zeichenglyphe an den Drucker zu ermöglichen.

Wenn ein Rendering-Plug-In die IPrintOemUni::DownloadCharGlyph-Methode implementiert, ruft Unidrv die Methode unmittelbar nach dem Senden der befehlszeichenfolge auf, die durch den Befehlseintrag "CmdSetCharCode" angegeben ist, der in der GPD--Datei des Druckers enthalten ist. (GPD-Dateien werden in Microsoft Universal Printer Driverbeschrieben.) Die Methode sollte folgendes ausführen:

• Rufen Sie die UNIFONTOBJ_GetInfo-Funktion auf, um das durch angegebene Glyphenbild abzurufen.
• Rufen Sie IPrintOemDriverUni::D rvWriteSpoolBuf auf, um die Glyphe an den Drucker zu senden.
• Rufen Sie die UNIFONTOBJ_GetInfo-Funktion erneut auf, um die Breite der Glyphe abzurufen, und speichern Sie dann die Breite in der Adresse, auf die pdwWidthverweist.
• Geben Sie den zum Speichern der Glyphe erforderlichen Druckerspeicher zurück, indem Sie ihn an der durch pdwResult-angegebenen Position platzieren.

Die IPrintOemUni::DownloadCharGlyph-Methode ist optional. Wenn ein Rendering-Plug-In diese Methode implementiert, muss die IPrintOemUni::GetImplementedMethod--Methode S_OK zurückgeben, wenn es "DownloadCharGlyph" als Eingabe empfängt.

Wenn Sie die IPrintOemUni::DownloadCharGlyph-Methode implementieren, müssen Sie auch die IPrintOemUni::D ownloadFontHeader--Methode implementieren.

Weitere Informationen finden Sie unter Angepasste Schriftartverwaltung.

Anforderungen

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