CFont::CreateFont

BOOL CreateFont ( int nHeight, int nWidth, int nEscapement, int nOrientation, int nWeight, bytes bItalic, bytes bUnderline, bytes cStrikeOut, bytes nCharSet, bytes nOutPrecision, bytes nClipPrecision, bytes nQuality, bytes nPitchAndFamily, LPCTSTR lpszFacename );

Valor devuelto

Distinto de cero si es correcto; caso contrario 0.

Parámetros

nHeight

Especifica la altura deseada (en unidades lógicas) de la fuente. Puede especificar la altura de la fuente de las siguientes maneras:

nWidth

Especifica el ancho promedio (en unidades lógicas) de caracteres de la fuente. Si nWidth es 0, la proporción de aspecto del dispositivo se comparará con la proporción de aspecto de la digitalización de las fuentes disponibles para encontrar a la coincidencia más cercana, que es determinada por el valor absoluto de la diferencia.

nEscapement

Especifica el ángulo (en unidades de 0,1 grados) entre el vector de escape y el eje x de la superficie de la pantalla. El vector de escape es la línea a través de los orígenes de los caracteres primeros y últimos de una línea. El ángulo se mide en sentido antihorario desde el eje x.

nOrientation

Especifica el ángulo (en unidades de 0,1 grado) entre la línea base del carácter y el eje x. El ángulo se mide en sentido antihorario desde el eje x para sistemas de coordenadas en el que la dirección y es hacia abajo y las agujas del reloj desde el eje x para sistemas de coordenadas en el que la dirección y es hasta.

nWeight

Especifica el grosor de la fuente (en píxeles entintados por 1000). Aunque nWeight puede ser cualquier valor entero entre 0 y 1000, las constantes y valores comunes son los siguientes:

Constante Valor
FW_DONTCARE 0
FW_THIN 100
FW_EXTRALIGHT 200
FW_ULTRALIGHT 200
FW_LIGHT 300
FW_NORMAL 400
FW_REGULAR 400
FW_MEDIUM 500
FW_SEMIBOLD 600
FW_DEMIBOLD 600
FW_BOLD 700
FW_EXTRABOLD 800
FW_ULTRABOLD 800
FW_BLACK 900
FW_HEAVY 900

Estos valores son aproximados; el aspecto real depende de la tipografía. Algunas fuentes tienen sólo FW_NORMAL, FW_REGULARy FW_BOLD pesos. Si se especifica FW_DONTCARE , se utiliza un peso predeterminado.

bItalic

Especifica si la fuente está en cursiva.

bUnderline

Especifica si la fuente está subrayada.

cStrikeOut

Especifica si los caracteres de la fuente se ponchó. Especifica una fuente tachado si establece en un valor distinto de cero.

nCharSet

Especifica el conjunto de caracteres de la fuente. Los siguientes valores y constantes predefinidos:

Constante Valor
ANSI_CHARSET 0
JUEGO 1
SYMBOL_CHARSET 2
SHIFTJIS_CHARSET 128
OEM_CHARSET 255

El conjunto de caracteres OEM es dependiente del sistema.

Fuentes con otros conjuntos de caracteres pueden existir en el sistema. Una aplicación que utiliza una fuente con un conjunto de caracteres desconocidos no debe intentar traducir o interpretar las cadenas que se van a procesar con esa fuente. Por el contrario, las cadenas deben pasar directamente al controlador del dispositivo de salida.

El asignador de fuentes no utiliza el valor del juego . Una aplicación puede utilizar este valor para permitir que el nombre y el tamaño de fuente para describir completamente la fuente lógica. Si no existe una fuente con el nombre especificado, una fuente de cualquier conjunto de caracteres puede ser sustituida por la fuente especificada. Para evitar resultados inesperados, las aplicaciones deben utilizar el valor de juego con moderación.

nOutPrecision

Especifica la precisión de salida deseado. La precisión de salida define cómo estrechamente la salida debe coincidir con altura, ancho, orientación de los caracteres, escape y tono de la fuente solicitada. Puede ser alguno de los siguientes valores:

OUT_CHARACTER_PRECIS OUT_STRING_PRECIS
OUT_DEFAULT_PRECIS OUT_STROKE_PRECIS
OUT_DEVICE_PRECIS OUT_TT_PRECIS
OUT_RASTER_PRECIS

Las aplicaciones pueden utilizar los valores OUT_DEVICE_PRECIS, OUT_RASTER_PRECISy OUT_TT_PRECIS para controlar cómo el asignador de fuentes elige una fuente cuando el sistema contiene más de una fuente con un nombre. Por ejemplo, si un sistema contiene una fuente denominada símbolo en la trama y la forma de TrueType, especificando OUT_TT_PRECIS fuerzas el asignador de fuentes para elegir la versión TrueType. (Especificar OUT_TT_PRECIS fuerzas el asignador de fuentes para seleccionar una fuente TrueType siempre el nombre de fuente especificado coincide con un dispositivo o raster, incluso cuando no hay ninguna fuente TrueType del mismo nombre).

nClipPrecision

Especifica la precisión deseada de recorte. La precisión de recorte define cómo recortar caracteres que son parcialmente fuera de la región de recorte. Puede ser alguno de los siguientes valores:

CLIP_CHARACTER_PRECIS CLIP_MASK
CLIP_DEFAULT_PRECIS CLIP_STROKE_PRECIS
CLIP_ENCAPSULATE CLIP_TT_ALWAYS
CLIP_LH_ANGLES

Para utilizar una fuente incrustada de sólo lectura, una aplicación debe especificar CLIP_ENCAPSULATE.

Para lograr la constante rotación de dispositivo, TrueType y fuentes vectoriales, una aplicación puede utilizar el operador OR para combinar el valor CLIP_LH_ANGLES con cualquiera de los otros valores de nClipPrecision . Si se configura el bit CLIP_LH_ANGLES , la rotación de todas las fuentes depende de si la orientación del sistema de coordenadas es zurda o diestro. (Para obtener más información acerca de la orientación de los sistemas de coordenadas, consulte la descripción del parámetro nOrientation ). Si CLIP_LH_ANGLES no está establecida, las fuentes de dispositivo siempre giran en sentido antihorario, pero la rotación de otras fuentes depende de la orientación del sistema de coordenadas.

nQuality

Especifica la calidad de salida de la fuente, que define cómo cuidadosamente la GDI debe intentar coinciden con los atributos de fuente lógica a los de una fuente física real. Puede ser uno de los siguientes valores:

nPitchAndFamily

Especifica el tono y la familia de la fuente. Los dos bits de orden inferior especifican el tono de la fuente y pueden ser cualquiera de los siguientes valores:

DEFAULT_PITCH VARIABLE_PITCH FIXED_PITCH

Las aplicaciones pueden agregar TMPF_TRUETYPE para el parámetro nPitchAndFamily para seleccionar una fuente TrueType. Los cuatro bits de orden superior del parámetro especifican la familia de fuentes y pueden ser cualquiera de los siguientes valores:

lpszFacename

Un puntero a una cadena terminada en nulo que especifica el nombre de tipografía de la fuente o CString . La longitud de esta cadena no debe superar los 30 caracteres. La función de Windows EnumFontFamilies puede utilizarse para enumerar todas las fuentes disponibles actualmente. Si lpszFacename es NULL, la GDI utiliza una tipografía independiente del dispositivo.

Observaciones

Inicializa un objeto CFont con las características especificadas. Posteriormente se puede seleccionar la fuente como la fuente de cualquier contexto de dispositivo.

La función CreateFont no crear una nueva fuente de GDI de Windows. Simplemente selecciona a la coincidencia más cercana de las fuentes disponibles en la piscina del GDI de fuentes físicas.

Las aplicaciones pueden utilizar la configuración predeterminada para la mayoría de estos parámetros al crear una fuente lógica. Los parámetros que deben siempre tener valores específicos son nHeight y lpszFacename. Si no se establecen nHeight y lpszFacename por la aplicación, la fuente lógica que se crea es dependiente del dispositivo.

Cuando termine con el objeto de CFont creado por la función de CreateFont , primero seleccione la fuente del contexto de dispositivo, y eliminar el objeto CFont.

Visión General de CFont |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CFont::CreateFontIndirect, CFont::CreatePointFont, :: CreateFont, :: EnumFontFamilies, :: EnumFonts

Index