QFont Class
La clase QFont define una consulta para una fuente utilizada para dibujar texto. Más información...
| Encabezado: | #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 miembros heredados
- Miembros obsoletos
- QFont forma parte de las clases de dibujo, las clases compartidas implícitamente y las API de procesamiento de texto enriquecido.
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(QFont &&) | |
| ~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() |
No miembros relacionados
| 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 sobre una o varias fuentes del sistema.
Al crear un objeto QFont, se especifican diversos atributos que se desea que tenga la fuente. Qt utilizará la fuente con los atributos especificados o, si no existe ninguna fuente que coincida, utilizará la fuente instalada que más se acerque. Los atributos de la fuente que se utiliza realmente se pueden obtener a través de 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 mediante ` QFontMetrics::horizontalAdvance()`.
Los atributos que no se hayan establecido específicamente no afectarán al algoritmo de selección de fuentes, y se darán preferencia a los valores por defecto.
Para cargar una fuente física específica, normalmente representada por un único archivo, utiliza en su lugar QRawFont.
Ten en cuenta que debe existir una instancia de ` QGuiApplication ` antes de poder utilizar un `QFont`. Puedes establecer la fuente predeterminada de la aplicación con ` QGuiApplication::setFont()`.
Si la fuente elegida no incluye todos los caracteres que deben mostrarse, QFont intentará encontrar los caracteres en las fuentes equivalentes más cercanas. Cuando un ` QPainter ` dibuja un carácter de una fuente, QFont indicará si dispone o no de dicho carácter; si no es así, ` QPainter ` dibujará un cuadrado sin rellenar.
Crea QFonts de esta manera:
Los atributos establecidos en el constructor también pueden configurarse posteriormente, p. ej., setFamily(), setPointSize(), setPointSizeF(), setWeight() y setItalic(). El resto de atributos deben configurarse tras la construcción, p. ej., setBold(), setUnderline(), setOverline(), setStrikeOut() y setFixedPitch(). Los objetos QFontInfo deben crearse una vez que se hayan 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 han establecido, aunque los valores utilizados puedan diferir. Los valores reales están disponibles en un objeto ` QFontInfo `.
Si la familia de fuentes solicitada no está disponible, puedes influir en el « font matching algorithm » seleccionando un « QFont::StyleHint » y un « QFont::StyleStrategy » concretos mediante setStyleHint(). La familia predeterminada (que se corresponde con la sugerencia de estilo actual) se devuelve mediante defaultFamily().
Se pueden proporcionar sustituciones para los nombres de las familias de fuentes utilizando insertSubstitution() y insertSubstitutions(). Las sustituciones se pueden eliminar con removeSubstitutions(). Utiliza substitute() para recuperar la primera sustitución de una familia, o el propio nombre de la familia si no tiene sustituciones. Utiliza substitutes() para recuperar una lista de las sustituciones de una familia (que puede estar vacía). Tras sustituir una fuente, debes forzar la actualización de la fuente destruyendo y volviendo a crear todos los objetos `QFont`.
Cada QFont dispone de un key() que se puede utilizar, por ejemplo, como clave en una caché o un diccionario. Si se desea almacenar las preferencias de fuente de un usuario, se puede utilizar QSettings, escribiendo la información de la fuente con toString() y leyéndola de nuevo con fromString(). Las funciones del operador <<() y del operador >>() también están disponibles, pero operan sobre un flujo de datos.
Es posible establecer la altura de los caracteres que se muestran en pantalla en un número específico de píxeles con ` setPixelSize()`; sin embargo, el uso de ` setPointSize()` tiene un efecto similar y garantiza la independencia del dispositivo.
La carga de fuentes puede ser costosa, especialmente en X11. QFont contiene numerosas optimizaciones para agilizar la copia de objetos QFont y para almacenar en caché los resultados de las funciones lentas 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 mediante setFamilies()).
- Si no se encuentran, se selecciona una fuente sustitutiva que admita el sistema de escritura. El algoritmo de búsqueda de fuentes intentará encontrar la mejor coincidencia para todas las propiedades establecidas en el objeto 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 unos recuadros especiales de «carácter ausente».
Nota: Si a la fuente seleccionada, aunque sea compatible con el sistema de escritura en general, le faltan glifos para uno o más caracteres específicos, Qt intentará encontrar una fuente alternativa para ese o esos caracteres concretos. Esta característica se puede desactivar utilizando la estrategia de estilo QFont::NoFontMerging.
En Windows, una solicitud de la fuente «Courier» se cambia automáticamente a «Courier New», una versión mejorada de Courier que permite un escalado fluido. La fuente bitmap «Courier» más antigua se puede seleccionar estableciendo la estrategia de estilo PreferBitmap (véase setStyleStrategy()).
Una vez encontrada la fuente, los atributos restantes se hacen coincidir por orden de prioridad:
- fixedPitch()
- pointSize() (véase más abajo)
- weight()
- style()
Si tienes una fuente que coincide en familia, aunque ninguno de los demás atributos coincida, se elegirá esta fuente antes que otra que no coincida en familia pero que sí coincida en los demás atributos. Esto se debe a que la familia de fuentes es el criterio de búsqueda predominante.
El tamaño en puntos se considera coincidente si se encuentra dentro de un margen del 20 % del tamaño solicitado. Cuando varias fuentes coinciden y solo se distinguen por el tamaño en puntos, se elegirá la fuente cuyo tamaño en puntos sea 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 tanto una Helvetica de Adobe como una de Cronyx, podría aparecer cualquiera de las dos.
QFont f("Helvetica [Cronyx]");Puedes especificar la casa tipográfica que desees en el nombre de la familia. La fuente «f» del ejemplo anterior se establecerá como «Helvetica [Cronyx]».
Para determinar los atributos de la fuente que se utiliza realmente en el sistema de ventanas, utiliza un objeto ` QFontInfo `, por ejemplo:
Para conocer las métricas de la fuente, utiliza un objeto ` QFontMetrics `, p. ej.:
QFontMetrics fm(f1);
int textWidthInPixels = fm.horizontalAdvance("How many pixels wide is this text?");
int textHeightInPixels = fm.height();Para obtener más información general sobre las fuentes, consulta las preguntas frecuentes (FAQ) de comp.fonts. Puedes encontrar información sobre las codificaciones en la página de UTR17.
Véase también QFontMetrics, QFontInfo y QFontDatabase.
Documentación sobre tipos de miembros
enum QFont::Capitalization
Opción de visualización del texto al que se aplica esta fuente.
| Constante | Valor | Descripción |
|---|---|---|
QFont::MixedCase | 0 | Esta es la opción de representación de texto normal, en la que no se aplica ningún cambio en el uso de mayúsculas. |
QFont::AllUppercase | 1 | Esta opción modifica el texto para que se represente íntegramente en mayúsculas. |
QFont::AllLowercase | 2 | Esto hace que el texto se muestre en minúsculas. |
QFont::SmallCaps | 3 | Esta opción hace que el texto se muestre en versalitas. |
QFont::Capitalize | 4 | Esta opción modifica el texto para que se muestre con la primera letra de cada palabra en mayúscula. |
enum QFont::HintingPreference
Esta enumeración describe los diferentes niveles de ajuste que se pueden aplicar 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 hinting predeterminado para la plataforma de destino. |
QFont::PreferNoHinting | 1 | Si es posible, representa el texto sin aplicar hinting a los contornos de los glifos. La composición del texto será tipográficamente precisa y escalable, utilizando las mismas métricas que se emplean, por ejemplo, en la impresión. |
QFont::PreferVerticalHinting | 2 | Si es posible, renderiza el texto sin hinting horizontal, pero alinea los glifos con la cuadrícula de píxeles en dirección vertical. El texto aparecerá más nítido en pantallas cuya densidad sea demasiado baja para ofrecer una representación precisa de los glifos. Sin embargo, dado que las métricas horizontales de los glifos no están suavizadas, la maquetación del texto será escalable a dispositivos de mayor densidad (como las impresoras) sin que ello afecte a detalles como los saltos de línea. |
QFont::PreferFullHinting | 3 | Si es posible, representa el texto con hinting tanto en dirección horizontal como vertical. El texto se modificará para optimizar la legibilidad en el dispositivo de destino, pero, dado que 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 el diseño del texto puede verse diferente en dispositivos con distintas densidades de píxeles. |
Ten en cuenta que esta enumeración solo describe una preferencia, ya que no todas las plataformas compatibles con Qt admiten toda la gama de niveles de hinting. La siguiente tabla detalla el efecto de una preferencia de hinting determinada en un conjunto seleccionado de plataformas de destino.
| PreferDefaultHinting | PreferNoHinting | PreferVerticalHinting | PreferFullHinting | |
|---|---|---|---|---|
| Windows y DirectWrite habilitados en Qt | Hinting completo | Hinting vertical | Ajuste vertical | Hinting completo |
| FreeType | Configuración del sistema operativo | Sin ajuste | Ajuste vertical (ligero) | Hinting completo |
| Cocoa en macOS | Sin hinting | Sin hinting | Sin ajuste | Sin hinting |
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 tras un carácter en la anchura del propio carácter. |
QFont::AbsoluteSpacing | 1 | Un valor positivo aumenta el espaciado entre 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 de CSS. Cuanto mayor sea el valor, más estirado quedará el texto.
| Constante | Valor | Descripción |
|---|---|---|
QFont::AnyStretch (since Qt 5.8) | 0 | 0 Acepta cualquier estiramiento que coincida con las demás propiedades « 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
Esta enumeración describe los diferentes estilos de glifos que se utilizan para mostrar el 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 aspecto cursivo que suelen basarse en los glifos sin estilo, pero que no están optimizados para representar texto en cursiva. |
Véase también Weight.
enum QFont::StyleHint
El algoritmo « font matching » utiliza las sugerencias de estilo para encontrar una familia predeterminada adecuada en caso de que la familia de fuentes seleccionada no esté disponible.
| Constante | Valor | Descripción |
|---|---|---|
QFont::AnyStyle | 5 | deja que el algoritmo de coincidencia de fuentes elija la familia. Este es el valor por defecto. |
QFont::SansSerif | Helvetica | El sistema de coincidencia de fuentes da preferencia a las fuentes sans serif. |
QFont::Helvetica | 0 | Es sinónimo de « SansSerif ». |
QFont::Serif | Times | El selector de fuentes da preferencia a las fuentes con serif. |
QFont::Times | 1 | Es sinónimo de « Serif ». |
QFont::TypeWriter | Courier | El selector de fuentes prefiere las fuentes de espaciado fijo. |
QFont::Courier | 2 | Sinónimo de « TypeWriter ». |
QFont::OldEnglish | 3 | El comparador de fuentes prefiere las fuentes decorativas. |
QFont::Decorative | OldEnglish | Es sinónimo de « OldEnglish ». |
QFont::Monospace | 7 | El comparador de fuentes prefiere las fuentes que se corresponden con la familia de fuentes genérica «monospace» de CSS. |
QFont::Fantasy | 8 | El comparador de fuentes prefiere las fuentes que se corresponden con la familia de fuentes genérica «fantasy» de CSS. |
QFont::Cursive | 6 | El comparador de fuentes da preferencia a las fuentes que se corresponden con la familia de fuentes genérica «cursive» de CSS. |
QFont::System | 4 | El comparador de fuentes da preferencia a las fuentes del sistema. |
enum QFont::StyleStrategy
La estrategia de estilo indica al algoritmo « font matching » qué tipo de fuentes deben utilizarse para encontrar una familia predeterminada adecuada.
Las estrategias disponibles son las siguientes:
| Constante | Valor | Descripción |
|---|---|---|
QFont::PreferDefault | 0x0001 | la estrategia de estilo predeterminada. No da preferencia a ningún tipo de fuente. |
QFont::PreferBitmap | 0x0002 | Da preferencia a las fuentes de mapa de bits (en lugar de a las fuentes vectoriales). |
QFont::PreferDevice | 0x0004 | Prefiere las fuentes de dispositivo. |
QFont::PreferOutline | 0x0008 | Prefiere las fuentes vectoriales (en lugar de las fuentes de mapa de bits). |
QFont::ForceOutline | 0x0010 | Obliga a utilizar fuentes de contorno. |
QFont::NoAntialias | 0x0100 | No aplica suavizado a las fuentes. |
QFont::NoSubpixelAntialias | 0x0800 | Evita el suavizado de subpíxeles en las fuentes si es posible. |
QFont::PreferAntialias | 0x0080 | Aplica suavizado 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 sí lo contenga. Por defecto, esto se hace carácter por carácter. Esto significa que, en ciertos casos poco habituales, pueden utilizarse varias fuentes para representar una misma cadena de texto, incluso si pertenece al mismo alfabeto. Al establecer ` ContextFontMerging `, se intentará encontrar la fuente alternativa que coincida con el subconjunto más amplio de la cadena de entrada. Esto supondrá un mayor coste para las cadenas en las que falten glifos, pero puede ofrecer resultados más coherentes. Si se establece ` NoFontMerging `, entonces ` ContextFontMerging ` no tendrá ningún efecto. |
QFont::PreferTypoLineMetrics (since Qt 6.8) | 0x4000 | Por motivos de compatibilidad, las fuentes OpenType contienen dos conjuntos de métricas de línea vertical que compiten entre sí y 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 las métricas « typo » para el interlineado, muchas aplicaciones prefieren las métricas « win », a menos que se haya establecido el indicador « USE_TYPO_METRICS » en el campo «fsSelection» de la fuente. Por motivos de compatibilidad con versiones anteriores, esto también ocurre en las aplicaciones Qt. Esto no supone un problema para las fuentes que establecen el indicador « USE_TYPO_METRICS » para indicar que las métricas « typo » son válidas, ni para aquellas en las que las métricas « win » y « typo » coinciden. Sin embargo, en determinadas fuentes, las métricas « win » pueden ser mayores que el interlineado preferido y el indicador « USE_TYPO_METRICS » puede estar desactivado por error. En el caso de estas fuentes, establecer « PreferTypoLineMetrics » puede ofrecer mejores resultados. |
QFont::NoFontMerging | 0x8000 | Si la fuente seleccionada para un determinado sistema de escritura no contiene un carácter que se desea dibujar, Qt elige automáticamente una fuente de aspecto similar que sí contenga dicho carácter. El indicador NoFontMerging desactiva esta función. Ten en cuenta que activar este indicador no impedirá que Qt elija automáticamente una fuente adecuada cuando la fuente seleccionada no sea compatible con el sistema de escritura del texto. |
QFont::PreferNoShaping | 0x1000 | En ocasiones, una fuente aplica reglas complejas a un conjunto de caracteres para mostrarlos correctamente. En algunos sistemas de escritura, como las escrituras brahmicas, esto es necesario para que el texto sea legible, pero en la escritura latina, por ejemplo, se trata simplemente de una característica estética. El indicador «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 ellas puede combinarse mediante la operación OR con uno de estos indicadores:
| Constante | Valor | Descripción |
|---|---|---|
QFont::PreferMatch | 0x0020 | Prefiere una coincidencia exacta. El selector de fuentes intentará utilizar el tamaño de fuente exacto que se haya especificado. |
QFont::PreferQuality | 0x0040 | Prefiere la fuente de mejor calidad. El comparador de fuentes utilizará el tamaño en puntos estándar más cercano que admita la fuente. |
enum QFont::Weight
Qt utiliza una escala de grosor del 1 al 1000 compatible con OpenType. Un grosor de 1 corresponderá a una fuente fina, mientras que 1000 corresponderá a una fuente extremadamente negra.
Esta enumeración contiene los grosores 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 funciones de miembro
QFont::QFont()
Crea un objeto de fuente que utiliza la fuente predeterminada de la aplicación.
Véase también QGuiApplication::setFont() y QGuiApplication::font().
QFont::QFont(const QFont &font, const QPaintDevice *pd)
Crea una fuente a partir de font para utilizarla en el dispositivo de pintura pd.
QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)
Crea un objeto de fuente con los ajustes especificados para « family », « pointSize », « weight » y « italic ».
Si pointSize es cero o un valor negativo, el tamaño en puntos de la fuente se establece en un valor predeterminado que depende del sistema. Por lo general, este valor es de 12 puntos.
El nombre de la fuente ( family ) también puede incluir opcionalmente el nombre de la fundición, p. ej., «Helvetica [Cronyx]». Si la fuente ( family ) está disponible en más de una fundición y no se especifica ninguna, se elige una fundición al azar. Si la familia no está disponible, se establecerá una utilizando el algoritmo de font matching.
Esto dividirá la cadena de la familia por una coma y llamará a setFamilies() con la lista resultante. Para conservar una fuente que utilice 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)
Crea un objeto de fuente con los ajustes especificados para « families », « pointSize », « weight » y « italic ».
Si pointSize es cero o un valor negativo, el tamaño en puntos de la fuente se establece en un valor predeterminado que depende del sistema. Por lo general, este valor es de 12 puntos.
Cada entrada de nombre de familia en families puede incluir opcionalmente también el nombre de la fundición, p. ej., «Helvetica [Cronyx]». Si la familia está disponible en más de una fundición tipográfica y no se especifica la fundición, se elige una fundición al azar. Si la familia no está disponible, se establecerá una familia utilizando el algoritmo font matching.
Véase también Weight, setPointSize(), setWeight(), setItalic(), setStyleHint(), setFamilies() y QGuiApplication::font().
QFont::QFont(const QFont &font)
Crea una fuente que es una copia de font.
[constexpr noexcept default] QFont::QFont(QFont &&)
Crea una instancia de ` QFont` mediante la construcción «move».
[noexcept] QFont::~QFont()
Destruye el objeto de 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 mayúsculas actual de la fuente.
Véase también setCapitalization().
[since 6.7] void QFont::clearFeatures()
Borra cualquier característica previamente establecida en el QFont.
Consulta setFeature() para obtener más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véanse también QFont::Tag, setFeature(), unsetFeature(), featureTags() y featureValue().
[since 6.7] void QFont::clearVariableAxes()
Borra cualquier valor de eje variable establecido previamente en QFont.
Consulta setVariableAxis() para obtener más detalles sobre los ejes variables.
Esta función se introdujo en Qt 6.7.
Véanse también QFont::Tag, setVariableAxis(), unsetVariableAxis(), isVariableAxisSet() y variableAxisValue().
QString QFont::defaultFamily() const
Devuelve el nombre de la familia tipográfica 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 las familias de fuentes solicitadas, 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éanse también setFamily(), setFamilies(), family(), substitutes() y substitute().
QString QFont::family() const
Devuelve el nombre de la familia de fuentes solicitada. Este será siempre el mismo que el de la primera entrada en la llamada a families().
Véanse 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 configuradas actualmente en este QFont.
Consulta setFeature() para obtener más detalles sobre las características de fuente.
Esta función se introdujo en Qt 6.7.
Véanse 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.
Consulta setFeature() para obtener más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véanse también QFont::Tag, setFeature(), unsetFeature(), featureTags() y isFeatureSet().
bool QFont::fixedPitch() const
Devuelve true si se ha establecido un 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 de atributos de fuente separados por comas, tal y como la devuelve la función toString().
Véase también toString().
QFont::HintingPreference QFont::hintingPreference() const
Devuelve el nivel de hinting 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 ».
Tras sustituir una fuente, activa la actualización de la misma 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.
Tras sustituir una fuente, activa la actualización de la misma 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 entre sí, es decir, si una de ellas se creó como copia de la otra y ninguna de las dos se ha modificado desde entonces. Esto es mucho más estricto que la igualdad.
Véanse 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 indicada en tag en QFont; en caso contrario, devuelve «false».
Consulta setFeature() para obtener más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véanse 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 de la variable especificado mediante ` tag ` en ` QFont`; en caso contrario, devuelve «false».
Consulte setVariableAxis() para obtener más detalles sobre los ejes variables de las fuentes.
Esta función se introdujo en Qt 6.7.
Véanse también QFont::Tag, setVariableAxis(), unsetVariableAxis(), variableAxisValue() y clearVariableAxes().
bool QFont::italic() const
Devuelve ` true ` si la función ` style()` de la fuente no es QFont::StyleNormal
Véase también setItalic() y style().
bool QFont::kerning() const
Devuelve ` true ` si se debe aplicar el 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 la misma. Se suele utilizar como clave para una caché o un 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 espaciado entre letras.
Véase también letterSpacing(), setLetterSpacing() y setWordSpacing().
bool QFont::overline() const
Devuelve « true » si se ha establecido la línea superior; 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 ha establecido mediante ` setPixelSize()`. Devuelve -1 si el tamaño se ha establecido mediante ` setPointSize()` o ` setPointSizeF()`.
Véanse 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 ha especificado 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 ha especificado 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 objeto ` QFont ` cuyos atributos se han copiado de ` other ` y que no se habían establecido previamente en esta fuente.
void QFont::setBold(bool enable)
Si enable es verdadero, establece el grosor de la fuente en QFont::Bold; en caso contrario, establece el grosor en QFont::Normal.
Para un control más preciso del grosor, utiliza ` setWeight()`.
Nota: Si se ha establecido ` styleName()` (), este valor puede ignorarse o, si la plataforma lo admite, la fuente puede aparecer artificialmente en negrita.
Véase también bold() y setWeight().
void QFont::setCapitalization(QFont::Capitalization caps)
Establece el modo de mayúsculas del texto en esta fuente en « caps ».
La mayúscula de una fuente hace que el texto aparezca en el modo de mayúsculas seleccionado.
Véase también capitalization().
void QFont::setFamilies(const QStringList &families)
Establece la lista de nombres de familias para la fuente. Los nombres no distinguen entre mayúsculas y minúsculas y pueden incluir el nombre de una fundición. La primera familia que aparezca en families se establecerá como la familia principal de la fuente.
Cada entrada de nombre de familia en families puede incluir opcionalmente también el nombre de la fundición, p. ej., «Helvetica [Cronyx]». Si la familia está disponible en más de una fundición tipográfica y no se especifica la fundición, se elige una fundición arbitraria. Si la familia no está disponible, se establecerá una familia utilizando el algoritmo font matching.
Véanse 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 el nombre de la fundición.
El nombre « family » también puede incluir, de forma opcional, el nombre de la fundición, p. ej., «Helvetica [Cronyx]». Si la fuente « family » está disponible en más de una fundición y no se especifica la fundición, se elige una fundición al azar. Si la familia no está disponible, se establecerá una familia utilizando 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 modelado de la fuente y puede utilizarse para admitir características de fuente 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 que figura en el mapa de características de la fuente.
Este « value » entero, que se pasa junto con la etiqueta en la mayoría de los casos, 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, para determinadas características de fuente, 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 que se debe utilizar.
Por ejemplo, la característica tipográfica « frac » convertirá las fracciones diagonales separadas por una barra (como « 1/2 ») con una representación diferente. Normalmente, esto implicará integrar la fracción completa en el ancho de un solo carácter (como « ½ »).
Si una fuente es compatible con la característica « frac », se puede activar en el shaper configurando « features["frac"] = 1 » en el mapa de características de la fuente.
Nota: Por defecto, Qt activará y desactivará determinadas características de fuente en función de otras propiedades de la misma. En concreto, la función « kern » se activará o desactivará en función de la propiedad « kerning()» de « QFont ». Además, todas las funciones de ligatura (liga, clig, dlig, hlig) se desactivarán si se aplica « letterSpacing()», pero solo para los sistemas de escritura en los que el uso de ligaturas es meramente estético. En los sistemas de escritura en los que se requieren ligaturas, las funciones 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 de kerning está establecida en false. Del mismo modo, si se establece en 0, siempre estará desactivado. Para restablecer una característica de fuente a su comportamiento predeterminado, puedes desactivarla mediante ` unsetFeature()`.
Esta función se introdujo en Qt 6.7.
Véase también QFont::Tag, clearFeatures(), unsetFeature() y featureTags().
void QFont::setFixedPitch(bool enable)
Si enable es verdadero, activa el tono fijo; en caso contrario, lo desactiva.
Véase también ` fixedPitch()` y ` QFontInfo`.
void QFont::setHintingPreference(QFont::HintingPreference hintingPreference)
Establece la preferencia del nivel de hinting de los glifos en « hintingPreference ». Se trata de una indicación para que el sistema de renderizado de fuentes subyacente utilice un determinado nivel de hinting, y su compatibilidad varía según las plataformas. Consulta la tabla de la documentación de QFont::HintingPreference para obtener más detalles.
La preferencia predeterminada de hinting es QFont::PreferDefaultHinting.
Véase también hintingPreference().
void QFont::setItalic(bool enable)
Establece el valor de « style()» de la fuente en « QFont::StyleItalic » si « enable » es «true»; en caso contrario, el estilo se establece en « QFont::StyleNormal ».
Nota: Si se ha establecido styleName(), es posible que se ignore este valor o, si la plataforma lo admite, que la fuente se represente inclinada en lugar de seleccionar una variante de fuente en cursiva diseñada.
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á habilitado, las métricas de los glifos ya no se suman, ni siquiera en el texto latino. En otras palabras, la suposición de que width('a') + width('b') es igual a width("ab") no es necesariamente cierta.
Véanse 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 modifica el espaciado predeterminado entre las letras individuales de la fuente. El espaciado entre las letras se puede reducir o aumentar, ya sea en porcentaje del ancho del carácter o en píxeles, dependiendo del tipo de espaciado seleccionado.
Véanse también letterSpacing(), letterSpacingType() y setWordSpacing().
void QFont::setOverline(bool enable)
Si enable es verdadero, activa la línea superior; 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 sin signo de 16 bits.
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 en puntos en pointSize. El tamaño en puntos debe ser mayor que cero.
Véase también pointSize() y setPointSizeF().
void QFont::setPointSizeF(qreal pointSize)
Establece el tamaño en puntos en pointSize. El tamaño en puntos debe ser mayor que cero. Es posible que no se alcance la precisión solicitada en todas las plataformas.
Véanse también pointSizeF(), setPointSize() y setPixelSize().
void QFont::setStretch(int factor)
Establece el factor de estiramiento de la fuente.
El factor de estiramiento se corresponde con una versión condensada o expandida de la fuente, o bien aplica una transformación de estiramiento que modifica el ancho de todos los caracteres de la fuente en un percentaj factor. Por ejemplo, si se establece « factor » en 150, todos los caracteres de la fuente serán 1,5 veces (es decir, un 150 %) más anchos. El factor de estiramiento mínimo es 1 y el máximo es 4000. El factor de estiramiento predeterminado es « AnyStretch », que acepta cualquier valor y no aplica ninguna transformación a la fuente.
El factor de estiramiento solo se aplica a las fuentes de contorno. En el caso de las fuentes de mapa de bits, el factor de estiramiento se ignora.
Nota: Al hacer coincidir una fuente con un factor de estiramiento nativo no predeterminado, solicitar un estiramiento de 100 la volverá a estirar hasta convertirla en una fuente de ancho medio.
Véase también stretch() y QFont::Stretch.
void QFont::setStrikeOut(bool enable)
Si enable es verdadero, activa la función «strikeout»; en caso contrario, la desactiva.
Véase también strikeOut() y QFontInfo.
void QFont::setStyle(QFont::Style style)
Establece el estilo de la fuente como « style ».
Véase también style(), italic() y QFontInfo.
void QFont::setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)
Establece la sugerencia de estilo y la estrategia en hint y strategy, respectivamente.
Si no se establecen explícitamente, la sugerencia de estilo adoptará por defecto el valor AnyStyle y la estrategia de estilo, el valor PreferDefault.
Qt no admite sugerencias de estilo en X11, ya que el sistema de ventanas no proporciona esta información.
Véase también StyleHint, styleHint(), StyleStrategy, styleStrategy() y QFontInfo.
void QFont::setStyleName(const QString &styleName)
Establece el nombre del estilo de la fuente como « styleName ». Una vez establecido, otras propiedades de estilo como « style()» y « weight()» se ignorarán a la hora de buscar coincidencias de fuentes, aunque puedan simularse posteriormente si el motor de fuentes de la plataforma lo admite.
Debido a la menor calidad de los estilos simulados artificialmente y a la falta de compatibilidad total entre plataformas, 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 valor « value » al eje variable correspondiente a « tag ».
Las fuentes variables permiten almacenar múltiples variaciones (con diferentes grosores, anchos o estilos) en un mismo archivo de fuente. Las variaciones se expresan como valores de coma flotante para un conjunto predefinido de parámetros, denominados «ejes variables». El diseñador de la fuente suele asignar nombres a las instancias específicas y, en Qt, estas se pueden seleccionar mediante ` setStyleName()` al igual que las subfamilias tradicionales.
En algunos casos, también resulta útil proporcionar valores arbitrarios para los diferentes ejes. Por ejemplo, si una fuente tiene una subfamilia Regular y otra Negrita, es posible que se desee un grosor intermedio entre ambas. En ese caso, se podría solicitar manualmente proporcionando un valor personalizado para el eje «wght» de la fuente.
Si la fuente admite el eje «wght» y el valor proporcionado se encuentra dentro de su rango definido, se proporcionará una fuente correspondiente al peso 550,0.
Existen algunos ejes estándar que ofrecen muchas fuentes, como «wght» (peso), «wdth» (anchura), «ital» (cursiva) y «opsz» (tamaño óptico). Cada uno de ellos tiene unos rangos individuales definidos en la propia fuente. Por ejemplo, «wght» puede oscilar entre 100 y 900 (QFont::Thin a QFont::Black), mientras que «ital» puede oscilar entre 0 y 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 debe cumplir los requisitos de un QFont::Tag (secuencia de cuatro caracteres Latin-1).
Por defecto, no se establecen ejes variables.
Nota: En Windows, los ejes variables no son compatibles si se utiliza el backend de fuentes GDI opcional.
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 se establece ` styleName()` (peso de la fuente), este valor puede ignorarse a la hora de seleccionar la fuente.
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 modifica el espaciado predeterminado entre palabras individuales. Un valor positivo aumenta el espaciado entre palabras en la cantidad correspondiente de píxeles, mientras que un valor negativo lo reduce en la misma medida.
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 el formato de tachado; 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 puede utilizarse para hacer coincidir la fuente con estilos irregulares (que no pueden normalizarse en otras propiedades de estilo).
Véase también setStyleName(), setFamily() y setStyle().
QFont::StyleStrategy QFont::styleStrategy() const
Devuelve el objeto ` 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 ninguna sustitución para ` familyName`, se devuelve ` familyName `.
Para obtener una lista de sustituciones, utiliza 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 ninguna 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)
Sustituye esta instancia de fuente por 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 de atributos separados por comas, ideal para su uso en QSettings, y consta de lo siguiente:
- Familia de fuentes
- Tamaño en puntos
- Tamaño en píxeles
- Sugerencia de estilo
- Grosor de la fuente
- Estilo de la fuente
- Subrayado
- Tachado
- Espaciado fijo
- Siempre 0
- Mayúsculas
- Espaciado entre letras
- Espaciado entre palabras
- Estiramiento
- Estrategia de estilo
- Estilo de fuente
- Características de la fuente
- Ejes variables
Véase también fromString().
bool QFont::underline() const
Devuelve « true » si se ha activado el subrayado; en caso contrario, devuelve « false ».
Véase también setUnderline().
[since 6.7] void QFont::unsetFeature(QFont::Tag tag)
Elimina la característica « tag » del mapa de características habilitadas o deshabilitadas explícitamente.
Nota: Aunque la característica no se haya añadido previamente, esto marcará el mapa de características de la fuente como modificado en este « QFont », de modo que tendrá prioridad a la hora de resolverla frente a otras fuentes.
Al desactivar una característica existente en el ` QFont `, el comportamiento vuelve a ser el predeterminado.
Consulta setFeature() para obtener más detalles sobre las características de las fuentes.
Esta función se introdujo en Qt 6.7.
Véanse también QFont::Tag, clearFeatures(), setFeature(), featureTags() y featureValue().
[since 6.7] void QFont::unsetVariableAxis(QFont::Tag tag)
Desactiva un valor de eje variable establecido previamente y proporcionado por tag.
Nota: Si no se ha especificado previamente ningún valor para esta etiqueta, el ` QFont ` seguirá considerando que sus ejes variables están establecidos a la hora de resolverlos frente a 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.
Consulta setVariableAxis() para obtener más detalles sobre los ejes variables.
Esta función se introdujo en Qt 6.7.
Véanse 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 de variable específico tag. Si no se ha establecido la etiqueta, se devolverá 0,0 en su lugar.
Consulta setVariableAxis() para obtener más detalles sobre los 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 grosor 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 un QVariant
bool QFont::operator!=(const QFont &f) const
Devuelve « true » si esta fuente es diferente de « f »; en caso contrario, devuelve « false ».
Se considera que dos objetos `QFont` son diferentes si sus atributos de fuente son distintos.
Véase también operator==().
bool QFont::operator<(const QFont &f) const
Proporciona una comparación arbitraria entre esta fuente y la fuente f. Lo único 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 resulta útil en determinadas circunstancias, por ejemplo, si se desea utilizar objetos de tipo QFont como claves en un QMap.
Véanse también operator==(), operator!=() y isCopyOf().
[noexcept] QFont &QFont::operator=(QFont &&other)
Asigna « other » a esta instancia de « 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`.
Se considera que dos objetos `QFont` son iguales si sus atributos de fuente son iguales.
Véase también operator!=() y isCopyOf().
Elementos no miembros relacionados
[noexcept] size_t qHash(const QFont &key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
QDataStream &operator<<(QDataStream &s, const QFont &font)
Escribe la fuente « font » en el flujo de datos « s ». (La función «toString()» escribe en un flujo de texto.)
Véase también Formato de los operadores de QDataStream.
QDataStream &operator>>(QDataStream &s, QFont &font)
Lee el archivo de fuentes « font » desde el flujo de datos « s ». (La función «fromString()» lee desde un flujo de texto.)
Véase también Formato de los operadores de 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.