Функция TTGetEmbeddedFontInfo (t2embapi.h)

Статья
03/02/2024

Извлекает сведения о внедренном шрифте, например разрешения на внедрение. TTGetEmbeddedFontInfo выполняет ту же задачу, что и TTLoadEmbeddedFont, но не выделяет внутренние структуры данных для внедренного шрифта.

Синтаксис

LONG TTGetEmbeddedFontInfo(
  [in]  ULONG         ulFlags,
  [out] ULONG         *pulPrivStatus,
  [in]  ULONG         ulPrivs,
  [out] ULONG         *pulStatus,
        READEMBEDPROC lpfnReadFromStream,
  [in]  LPVOID        lpvReadStream,
  [in]  TTLOADINFO    *pTTLoadInfo
);

Параметры

[in] ulFlags

Флаги, указывающие запрос. Этот флаг может иметь ноль или более следующих значений.

Значение	Значение
TTEMBED_EMBEDEUDC	Включите связанные данные файла шрифтов EUDC в структуру шрифта.
TTEMBED_RAW	Возвращает структуру шрифта, содержащую полную кодировку без сжатия. Это поведение функции по умолчанию.
TTEMBED_SUBSET	Возвращает поднабор шрифта, содержащего только глифы, указанные параметром pusCharCodeSet или pulCharCodeSet . Эти коды символов должны быть обозначены как 16-разрядные или UCS-4 символы в соответствии с параметром .
TTEMBED_TTCOMPRESSED	Возвращает сжатую структуру шрифта.

[out] pulPrivStatus

По завершении указывает привилегии внедрения шрифта. Ниже приведен список возможных значений.

Значение	Значение
EMBED_PREVIEWPRINT	Предварительный просмотр и внедрение на печать.
EMBED_EDITABLE	Редактируемое внедрение.
EMBED_INSTALLABLE	Устанавливаемое внедрение.
EMBED_NOEMBEDDING	Внедрение ограниченной лицензии.

[in] ulPrivs

Флаг, указывающий дальнейшее ограничение привилегий внедрения, налагаемых клиентом. Дополнительные сведения см. в разделе TTLoadEmbeddedFont .

Этот флаг должен иметь одно из следующих значений.

Значение	Значение
LICENSE_PREVIEWPRINT	Предварительный просмотр и внедрение на печать.
LICENSE_EDITABLE	Редактируемое внедрение.
LICENSE_INSTALLABLE	Устанавливаемое внедрение.
LICENSE_NOEMBEDDING	Внедрение ограниченной лицензии.
LICENSE_DEFAULT	Используйте уровень внедрения по умолчанию.

[out] pulStatus

Указатель на битовое поле, содержащее сведения о состоянии, и заполняется после выполнения этой функции. Состояние может быть равно нулю или следующему значению:

Значение	Значение
TTLOAD_FONT_SUBSETTED	Загруженный шрифт является подмножеством исходного шрифта.

lpfnReadFromStream

[обратный вызов] Указатель на определяемую клиентом функцию обратного вызова, которая считывает структуру шрифта из потока документа.

[in] lpvReadStream

В настоящее время не определено. Зарезервировано для указателя на поток (структура шрифта).

[in] pTTLoadInfo

Указатель на структуру TTLOADINFO , содержащую URL-адрес, по которому был получен внедренный объект шрифта.

Возвращаемое значение

В случае успешного выполнения возвращает E_NONE.

Расположение, на которое ссылается *pulPrivStatus , определяет привилегии внедрения шрифта. Расположение, на которое ссылается *pulStatus , определяет, внедрено ли подмножество шрифта.

В противном случае возвращает код ошибки, описанный в разделе Сообщения об ошибках embedding-function.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	t2embapi.h
Библиотека	T2embed.lib
DLL	T2embed.dll

См. также раздел

Поделиться через