Метод IPrintOemUni::TTDownloadMethod (prcomoem.h)

Статья
02/26/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 реализует метод , Unidrv вызывает метод каждый раз, когда он готов к отправке шрифта TrueType в очередь печати. Unidrv задает тип шрифта IPrintOemUni::TTDownloadMethod , а метод должен указывать предпочтительный формат принтера в расположении, на которое указывает pdwResult.

Метод не должен возвращать TTDOWNLOAD_TTOUTLINE, если принтер не может растеризовать шрифты TrueType. Подключаемый модуль отрисовки отвечает за чтение и анализ файлов шрифтов TrueType. Указатели на файлы шрифтов TrueType можно получить, вызвав FONTOBJ_pvTrueTypeFontFile.

Метод IPrintOemUni::TTDownloadMethod является необязательным. Если подключаемый модуль отрисовки реализует этот метод, метод IPrintOemUni::GetImplementedMethod должен возвращать S_OK при получении "TTDownLoadMethod" в качестве входных данных.

Дополнительные сведения см. в разделе Управление настраиваемыми шрифтами.