font.h

Clase wxFont

Una fuente es un objeto que determina la apariencia del texto.

Jerarquía:

Las fuentes se utilizan para dibujar texto en el contexto de un dispositivo, y para establecer la apariencia del texto de una ventana, véase wxDC::SetFont() y wxWindow::SetFont().

La forma más sencilla de crear una fuente personalizada es utilizar el objeto wxFontInfo para especificar los atributos de la fuente y luego utilizar el constructor wxFont::wxFont(const wxFontInfo&). Alternativamente, se puede empezar con una de las fuentes predefinidas o utilizar wxWindow::GetFont() y modificar la fuente, por ejemplo, aumentando su tamaño utilizando MakeLarger() o cambiando su peso utilizando MakeBold().

Esta clase utiliza internamente el recuento de referencias y la copia en escritura, de modo que las asignaciones entre dos instancias de esta clase son muy baratas. Por tanto, se pueden utilizar objetos reales en lugar de punteros sin problemas de eficiencia. Si se cambia una instancia de esta clase, creará sus propios datos internamente para que otras instancias, que previamente compartieron los datos usando el conteo de referencias, no se vean afectadas.

Se puede recuperar la configuración actual de fuentes del sistema con wxSystemSettings.

Funciones miembro

wxFont()

wxFont::wxFont()

Constructor por defecto.

wxFont()

wxFont::wxFont(const wxFont & font)

Constructor copia. Usa contador de referencias.

wxFont()

wxFont::wxFont(const wxFontInfo & fontInfo)

Crea un objeto de fuente utilizando la descripción de fuente especificada.

Esta es la forma preferida de crear objetos de tipo de letra, ya que el uso de este constructor da como resultado un código más legible y también es extensible, por ejemplo, podría seguir utilizándose si en el futuro se añadiera soporte para más atributos de tipo de letra. Por ejemplo, este constructor proporciona la única forma de crear fuentes con estilo tachado.

Ejemplo de creación de una fuente usando este constructor:

wxFont font(wxFontInfo(10).Bold().Underlined());

wxFont()

wxFont::wxFont( int pointSize, wxFontFamily family, wxFontStyle style, wxFontWeight weight, bool underline = false, const wxString & faceName = wxEmptyString, wxFontEncoding encoding = wxFONTENCODING_DEFAULT )

Crea un objeto fuente con los atributos y tamaño en puntos especificados.

Hay que tener en cuenta que el uso de este constructor es a menudo más verboso y menos legible que el uso de wxFont(const wxFontInfo& font), por ejemplo, el ejemplo en la documentación del constructor tendría que ser escrito como:

wxFont font(10, wxFONTFAMILY_DEFAULT, wxFONTSTYLE_NORMAL,
            wxFONTWEIGHT_BOLD, true);

Parámetros

pointSize: Tamaño en puntos. Véase SetPointSize() para más información. Hay que tener en cuenta que, por razones históricas, el valor 70 aquí se interpreta en wxDEFAULT y resulta en la creación de la fuente con el tamaño por defecto y no de una fuente con el tamaño de 70pt. Si realmente necesita esto último, por favor utilizar SetPointSize(70). También hay que tener en cuenta que este constructor y la sobrecarga correspondiente del método Create() son los únicos lugares de la API de wxFont que manejan wxDEFAULT de forma especial: ni SetPointSize() ni el constructor que toma wxFontInfo manejan este valor de esta forma.
family: La familia de fuentes: una forma genérica y portable de referirse a las fuentes sin especificar un nombre de cara. Este parámetro debe ser uno de los valores de la enumeración wxFontFamily. Si se proporciona el argumento faceName, éste sustituye a la familia de fuentes.
style: Uno de wxFONTSTYLE_NORMAL, wxFONTSTYLE_SLANT y wxFONTSTYLE_ITALIC.
weight: Peso de la fuente, a veces también denominado negrita de la fuente. Uno de los valores de la enumeración wxFontWeight.
underline: El valor puede ser verdadero o falso. Actualmente sólo tiene efecto en Windows y Motif 2.x.
faceName: Cadena opcional que especifica el nombre de la fuente que se utilizará. Si es una cadena vacía, se elegirá un nombre de cara por defecto basado en la familia.
encoding: Codificación que puede ser uno de los valores de la enumeración wxFontEncoding. Si la codificación especificada no está disponible, no se creará ninguna fuente (véase también Codificaciones de fuentes).

Observaciones

Si la fuente deseada no existe, se elegirá la más parecida. En Windows, sólo se utilizan fuentes TrueType escalables.

wxFont()

wxFont::wxFont( const wxSize & pixelSize, wxFontFamily family, wxFontStyle style, wxFontWeight weight, bool underline = false, const wxString & faceName = wxEmptyString, wxFontEncoding encoding = wxFONTENCODING_DEFAULT )

Crea un objeto fuente con los atributos especificados y el tamaño en píxeles.

Hay que tener en cuenta que el uso de este constructor es a menudo más verboso y menos legible que el uso del constructor de wxFontInfo, considerar usar ese constructor en su lugar.

Parámetros

pixelSize: Tamaño en píxeles. Ver SetPixelSize() para más información.
family: La familia de fuentes: una forma genérica y portable de referirse a las fuentes sin especificar un nombre de cara. Este parámetro debe ser uno de los valores de la enumeración wxFontFamily. Si se proporciona el argumento faceName, éste sustituye a la familia de fuentes.
style: Uno de wxFONTSTYLE_NORMAL, wxFONTSTYLE_SLANT y wxFONTSTYLE_ITALIC.
weight: Peso de la fuente, a veces también denominado negrita de la fuente. Uno de los valores de la enumeración wxFontWeight.
underline: El valor puede ser verdadero o falso. Actualmente sólo tiene efecto en Windows y Motif 2.x.
faceName: Cadena opcional que especifica el nombre de la fuente que se utilizará. Si es una cadena vacía, se elegirá un nombre de cara por defecto basado en la familia.
encoding: Codificación que puede ser uno de los valores de la enumeración wxFontEncoding. Si la codificación especificada no está disponible, no se creará ninguna fuente (véase también Codificaciones de fuentes).

Observaciones

Si la fuente deseada no existe, se elegirá la más parecida. En Windows, sólo se utilizan fuentes TrueType escalables.

wxFont()

wxFont::wxFont(const wxString & nativeInfoString)

Constructor a partir de la cadena de descripción de la fuente.

Este constructor utiliza SetNativeFontInfo() para inicializar la fuente. Si fontdesc no es válida, la fuente permanece sin inicializar, es decir, su método IsOk() devolverá false.

wxFont()

wxFont::wxFont(const wxNativeFontInfo & nativeInfo)

Construye la fuente a partir de una estructura de información de fuente nativa.

~wxFont()

virtual wxFont::~wxFont()

Destructor.

Ver destrucción de objetos por referencia para más información.

Observaciones

Aunque todas las fuentes restantes se borran cuando la aplicación sale, la aplicación debería intentar limpiar todas las fuentes por sí misma. Esto se debe a que wxWidgets no puede saber si un puntero al objeto fuente está almacenado en una estructura de datos de la aplicación, y existe el riesgo de un doble borrado.

AddPrivateFont()

static bool wxFont::AddPrivateFont(const wxString & filename)

Especifica el nombre de un archivo que contiene una fuente TrueType que se pondrá a disposición de la aplicación actual.

Este método se puede utilizar para permitir que esta aplicación utilice la fuente del archivo dado incluso si no está instalada globalmente en el sistema.

En macOS, este método no hace nada más que comprobar la existencia del archivo en el subdirectorio "Fuentes" del directorio "Recursos" del paquete de aplicaciones. Usted es responsable de hacer que el archivo de fuentes esté disponible en este directorio y de establecer el valor ATSApplicationFontsPath to Fonts en su archivo Info.plist. Ver también wxStandardPaths::GetResourcesDir().

Bajo MSW este método debe ser llamado antes de que cualquier objeto wxGraphicsContext haya sido creado, de lo contrario la fuente privada no será utilizable desde ellos.

Bajo Unix este método requiere Pango 1.38 o posterior y devolverá false y registrará un mensaje de error explicando el problema si este requisito no se cumple ya sea en tiempo de compilación o de ejecución.

Actualmente este método está implementado para todas las plataformas principales (sujeto a tener Pango 1.38 o posterior cuando se ejecuta configure bajo Unix) y wxUSE_PRIVATE_FONTS está siempre a 0 bajo las otras plataformas, haciendo que esta función no esté disponible en tiempo de compilación.

Valor de retorno

true si la fuente fue añadida y puede ser usada.

Bold()

wxFont wxFont::Bold() const

Devuelve una versión en negrita de esta fuente.

GetBaseFont()

wxFont wxFont::GetBaseFont() const

Devuelve una fuente con la misma cara/tamaño que la dada pero con peso y estilo normales y sin subrayar ni tachar.

GetDefaultEncoding()

static wxFontEncoding wxFont::GetDefaultEncoding()

Devuelve la codificación por defecto de la aplicación actual.

GetEncoding()

virtual wxFontEncoding wxFont::GetEncoding() const

Devuelve la codificación de esta fuente.

Hay que tener en cuenta que bajo wxGTK el valor devuelto es siempre wxFONTENCODING_UTF8.

GetFaceName()

virtual wxString wxFont::GetFaceName() const

Devuelve el nombre de la cara asociada a la fuente, o la cadena vacía si no hay información sobre la cara.

GetFamily()

virtual wxFontFamily wxFont::GetFamily() const

Obtiene la familia de fuentes si es posible.

Como se describe en la documentación de wxFontFamily, el valor devuelto actúa como una clasificación básica aproximada de las principales propiedades de la fuente (aspecto, espaciado).

Si el nombre de la fuente actual no es reconocido por wxFont o por el sistema subyacente, se devuelve wxFONTFAMILY_DEFAULT.

Hay que tener en cuenta que actualmente esta función no es muy precisa y por lo tanto no es particularmente útil. Las familias de fuentes sólo tienen sentido para la creación de fuentes, véase SetFamily().

GetFractionalPointSize()

virtual double wxFont::GetFractionalPointSize() const

Obtiene el tamaño del punto como un número en coma flotante.

GetNativeFontInfo()

const wxNativeFontInfo* wxFont::GetNativeFontInfo() const

Devuelve una fuente con la misma cara/tamaño que la dada pero con peso y estilo normales y sin subrayar ni tachar.

GetNativeFontInfoDesc()

wxString wxFont::GetNativeFontInfoDesc() const

Devuelve la cadena dependiente de la plataforma que describe completamente esta fuente.

La cadena devuelta es siempre no vacía a menos que la fuente no sea válida (en cuyo caso se lanza un assert).

Hay que tener en cuenta que la cadena devuelta no está destinada a ser mostrada o editada por el usuario: un uso típico de esta función es para serializar en forma de cadena un objeto wxFont.

GetNativeFontInfoUserDesc()

wxString wxFont::GetNativeFontInfoUserDesc() const

Devuelve una cadena amigable para este objeto de fuente.

La cadena devuelta es siempre no vacía a menos que la fuente no sea válida (en cuyo caso se lanza un assert).

La cadena no codifica toda la información de wxFont en todas las plataformas; por ejemplo, en wxMSW la familia de fuentes no está presente en la cadena devuelta.

Algunos ejemplos de los formatos de las cadenas devueltas (que dependen de la plataforma) están en SetNativeFontInfoUserDesc().

GetNumericWeight()

virtual int wxFont::GetNumericWeight() const

Obtiene el peso de la fuente como un valor entero.

Véase wxFontWeight para una lista de identificadores de peso válidos y su correspondiente valor entero.

GetNumericWeightOf()

static int wxFont::GetNumericWeightOf(wxFontWeight weight)

Obtiene el valor de peso bruto correspondiente a la constante simbólica dada.

Por compatibilidad, esta función trata los valores wxNORMAL, wxLIGHT y wxBOLD, que tienen los valores 90, 91 y 92, de forma especial y los convierte al valor de peso wxFONTWEIGHT_XXX correspondiente.

Parámetros

weight: Un elemento válido del enum wxFontWeight, es decir, este argumento no puede tener valor wxFONTWEIGHT_INVALID.

Valor de retorno

Peso numérico, entre 1 y 1000.

GetPixelSize()

virtual wxSize wxFont::GetPixelSize() const

Obtiene el tamaño del píxel.

Hay que tener en cuenta que en wxMSW si se pasa a SetPixelSize() (o al constructor) un objeto wxSize con un valor de anchura nulo, se obtendrá una anchura nula en el objeto devuelto.

GetPointSize()

virtual int wxFont::GetPointSize() const

Obtiene el tamaño del punto como un número entero.

Esta función se mantiene por razones de compatibilidad. El código nuevo debería usar GetFractionalPointSize() y admitir tamaños de punto fraccionarios.

GetStrikethrough()

virtual bool wxFont::GetStrikethrough() const

Devuelve true si la fuente es tachada, false en caso contrario.

GetStyle()

virtual wxFontStyle wxFont::GetStyle() const

Obtiene el estilo de fuente.

Ver wxFontStyle para una lista de estilos válidos.

GetUnderlined()

virtual bool wxFont::GetUnderlined() const

Devuelve true si la fuente está subrayada, false en caso contrario.

GetWeight()

virtual wxFontWeight wxFont::GetWeight() const

Obtiene el peso de la fuente.

Ver wxFontWeight para una lista de identificadores de peso válidos.

IsFixedWidth()

virtual bool wxFont::IsFixedWidth() const

Devuelve true si la fuente es de anchura fija (o monoespaciada), false si es proporcional o la fuente no es válida.

Hay que tener en cuenta que esta función en algunas plataformas es diferente de simplemente comprobar si la familia de fuentes es igual a wxFONTFAMILY_TELETYPE porque se utilizan funciones nativas específicas de la plataforma para la comprobación (lo que resulta en un valor de retorno más preciso).

IsOk()

virtual bool wxFont::IsOk() const

Devuelve true si este objeto es una fuente válida, false en caso contrario.

Italic()

wxFont wxFont::Italic() const

Devuelve una versión en cursiva de esta fuente.

Larger()

wxFont wxFont::Larger() const

Devuelve una versión más grande de esta fuente.

El tamaño de la fuente se multiplica por 1.2, factor inspirado en la especificación CSS del W3C.

MakeBold()

wxFont& wxFont::MakeBold()

Cambia esta fuente a negrita.

MakeItalic()

wxFont& wxFont::MakeItalic()

Cambia esta fuente a cursiva.

MakeLarger()

wxFont& wxFont::MakeLarger()

Cambia esta fuente para que sea más grande.

El tamaño de la fuente se multiplica por 1,2, factor inspirado en la especificación CSS del W3C.

MakeSmaller()

wxFont& wxFont::MakeSmaller()

Cambia esta fuente para que sea más pequeña.

El tamaño de la fuente se divide por 1,2, el factor de 1,2 está inspirado en la especificación CSS del W3C.

MakeStrikethrough()

wxFont& wxFont::MakeStrikethrough()

Cambia esta fuente a tachada.

Actualmente, las fuentes tachadas sólo se admiten en wxMSW, wxGTK y wxOSX.

MakeUnderlined()

wxFont& wxFont::MakeUnderlined()

Cambia esta fuente para que aparezca subrayada.

New()

static wxFont* wxFont::New(const wxNativeFontInfo & nativeInfo)

Esta función toma los mismos parámetros que el constructor wxFont relativo y devuelve un nuevo objeto fuente asignado en el montón.