Función TTEmbedFont (t2embapi.h)

  • Artículo

Crea una estructura de fuente que contiene la fuente de caracteres anchos (16 bits) subconjunto. La fuente actual del contexto del dispositivo (hDC) proporciona la información de fuente.

Esta función pasa los datos a una rutina de devolución de llamada definida por el cliente para la inserción en la secuencia de documentos.

Sintaxis

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

Parámetros

[in] hDC

Identificador de contexto del dispositivo.

[in] ulFlags

Marca que especifica la solicitud de inserción. Esta marca puede tener cero o más de los siguientes valores.

Valor Significado
TTEMBED_EMBEDEUDC
 Incluya los datos del archivo de fuente EUDC asociado con la estructura de fuentes.
TTEMBED_RAW
 Devuelve una estructura de fuente que contiene el juego de caracteres completo, sin comprimir. Este es el comportamiento predeterminado de la función.
TTEMBED_SUBSET
 Devuelve una fuente subconjunto que contiene solo los glifos indicados por el parámetro pusCharCodeSet o pulCharCodeSet . Estos códigos de caracteres deben indicarse como caracteres de 16 bits o UCS-4, según corresponda para el parámetro .
TTEMBED_TTCOMPRESSED
 Devuelve una estructura de fuente comprimida.

[in] ulCharSet

Marca que especifica el juego de caracteres de la fuente que se va a incrustar. Esta marca puede tener uno de los siguientes valores.

Valor Significado
CHARSET_UNICODE
 Juego de caracteres Unicode, que requiere codificación de caracteres de 16 bits.
CHARSET_SYMBOL
 Juego de caracteres de símbolo, que requiere codificación de caracteres de 16 bits.

[out] pulPrivStatus

Puntero al marcador que indica los privilegios de inserción de la fuente. Esta marca puede tener uno de los siguientes valores. Esta función devuelve la licencia menos restrictiva concedida.

Valor Significado
EMBED_PREVIEWPRINT
 Vista previa e inserción de impresión.
EMBED_EDITABLE
 Inserción editable.
EMBED_INSTALLABLE
 Inserción instalable.
EMBED_NOEMBEDDING
 Inserción de licencias restringidas.

[out] pulStatus

Puntero a un campo de bits que contiene información de estado sobre la solicitud de inserción. Este campo se rellena al finalizar esta función. Actualmente no se definen bits para este parámetro.

lpfnWriteToStream

Puntero a la función de devolución de llamada definida por el cliente, que escribe la estructura de fuente en la secuencia del documento. Consulte WRITEEMBEDPROC.

[in] lpvWriteStream

Token para representar el flujo de salida.

[in] pusCharCodeSet

Puntero al búfer que contiene los códigos de caracteres Unicode opcionales para el restablecimiento. Este campo solo se usa para restablecer una fuente y se omite si el campo ulFlags no especifica TTEMBED_SUBSET.

[in] usCharCodeCount

Número de caracteres de la lista de caracteres indicados por pusCharCodeSet. Este campo solo se usa para restablecer una fuente y se omite si el campo ulFlags no especifica TTEMBED_SUBSET.

[in] usLanguage

Especifica el idioma de la tabla de nombres que se debe mantener cuando se establece la subconfiguración. Establezca en 0 para mantener todos los idiomas. Este campo solo se usa para restablecer una fuente y se omite si el campo ulFlags no especifica TTEMBED_SUBSET.

[in, optional] pTTEmbedInfo

Puntero a una estructura TTEMBEDINFO que contiene las direcciones URL desde las que se puede hacer referencia legítimamente al objeto de fuente incrustado. Si pTTEmbedInfo es NULL, no se agregarán direcciones URL al objeto de fuente incrustado y no se producirá ninguna comprobación de direcciones URL cuando el cliente llame a TTLoadEmbeddedFont.

Valor devuelto

Si la inserción se realiza correctamente, devuelve E_NONE.

El cliente incorpora la estructura de fuentes en la secuencia de documentos. pulPrivStatus se establece, lo que indica los privilegios de inserción de la fuente; y pulStatus se establece para proporcionar resultados de la operación de inserción.

De lo contrario, devuelve un código de error descrito en Mensajes de error de inserción y función.

Comentarios

Los clientes son responsables de determinar e indicar el juego de caracteres de la fuente.

Para obtener información sobre cómo insertar caracteres UCS-4, vea TTEmbedFontEx. Para obtener información sobre cómo insertar caracteres de fuente desde un archivo, vea TTEmbedFontFromFileA.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado t2embapi.h
Library T2embed.lib
Archivo DLL T2embed.dll

Consulte también

TTEMBEDINFO

TTEmbedFontEx

TTEmbedFontFromFileA

TTLoadEmbeddedFont