IPrintOemUni：：TTDownloadMethod 方法 (prcomoem.h)

项目
02/27/2024

方法 IPrintOemUni::TTDownloadMethod 使呈现插件能够指示 Unidrv 应对指定的 TrueType 软字体使用的格式。

语法

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

参数

pdevobj

调用方提供的指向 DEVOBJ 结构的指针。

pUFObj

调用方提供的指向 UNIFONTOBJ 结构的指针。

[out] pdwResult

接收以下方法提供的常量值之一：

值	定义
TTDOWNLOAD_BITMAP	Unidrv 应下载指定字体作为位图。
TTDOWNLOAD_DONTCARE	Unidrv 可以选择字体格式。
TTDOWNLOAD_GRAPHICS	Unidrv 应将 TrueType 字体打印为图形，而不是下载字体。
TTDOWNLOAD_TTOUTLINE	Unidrv 应下载指定的字体作为大纲。有关更多信息，请参见下面的“备注”部分。

返回值

方法必须返回以下值之一。

返回代码	说明
S_OK	操作成功。
E_FAIL	此操作失败。
E_NOTIMPL	该方法未实现。

注解

方法 IPrintOemUni::TTDownloadMethod 的目的是允许呈现插件为指定的 TrueType 软字体指定打印机的首选格式。

如果呈现插件实现了 IPrintOemUni::TTDownloadMethod 方法，则 Unidrv 会在每次准备好向打印后台处理程序发送 TrueType 字体时调用该方法。 Unidrv 指定字体类型， IPrintOemUni::TTDownloadMethod 方法应在 pdwResult 指向的位置指定打印机的首选格式。

除非打印机可以光栅化 TrueType 字体，否则该方法不应返回TTDOWNLOAD_TTOUTLINE。呈现插件负责读取和分析 TrueType 字体文件。可以通过调用 FONTOBJ_pvTrueTypeFontFile 来获取指向 TrueType 字体文件的指针。

方法 IPrintOemUni::TTDownloadMethod 是可选的。如果呈现插件实现此方法，则插件的 IPrintOemUni：：GetImplementedMethod 方法在接收“TTDownLoadMethod”作为输入时必须返回S_OK。

有关其他信息，请参阅自定义字体管理。