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

  • Artikel

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)