QTextCharFormat Class

Documentación de las funciones miembro

QTextCharFormat::QTextCharFormat()

Construye un nuevo objeto de formato de caracteres.

QString QTextCharFormat::anchorHref() const

Devuelve el enlace de hipertexto del formato de texto, o una cadena vacía si no se ha establecido ninguno.

Véase también setAnchorHref().

QStringList QTextCharFormat::anchorNames() const

Devuelve los nombres de ancla asociados a este formato de texto, o una lista de cadenas vacía si no se ha establecido ninguno. Si se establecen los nombres de ancla, el texto con este formato puede ser el destino de un enlace de hipertexto.

Véase también setAnchorNames().

[since 6.0] qreal QTextCharFormat::baselineOffset() const

Devuelve el desplazamiento de la línea de base en %.

Esta función se introdujo en Qt 6.0.

Ver también setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline(), y superScriptBaseline().

QFont QTextCharFormat::font() const

Devuelve la fuente para este formato de caracteres.

Esta función tiene en cuenta los atributos de fuente del formato (como fontWeight() y fontPointSize()) y los resuelve sobre la fuente por defecto, definida como sigue. Si el formato forma parte de un documento, ese será el tipo de letra por defecto del documento. En caso contrario, las propiedades se resuelven sobre una fuente construida por defecto QFont.

Por ejemplo, si el tamaño de la fuente de este formato no se ha modificado con respecto a la fuente por defecto, fontPointSize() devuelve 0, mientras que font().pointSize() devuelve el tamaño real utilizado para el dibujo.

Véase también setFont() y QTextDocument::defaultFont().

QFont::Capitalization QTextCharFormat::fontCapitalization() const

Devuelve el tipo de capitalización actual de la fuente.

Véase también setFontCapitalization().

QVariant QTextCharFormat::fontFamilies() const

Devuelve las familias de fuentes del formato de texto.

Véase también setFontFamilies() y font().

[since 6.11] QMap<QFont::Tag, quint32> QTextCharFormat::fontFeatures() const

Obtiene las características tipográficas de la fuente del formato de texto.

Esta función se introdujo en Qt 6.11.

Véase también setFontFeatures().

bool QTextCharFormat::fontFixedPitch() const

Devuelve true si la fuente del formato de texto es de paso fijo; en caso contrario devuelve false.

Véase también setFontFixedPitch() y font().

QFont::HintingPreference QTextCharFormat::fontHintingPreference() const

Devuelve la preferencia de sugerencia establecida para este formato de texto.

Véase también setFontHintingPreference(), font() y QFont::hintingPreference().

bool QTextCharFormat::fontItalic() const

Devuelve true si la fuente del formato de texto es cursiva; en caso contrario devuelve false.

Véase también setFontItalic() y font().

bool QTextCharFormat::fontKerning() const

Devuelve true si el kerning de la fuente está activado.

Véase también setFontKerning() y font().

qreal QTextCharFormat::fontLetterSpacing() const

Devuelve el espaciado entre letras actual.

Véase también setFontLetterSpacing(), setFontLetterSpacingType() y fontLetterSpacingType().

QFont::SpacingType QTextCharFormat::fontLetterSpacingType() const

Devuelve el tipo de espaciado entre letras de este formato..

Véase también setFontLetterSpacingType(), setFontLetterSpacing() y fontLetterSpacing().

bool QTextCharFormat::fontOverline() const

Devuelve true si la fuente del formato de texto está superpuesta; en caso contrario devuelve false.

Véase también setFontOverline() y font().

qreal QTextCharFormat::fontPointSize() const

Devuelve el tamaño de fuente utilizado para mostrar texto en este formato.

Véase también setFontPointSize() y font().

int QTextCharFormat::fontStretch() const

Devuelve el estiramiento actual de la fuente.

Véase también setFontStretch().

bool QTextCharFormat::fontStrikeOut() const

Devuelve true si la fuente del formato de texto está tachada (tiene una línea horizontal dibujada a través de ella); en caso contrario devuelve false.

Véase también setFontStrikeOut() y font().

QFont::StyleHint QTextCharFormat::fontStyleHint() const

Devuelve la sugerencia de estilo de fuente.

Véase también setFontStyleHint() y font().

QVariant QTextCharFormat::fontStyleName() const

Devuelve el nombre del estilo de fuente del formato de texto.

Véase también setFontStyleName(), font(), y QFont::styleName().

QFont::StyleStrategy QTextCharFormat::fontStyleStrategy() const

Devuelve la estrategia de estilo de fuente actual.

Véase también setFontStyleStrategy() y font().

bool QTextCharFormat::fontUnderline() const

Devuelve true si la fuente del formato de texto está subrayada; en caso contrario devuelve false.

Véase también setFontUnderline() y font().

[since 6.11] QMap<QFont::Tag, float> QTextCharFormat::fontVariableAxes() const

Obtiene los ejes variables de la fuente del formato de texto.

Esta función se introdujo en Qt 6.11.

Véase también setFontVariableAxes().

int QTextCharFormat::fontWeight() const

Devuelve el peso de la fuente del formato de texto.

Véase también setFontWeight(), font() y QFont::Weight.

qreal QTextCharFormat::fontWordSpacing() const

Devuelve el valor actual del espaciado entre palabras.

Véase también setFontWordSpacing().

bool QTextCharFormat::isAnchor() const

Devuelve true si el texto tiene formato de ancla; en caso contrario, devuelve false.

Véase también setAnchor(), setAnchorHref() y setAnchorNames().

bool QTextCharFormat::isValid() const

Devuelve true si este formato de caracteres es válido; en caso contrario devuelve false.

void QTextCharFormat::setAnchor(bool anchor)

Si anchor es verdadero, el texto con este formato representa un ancla, y se formatea de la manera apropiada; en caso contrario, el texto se formatea normalmente. (Las anclas son hipervínculos que suelen mostrarse subrayados y en un color distinto al del texto sin formato).

La forma en que se muestra el texto es independiente de si el formato tiene o no un ancla válida definida. Utilice setAnchorHref(), y opcionalmente setAnchorNames() para crear un enlace de hipertexto.

Véase también isAnchor().

void QTextCharFormat::setAnchorHref(const QString &value)

Establece el enlace de hipertexto para el formato de texto en la dirección value. Normalmente se trata de una URL como "http://example.com/index.html".

El ancla se mostrará con value como texto; si desea mostrar un texto diferente, llame a setAnchorNames().

Para formatear el texto como un enlace de hipertexto, utilice setAnchor().

Véase también anchorHref().

void QTextCharFormat::setAnchorNames(const QStringList &names)

Establece el ancla del formato de texto names. Para que el ancla funcione como hipervínculo, el destino debe establecerse con setAnchorHref() y el ancla debe habilitarse con setAnchor().

Véase también anchorNames().

[since 6.0] void QTextCharFormat::setBaselineOffset(qreal baseline)

Establece la línea base (en % de la altura) del texto en baseline. Un valor positivo desplaza el texto hacia arriba, en el % correspondiente; un valor negativo lo desplaza hacia abajo. El valor por defecto es 0.

Esta función se introdujo en Qt 6.0.

Ver también baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline(), y superScriptBaseline().

void QTextCharFormat::setFont(const QFont &font, QTextCharFormat::FontPropertiesInheritanceBehavior behavior = FontPropertiesAll)

Establece el formato de texto font.

Si behavior es QTextCharFormat::FontPropertiesAll, la propiedad de fuente que no se ha establecido explícitamente se trata como si se hubiera establecido con el valor predeterminado; Si behavior es QTextCharFormat::FontPropertiesSpecifiedOnly, la propiedad de fuente que no se ha establecido explícitamente se ignora y el valor de la propiedad respectiva permanece sin cambios.

Véase también font().

void QTextCharFormat::setFontCapitalization(QFont::Capitalization capitalization)

Establece la capitalización del texto que aparece en esta fuente en capitalization.

La capitalización de una fuente hace que el texto aparezca en el modo de capitalización seleccionado.

Véase también fontCapitalization().

void QTextCharFormat::setFontFamilies(const QStringList &families)

Establece la fuente del formato de texto families.

Véase también fontFamilies() y setFont().

[since 6.11] void QTextCharFormat::setFontFeatures(const QMap<QFont::Tag, quint32> &fontFeatures)

Establece las características tipográficas de la fuente del formato de texto en fontFeatures.

Esta función se introdujo en Qt 6.11.

Véase también fontFeatures() y QFont::setFeature().

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

Si fixedPitch es verdadero, establece que la fuente del formato de texto sea de paso fijo; en caso contrario, se utiliza una fuente de paso no fijo.

Véase también fontFixedPitch() y setFont().

void QTextCharFormat::setFontHintingPreference(QFont::HintingPreference hintingPreference)

Establece la preferencia de sugerencia de la fuente del formato de texto en hintingPreference.

Véase también fontHintingPreference(), setFont() y QFont::setHintingPreference().

void QTextCharFormat::setFontItalic(bool italic)

Si italic es verdadero, establece la fuente del formato de texto en cursiva; en caso contrario, la fuente será no cursiva.

Véase también fontItalic() y setFont().

void QTextCharFormat::setFontKerning(bool enable)

Activa el kerning para esta fuente si enable es verdadero; en caso contrario, lo desactiva.

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 fontKerning() y setFont().

void QTextCharFormat::setFontLetterSpacing(qreal spacing)

Establece el espaciado entre letras de este formato en el valor spacing. El significado del valor depende del tipo de espaciado entre letras de la fuente.

Para el espaciado porcentual, un valor de 100 indica el espaciado por defecto; un valor de 200 duplica la cantidad de espacio que ocupa una letra.

Véase también fontLetterSpacing(), setFontLetterSpacingType() y fontLetterSpacingType().

void QTextCharFormat::setFontLetterSpacingType(QFont::SpacingType letterSpacingType)

Establece el tipo de espaciado entre letras de este formato en letterSpacingType.

Véase también fontLetterSpacingType(), setFontLetterSpacing() y fontLetterSpacing().

void QTextCharFormat::setFontOverline(bool overline)

Si overline es verdadero, establece la fuente del formato de texto para que se sobrelinee; de lo contrario, la fuente se muestra sin sobrelinear.

Véase también fontOverline() y setFont().

void QTextCharFormat::setFontPointSize(qreal size)

Establece la fuente del formato de texto size.

Véase también fontPointSize() y setFont().

void QTextCharFormat::setFontStretch(int factor)

Establece el factor de estiramiento de la fuente en factor.

El factor de estiramiento cambia la anchura de todos los caracteres de la fuente en un factor porcentual. Por ejemplo, si estableces factor a 150, todos los caracteres de la fuente serán 1,5 veces (es decir, 150%) más anchos. El factor de ampliación por defecto es 100. El factor de estiramiento mínimo es 1 y el máximo 4000.

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.

Véase también fontStretch().

void QTextCharFormat::setFontStrikeOut(bool strikeOut)

Si strikeOut es verdadero, establece la fuente del formato de texto con el tachado activado (con una línea horizontal que lo atraviesa); de lo contrario, se muestra sin tachado.

Véase también fontStrikeOut() y setFont().

void QTextCharFormat::setFontStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = QFont::PreferDefault)

Establece el estilo de fuente hint y strategy.

Qt no soporta sugerencias de estilo en X11 ya que esta información no es proporcionada por el sistema de ventanas.

Véase también fontStyleHint(), setFont(), y QFont::setStyleHint().

void QTextCharFormat::setFontStyleName(const QString &styleName)

Establece la fuente del formato de texto styleName.

Véase también fontStyleName(), setFont() y QFont::setStyleName().

void QTextCharFormat::setFontStyleStrategy(QFont::StyleStrategy strategy)

Establece el estilo de fuente strategy.

Véase también fontStyleStrategy(), setFont() y QFont::setStyleStrategy().

void QTextCharFormat::setFontUnderline(bool underline)

Si underline es verdadero, establece que la fuente del formato de texto esté subrayada; de lo contrario, se muestra sin subrayar.

Véase también fontUnderline() y setFont().

[since 6.11] void QTextCharFormat::setFontVariableAxes(const QMap<QFont::Tag, float> &fontVariableAxes)

Establece los ejes variables de la fuente del formato de texto en fontVariableAxes.

Esta función se introdujo en Qt 6.11.

Véase también fontVariableAxes() y QFont::setVariableAxis().

void QTextCharFormat::setFontWeight(int weight)

Establece el peso de la fuente del formato de texto en weight.

Véase también fontWeight(), setFont() y QFont::Weight.

void QTextCharFormat::setFontWordSpacing(qreal spacing)

Establece el espaciado entre palabras de este formato en el valor spacing, en píxeles.

Véase también fontWordSpacing().

[since 6.0] void QTextCharFormat::setSubScriptBaseline(qreal baseline)

Establece la línea base del subíndice como un % de la altura de la fuente a baseline. El valor por defecto es 16.67% (1/6 de la altura).

Esta función se introdujo en Qt 6.0.

Véase también subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset(), y baselineOffset().

[since 6.0] void QTextCharFormat::setSuperScriptBaseline(qreal baseline)

Establece la línea base del superíndice como un % de la altura de la fuente en baseline. El valor por defecto es 50% (1/2 de la altura).

Esta función se introdujo en Qt 6.0.

Véase también superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset(), y baselineOffset().

void QTextCharFormat::setTextOutline(const QPen &pen)

Establece el lápiz utilizado para dibujar los contornos de los caracteres en la dirección pen.

Véase también textOutline().

void QTextCharFormat::setToolTip(const QString &text)

Establece la información sobre la herramienta para un fragmento de texto en la dirección text.

Véase también toolTip().

void QTextCharFormat::setUnderlineColor(const QColor &color)

Establece el color utilizado para dibujar subrayados, sobrelíneas y tachados en los caracteres con este formato en el color especificado.

Véase también underlineColor().

void QTextCharFormat::setUnderlineStyle(QTextCharFormat::UnderlineStyle style)

Establece el estilo de subrayado del texto en style.

Véase también underlineStyle().

void QTextCharFormat::setVerticalAlignment(QTextCharFormat::VerticalAlignment alignment)

Establece la alineación vertical utilizada para los caracteres con este formato en la dirección alignment especificada.

Véase también verticalAlignment().

[since 6.0] qreal QTextCharFormat::subScriptBaseline() const

Devuelve la línea base del subíndice como un % de la altura de la fuente.

Esta función se introdujo en Qt 6.0.

Véase también setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() y baselineOffset().

[since 6.0] qreal QTextCharFormat::superScriptBaseline() const

Devuelve la línea base del superíndice como un % de la altura de la fuente.

Esta función se introdujo en Qt 6.0.

Véase también setSuperScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() y baselineOffset().

QPen QTextCharFormat::textOutline() const

Devuelve la pluma utilizada para dibujar los contornos de los caracteres en este formato.

Véase también setTextOutline().

QString QTextCharFormat::toolTip() const

Devuelve la información sobre la herramienta que se muestra para un fragmento de texto.

Véase también setToolTip().

QColor QTextCharFormat::underlineColor() const

Devuelve el color utilizado para dibujar subrayados, sobrelíneas y tachados en los caracteres con este formato.

Véase también setUnderlineColor().

QTextCharFormat::UnderlineStyle QTextCharFormat::underlineStyle() const

Devuelve el estilo de subrayado del texto.

Véase también setUnderlineStyle().

QTextCharFormat::VerticalAlignment QTextCharFormat::verticalAlignment() const

Devuelve la alineación vertical utilizada para los caracteres con este formato.

Véase también setVerticalAlignment().