Función CreateFontIndirectA (wingdi.h)

Artículo
03/09/2024

La función CreateFontIndirect crea una fuente lógica que tiene las características especificadas. La fuente se puede seleccionar posteriormente como fuente actual para cualquier contexto de dispositivo.

Sintaxis

HFONT CreateFontIndirectA(
  [in] const LOGFONTA *lplf
);

Parámetros

[in] lplf

Puntero a una estructura LOGFONT que define las características de la fuente lógica.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador de una fuente lógica.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

La función CreateFontIndirect crea una fuente lógica con las características especificadas en la estructura LOGFONT . Cuando se selecciona esta fuente mediante la función SelectObject , el asignador de fuentes de GDI intenta hacer coincidir la fuente lógica con una fuente física existente. Si no encuentra una coincidencia exacta, proporciona una alternativa cuyas características coinciden con tantas de las características solicitadas como sea posible.

Para obtener la fuente adecuada en diferentes versiones de idioma del sistema operativo, llame a EnumFontFamiliesEx con las características de fuente deseadas en la estructura LOGFONT , recupere el nombre de tipo de letra adecuado y cree la fuente mediante CreateFont o CreateFontIndirect.

Cuando ya no necesite la fuente, llame a la función DeleteObject para eliminarla.

Las fuentes de muchos idiomas asiáticos orientales tienen dos nombres de tipo: un nombre en inglés y un nombre localizado. CreateFont y CreateFontIndirect toman el nombre del tipo de letra localizado solo en una configuración regional del sistema que coincida con el idioma, mientras que toman el nombre del tipo de letra en inglés en todas las demás configuraciones regionales del sistema. El mejor método es probar un nombre y, en caso de error, probar el otro. Tenga en cuenta que EnumFonts, EnumFontFamilies y EnumFontFamiliesEx devuelven el nombre del tipo de letra en inglés si la configuración regional del sistema no coincide con el idioma de la fuente.

El asignador de fuentes para CreateFont, CreateFontIndirect y CreateFontIndirectEx reconoce el nombre del tipo de letra inglés y localizado, independientemente de la configuración regional.

Ejemplos

Para obtener un ejemplo, consulte Creación de una fuente lógica.

Nota

El encabezado wingdi.h define CreateFontIndirect 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