Función CreateFontIndirectA (wingdi.h)

Artículo
11/20/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 de LOGFONT que define las características de la fuente lógica.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es NULL.

Observaciones

La función createFontIndirect crea una fuente lógica con las características especificadas en la estructura LOGFONT de . 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 letra 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 tomar el nombre del tipo de letra localizado solo en una configuración regional del sistema que coincida con el idioma, mientras toman el nombre de tipo de letra 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, EnumFontFamiliesy EnumFontFamiliesEx devuelven el nombre del tipo de letra inglés si la configuración regional del sistema no coincide con el idioma de la fuente.

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

Ejemplos

Para obtener un ejemplo, vea 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 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