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

Artikel
02/26/2024

Die IPrintOemUni::DownloadCharGlyph Methode ermöglicht es einem Rendering-Plug-In für Unidrv, eine Zeichenglyphe für eine angegebene weiche Schriftart an den Drucker zu 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 Aufrufer bereitgestelltes Glyphenhandle.

pdwWidth

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

[out] pdwResult

Empfängt einen von der Methode angegebenen Wert, der die Menge des Druckerspeichers in Bytes darstellt, der zum Speichern der Zeichen-Glyphe erforderlich ist. Wenn der Vorgang fehlschlägt, sollte der zurückgegebene Wert 0 sein.

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::DownloadCharGlyph -Methode wird verwendet, um soft fonts auf Druckern zu unterstützen, die keine PCL-Befehle akzeptieren. Sein Zweck besteht darin, ein Rendering-Plug-In zum Senden einer Zeichen-Glyphe an den Drucker zu ermöglichen.

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

Rufen Sie die funktion UNIFONTOBJ_GetInfo auf, um das von hGlyphen angegebene Glyphenbild abzurufen.
Rufen Sie IPrintOemDriverUni::D rvWriteSpoolBuf auf, um die Glyphe an den Drucker zu senden.
Rufen Sie die funktion UNIFONTOBJ_GetInfo erneut auf, um die Breite der Glyphe abzurufen, und speichern Sie dann die Breite in der Adresse, auf die pdwWidth verweist.
Geben Sie die Zum Speichern der Glyphe erforderliche Druckerspeichermenge zurück, indem Sie sie an der von pdwResult angegebenen Position platzieren.

Die IPrintOemUni::DownloadCharGlyph 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 "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 Schriftverwaltung.

Anforderungen

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

Freigeben über