QTextBlockFormat Class

Documentation sur les fonctions membres

QTextBlockFormat::QTextBlockFormat()

Crée un nouvel objet QTextBlockFormat.

Qt::Alignment QTextBlockFormat::alignment() const

Renvoie l'alignement du paragraphe.

Voir aussi setAlignment().

qreal QTextBlockFormat::bottomMargin() const

Renvoie la marge inférieure du paragraphe.

Voir également setBottomMargin() et topMargin().

int QTextBlockFormat::headingLevel() const

Renvoie le niveau d'en-tête du paragraphe s'il s'agit d'un en-tête, ou 0 dans le cas contraire.

Voir également setHeadingLevel().

int QTextBlockFormat::indent() const

Renvoie l'indentation du paragraphe.

Voir aussi setIndent().

bool QTextBlockFormat::isValid() const

Renvoie « true » si ce format de bloc est valide ; sinon, renvoie « false ».

qreal QTextBlockFormat::leftMargin() const

Renvoie la marge gauche du paragraphe.

Voir également setLeftMargin(), rightMargin() et indent().

qreal QTextBlockFormat::lineHeight() const

Cette méthode renvoie la propriété LineHeight du paragraphe.

Voir également LineHeightTypes, setLineHeight() et lineHeightType().

qreal QTextBlockFormat::lineHeight(qreal scriptLineHeight, qreal scaling = 1.0) const

Renvoie la hauteur des lignes du paragraphe en fonction de la hauteur de la ligne de script indiquée par ` scriptLineHeight ` et du facteur ` scaling ` spécifié.

La valeur renvoyée dépend également du paramètre `LineHeightType` du paragraphe, ainsi que du paramètre `LineHeight` défini pour ce dernier.

La mise à l’échelle est nécessaire pour les hauteurs comprenant un nombre fixe de pixels, afin de les adapter correctement à l’impression.

Voir également LineHeightTypes, setLineHeight() et lineHeightType().

int QTextBlockFormat::lineHeightType() const

Cette méthode renvoie la propriété LineHeightType du paragraphe.

Voir également LineHeightTypes, setLineHeight() et lineHeight().

QTextBlockFormat::MarkerType QTextBlockFormat::marker() const

Renvoie le marqueur du paragraphe s'il en existe un, ou « NoMarker » dans le cas contraire.

Voir aussi setMarker().

bool QTextBlockFormat::nonBreakableLines() const

Renvoie « true » si les lignes du paragraphe sont insécables ; sinon, renvoie « false ».

Voir également setNonBreakableLines().

QTextFormat::PageBreakFlags QTextBlockFormat::pageBreakPolicy() const

Renvoie la règle de saut de page actuellement définie pour le paragraphe. La valeur par défaut est « QTextFormat::PageBreak_Auto ».

Voir également setPageBreakPolicy().

qreal QTextBlockFormat::rightMargin() const

Renvoie la marge droite du paragraphe.

Voir également setRightMargin() et leftMargin().

void QTextBlockFormat::setAlignment(Qt::Alignment alignment)

Définit l'alignment e du paragraphe.

Voir aussi alignment().

void QTextBlockFormat::setBottomMargin(qreal margin)

Définit l'margin e inférieure du paragraphe.

Voir également bottomMargin(), setTopMargin(), setLeftMargin() et setRightMargin().

void QTextBlockFormat::setHeadingLevel(int level)

Définit l'level du titre du paragraphe, où 1 correspond au type de titre de plus haut niveau (généralement associé à la plus grande taille de police possible pour un titre), et où les valeurs croissantes correspondent à des niveaux de titre de plus en plus bas dans le document (et généralement associés à des tailles de police plus petites). Par exemple, lors de la lecture d'une balise HTML H1, le niveau de titre est défini sur 1. La définition du niveau de titre ne modifie pas automatiquement la taille de police ; cependant, la fonction ` QTextDocumentFragment::fromHtml()` définit simultanément le niveau de titre et la taille de police.

Si le paragraphe n’est pas un titre, le niveau doit être défini sur 0 (valeur par défaut).

Voir également headingLevel().

void QTextBlockFormat::setIndent(int indentation)

Définit l'indentation du paragraphe. Les marges sont définies indépendamment de l'indentation à l'aide des fonctions setLeftMargin() et setTextIndent(). La indentation est un nombre entier qui est multiplié par l'indentation standard du document, ce qui donne l'indentation réelle du paragraphe.

Voir également indent() et QTextDocument::indentWidth().

void QTextBlockFormat::setLeftMargin(qreal margin)

Définit l'margin gauche du paragraphe. L' peut être appliquée séparément à l'aide de la fonction setIndent().

Voir également leftMargin(), setRightMargin(), setTopMargin() et setBottomMargin().

void QTextBlockFormat::setLineHeight(qreal height, int heightType)

Définit la hauteur de ligne du paragraphe sur la valeur fournie par height, qui dépend de heightType selon les modalités décrites par l'énumération LineHeightTypes.

Voir également LineHeightTypes, lineHeight() et lineHeightType().

void QTextBlockFormat::setMarker(QTextBlockFormat::MarkerType marker)

Définit le type d'élément décoratif à afficher à côté du paragraphe sur marker. Par exemple, un élément de liste peut être accompagné d'une case à cocher, cochée ou non, en lieu et place de sa puce. La valeur par défaut est NoMarker.

Voir également marker().

void QTextBlockFormat::setNonBreakableLines(bool b)

Si la valeur de « b » est « true », les lignes du paragraphe sont considérées comme non cassables ; dans le cas contraire, elles sont cassables.

Voir également nonBreakableLines().

void QTextBlockFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)

Définit la règle de saut de page pour le paragraphe sur « policy ».

Voir également pageBreakPolicy().

void QTextBlockFormat::setRightMargin(qreal margin)

Définit l'margin e à droite du paragraphe.

Voir également rightMargin(), setLeftMargin(), setTopMargin() et setBottomMargin().

void QTextBlockFormat::setTabPositions(const QList<QTextOption::Tab> &tabs)

Définit les positions des tabulations du bloc de texte selon celles spécifiées par tabs.

Voir aussi tabPositions().

void QTextBlockFormat::setTextIndent(qreal indent)

Définit l'indent de la première ligne du bloc. Cela permet de mettre en retrait la première ligne d'un paragraphe différemment des autres lignes, ce qui améliore la lisibilité du texte.

Voir également textIndent(), setLeftMargin(), setRightMargin(), setTopMargin() et setBottomMargin().

void QTextBlockFormat::setTopMargin(qreal margin)

Définit l'margin e supérieure du paragraphe.

Voir également topMargin(), setBottomMargin(), setLeftMargin() et setRightMargin().

QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const

Renvoie une liste des positions de tabulation définies pour le bloc de texte.

Voir aussi setTabPositions().

qreal QTextBlockFormat::textIndent() const

Renvoie l'indentation du texte du paragraphe.

Voir aussi setTextIndent().

qreal QTextBlockFormat::topMargin() const

Renvoie la marge supérieure du paragraphe.

Voir également setTopMargin() et bottomMargin().