Función AddFontResourceExA (wingdi.h)

La función addFontResourceEx agrega el recurso de fuente del archivo especificado al sistema. Las fuentes agregadas con la función AddFontResourceEx se pueden marcar como privadas y no enumerables.

Sintaxis

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

Parámetros

[in] name

Puntero a una cadena de caracteres terminada en null que contiene un nombre de archivo de fuente válido. Este parámetro puede especificar cualquiera de los siguientes archivos.

Extensión de archivo	Significado
.fon	Archivo de recursos de fuente.
.fnt	Archivo de fuente de mapa de bits sin formato.
.ttf	Archivo TrueType sin formato.
.ttc	Windows del Este asiático: colección de fuentes TrueType.
.fot	Archivo de recursos TrueType.
.otf	Fuente OpenType postScript.
.mmm	varios archivos de recursos de fuente tipo1 maestros. Debe usarse con archivos .pfm y .pfb.
.pfb	Escriba 1 archivo de bits de fuente. Se usa con un archivo .pfm.
.pfm	Escriba 1 archivo de métricas de fuente. Se usa con un archivo .pfb.

 

Para agregar una fuente cuya información procede de varios archivos de recursos, apunte lpszFileName a una cadena con los nombres de archivo separados por | --por ejemplo, abcxxxxx.pfm | abcxxxxx.pfb.

[in] fl

Características de la fuente que se va a agregar al sistema. Este parámetro puede ser uno de los siguientes valores.

Valor	Significado
FR_PRIVATE	Especifica que solo el proceso que llamó a la función AddFontResourceEx puede usar esta fuente. Cuando el nombre de fuente coincide con una fuente pública, se elegirá la fuente privada. Cuando finaliza el proceso, el sistema quitará todas las fuentes instaladas por el proceso con la función AddFontResourceEx.
FR_NOT_ENUM	Especifica que ningún proceso, incluido el proceso que llamó a la función AddFontResourceEx, puede enumerar esta fuente.

[in] res

Reservado. Debe ser cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto especifica el número de fuentes agregadas.

Si se produce un error en la función, el valor devuelto es cero. No hay información de error extendida disponible.

Observaciones

Esta función permite que un proceso use fuentes sin permitir que otros procesos accedan a las fuentes.

Cuando una aplicación ya no necesita un recurso de fuente que cargó llamando a la función AddFontResourceEx, debe quitar el recurso llamando a la función RemoveFontResourceEx.

Esta función instala la fuente solo para la sesión actual. Cuando se reinicie el sistema, la fuente no estará presente. Para tener instalada la fuente incluso después de reiniciar el sistema, la fuente debe aparecer en el Registro.

Una fuente que aparece en el Registro e instalada en una ubicación distinta de la carpeta \fonts\ de %windir%no se puede modificar, eliminar ni reemplazar siempre que se cargue en cualquier sesión. Para cambiar una de estas fuentes, primero debe quitarse llamando a RemoveFontResource, quitado del registro de fuentes (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) y el sistema reiniciado. Después de reiniciar el sistema, la fuente ya no se cargará y se podrá cambiar.

Nota

El encabezado wingdi.h define AddFontResourceEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wingdi.h (incluya Windows.h)
biblioteca de	Gdi32.lib
DLL de	Gdi32.dll

Consulte también

funciones de fuente y texto de

de información general de fuentes y texto de

RemoveFontResourceEx

SendMessage de