Función AddFontResourceA (wingdi.h)

La función AddFontResource agrega el recurso de fuente del archivo especificado a la tabla de fuentes del sistema. Posteriormente, cualquier aplicación puede usar la fuente para la salida de texto.

Para marcar una fuente como privada o no enumerable, use la función AddFontResourceEx.

Sintaxis

int AddFontResourceA(
  [in] LPCSTR unnamedParam1
);

Parámetros

[in] unnamedParam1

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 de tipo 1 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, tenga lpszFileName apunte a una cadena con los nombres de archivo separados por un "|", por ejemplo, abcxxxxx.pfm | abcxxxxx.pfb.

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

Cualquier aplicación que agregue o quite fuentes de la tabla de fuentes del sistema debe notificar a otras ventanas del cambio enviando un mensaje de WM_FONTCHANGE a todas las ventanas de nivel superior del sistema operativo. La aplicación debe enviar este mensaje llamando a la función SendMessage y estableciendo el parámetro hwnd en HWND_BROADCAST.

Cuando una aplicación ya no necesita un recurso de fuente que cargó llamando a la función addFontResource , debe quitar ese recurso llamando a la función removeFontResource de .

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 AddFontResource 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

AddFontResourceEx

funciones de fuente y texto de

de información general de fuentes y texto de

RemoveFontResource

SendMessage de