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 un | --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 valores siguientes.

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 coincida con una fuente pública, se elegirá la fuente privada. Cuando finalice 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 la función no se realiza correctamente, el valor devuelto es cero. No hay información de error extendida disponible.

Comentarios

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 enumerada en el Registro e instalada en una ubicación distinta de la carpeta %windir%\fonts\ no se puede modificar, eliminar ni reemplazar siempre que se cargue en ninguna sesión. Para cambiar una de estas fuentes, primero debe quitarse llamando a RemoveFontResource, quitada 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 Convenciones para prototipos de función.

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	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll

Consulte también

Funciones de fuente y texto

Información general sobre fuentes y texto

RemoveFontResourceEx

SendMessage