              
QTextCharFormat Class Reference |
| enum | UnderlineStyle { NoUnderline, SingleUnderline, DashUnderline, DotLine, ..., SpellCheckUnderline } |
| enum | VerticalAlignment { AlignNormal, AlignSuperScript, AlignSubScript, AlignMiddle, AlignBottom, AlignTop } |
Public Functions
| QTextCharFormat () | |
| QString | anchorHref () const |
| QStringList | anchorNames () const |
| QFont | font () const |
| QFont::Capitalization | fontCapitalization () const |
| QString | fontFamily () const |
| bool | fontFixedPitch () const |
| bool | fontItalic () const |
| bool | fontKerning () const |
| qreal | fontLetterSpacing () const |
| bool | fontOverline () const |
| qreal | fontPointSize () const |
| bool | fontStrikeOut () const |
| QFont::StyleHint | fontStyleHint () const |
| QFont::StyleStrategy | fontStyleStrategy () const |
| bool | fontUnderline () const |
| int | fontWeight () const |
| qreal | fontWordSpacing () const |
| bool | isAnchor () const |
| bool | isValid () const |
| void | setAnchor ( bool anchor ) |
| void | setAnchorHref ( const QString & value ) |
| void | setAnchorNames ( const QStringList & names ) |
| void | setFont ( const QFont & font ) |
| void | setFontCapitalization ( QFont::Capitalization capitalization ) |
| void | setFontFamily ( const QString & family ) |
| void | setFontFixedPitch ( bool fixedPitch ) |
| void | setFontItalic ( bool italic ) |
| void | setFontKerning ( bool enable ) |
| void | setFontLetterSpacing ( qreal spacing ) |
| void | setFontOverline ( bool overline ) |
| void | setFontPointSize ( qreal size ) |
| void | setFontStrikeOut ( bool strikeOut ) |
| void | setFontStyleHint ( QFont::StyleHint hint, QFont::StyleStrategy strategy = QFont::PreferDefault ) |
| void | setFontStyleStrategy ( QFont::StyleStrategy strategy ) |
| void | setFontUnderline ( bool underline ) |
| void | setFontWeight ( int weight ) |
| void | setFontWordSpacing ( qreal spacing ) |
| void | setTextOutline ( const QPen & pen ) |
| void | setToolTip ( const QString & text ) |
| void | setUnderlineColor ( const QColor & color ) |
| void | setUnderlineStyle ( UnderlineStyle style ) |
| void | setVerticalAlignment ( VerticalAlignment alignment ) |
| QPen | textOutline () const |
| QString | toolTip () const |
| QColor | underlineColor () const |
| UnderlineStyle | underlineStyle () const |
| VerticalAlignment | verticalAlignment () const |
- 49 public functions inherited from QTextFormat
Detailed Description
The QTextCharFormat class provides formatting information for characters in a QTextDocument.
The character format of text in a document specifies the visual properties of the text, as well as information about its role in a hypertext document.
The font used can be set by supplying a font to the setFont() function, and each aspect of its appearance can be adjusted to give the desired effect. setFontFamily() and setFontPointSize() define the font's family (e.g. Times) and printed size; setFontWeight() and setFontItalic() provide control over the style of the font. setFontUnderline(), setFontOverline(), setFontStrikeOut(), and setFontFixedPitch() provide additional effects for text.
The color is set with setForeground(). If the text is intended to be used as an anchor (for hyperlinks), this can be enabled with setAnchor(). The setAnchorHref() and setAnchorNames() functions are used to specify the information about the hyperlink's destination and the anchor's name.
See also QTextFormat, QTextBlockFormat, QTextTableFormat, and QTextListFormat.
Member Type Documentation
enum QTextCharFormat::UnderlineStyle
This enum describes the different ways drawing underlined text.
| Constant | Value | Description |
|---|---|---|
| QTextCharFormat::NoUnderline | 0 | Text is draw without any underlining decoration. |
| QTextCharFormat::SingleUnderline | 1 | A line is drawn using Qt::SolidLine. |
| QTextCharFormat::DashUnderline | 2 | Dashes are drawn using Qt::DashLine. |
| QTextCharFormat::DotLine | 3 | Dots are drawn using Qt::DotLine; |
| QTextCharFormat::DashDotLine | 4 | Dashs and dots are drawn using Qt::DashDotLine. |
| QTextCharFormat::DashDotDotLine | 5 | Underlines draw drawn using Qt::DashDotDotLine. |
| QTextCharFormat::WaveUnderline | 6 | The text is underlined using a wave shaped line. |
| QTextCharFormat::SpellCheckUnderline | 7 | The underline is drawn depending on the QStyle::SH_SpellCeckUnderlineStyle style hint of the QApplication style. By default this is mapped to WaveUnderline, on Mac OS X it is mapped to DashDotLine. |
See also Qt::PenStyle.
enum QTextCharFormat::VerticalAlignment
This enum describes the ways that adjacent characters can be vertically aligned.
| Constant | Value | Description |
|---|---|---|
| QTextCharFormat::AlignNormal | 0 | Adjacent characters are positioned in the standard way for text in the writing system in use. |
| QTextCharFormat::AlignSuperScript | 1 | Characters are placed above the baseline for normal text. |
| QTextCharFormat::AlignSubScript | 2 | Characters are placed below the baseline for normal text. |
| QTextCharFormat::AlignMiddle | 3 | The center of the object is vertically aligned with the base line. Currently, this is only implemented for inline objects. |
| QTextCharFormat::AlignBottom | 5 | The bottom edge of the object is vertically aligned with the base line. |
| QTextCharFormat::AlignTop | 4 | The top edge of the object is vertically aligned with the base line. |
Member Function Documentation
QTextCharFormat::QTextCharFormat ()
Constructs a new character format object.
QString QTextCharFormat::anchorHref () const
Returns the text format's hypertext link, or an empty string if none has been set.
See also setAnchorHref().
QStringList QTextCharFormat::anchorNames () const
Returns the anchor names associated with this text format, or an empty string list if none has been set. If the anchor names are set, text with this format can be the destination of a hypertext link.
This function was introduced in Qt 4.3.
See also setAnchorNames().
QFont QTextCharFormat::font () const
Returns the font for this character format.
See also setFont().
QFont::Capitalization QTextCharFormat::fontCapitalization () const
Returns the current capitalization type of the font.
This function was introduced in Qt 4.4.
See also setFontCapitalization().
QString QTextCharFormat::fontFamily () const
Returns the text format's font family.
See also setFontFamily() and font().
bool QTextCharFormat::fontFixedPitch () const
Returns true if the text format's font is fixed pitch; otherwise returns false.
See also setFontFixedPitch() and font().
bool QTextCharFormat::fontItalic () const
Returns true if the text format's font is italic; otherwise returns false.
See also setFontItalic() and font().
bool QTextCharFormat::fontKerning () const
Returns true if the font kerning is enabled.
This function was introduced in Qt 4.5.
See also setFontKerning() and font().
qreal QTextCharFormat::fontLetterSpacing () const
Returns the current letter spacing percentage.
This function was introduced in Qt 4.4.
See also setFontLetterSpacing().
bool QTextCharFormat::fontOverline () const
Returns true if the text format's font is overlined; otherwise returns false.
See also setFontOverline() and font().
qreal QTextCharFormat::fontPointSize () const
Returns the font size used to display text in this format.
See also setFontPointSize() and font().
bool QTextCharFormat::fontStrikeOut () const
Returns true if the text format's font is struck out (has a horizontal line drawn through it); otherwise returns false.
See also setFontStrikeOut() and font().
QFont::StyleHint QTextCharFormat::fontStyleHint () const
Returns the font style hint.
This function was introduced in Qt 4.5.
See also setFontStyleHint() and font().
QFont::StyleStrategy QTextCharFormat::fontStyleStrategy () const
Returns the current font style strategy.
This function was introduced in Qt 4.5.
See also setFontStyleStrategy() and font().
bool QTextCharFormat::fontUnderline () const
Returns true if the text format's font is underlined; otherwise returns false.
See also setFontUnderline() and font().
int QTextCharFormat::fontWeight () const
Returns the text format's font weight.
See also setFontWeight(), font(), and QFont::Weight.
qreal QTextCharFormat::fontWordSpacing () const
Returns the current word spacing value.
This function was introduced in Qt 4.4.
See also setFontWordSpacing().
bool QTextCharFormat::isAnchor () const
Returns true if the text is formatted as an anchor; otherwise returns false.
See also setAnchor(), setAnchorHref(), and setAnchorNames().
bool QTextCharFormat::isValid () const
Returns true if this character format is valid; otherwise returns false.
void QTextCharFormat::setAnchor ( bool anchor )
If anchor is true, text with this format represents an anchor, and is formatted in the appropriate way; otherwise the text is formatted normally. (Anchors are hyperlinks which are often shown underlined and in a different color from plain text.)
The way the text is rendered is independent of whether or not the format has a valid anchor defined. Use setAnchorHref(), and optionally setAnchorNames() to create a hypertext link.
See also isAnchor().
void QTextCharFormat::setAnchorHref ( const QString & value )
Sets the hypertext link for the text format to the given value. This is typically a URL like "http://example.com/index.html".
The anchor will be displayed with the value as its display text; if you want to display different text call setAnchorNames().
To format the text as a hypertext link use setAnchor().
See also anchorHref().
void QTextCharFormat::setAnchorNames ( const QStringList & names )
Sets the text format's anchor names. For the anchor to work as a hyperlink, the destination must be set with setAnchorHref() and the anchor must be enabled with setAnchor().
This function was introduced in Qt 4.3.
See also anchorNames().
void QTextCharFormat::setFont ( const QFont & font )
Sets the text format's font.
See also font().
void QTextCharFormat::setFontCapitalization ( QFont::Capitalization capitalization )
Sets the capitalization of the text that apppears in this font to capitalization.
A font's capitalization makes the text appear in the selected capitalization mode.
This function was introduced in Qt 4.4.
See also fontCapitalization().
void QTextCharFormat::setFontFamily ( const QString & family )
Sets the text format's font family.
See also fontFamily() and setFont().
void QTextCharFormat::setFontFixedPitch ( bool fixedPitch )
If fixedPitch is true, sets the text format's font to be fixed pitch; otherwise a non-fixed pitch font is used.
See also fontFixedPitch() and setFont().
void QTextCharFormat::setFontItalic ( bool italic )
If italic is true, sets the text format's font to be italic; otherwise the font will be non-italic.
See also fontItalic() and setFont().
void QTextCharFormat::setFontKerning ( bool enable )
Enables kerning for this font if enable is true; otherwise disables it.
When kerning is enabled, glyph metrics do not add up anymore, even for Latin text. In other words, the assumption that width('a') + width('b') is equal to width("ab") is not neccesairly true.
This function was introduced in Qt 4.5.
See also fontKerning() and setFont().
void QTextCharFormat::setFontLetterSpacing ( qreal spacing )
Sets the letter spacing of this format to the given spacing, in percent. A value of 100 indicates default spacing; a value of 200 doubles the amount of space a letter takes.
This function was introduced in Qt 4.4.
See also fontLetterSpacing().
void QTextCharFormat::setFontOverline ( bool overline )
If overline is true, sets the text format's font to be overlined; otherwise the font is displayed non-overlined.
See also fontOverline() and setFont().
void QTextCharFormat::setFontPointSize ( qreal size )
Sets the text format's font size.
See also fontPointSize() and setFont().
void QTextCharFormat::setFontStrikeOut ( bool strikeOut )
If strikeOut is true, sets the text format's font with strike-out enabled (with a horizontal line through it); otherwise it is displayed without strikeout.
See also fontStrikeOut() and setFont().
void QTextCharFormat::setFontStyleHint ( QFont::StyleHint hint, QFont::StyleStrategy strategy = QFont::PreferDefault )
Sets the font style hint and strategy.
Qt does not support style hints on X11 since this information is not provided by the window system.
This function was introduced in Qt 4.5.
See also fontStyleHint(), setFont(), and QFont::setStyleHint().
void QTextCharFormat::setFontStyleStrategy ( QFont::StyleStrategy strategy )
Sets the font style strategy.
This function was introduced in Qt 4.5.
See also fontStyleStrategy(), setFont(), and QFont::setStyleStrategy().
void QTextCharFormat::setFontUnderline ( bool underline )
If underline is true, sets the text format's font to be underlined; otherwise it is displayed non-underlined.
See also fontUnderline() and setFont().
void QTextCharFormat::setFontWeight ( int weight )
Sets the text format's font weight to weight.
See also fontWeight(), setFont(), and QFont::Weight.
void QTextCharFormat::setFontWordSpacing ( qreal spacing )
Sets the word spacing of this format to the given spacing, in pixels.
This function was introduced in Qt 4.4.
See also fontWordSpacing().
void QTextCharFormat::setTextOutline ( const QPen & pen )
Sets the pen used to draw the outlines of characters to the given pen.
See also textOutline().
void QTextCharFormat::setToolTip ( const QString & text )
Sets the tool tip for a fragment of text to the given text.
This function was introduced in Qt 4.3.
See also toolTip().
void QTextCharFormat::setUnderlineColor ( const QColor & color )
Sets the underline color used for the characters with this format to the color specified.
See also underlineColor().
void QTextCharFormat::setUnderlineStyle ( UnderlineStyle style )
Sets the style of underlining the text to style.
This function was introduced in Qt 4.2.
See also underlineStyle().
void QTextCharFormat::setVerticalAlignment ( VerticalAlignment alignment )
Sets the vertical alignment used for the characters with this format to the alignment specified.
See also verticalAlignment().
QPen QTextCharFormat::textOutline () const
Returns the pen used to draw the outlines of characters in this format.
See also setTextOutline().
QString QTextCharFormat::toolTip () const
Returns the tool tip that is displayed for a fragment of text.
This function was introduced in Qt 4.3.
See also setToolTip().
QColor QTextCharFormat::underlineColor () const
Returns the color used to underline the characters with this format.
See also setUnderlineColor().
UnderlineStyle QTextCharFormat::underlineStyle () const
Returns the style of underlining the text.
This function was introduced in Qt 4.2.
See also setUnderlineStyle().
VerticalAlignment QTextCharFormat::verticalAlignment () const
Returns the vertical alignment used for characters with this format.
See also setVerticalAlignment().
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 5
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- Orientation de l'écran en QML, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- La rubrique Qt a besoin de vous ! 1
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Le Qt Developer Network au hasard
La création de colonnes dans une ListView en QML
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 48 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt
- 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6-snapshot | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com