Clase wxFontInfo
Esta clase es un ayudante para la creación de wxFont usando el lenguaje de parámetros con nombre: permite especificar varios atributos de wxFont usando llamadas encadenadas a sus métodos claramente nombrados en lugar de pasarlos en un orden fijo a los constructores de wxFont.
Por ejemplo, para crear una fuente en cursiva con el nombre y tamaño de fuente dados se puede usar:
wxFont font(wxFontInfo(12).FaceName("Helvetica").Italic());
Obsérvese que todos los métodos de este objeto devuelven una referencia al propio objeto, lo que permite encadenar las llamadas a ellos como en el ejemplo anterior.
Todos los métodos que toman parámetros booleanos pueden utilizarse para activar o desactivar el atributo de fuente especificado y activarlo por defecto.
Funciones miembro
wxFontInfo()
wxFontInfo::wxFontInfo()
El constructor por defecto utiliza el tamaño de fuente por defecto para la plataforma actual.
wxFontInfo()
wxFontInfo::wxFontInfo(double pointSize)
Constructor que establece el tamaño de fuente en puntos a utilizar.
Hay que tener en cuenta que hasta wxWidgets 3.1.2 los tamaños de punto fraccionarios no estaban soportados, y el tipo de pointSize era int.
wxFontInfo()
wxFontInfo::wxFontInfo(const wxSize & pixelSize)
Constructor que establece el tamaño de fuente en píxeles a utilizar.
AllFlags()
wxFontInfo& wxFontInfo::AllFlags(int flags)
Establece todos los atributos de la fuente a la vez.
Ver wxFontFlag para los distintos indicadores que se pueden utilizar.
Hay que tener en cuenta que llamar a este método afecta al peso de la fuente almacenada en este objeto: se establece a wxFONTWEIGHT_LIGHT o wxFONTWEIGHT_BOLD si la bandera correspondiente está presente en flags, o wxFONTWEIGHT_NORMAL en caso contrario.
AntiAliased()
wxFontInfo& wxFontInfo::AntiAliased(bool antiAliased = true)
Activar el anti-aliasing.
Activa o desactiva el antialiasing.
Actualmente esto no está implementado, es decir, usar este método no hace nada.
Bold()
wxFontInfo& wxFontInfo::Bold(bool bold = true)
Utiliza una versión en negrita de la fuente.
Esta es una envoltura para Weight() llamándola con el argumento wxFONTWEIGHT_BOLD.
Encoding()
wxFontInfo& wxFontInfo::Encoding(wxFontEncoding encoding)
Establece la codificación de fuente a utilizar.
Esto es innecesario en las versiones Unicode de wxWidgets.
FaceName()
wxFontInfo& wxFontInfo::FaceName(const wxString & faceName)
Establece el nombre de la fuente a utilizar.
Los nombres de fuente no son portables, por lo que es preferible usar Family() en código portable.
Family()
wxFontInfo& wxFontInfo::Family(wxFontFamily family)
Establece la familia de fuentes.
La familia es una forma genérica portátil de referirse a las fuentes sin especificar un nombre de cara preciso. Este parámetro debe ser uno de los valores de la enumeración wxFontFamily.
Si se utiliza FaceName(), entonces anula la familia de fuentes.
GetWeightClosestToNumericValue()
static wxFontWeight wxFontInfo::GetWeightClosestToNumericValue(int numWeight)
Obtiene el peso simbólico más cercano al valor del peso bruto dado.
Parámetros
- numWeight
- Un valor de peso bruto válido, es decir, un valor comprendido entre 1 y 1000, ambos inclusive.
Valor de retorno
Un elemento válido del enum wxFontWeight.
Italic()
wxFontInfo& wxFontInfo::Italic(bool italic = true)
Utiliza una versión en cursiva de la fuente.
Esta es una envoltura para Style() llamándola con el argumento wxFONTSTYLE_ITALIC.
Light()
wxFontInfo& wxFontInfo::Light(bool light = true)
Utiliza una versión más ligera de la fuente.
Esta es una envoltura para Weight() llamándola con el argumento wxFONTWEIGHT_LIGHT.
Slant()
wxFontInfo& wxFontInfo::Slant(bool slant = true)
Utiliza una versión inclinada de la fuente.
Esta es una envoltura para Style() llamándola con el argumento wxFONTSTYLE_SLANT.
Strikethrough()
wxFontInfo& wxFontInfo::Strikethrough(bool strikethrough = true)
Utilizar una versión tachada de la fuente.
Actualmente esto sólo está implementado en wxMSW, wxGTK y wxOSX.
Style()
wxFontInfo& wxFontInfo::Style(wxFontStyle style)
Especifica el estilo de la fuente utilizando una de las constantes wxFontStyle.
Underlined()
wxFontInfo& wxFontInfo::Underlined(bool underlined = true)
Utilizar una versión subrayada de la fuente.
Weight()
wxFontInfo& wxFontInfo::Weight(int weight)
Especifica el peso de la fuente.
Parámetros
- weight
- Un peso de fuente en el rango de 1 a 1000, ambos inclusive, siendo 1 la variante de fuente más fina y 1000 la más pesada posible. Los valores wxFONTWEIGHT_XXX del enum wxFontWeight pueden usarse aquí.