QFont Class
La clase QFont especifica una consulta para una fuente utilizada para dibujar texto. Más...
| Cabecera: | #include <QFont> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QFont es parte de Painting Classes, Implicitly Shared Classes y Rich Text Processing APIs.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos Públicos
(since 6.7) struct | Tag |
| enum | Capitalization { MixedCase, AllUppercase, AllLowercase, SmallCaps, Capitalize } |
| enum | HintingPreference { PreferDefaultHinting, PreferNoHinting, PreferVerticalHinting, PreferFullHinting } |
| enum | SpacingType { PercentageSpacing, AbsoluteSpacing } |
| enum | Stretch { AnyStretch, UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, …, UltraExpanded } |
| enum | Style { StyleNormal, StyleItalic, StyleOblique } |
| enum | StyleHint { AnyStyle, SansSerif, Helvetica, Serif, Times, …, System } |
| enum | StyleStrategy { PreferDefault, PreferBitmap, PreferDevice, PreferOutline, ForceOutline, …, PreferQuality } |
| enum | Weight { Thin, ExtraLight, Light, Normal, Medium, …, Black } |
Funciones públicas
| QFont() | |
| QFont(const QFont &font, const QPaintDevice *pd) | |
| QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false) | |
| QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false) | |
| QFont(const QFont &font) | |
| ~QFont() | |
| bool | bold() const |
| QFont::Capitalization | capitalization() const |
(since 6.7) void | clearFeatures() |
(since 6.7) void | clearVariableAxes() |
| QString | defaultFamily() const |
| bool | exactMatch() const |
| QStringList | families() const |
| QString | family() const |
(since 6.7) QList<QFont::Tag> | featureTags() const |
(since 6.7) quint32 | featureValue(QFont::Tag tag) const |
| bool | fixedPitch() const |
| bool | fromString(const QString &descrip) |
| QFont::HintingPreference | hintingPreference() const |
| bool | isCopyOf(const QFont &f) const |
(since 6.7) bool | isFeatureSet(QFont::Tag tag) const |
(since 6.7) bool | isVariableAxisSet(QFont::Tag tag) const |
| bool | italic() const |
| bool | kerning() const |
| QString | key() const |
| qreal | letterSpacing() const |
| QFont::SpacingType | letterSpacingType() const |
| bool | overline() const |
| int | pixelSize() const |
| int | pointSize() const |
| qreal | pointSizeF() const |
| QFont | resolve(const QFont &other) const |
| void | setBold(bool enable) |
| void | setCapitalization(QFont::Capitalization caps) |
| void | setFamilies(const QStringList &families) |
| void | setFamily(const QString &family) |
(since 6.7) void | setFeature(QFont::Tag tag, quint32 value) |
| void | setFixedPitch(bool enable) |
| void | setHintingPreference(QFont::HintingPreference hintingPreference) |
| void | setItalic(bool enable) |
| void | setKerning(bool enable) |
| void | setLetterSpacing(QFont::SpacingType type, qreal spacing) |
| void | setOverline(bool enable) |
| void | setPixelSize(int pixelSize) |
| void | setPointSize(int pointSize) |
| void | setPointSizeF(qreal pointSize) |
| void | setStretch(int factor) |
| void | setStrikeOut(bool enable) |
| void | setStyle(QFont::Style style) |
| void | setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault) |
| void | setStyleName(const QString &styleName) |
| void | setStyleStrategy(QFont::StyleStrategy s) |
| void | setUnderline(bool enable) |
(since 6.7) void | setVariableAxis(QFont::Tag tag, float value) |
| void | setWeight(QFont::Weight weight) |
| void | setWordSpacing(qreal spacing) |
| int | stretch() const |
| bool | strikeOut() const |
| QFont::Style | style() const |
| QFont::StyleHint | styleHint() const |
| QString | styleName() const |
| QFont::StyleStrategy | styleStrategy() const |
| void | swap(QFont &other) |
| QString | toString() const |
| bool | underline() const |
(since 6.7) void | unsetFeature(QFont::Tag tag) |
(since 6.7) void | unsetVariableAxis(QFont::Tag tag) |
(since 6.7) QList<QFont::Tag> | variableAxisTags() const |
(since 6.7) float | variableAxisValue(QFont::Tag tag) const |
| QFont::Weight | weight() const |
| qreal | wordSpacing() const |
| operator QVariant() const | |
| bool | operator!=(const QFont &f) const |
| bool | operator<(const QFont &f) const |
| QFont & | operator=(QFont &&other) |
| QFont & | operator=(const QFont &font) |
| bool | operator==(const QFont &f) const |
Miembros públicos estáticos
| void | insertSubstitution(const QString &familyName, const QString &substituteName) |
| void | insertSubstitutions(const QString &familyName, const QStringList &substituteNames) |
| void | removeSubstitutions(const QString &familyName) |
| QString | substitute(const QString &familyName) |
| QStringList | substitutes(const QString &familyName) |
| QStringList | substitutions() |
Relacionados No Miembros
| size_t | qHash(const QFont &key, size_t seed = 0) |
| QDataStream & | operator<<(QDataStream &s, const QFont &font) |
| QDataStream & | operator>>(QDataStream &s, QFont &font) |
Descripción detallada
QFont puede considerarse como una consulta de una o más fuentes del sistema.
Cuando se crea un objeto QFont se especifican varios atributos que se desea que tenga la fuente. Qt utilizará la fuente con los atributos especificados, o si no existe ninguna fuente que coincida, Qt utilizará la fuente instalada que más se aproxime. Los atributos de la fuente que se utiliza realmente se pueden recuperar desde un objeto QFontInfo. Si el sistema de ventanas proporciona una coincidencia exacta exactMatch() devuelve true. Utilice QFontMetricsF para obtener medidas, por ejemplo, la longitud en píxeles de una cadena utilizando QFontMetrics::horizontalAdvance().
Los atributos que no se establezcan específicamente no afectarán al algoritmo de selección de fuentes y, en su lugar, se preferirán los valores predeterminados.
Para cargar una fuente física específica, normalmente representada por un único archivo, utilice QRawFont en su lugar.
Tenga en cuenta que debe existir una instancia de QGuiApplication antes de poder utilizar una QFont. Puedes establecer la fuente por defecto de la aplicación con QGuiApplication::setFont().
Si una fuente elegida no incluye todos los caracteres que deben mostrarse, QFont intentará encontrar los caracteres en las fuentes equivalentes más cercanas. Cuando QPainter dibuje un carácter de una fuente, QFont informará de si tiene o no el carácter; si no lo tiene, QPainter dibujará un cuadrado sin rellenar.
Crea QFonts así:
Los atributos establecidos en el constructor también pueden establecerse posteriormente, por ejemplo setFamily(), setPointSize(), setPointSizeF(), setWeight() y setItalic(). El resto de atributos deben establecerse después de la construcción, por ejemplo setBold(), setUnderline(), setOverline(), setStrikeOut() y setFixedPitch(). Los objetos QFontInfo deben crearse después de haber establecido los atributos de la fuente. Un objeto QFontInfo no cambiará aunque se modifiquen los atributos de la fuente. Las funciones "get" correspondientes, por ejemplo family(), pointSize(), etc., devuelven los valores que se establecieron, aunque los valores utilizados puedan diferir. Los valores reales están disponibles en un objeto QFontInfo.
Si la familia tipográfica solicitada no está disponible, puede influir en font matching algorithm eligiendo una determinada QFont::StyleHint y QFont::StyleStrategy con setStyleHint(). La familia por defecto (correspondiente a la sugerencia de estilo actual) es devuelta por defaultFamily().
Puede proporcionar sustituciones para los nombres de familia de fuentes utilizando insertSubstitution() y insertSubstitutions(). Las sustituciones pueden eliminarse con removeSubstitutions(). Utilice substitute() para recuperar el primer sustituto de una familia, o el propio nombre de la familia si no tiene sustitutos. Utilice substitutes() para obtener una lista de los sustitutos de una familia (que puede estar vacía). Después de sustituir una fuente, debes activar la actualización de la fuente destruyendo y volviendo a crear todos los objetos QFont.
Cada QFont tiene un key() que puedes usar, por ejemplo, como clave en una caché o diccionario. Si quieres almacenar las preferencias de fuente de un usuario puedes usar QSettings, escribiendo la información de la fuente con toString() y leyéndola de vuelta con fromString(). Las funciones operator<<() y operator>>() también están disponibles, pero trabajan sobre un flujo de datos.
Es posible ajustar la altura de los caracteres mostrados en pantalla a un número especificado de píxeles con setPixelSize(); sin embargo, el uso de setPointSize() tiene un efecto similar y proporciona independencia del dispositivo.
La carga de fuentes puede ser costosa, especialmente en X11. QFont contiene amplias optimizaciones para que la copia de objetos QFont sea rápida, y para almacenar en caché los resultados de las lentas funciones del sistema de ventanas de las que depende.
El algoritmo de correspondencia de fuentes funciona de la siguiente manera:
- Se buscan las familias de fuentes especificadas (establecidas por setFamilies()).
- Si no, se selecciona una fuente de reemplazo que soporte el sistema de escritura. El algoritmo de correspondencia de fuentes intentará encontrar la que mejor se ajuste a todas las propiedades establecidas en QFont. La forma de hacerlo varía de una plataforma a otra.
- Si no existe ninguna fuente en el sistema que admita el texto, se mostrarán en su lugar cuadros especiales de "carácter que falta".
Nota: Si la fuente seleccionada, aunque soporta el sistema de escritura en general, carece de glifos para uno o más caracteres específicos, entonces Qt intentará encontrar una fuente alternativa para este o estos caracteres en particular. Esta función puede desactivarse mediante la estrategia de estilo QFont::NoFontMerging.
En Windows, si se solicita la fuente "Courier", se cambia automáticamente a "Courier New", una versión mejorada de Courier que permite un escalado suave. La fuente de mapa de bits "Courier" más antigua puede seleccionarse configurando la estrategia de estilo PreferBitmap (véase setStyleStrategy()).
Una vez encontrada una fuente, se comparan los atributos restantes por orden de prioridad:
- fixedPitch()
- pointSize() (véase más abajo)
- weight()
- style()
Si tiene un tipo de letra que coincide en la familia, aunque no coincida ninguno de los demás atributos, este tipo de letra se elegirá con preferencia a otro que no coincida en la familia pero sí en los demás atributos. Esto se debe a que la familia de fuentes es el criterio de búsqueda dominante.
Se considera que el tamaño de punto coincide si está dentro del 20% del tamaño de punto solicitado. Cuando varias fuentes coinciden y sólo se distinguen por el tamaño de punto, se elegirá la fuente con el tamaño de punto más cercano al solicitado.
La familia real, el tamaño de fuente, el peso y otros atributos de fuente utilizados para dibujar el texto dependerán de lo que esté disponible para la familia elegida en el sistema de ventanas. Se puede utilizar un objeto QFontInfo para determinar los valores reales utilizados para dibujar el texto.
Ejemplos:
QFont f("Helvetica");
Si tuvieras una Adobe y una Cronyx Helvetica, podrías obtener cualquiera de las dos.
QFont f("Helvetica [Cronyx]");
Puede especificar la fundición que desee en el nombre de la familia. La fuente f en el ejemplo anterior se establecerá en "Helvetica [Cronyx]".
Para determinar los atributos de la fuente realmente utilizada en el sistema de ventanas, utilice un objeto QFontInfo, por ejemplo
Para conocer las métricas de la fuente utilice un objeto QFontMetrics, por ejemplo
QFontMetrics fm(f1); int textWidthInPixels = fm.horizontalAdvance("How many pixels wide is this text?"); int textHeightInPixels = fm.height();
Para más información general sobre fuentes, consulte las FAQ de comp.fonts. Puede encontrar información sobre codificaciones en la página UTR17.
Véase también QFontMetrics, QFontInfo, y QFontDatabase.
Documentación de tipos de miembros
enum QFont::Capitalization
Opción de representación para el texto al que se aplica esta fuente.
| Constante | Valor | Descripción |
|---|---|---|
QFont::MixedCase | 0 | Esta es la opción normal de renderizado de texto donde no se aplica ningún cambio de mayúsculas. |
QFont::AllUppercase | 1 | Modifica el texto para que aparezca en mayúsculas. |
QFont::AllLowercase | 2 | Modifica el texto para que aparezca en minúsculas. |
QFont::SmallCaps | 3 | Modifica el texto para que aparezca en minúsculas. |
QFont::Capitalize | 4 | Modifica el texto para que el primer carácter de cada palabra sea mayúscula. |
enum QFont::HintingPreference
Este enum describe los distintos niveles de insinuación que pueden aplicarse a los glifos para mejorar la legibilidad en pantallas en las que la densidad de píxeles lo justifique.
| Constante | Valor | Descripción |
|---|---|---|
QFont::PreferDefaultHinting | 0 | Utiliza el nivel de sugerencia por defecto para la plataforma de destino. |
QFont::PreferNoHinting | 1 | Si es posible, renderice el texto sin insinuar los contornos de los glifos. El diseño del texto será tipográficamente preciso y escalable, utilizando las mismas métricas que se utilizan, por ejemplo, al imprimir. |
QFont::PreferVerticalHinting | 2 | Si es posible, represente el texto sin insinuación horizontal, pero alinee los glifos con la cuadrícula de píxeles en dirección vertical. El texto aparecerá más nítido en las pantallas en las que la densidad sea demasiado baja para ofrecer una representación precisa de los glifos. Pero como las métricas horizontales de los glifos no están insinuadas, el diseño del texto será escalable a dispositivos de mayor densidad (como impresoras) sin afectar a detalles como los saltos de línea. |
QFont::PreferFullHinting | 3 | Si es posible, represente el texto con insinuación tanto en horizontal como en vertical. El texto se modificará para optimizar la legibilidad en el dispositivo de destino, pero como las métricas dependerán del tamaño de destino del texto, las posiciones de los glifos, los saltos de línea y otros detalles tipográficos no se escalarán, lo que significa que un diseño de texto puede tener un aspecto diferente en dispositivos con distintas densidades de píxeles. |
Tenga en cuenta que este enum sólo describe una preferencia, ya que la gama completa de niveles de sugerencia no es compatible con todas las plataformas soportadas por Qt. La siguiente tabla detalla el efecto de una preferencia de sugerencia determinada en un conjunto seleccionado de plataformas de destino.
| PreferDefaultHinting | PreferNoHinting | PreferVerticalHinting | PreferFullHinting | |
|---|---|---|---|---|
| Windows y DirectWrite habilitados en Qt | Sugerencia completa | Sugerencia vertical | Sugerencia vertical | Sugerencia completa |
| FreeType | Configuración del sistema operativo | No hinting | Insinuación vertical (ligera) | Insinuación completa |
| Cocoa en macOS | No hinting | No hinting | No hinting | Sin sugerencias |
enum QFont::SpacingType
| Constante | Valor | Descripción |
|---|---|---|
QFont::PercentageSpacing | 0 | Un valor de 100 mantendrá el espaciado sin cambios; un valor de 200 aumentará el espaciado después de un carácter en la anchura del propio carácter. |
QFont::AbsoluteSpacing | 1 | Un valor positivo aumenta el espaciado de las letras en los píxeles correspondientes; un valor negativo lo reduce. |
enum QFont::Stretch
Valores de estiramiento predefinidos que siguen la convención de nomenclatura CSS. Cuanto mayor sea el valor, más estirado estará el texto.
| Constante | Valor | Descripción |
|---|---|---|
QFont::AnyStretch (since Qt 5.8) | 0 | 0 Acepta cualquier estiramiento igualado usando las otras propiedades de QFont |
QFont::UltraCondensed | 50 | 50 |
QFont::ExtraCondensed | 62 | 62 |
QFont::Condensed | 75 | 75 |
QFont::SemiCondensed | 87 | 87 |
QFont::Unstretched | 100 | 100 |
QFont::SemiExpanded | 112 | 112 |
QFont::Expanded | 125 | 125 |
QFont::ExtraExpanded | 150 | 150 |
QFont::UltraExpanded | 200 | 200 |
Véase también setStretch() y stretch().
enum QFont::Style
Este enum describe los diferentes estilos de glifos que se utilizan para mostrar texto.
| Constante | Valor | Descripción |
|---|---|---|
QFont::StyleNormal | 0 | Glifos normales utilizados en texto sin estilo. |
QFont::StyleItalic | 1 | Glifos en cursiva diseñados específicamente para representar texto en cursiva. |
QFont::StyleOblique | 2 | Glifos con apariencia cursiva que se basan normalmente en los glifos sin estilo, pero que no están ajustados con el fin de representar texto en cursiva. |
Véase también Weight.
enum QFont::StyleHint
El algoritmo font matching utiliza sugerencias de estilo para encontrar una familia predeterminada adecuada si la familia de fuentes seleccionada no está disponible.
| Constante | Valor | Descripción |
|---|---|---|
QFont::AnyStyle | 5 | deja que el algoritmo de concordancia de fuentes elija la familia. Este es el valor predeterminado. |
QFont::SansSerif | Helvetica | el comparador de fuentes prefiere fuentes sans serif. |
QFont::Helvetica | 0 | es un sinónimo de SansSerif. |
QFont::Serif | Times | el comparador de fuentes prefiere fuentes con gracias. |
QFont::Times | 1 | es un sinónimo de Serif. |
QFont::TypeWriter | Courier | el comparador de fuentes prefiere fuentes de tono fijo. |
QFont::Courier | 2 | es sinónimo de TypeWriter. |
QFont::OldEnglish | 3 | el buscador de fuentes prefiere fuentes decorativas. |
QFont::Decorative | OldEnglish | es sinónimo de OldEnglish. |
QFont::Monospace | 7 | el comparador de fuentes prefiere fuentes que se correspondan con la familia de fuentes genérica CSS 'monospace'. |
QFont::Fantasy | 8 | el correlacionador de fuentes prefiere fuentes que correspondan a la familia de fuentes genérica de CSS 'fantasy'. |
QFont::Cursive | 6 | el correlacionador de fuentes prefiere fuentes que correspondan a la familia de fuentes genérica de CSS 'cursive'. |
QFont::System | 4 | el comparador de fuentes prefiere fuentes del sistema. |
enum QFont::StyleStrategy
La estrategia de estilo indica al algoritmo font matching qué tipo de fuentes debe utilizar para encontrar una familia predeterminada adecuada.
Están disponibles las siguientes estrategias:
| Constante | Valor | Descripción |
|---|---|---|
QFont::PreferDefault | 0x0001 | la estrategia de estilo por defecto. No prefiere ningún tipo de fuente. |
QFont::PreferBitmap | 0x0002 | prefiere fuentes de mapa de bits (en lugar de fuentes de contorno). |
QFont::PreferDevice | 0x0004 | prefiere fuentes de dispositivo. |
QFont::PreferOutline | 0x0008 | prefiere las fuentes de contorno (frente a las fuentes de mapa de bits). |
QFont::ForceOutline | 0x0010 | fuerza el uso de fuentes de contorno. |
QFont::NoAntialias | 0x0100 | no aplicar antialiasing a las fuentes. |
QFont::NoSubpixelAntialias | 0x0800 | evita el antialiasing de subpíxeles en las fuentes si es posible. |
QFont::PreferAntialias | 0x0080 | antialias si es posible. |
QFont::ContextFontMerging (since Qt 6.8) | 0x2000 | Si la fuente seleccionada no contiene un carácter determinado, Qt elige automáticamente una fuente alternativa de aspecto similar que contenga el carácter. Por defecto, esto se hace carácter por carácter. Esto significa que en ciertos casos poco comunes, se pueden usar múltiples fuentes para representar una cadena de texto incluso si está en el mismo script. Si se define ContextFontMerging, se intentará encontrar la fuente alternativa que coincida con el mayor subconjunto de la cadena de entrada. Esto será más costoso para las cadenas en las que falten glifos, pero puede dar resultados más consistentes. Si se define NoFontMerging, ContextFontMerging no tendrá ningún efecto. |
QFont::PreferTypoLineMetrics (since Qt 6.8) | 0x4000 | Por razones de compatibilidad, las fuentes OpenType contienen dos conjuntos competitivos de métricas de línea vertical que proporcionan los valores ascent, descent y leading de la fuente. A menudo se denominan métricas win (Windows) y métricas typo (tipográficas). Aunque la especificación recomienda utilizar la métrica typo para el interlineado, muchas aplicaciones prefieren la métrica win a menos que se establezca el indicador USE_TYPO_METRICS en el campo fsSelection de la fuente. Por razones de retrocompatibilidad, éste es también el caso de las aplicaciones Qt. Esto no es un problema para las fuentes que establecen la bandera USE_TYPO_METRICS para indicar que las métricas typo son válidas, ni para las fuentes en las que las métricas win y typo coinciden. Sin embargo, en algunos tipos de letra, la métrica win puede ser mayor que el interlineado preferible y el indicador USE_TYPO_METRICS puede no estar activado por error. Para este tipo de fuentes, la configuración de PreferTypoLineMetrics puede dar mejores resultados. |
QFont::NoFontMerging | 0x8000 | Si la fuente seleccionada para un determinado sistema de escritura no contiene un carácter solicitado para dibujar, entonces Qt elige automáticamente una fuente de aspecto similar que contenga el carácter. La bandera NoFontMerging desactiva esta característica. Tenga en cuenta que habilitar esta bandera no evitará que Qt elija automáticamente una fuente adecuada cuando la fuente seleccionada no soporte el sistema de escritura del texto. |
QFont::PreferNoShaping | 0x1000 | A veces, una fuente aplica reglas complejas a un conjunto de caracteres para mostrarlos correctamente. En algunos sistemas de escritura, como la escritura brahmánica, esto es necesario para que el texto sea legible, pero en la escritura latina, por ejemplo, es simplemente una característica cosmética. La bandera PreferNoShaping desactivará todas estas características cuando no sean necesarias, lo que mejorará el rendimiento en la mayoría de los casos (desde Qt 5.10). |
Cualquiera de estas puede ser OR-ed con una de estas banderas:
| Constante | Valor | Descripción |
|---|---|---|
QFont::PreferMatch | 0x0020 | prefiere una coincidencia exacta. El comparador de fuentes intentará utilizar el tamaño de fuente exacto que se haya especificado. |
QFont::PreferQuality | 0x0040 | preferir la fuente de mejor calidad. El comparador de fuentes utilizará el tamaño de punto estándar más cercano que admita la fuente. |
enum QFont::Weight
Qt utiliza una escala de ponderación de 1 a 1000 compatible con OpenType. Un peso de 1 será fino, mientras que 1000 será extremadamente negro.
Este enum contiene los pesos de fuente predefinidos:
| Constante | Valor | Descripción |
|---|---|---|
QFont::Thin | 100 | 100 |
QFont::ExtraLight | 200 | 200 |
QFont::Light | 300 | 300 |
QFont::Normal | 400 | 400 |
QFont::Medium | 500 | 500 |
QFont::DemiBold | 600 | 600 |
QFont::Bold | 700 | 700 |
QFont::ExtraBold | 800 | 800 |
QFont::Black | 900 | 900 |
Documentación de las funciones de los miembros
QFont::QFont()
Construye un objeto de fuente que utiliza la fuente por defecto de la aplicación.
Véase también QGuiApplication::setFont() y QGuiApplication::font().
QFont::QFont(const QFont &font, const QPaintDevice *pd)
Construye una fuente a partir de font para su uso en el dispositivo de pintura pd.
QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)
Construye un objeto de fuente con los ajustes especificados family, pointSize, weight y italic.
Si pointSize es cero o negativo, el tamaño en puntos de la fuente se establece en un valor predeterminado dependiente del sistema. Por lo general, es de 12 puntos.
El nombre family también puede incluir opcionalmente un nombre de fundición, por ejemplo "Helvetica [Cronyx]". Si family está disponible en más de una fundición y no se especifica la fundición, se elige una arbitraria. Si la familia no está disponible, se establecerá una familia utilizando el algoritmo font matching.
Esto dividirá la cadena de familia en una coma y llamará a setFamilies() con la lista resultante. Para conservar una fuente que utiliza una coma en su nombre, utilice el constructor que toma un QStringList.
Véase también Weight, setFamily(), setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies(), y QGuiApplication::font().
[explicit] QFont::QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false)
Construye un objeto de fuente con los ajustes especificados families, pointSize, weight y italic.
Si pointSize es cero o negativo, el tamaño en puntos de la fuente se establece en un valor predeterminado dependiente del sistema. Por lo general, es de 12 puntos.
Cada entrada de nombre de familia en families puede incluir opcionalmente un nombre de fundición, por ejemplo "Helvetica [Cronyx]". Si la familia está disponible en más de una fundición y no se especifica la fundición, se elige una arbitraria. Si la familia no está disponible, se establecerá una utilizando el algoritmo font matching.
Véase también Weight, setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies(), y QGuiApplication::font().
QFont::QFont(const QFont &font)
Construye una fuente que es una copia de font.
[noexcept] QFont::~QFont()
Destruye el objeto fuente y libera todos los recursos asignados.
bool QFont::bold() const
Devuelve true si weight() es un valor mayor que QFont::Medium; en caso contrario devuelve false.
Véase también weight(), setBold() y QFontInfo::bold().
QFont::Capitalization QFont::capitalization() const
Devuelve el tipo de capitalización actual de la fuente.
Véase también setCapitalization().
[since 6.7] void QFont::clearFeatures()
Borra cualquier característica previamente configurada en QFont.
Véase setFeature() para más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setFeature(), unsetFeature(), featureTags(), y featureValue().
[since 6.7] void QFont::clearVariableAxes()
Borra cualquier valor de eje variable previamente configurado en QFont.
Ver setVariableAxis() para más detalles sobre ejes variables.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet(), y variableAxisValue().
QString QFont::defaultFamily() const
Devuelve el nombre de la familia que corresponde a la sugerencia de estilo actual.
Véase también StyleHint, styleHint(), y setStyleHint().
bool QFont::exactMatch() const
Devuelve true si hay disponible una fuente del sistema de ventanas que coincida exactamente con la configuración de esta fuente.
Véase también QFontInfo.
QStringList QFont::families() const
Devuelve los nombres de familia de fuentes solicitados, es decir, los nombres establecidos en la última llamada a setFamilies() o a través del constructor. En caso contrario, devuelve una lista vacía.
Véase también setFamily(), setFamilies(), family(), substitutes() y substitute().
QString QFont::family() const
Devuelve el nombre de la familia de fuentes solicitada. Siempre será el mismo que el de la primera entrada de la llamada a families().
Véase también setFamily(), substitutes(), substitute(), setFamilies() y families().
[since 6.7] QList<QFont::Tag> QFont::featureTags() const
Devuelve una lista de etiquetas para todas las características de fuente actualmente configuradas en este QFont.
Véase setFeature() para más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setFeature(), unsetFeature(), isFeatureSet(), y clearFeatures().
[since 6.7] quint32 QFont::featureValue(QFont::Tag tag) const
Devuelve el valor establecido para una característica específica tag. Si la etiqueta no se ha establecido, se devolverá 0 en su lugar.
Véase setFeature() para más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setFeature(), unsetFeature(), featureTags(), y isFeatureSet().
bool QFont::fixedPitch() const
Devuelve true si se ha establecido el paso fijo; en caso contrario devuelve false.
Véase también setFixedPitch() y QFontInfo::fixedPitch().
bool QFont::fromString(const QString &descrip)
Establece esta fuente para que coincida con la descripción descrip. La descripción es una lista separada por comas de los atributos de la fuente, tal y como la devuelve toString().
Véase también toString().
QFont::HintingPreference QFont::hintingPreference() const
Devuelve el nivel de sugerencia preferido actualmente para los glifos representados con esta fuente.
Véase también setHintingPreference().
[static] void QFont::insertSubstitution(const QString &familyName, const QString &substituteName)
Inserta substituteName en la tabla de sustitución de la familia familyName.
Después de sustituir una fuente, desencadena la actualización de la fuente destruyendo y volviendo a crear todos los objetos QFont.
Véase también insertSubstitutions(), removeSubstitutions(), substitutions(), substitute() y substitutes().
[static] void QFont::insertSubstitutions(const QString &familyName, const QStringList &substituteNames)
Inserta la lista de familias substituteNames en la lista de sustitución de familyName.
Después de sustituir una fuente, desencadena la actualización de la fuente destruyendo y volviendo a crear todos los objetos QFont.
Véase también insertSubstitution(), removeSubstitutions(), substitutions() y substitute().
bool QFont::isCopyOf(const QFont &f) const
Devuelve true si esta fuente y f son copias la una de la otra, es decir, una de ellas fue creada como copia de la otra y ninguna ha sido modificada desde entonces. Esto es mucho más estricto que la igualdad.
Véase también operator=() y operator==().
[since 6.7] bool QFont::isFeatureSet(QFont::Tag tag) const
Devuelve true si se ha establecido un valor para la característica dada por tag en QFont, de lo contrario devuelve false.
Véase setFeature() para más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setFeature(), unsetFeature(), featureTags(), y featureValue().
[since 6.7] bool QFont::isVariableAxisSet(QFont::Tag tag) const
Devuelve true si se ha establecido un valor para el eje variable dado por tag en QFont, en caso contrario devuelve false.
Véase setVariableAxis() para más detalles sobre ejes variables de fuentes.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setVariableAxis(), unsetVariableAxis(), variableAxisValue(), y clearVariableAxes().
bool QFont::italic() const
Devuelve true si el style() de la fuente no es QFont::StyleNormal
Véase también setItalic() y style().
bool QFont::kerning() const
Devuelve true si se debe utilizar kerning al dibujar texto con esta fuente.
Véase también setKerning().
QString QFont::key() const
Devuelve la clave de la fuente, una representación textual de una fuente. Suele utilizarse como clave de una caché o diccionario de fuentes.
Véase también QMap.
qreal QFont::letterSpacing() const
Devuelve el espaciado entre letras de la fuente.
Véase también setLetterSpacing(), letterSpacingType() y setWordSpacing().
QFont::SpacingType QFont::letterSpacingType() const
Devuelve el tipo de espaciado utilizado para el interlineado de las letras.
Véase también letterSpacing(), setLetterSpacing() y setWordSpacing().
bool QFont::overline() const
Devuelve true si se ha establecido la sobrelínea; en caso contrario, devuelve false.
Véase también setOverline().
int QFont::pixelSize() const
Devuelve el tamaño en píxeles de la fuente si se estableció con setPixelSize(). Devuelve -1 si el tamaño se estableció con setPointSize() o setPointSizeF().
Véase también setPixelSize(), pointSize(), QFontInfo::pointSize() y QFontInfo::pixelSize().
int QFont::pointSize() const
Devuelve el tamaño en puntos de la fuente. Devuelve -1 si el tamaño de la fuente se especificó en píxeles.
Véase también setPointSize() y pointSizeF().
qreal QFont::pointSizeF() const
Devuelve el tamaño en puntos de la fuente. Devuelve -1 si el tamaño de la fuente se especificó en píxeles.
Véase también pointSize(), setPointSizeF(), pixelSize(), QFontInfo::pointSize() y QFontInfo::pixelSize().
[static] void QFont::removeSubstitutions(const QString &familyName)
Elimina todas las sustituciones de familyName.
Véase también insertSubstitutions(), insertSubstitution(), substitutions() y substitute().
QFont QFont::resolve(const QFont &other) const
Devuelve un nuevo QFont que tiene atributos copiados de other que no se han establecido previamente en esta fuente.
void QFont::setBold(bool enable)
Si enable es verdadero establece el peso de la fuente en QFont::Bold; en caso contrario establece el peso en QFont::Normal.
Para un control más preciso de la negrita, utilice setWeight().
Nota: Si styleName() está establecido, este valor puede ser ignorado, o si es soportado en la plataforma, la fuente puede ser artificialmente negrita.
Véase también bold() y setWeight().
void QFont::setCapitalization(QFont::Capitalization caps)
Establece la capitalización del texto de esta fuente en caps.
La capitalización de una fuente hace que el texto aparezca en el modo de capitalización seleccionado.
Véase también capitalization().
void QFont::setFamilies(const QStringList &families)
Establece la lista de nombres de familia para la fuente. Los nombres no distinguen mayúsculas de minúsculas y pueden incluir un nombre de fundición. La primera familia de families será la familia principal de la fuente.
Cada entrada de nombre de familia en families puede incluir opcionalmente un nombre de fundición, por ejemplo "Helvetica [Cronyx]". Si la familia está disponible en más de una fundición y no se especifica la fundición, se elige una arbitraria. Si la familia no está disponible, se establecerá una utilizando el algoritmo font matching.
Véase también family(), families(), setFamily(), setStyleHint(), y QFontInfo.
void QFont::setFamily(const QString &family)
Establece el nombre de la familia de la fuente. El nombre no distingue entre mayúsculas y minúsculas y puede incluir un nombre de fundición.
El nombre family también puede incluir opcionalmente un nombre de fundición, por ejemplo, "Helvetica [Cronyx]". Si family está disponible en más de una fundición y no se especifica la fundición, se elegirá una arbitraria. Si la familia no está disponible, se establecerá una familia mediante el algoritmo font matching.
Véase también family(), setStyleHint(), setFamilies(), families(), y QFontInfo.
[since 6.7] void QFont::setFeature(QFont::Tag tag, quint32 value)
Aplica un valor entero a la característica tipográfica especificada por tag al dar forma al texto. Esto proporciona un acceso avanzado al proceso de conformación de la fuente y puede utilizarse para admitir características tipográficas que, de otro modo, no estarían cubiertas por la API.
La característica se especifica mediante un tag, que normalmente se codifica a partir del nombre de la característica de cuatro caracteres en el mapa de características de la fuente.
En la mayoría de los casos, este número entero value que se pasa junto con la etiqueta representa un valor booleano: Un valor cero significa que la característica está desactivada, y un valor distinto de cero significa que está activada. Sin embargo, en el caso de determinadas características tipográficas, puede tener otras interpretaciones. Por ejemplo, cuando se aplica a la característica salt, el valor es un índice que especifica la alternativa estilística a utilizar.
Por ejemplo, la característica de fuente frac convertirá las fracciones diagonales separadas con una barra (como 1/2) con una representación diferente. Normalmente, esto implicará la conversión de la fracción completa en un único carácter de ancho (como ½).
Si una fuente soporta la característica frac, entonces puede habilitarse en el modelador configurando features["frac"] = 1 en el mapa de características de la fuente.
Nota: Por defecto, Qt habilitará y deshabilitará ciertas características de la fuente basándose en otras propiedades de la fuente. En particular, la característica kern se habilitará/deshabilitará dependiendo de la propiedad kerning() de la QFont. Además, todas las características de ligadura (liga, clig, dlig, hlig) se deshabilitarán si se aplica una letterSpacing(), pero sólo para sistemas de escritura donde el uso de ligaduras es cosmético. Para los sistemas de escritura en los que las ligaduras son obligatorias, las características permanecerán en su estado predeterminado. Los valores establecidos mediante setFeature() y funciones relacionadas anularán el comportamiento predeterminado. Si, por ejemplo, la característica "kern" se establece en 1, el kerning estará siempre activado, independientemente de si la propiedad kerning se establece en false. Del mismo modo, si se establece en 0, siempre estará desactivado. Para restablecer una característica de fuente a su comportamiento predeterminado, puede desactivarla utilizando unsetFeature().
Esta función se introdujo en Qt 6.7.
Ver también QFont::Tag, clearFeatures(), unsetFeature(), y featureTags().
void QFont::setFixedPitch(bool enable)
Si enable es verdadero, activa el paso fijo; si no, lo desactiva.
Véase también fixedPitch() y QFontInfo.
void QFont::setHintingPreference(QFont::HintingPreference hintingPreference)
Establece la preferencia para el nivel de sugerencia de los glifos en hintingPreference. Se trata de una sugerencia al sistema de representación de fuentes subyacente para que utilice un determinado nivel de sugerencia, y tiene soporte variable en las distintas plataformas. Consulte la tabla de la documentación de QFont::HintingPreference para obtener más información.
La preferencia por defecto es QFont::PreferDefaultHinting.
Véase también hintingPreference().
void QFont::setItalic(bool enable)
Establece el style() de la fuente a QFont::StyleItalic si enable es verdadero; de lo contrario el estilo se establece a QFont::StyleNormal.
Nota: Si styleName() está establecido, este valor puede ser ignorado, o si es soportado en la plataforma, la fuente puede ser renderizada inclinada en lugar de escoger una variante de fuente diseñada en cursiva.
Véase también italic() y QFontInfo.
void QFont::setKerning(bool enable)
Activa el kerning para esta fuente si enable es verdadero; en caso contrario, lo desactiva. Por defecto, el kerning está activado.
Cuando el kerning está activado, las métricas de los glifos ya no se suman, incluso para texto latino. En otras palabras, la suposición de que width('a') + width('b') es igual a width("ab") no es necesariamente cierta.
Véase también kerning() y QFontMetrics.
void QFont::setLetterSpacing(QFont::SpacingType type, qreal spacing)
Establece el espaciado entre letras de la fuente en spacing y el tipo de espaciado en type.
El espaciado entre letras cambia el espaciado predeterminado entre las letras individuales de la fuente. El espaciado entre las letras puede hacerse más pequeño o más grande, ya sea en porcentaje del ancho del carácter o en píxeles, dependiendo del tipo de espaciado seleccionado.
Véase también letterSpacing(), letterSpacingType() y setWordSpacing().
void QFont::setOverline(bool enable)
Si enable es verdadero, activa la sobrelínea; en caso contrario, la desactiva.
Véase también overline() y QFontInfo.
void QFont::setPixelSize(int pixelSize)
Establece el tamaño de la fuente en pixelSize píxeles, con un tamaño máximo de un entero de 16 bits sin signo.
El uso de esta función hace que la fuente dependa del dispositivo. Utilice setPointSize() o setPointSizeF() para establecer el tamaño de la fuente de forma independiente del dispositivo.
Véase también pixelSize().
void QFont::setPointSize(int pointSize)
Establece el tamaño de punto en pointSize. El tamaño de punto debe ser mayor que cero.
Véase también pointSize() y setPointSizeF().
void QFont::setPointSizeF(qreal pointSize)
Establece el tamaño de punto en pointSize. El tamaño de punto debe ser mayor que cero. La precisión solicitada puede no alcanzarse en todas las plataformas.
Véase también pointSizeF(), setPointSize() y setPixelSize().
void QFont::setStretch(int factor)
Establece el factor de estiramiento de la fuente.
El factor de estiramiento coincide con una versión condensada o ampliada de la fuente o aplica una transformación de estiramiento que cambia la anchura de todos los caracteres de la fuente en factor por ciento. Por ejemplo, si se establece factor en 150, todos los caracteres de la fuente serán 1,5 veces (es decir, 150%) más anchos. El factor de estiramiento mínimo es 1 y el máximo 4000. El factor de estiramiento por defecto es AnyStretch, que aceptará cualquier factor de estiramiento y no aplicará ninguna transformación a la fuente.
El factor de estiramiento sólo se aplica a las fuentes de contorno. El factor de estiramiento se ignora para las fuentes de mapa de bits.
Nota: Cuando se busca una fuente con un factor de estiramiento nativo no predeterminado, si se solicita un estiramiento de 100, se volverá a una fuente de anchura media.
Véase también stretch() y QFont::Stretch.
void QFont::setStrikeOut(bool enable)
Si enable es verdadero, activa el tachado; en caso contrario, lo desactiva.
Véase también strikeOut() y QFontInfo.
void QFont::setStyle(QFont::Style style)
Establece el estilo de la fuente en style.
Véase también style(), italic() y QFontInfo.
void QFont::setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)
Establece la sugerencia y la estrategia de estilo en hint y strategy, respectivamente.
Si no se establecen explícitamente, la sugerencia de estilo será por defecto AnyStyle y la estrategia de estilo PreferDefault.
Qt no soporta sugerencias de estilo en X11 ya que esta información no es proporcionada por el sistema de ventanas.
Ver también StyleHint, styleHint(), StyleStrategy, styleStrategy(), y QFontInfo.
void QFont::setStyleName(const QString &styleName)
Establece el nombre de estilo de la fuente en styleName. Cuando se establece, otras propiedades de estilo como style() y weight() serán ignoradas para la correspondencia de fuentes, aunque pueden ser simuladas posteriormente si son soportadas por el motor de fuentes de la plataforma.
Debido a la baja calidad de los estilos simulados artificialmente, y a la falta de soporte multiplataforma, no se recomienda utilizar la coincidencia por nombre de estilo junto con la coincidencia por propiedades de estilo.
Véase también styleName().
void QFont::setStyleStrategy(QFont::StyleStrategy s)
Establece la estrategia de estilo de la fuente en s.
Véase también styleStrategy() y QFont::StyleStrategy.
void QFont::setUnderline(bool enable)
Si enable es verdadero, activa el subrayado; en caso contrario, lo desactiva.
Véase también underline() y QFontInfo.
[since 6.7] void QFont::setVariableAxis(QFont::Tag tag, float value)
Aplica un value al eje variable correspondiente a tag.
Las fuentes variables permiten almacenar múltiples variaciones (con distintos pesos, anchos o estilos) en el mismo archivo de fuente. Las variaciones se dan como valores en coma flotante para un conjunto predefinido de parámetros, denominados "ejes variables". El diseñador de fuentes suele asignar nombres a las instancias específicas y, en Qt, éstas pueden seleccionarse mediante setStyleName() igual que las subfamilias tradicionales.
En algunos casos, también es útil proporcionar valores arbitrarios para los diferentes ejes. Por ejemplo, si una fuente tiene una subfamilia Regular y otra Negrita, es posible que desee un peso intermedio. Puede solicitarlo manualmente proporcionando un valor personalizado para el eje "wght" de la fuente.
Si el eje "wght" está soportado por la fuente y el valor dado está dentro de su rango definido, se proporcionará una fuente correspondiente al peso 550.0.
Hay algunos ejes estándar que muchas fuentes proporcionan, como "wght" (peso), "wdth" (anchura), "ital" (cursiva) y "opsz" (tamaño óptico). Cada uno de ellos tiene rangos independientes definidos en la propia fuente. Por ejemplo, "wght" puede ir de 100 a 900 (deQFont::Thin a QFont::Black), mientras que "ital" puede ir de 0 a 1 (de no cursiva a totalmente cursiva).
Una fuente también puede optar por definir ejes personalizados; la única limitación es que el nombre tiene que cumplir los requisitos para un QFont::Tag (secuencia de cuatro caracteres latinos-1.)
Por defecto, no se define ningún eje variable.
Nota: En Windows, los ejes variables no están soportados si se utiliza el backend opcional de fuentes GDI.
Esta función se introdujo en Qt 6.7.
Véase también unsetVariableAxis.
void QFont::setWeight(QFont::Weight weight)
Establece el peso de la fuente en weight, utilizando la escala definida por la enumeración QFont::Weight.
Nota: Si styleName() está establecido, este valor puede ser ignorado para la selección de fuentes.
Véase también weight() y QFontInfo.
void QFont::setWordSpacing(qreal spacing)
Establece el espaciado entre palabras de la fuente en spacing.
El espaciado entre palabras cambia el espaciado predeterminado entre palabras individuales. Un valor positivo aumenta el espaciado entre palabras en la cantidad de píxeles correspondiente, mientras que un valor negativo disminuye el espaciado entre palabras.
El espaciado entre palabras no se aplica a los sistemas de escritura en los que las palabras individuales no están separadas por espacios en blanco.
Véase también wordSpacing() y setLetterSpacing().
int QFont::stretch() const
Devuelve el factor de estiramiento de la fuente.
Véase también setStretch().
bool QFont::strikeOut() const
Devuelve true si se ha establecido strikeout; en caso contrario devuelve false.
Véase también setStrikeOut().
QFont::Style QFont::style() const
Devuelve el estilo de la fuente.
Véase también setStyle().
QFont::StyleHint QFont::styleHint() const
Devuelve el StyleHint.
La sugerencia de estilo afecta a font matching algorithm. Consulte QFont::StyleHint para ver la lista de sugerencias disponibles.
Véase también setStyleHint(), QFont::StyleStrategy, y QFontInfo::styleHint().
QString QFont::styleName() const
Devuelve el nombre del estilo de fuente solicitado. Esto se puede utilizar para hacer coincidir la fuente con estilos irregulares (que no se pueden normalizar en otras propiedades de estilo).
Véase también setStyleName(), setFamily(), y setStyle().
QFont::StyleStrategy QFont::styleStrategy() const
Devuelve el StyleStrategy.
La estrategia de estilo afecta al algoritmo font matching. Consulte QFont::StyleStrategy para ver la lista de estrategias disponibles.
Véase también setStyleStrategy(), setStyleHint(), y QFont::StyleHint.
[static] QString QFont::substitute(const QString &familyName)
Devuelve el primer apellido que se utilizará siempre que se especifique familyName. La búsqueda no distingue entre mayúsculas y minúsculas.
Si no hay sustituto para familyName, se devuelve familyName.
Para obtener una lista de sustituciones, utilice substitutes().
Véase también setFamily(), insertSubstitutions(), insertSubstitution() y removeSubstitutions().
[static] QStringList QFont::substitutes(const QString &familyName)
Devuelve una lista de apellidos que se utilizarán siempre que se especifique familyName. La búsqueda no distingue entre mayúsculas y minúsculas.
Si no hay sustitución para familyName, se devuelve una lista vacía.
Véase también substitute(), insertSubstitutions(), insertSubstitution() y removeSubstitutions().
[static] QStringList QFont::substitutions()
Devuelve una lista ordenada de apellidos sustituidos.
Véase también insertSubstitution(), removeSubstitutions() y substitute().
[noexcept] void QFont::swap(QFont &other)
Intercambia esta instancia de fuente con other. Esta operación es muy rápida y nunca falla.
QString QFont::toString() const
Devuelve una descripción de la fuente. La descripción es una lista separada por comas de los atributos, perfectamente adecuada para su uso en QSettings, y consta de lo siguiente:
- Familia de fuentes
- Tamaño de punto
- Tamaño en píxeles
- Sugerencia de estilo
- Peso de la fuente
- Estilo de fuente
- Subrayado
- Tachado
- Tono fijo
- Siempre 0
- Mayúsculas
- Espaciado entre letras
- Espaciado entre palabras
- Estirar
- Estrategia de estilo
- Estilo de fuente
- Características de las fuentes
- Ejes variables
Véase también fromString().
bool QFont::underline() const
Devuelve true si se ha establecido el subrayado; en caso contrario devuelve false.
Véase también setUnderline().
[since 6.7] void QFont::unsetFeature(QFont::Tag tag)
Anula la selección de tag del mapa de características habilitadas/deshabilitadas explícitamente.
Nota: Incluso si la característica no se ha añadido previamente, esto marcará el mapa de características de la fuente como modificado en este QFont, de modo que tendrá prioridad cuando se resuelva contra otras fuentes.
La anulación de una característica existente en QFont devuelve el comportamiento al predeterminado.
Véase setFeature() para más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, clearFeatures(), setFeature(), featureTags(), y featureValue().
[since 6.7] void QFont::unsetVariableAxis(QFont::Tag tag)
Anula el valor de un eje variable previamente establecido por tag.
Nota: Si no se ha dado previamente ningún valor para esta etiqueta, QFont seguirá considerando sus ejes variables como establecidos al resolver contra otros valores de QFont.
Esta función se introdujo en Qt 6.7.
Véase también setVariableAxis.
[since 6.7] QList<QFont::Tag> QFont::variableAxisTags() const
Devuelve una lista de etiquetas para todos los ejes variables configurados actualmente en este QFont.
Ver setVariableAxis() para más detalles sobre ejes variables.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet(), y clearVariableAxes().
[since 6.7] float QFont::variableAxisValue(QFont::Tag tag) const
Devuelve el valor establecido para un eje variable específico tag. Si no se ha establecido la etiqueta, se devolverá 0.0 en su lugar.
Véase setVariableAxis() para más detalles sobre ejes variables.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet(), y clearVariableAxes().
QFont::Weight QFont::weight() const
Devuelve el peso de la fuente, utilizando la misma escala que la enumeración QFont::Weight.
Véase también setWeight(), Weight, y QFontInfo.
qreal QFont::wordSpacing() const
Devuelve el espaciado entre palabras de la fuente.
Véase también setWordSpacing() y setLetterSpacing().
QFont::operator QVariant() const
Devuelve la fuente como QVariant
bool QFont::operator!=(const QFont &f) const
Devuelve true si esta fuente es diferente de f; en caso contrario devuelve false.
Dos QFonts se consideran diferentes si sus atributos de fuente son diferentes.
Véase también operator==().
bool QFont::operator<(const QFont &f) const
Proporciona una comparación arbitraria de esta fuente y la fuente f. Todo lo que se garantiza es que el operador devuelve false si ambas fuentes son iguales y que (f1 < f2) == !(f2 < f1) si las fuentes no son iguales.
Esta función es útil en algunas circunstancias, por ejemplo si desea utilizar objetos QFont como claves en un QMap.
Véase también operator==(), operator!=() y isCopyOf().
[noexcept] QFont &QFont::operator=(QFont &&other)
Mover-asigna other a esta instancia QFont.
QFont &QFont::operator=(const QFont &font)
Asigna font a esta fuente y devuelve una referencia a la misma.
bool QFont::operator==(const QFont &f) const
Devuelve true si esta fuente es igual a f; en caso contrario devuelve false.
Dos QFonts se consideran iguales si sus atributos de fuente son iguales.
Véase también operator!=() y isCopyOf().
No miembros relacionados
[noexcept] size_t qHash(const QFont &key, size_t seed = 0)
Devuelve el valor hash para key, utilizando seed para sembrar el cálculo.
QDataStream &operator<<(QDataStream &s, const QFont &font)
Escribe la fuente font en el flujo de datos s. (toString() escribe en un flujo de texto.)
Véase también Formato de los operadores QDataStream.
QDataStream &operator>>(QDataStream &s, QFont &font)
Lee la fuente font del flujo de datos s. (fromString() lee de un flujo de texto.)
Véase también Formato de los operadores QDataStream.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.