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

Добавляет или удаляет имена лиц из списка исключений шрифтов.

Синтаксис

LONG TTEnableEmbeddingForFacename(
  [in] LPCSTR lpszFacename,
  [in] BOOL   bEnable
);

Параметры

[in] lpszFacename

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

[in] bEnable

Логическая операция управления списком исключений шрифтов. Если значение не равно нулю, имя лица будет удалено из списка; Если значение равно нулю, имя лица будет добавлено в список.

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

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

Имя лица, указанное lpszFacename , будет добавлено или удалено из списка исключений шрифта.

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

Комментарии

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

Клиент разработки может внедрять шрифты без ссылки на список исключений шрифтов (то есть без использования TTEnableEmbeddingForFacename). Внедрение шрифтов в документ приводит к следующим компромиссам.

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

Две дополнительные функции, TTIsEmbeddingEnabled и TTIsEmbedddEnabledForFacename, получают доступ к списку исключений шрифтов, чтобы предоставить состояние включения.

Список исключений шрифта хранится в разделе реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\t2embed. Список исключений шрифтов по умолчанию должен содержать следующие записи именованных значений, представляющие основные шрифты Microsoft Windows.

Имя значения	Тип данных	Значение
Arial	REG_DWORD	0
Arial Полужирный (Arial Bold)	REG_DWORD	0
Arial Полужирный курсив (Arial Bold Italic)	REG_DWORD	0
Arial Курсив (Arial Italic)	REG_DWORD	0
Courier New	REG_DWORD	0
Курьер Новый полужирный	REG_DWORD	0
Курьер Новый полужирный курсив	REG_DWORD	0
Курьер Нью Курсив	REG_DWORD	0
Times New Roman	REG_DWORD	0
Times New Roman Bold	REG_DWORD	0
Times New Roman Bold Курсив	REG_DWORD	0
Times New Roman Italic	REG_DWORD	0

Требования

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

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

TTIsEmbeddingEnabled

TTIsEmbeddingEnabledForFacename