IPrintOemUni::TTDownloadMethod 方法 (prcomoem.h)

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。

有关详细信息,请参阅 自定义字体管理

要求

要求 价值
目标平台 桌面
标头 prcomoem.h (include Prcomoem.h)

另请参阅

DEVOBJ

FONTOBJ_pvTrueTypeFontFile

IPrintOemUni

IPrintOemUni::GetImplementedMethod

UNIFONTOBJ