IPrintOemUni::TTDownloadMethod-Methode (prcomoem.h)

Artikel
02/26/2024

Die IPrintOemUni::TTDownloadMethod -Methode ermöglicht ein Rendering-Plug-In, um das Format anzugeben, das Unidrv für eine angegebene weiche TrueType-Schriftart verwenden soll.

Syntax

HRESULT TTDownloadMethod(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
  [out] OUT DWORD   *pdwResult
);

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ-Struktur .

pUFObj

Vom Aufrufer bereitgestellter Zeiger auf eine UNIFONTOBJ-Struktur .

[out] pdwResult

Empfängt einen der folgenden von der Methode bereitgestellten konstanten Werte:

Wert	Definition
TTDOWNLOAD_BITMAP	Unidrv sollte die angegebene Schriftart als Bitmaps herunterladen.
TTDOWNLOAD_DONTCARE	Unidrv kann das Schriftformat auswählen.
TTDOWNLOAD_GRAPHICS	Unidrv sollte TrueType-Schriftarten als Grafiken drucken, anstatt die Schriftart herunterzuladen.
TTDOWNLOAD_TTOUTLINE	Unidrv sollte die angegebene Schriftart als Konturen herunterladen. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

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

Der IPrintOemUni::TTDownloadMethod Zweck der -Methode besteht darin, einem Rendering-Plug-In zu ermöglichen, das bevorzugte Format eines Druckers für eine angegebene weiche TrueType-Schriftart anzugeben.

Wenn ein Rendering-Plug-In die IPrintOemUni::TTDownloadMethod -Methode implementiert, ruft Unidrv die -Methode jedes Mal auf, wenn sie bereit ist, eine TrueType-Schriftart an den Druckspooler zu senden. Unidrv gibt den Schriftarttyp an, und die IPrintOemUni::TTDownloadMethod Methode sollte das bevorzugte Format des Druckers an der Position angeben, auf die pdwResult verweist.

Die -Methode sollte nur dann TTDOWNLOAD_TTOUTLINE zurückgeben, wenn der Drucker TrueType-Schriftarten rastern kann. Das Rendering-Plug-In ist für das Lesen und Analysieren von TrueType-Schriftartdateien verantwortlich. Zeiger auf TrueType-Schriftartdateien können durch Aufrufen von FONTOBJ_pvTrueTypeFontFile abgerufen werden.

Die IPrintOemUni::TTDownloadMethod -Methode ist optional. Wenn ein Rendering-Plug-In diese Methode implementiert, muss die IPrintOemUni::GetImplementedMethod-Methode des Plug-Ins S_OK zurückgeben, wenn "TTDownLoadMethod" als Eingabe empfangen wird.

Weitere Informationen finden Sie unter Angepasste Schriftverwaltung.