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

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

  • Статья

Создает структуру шрифта, содержащую 32-разрядный шрифт UCS-4. Текущий шрифт контекста устройства (hDC) предоставляет сведения о шрифте.

Эта функция передает данные в определяемую клиентом процедуру обратного вызова для вставки в поток документов.

TTEmbedFontEx используется так же, как и TTEmbedFont, но принимает набор символьного кода, заданный в UCS-4 (32 бита).

Синтаксис

LONG TTEmbedFontEx(
  [in]           HDC            hDC,
  [in]           ULONG          ulFlags,
  [in]           ULONG          ulCharSet,
  [out]          ULONG          *pulPrivStatus,
  [out]          ULONG          *pulStatus,
                 WRITEEMBEDPROC lpfnWriteToStream,
  [in]           LPVOID         lpvWriteStream,
  [in]           ULONG          *pulCharCodeSet,
  [in]           USHORT         usCharCodeCount,
  [in]           USHORT         usLanguage,
  [in, optional] TTEMBEDINFO    *pTTEmbedInfo
);

Параметры

[in] hDC

Дескриптор контекста устройства.

[in] ulFlags

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

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

[in] ulCharSet

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

Значение Значение
CHARSET_UNICODE
 Набор символов Юникода, требующий 16-разрядной кодировки символов.
CHARSET_SYMBOL
 Набор символов, требующий 16-разрядной кодировки символов.

[out] pulPrivStatus

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

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

[out] pulStatus

Указатель на битовое поле, содержащее сведения о состоянии запроса внедрения. Это поле заполняется после завершения этой функции. В настоящее время для этого параметра не определены биты.

lpfnWriteToStream

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

[in] lpvWriteStream

Маркер для представления выходного потока.

[in] pulCharCodeSet

Указатель на буфер, содержащий необязательные символьные коды UCS-4 для подмножества. Это поле используется только для поднабора шрифта и игнорируется, если в поле ulFlags не указано TTEMBED_SUBSET.

[in] usCharCodeCount

Число символов в списке символов, указанных pulCharCodeSet. Это поле используется только для поднабора шрифта и игнорируется, если в поле ulFlags не указано TTEMBED_SUBSET.

[in] usLanguage

Указывает язык в таблице имен, который следует сохранить при поднастройке. Установите значение 0, чтобы сохранить все языки. Это поле используется только для поднабора шрифта и игнорируется, если в поле ulFlags не указано TTEMBED_SUBSET.

[in, optional] pTTEmbedInfo

Указатель на структуру TTEMBEDINFO , содержащую URL-адреса, с которых можно ссылаться на внедренный объект шрифта. Если параметр pTTEmbedInfo имеет значение NULL, url-адреса не будут добавлены во внедренный объект шрифта, а проверка URL-адреса не будет выполняться при вызове клиентом TTLoadEmbeddedFont.

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

Если внедрение прошло успешно, возвращается E_NONE.

Структура шрифтов включается клиентом в поток документов.

Задано значение pulPrivStatus , указывающее привилегии внедрения шрифта; И pulStatus задано для предоставления результатов операции внедрения.

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

Комментарии

Эта функция ссылается на определяемую клиентом процедуру обратного вызова для внедрения структуры шрифта в поток документа.

Клиенты отвечают за определение и указание набора символов шрифта.

Сведения о внедрении символов Юникода см. в разделе TTEmbedFont; Сведения о внедрении символов Юникода из файла см. в разделе TTEmbedFontFromFileA.

Требования

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

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

TTEMBEDINFO

TTEmbedFont

TTEmbedFontFromFileA

TTLoadEmbeddedFont