Función TTEmbedFontFromFileA (t2embapi.h)

  • Artículo

Crea una estructura de fuente que contiene la fuente de caracteres anchos subconjuntos (16 bits). Un archivo externo 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 el flujo de documento.

Sintaxis

LONG TTEmbedFontFromFileA(
  [in]           HDC            hDC,
  [in]           LPCSTR         szFontFileName,
  [in]           USHORT         usTTCIndex,
  [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] szFontFileName

Nombre del archivo de fuente y ruta de acceso que se va a insertar. Se trata de una cadena ANSI.

[in] usTTCIndex

Índice de base cero en el archivo de fuente (TTC) que identifica la fuente física que se va a insertar. Si el archivo contiene una sola fuente (como un archivo de esquema TTF o OTF), este parámetro debe establecerse en 0.

[in] ulFlags

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

Value Significado
TTEMBED_EMBEDEUDC
 Incluya los datos asociados del archivo de fuente EUDC 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 valores siguientes.

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

[out] pulPrivStatus

Puntero a marca que indica los privilegios de inserción de la fuente. Esta marca puede tener uno de los valores siguientes. 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 tras la finalización de esta función. Actualmente no hay bits definidos para este parámetro.

lpfnWriteToStream

Puntero a la función de devolución de llamada definida por el cliente que escribe la estructura de fuentes en la secuencia de documentos. 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 theulFlagsfield no especifica TTEMBED_SUBSET.

[in] usCharCodeCount

Número de caracteres de la lista de caracteres indicados por pusCharCodeSet. Este campo solo se usa para establecer 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 va a mantener cuando se restablezca. Establezca en 0 para mantener todos los idiomas. Este campo solo se usa para establecer 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 la función 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 establecen 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

Esta función hace referencia a una rutina de devolución de llamada definida por el cliente para insertar la estructura de fuentes en la secuencia de documentos.

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

Para obtener información sobre cómo insertar caracteres Unicode desde un contexto de dispositivo, consulte TTEmbedFont; para obtener información sobre cómo insertar caracteres UCS-4 desde un contexto de dispositivo, consulte TTEmbedFontEx.

Requisitos

   
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

TTEmbedFont

TTEmbedFontEx

TTLoadEmbeddedFont