Función AddFontResourceA (wingdi.h)

  • Artículo

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 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, haga que 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 la función no se realiza correctamente, el valor devuelto es cero. No hay información de error extendida disponible.

Comentarios

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 .

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 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 Convenciones para prototipos de función.

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

Consulte también

AddFontResourceEx

Funciones de fuente y texto

Información general sobre fuentes y texto

RemoveFontResource

SendMessage