QTextCharFormat Class Reference · PyQt4 中文文檔

# QTextCharFormat Class Reference ## [[QtGui](index.htm) module] 該QTextCharFormat類提供格式設置信息的字符[QTextDocument](qtextdocument.html)。[More...](#details) 繼承[QTextFormat](qtextformat.html)。通過繼承[QTextImageFormat](qtextimageformat.html)和[QTextTableCellFormat](qtexttablecellformat.html)。 ### Types * `enum UnderlineStyle { NoUnderline, SingleUnderline, DashUnderline, DotLine, ..., SpellCheckUnderline }` * `enum VerticalAlignment { AlignNormal, AlignSuperScript, AlignSubScript, AlignMiddle, ..., AlignBaseline }` ### Methods * `__init__ (self)` * `__init__ (self, QTextCharFormat)` * `QString anchorHref (self)` * `QString anchorName (self)` * `QStringList anchorNames (self)` * `QFont font (self)` * `QFont.Capitalization fontCapitalization (self)` * `QString fontFamily (self)` * `bool fontFixedPitch (self)` * `QFont.HintingPreference fontHintingPreference (self)` * `bool fontItalic (self)` * `bool fontKerning (self)` * `float fontLetterSpacing (self)` * `bool fontOverline (self)` * `float fontPointSize (self)` * `bool fontStrikeOut (self)` * `QFont.StyleHint fontStyleHint (self)` * `QFont.StyleStrategy fontStyleStrategy (self)` * `bool fontUnderline (self)` * `int fontWeight (self)` * `float fontWordSpacing (self)` * `bool isAnchor (self)` * `bool isValid (self)` * `setAnchor (self, bool?anchor)` * `setAnchorHref (self, QString?value)` * `setAnchorName (self, QString?name)` * `setAnchorNames (self, QStringList?names)` * `setFont (self, QFont?font)` * `setFontCapitalization (self, QFont.Capitalization?capitalization)` * `setFontFamily (self, QString?family)` * `setFontFixedPitch (self, bool?fixedPitch)` * `setFontHintingPreference (self, QFont.HintingPreference?hintingPreference)` * `setFontItalic (self, bool?italic)` * `setFontKerning (self, bool?enable)` * `setFontLetterSpacing (self, float?spacing)` * `setFontOverline (self, bool?overline)` * `setFontPointSize (self, float?size)` * `setFontStrikeOut (self, bool?strikeOut)` * `setFontStyleHint (self, QFont.StyleHint?hint, QFont.StyleStrategy?strategy?=?QFont.PreferDefault)` * `setFontStyleStrategy (self, QFont.StyleStrategy?strategy)` * `setFontUnderline (self, bool?underline)` * `setFontWeight (self, int?weight)` * `setFontWordSpacing (self, float?spacing)` * `setTableCellColumnSpan (self, int?atableCellColumnSpan)` * `setTableCellRowSpan (self, int?atableCellRowSpan)` * `setTextOutline (self, QPen?pen)` * `setToolTip (self, QString?tip)` * `setUnderlineColor (self, QColor?color)` * `setUnderlineStyle (self, UnderlineStyle?style)` * `setVerticalAlignment (self, VerticalAlignment?alignment)` * `int tableCellColumnSpan (self)` * `int tableCellRowSpan (self)` * `QPen textOutline (self)` * `QString toolTip (self)` * `QColor underlineColor (self)` * `UnderlineStyle underlineStyle (self)` * `VerticalAlignment verticalAlignment (self)` * * * ## Detailed Description 該QTextCharFormat類提供格式設置信息的字符[QTextDocument](qtextdocument.html)。在文檔中的文本的字符格式指定的文本的可視特性，以及關于其在一個超文本文件的作用的信息。使用的字體可以通過提供一種字體的設置[setFont](qtextcharformat.html#setFont)（）函數，并且其外觀的各個方面可以調整，以得到所需的效果。[setFontFamily](qtextcharformat.html#setFontFamily)（）和[setFontPointSize](qtextcharformat.html#setFontPointSize)（）定義字體的家庭（如時間）和印刷尺寸;[setFontWeight](qtextcharformat.html#setFontWeight)（）和[setFontItalic](qtextcharformat.html#setFontItalic)（）提供了對字體的樣式控制。[setFontUnderline](qtextcharformat.html#setFontUnderline)（）[setFontOverline](qtextcharformat.html#setFontOverline)（）[setFontStrikeOut](qtextcharformat.html#setFontStrikeOut)（）和[setFontFixedPitch](qtextcharformat.html#setFontFixedPitch)（）為文本附加效果。顏色設置與[setForeground](qtextformat.html#setForeground)（）。如果文本旨在用作錨（超鏈接），這可以被啟用[setAnchor](qtextcharformat.html#setAnchor)（）。該[setAnchorHref](qtextcharformat.html#setAnchorHref)（）和[setAnchorNames](qtextcharformat.html#setAnchorNames)（）函數用于指定關于超鏈接的目標與錨的名稱的信息。 * * * ## Type Documentation ``` QTextCharFormat.UnderlineStyle ``` 這個枚舉變量描述了不同的方式繪制下劃線的文本。 | Constant | Value | Description | | --- | --- | --- | | `QTextCharFormat.NoUnderline` | `0` | 文字是畫，沒有任何強調裝飾。 | | `QTextCharFormat.SingleUnderline` | `1` | A線是用畫[Qt.SolidLine](qt.html#PenStyle-enum)。 | | `QTextCharFormat.DashUnderline` | `2` | 破折號使用繪制[Qt.DashLine](qt.html#PenStyle-enum)。 | | `QTextCharFormat.DotLine` | `3` | 點是使用繪制[Qt.DotLine](qt.html#PenStyle-enum); | | `QTextCharFormat.DashDotLine` | `4` | Dashs和點使用繪制[Qt.DashDotLine](qt.html#PenStyle-enum)。 | | `QTextCharFormat.DashDotDotLine` | `5` | 強調用畫繪制[Qt.DashDotDotLine](qt.html#PenStyle-enum)。 | | `QTextCharFormat.WaveUnderline` | `6` | 該文本是用波浪形下劃線標出。 | | `QTextCharFormat.SpellCheckUnderline` | `7` | 視乎該QStyle.SH_SpellCeckUnderlineStyle風格提示下劃線繪制[QApplication](qapplication.html)風格。默認情況下，這個被映射到WaveUnderline ，在Mac OS X被映射到DashDotLine 。 | **See also** [Qt.PenStyle](qt.html#PenStyle-enum)。 ``` QTextCharFormat.VerticalAlignment ``` 該枚舉描述的方式使相鄰的字符可以垂直對齊。 | Constant | Value | Description | | --- | --- | --- | | `QTextCharFormat.AlignNormal` | `0` | 相鄰字符被放置在標準方式中的寫入系統中使用的文本。 | | `QTextCharFormat.AlignSuperScript` | `1` | 字符放在高于正常文本基線。 | | `QTextCharFormat.AlignSubScript` | `2` | 字符都放在下面的普通文本基線。 | | `QTextCharFormat.AlignMiddle` | `3` | 對象的中心垂直基準線對齊。目前，這只是實施了內聯對象。 | | `QTextCharFormat.AlignBottom` | `5` | 物體的底部邊緣垂直基準線對齊。 | | `QTextCharFormat.AlignTop` | `4` | 對象的上邊緣垂直的基準線對齊。 | | `QTextCharFormat.AlignBaseline` | `6` | 字符的基線對齊。 | * * * ## Method Documentation ``` QTextCharFormat.__init__ (self) ``` 構造一個新的字符格式的對象。 ``` QTextCharFormat.__init__ (self, QTextCharFormat) ``` ``` QString QTextCharFormat.anchorHref (self) ``` 返回如果沒有設置文本格式的超文本鏈接，或空字符串。 **See also** [setAnchorHref](qtextcharformat.html#setAnchorHref)（）。 ``` QString QTextCharFormat.anchorName (self) ``` ``` QStringList QTextCharFormat.anchorNames (self) ``` 返回與此文本格式，或者一個空字符串列表相關聯，如果沒有設置錨的名稱。如果錨的名稱被設置，文本這種格式可以是一個超文本鏈接的目標。此功能被引入Qt的4.3 。 **See also** [setAnchorNames](qtextcharformat.html#setAnchorNames)（）。 ``` QFont QTextCharFormat.font (self) ``` [ 返回的字體為這個字符格式。 ](qfont.html) [**See also**](qfont.html) [setFont](qtextcharformat.html#setFont)（）。 ``` QFont.Capitalization QTextCharFormat.fontCapitalization (self) ``` [ 返回該字體的當前市值類型。此功能被引入Qt的4.4 。 ](qfont.html#Capitalization-enum) [**See also**](qfont.html#Capitalization-enum) [setFontCapitalization](qtextcharformat.html#setFontCapitalization)（）。 ``` QString QTextCharFormat.fontFamily (self) ``` 返回文本格式的字體系列。 **See also** [setFontFamily](qtextcharformat.html#setFontFamily)（）和[font](qtextcharformat.html#font)（）。 ``` bool QTextCharFormat.fontFixedPitch (self) ``` 返回True如果文本格式的字體是固定的間距，否則返回False 。 **See also** [setFontFixedPitch](qtextcharformat.html#setFontFixedPitch)（）和[font](qtextcharformat.html#font)（）。 ``` QFont.HintingPreference QTextCharFormat.fontHintingPreference (self) ``` [ 返回此文本格式的暗示偏好設定。此功能被引入Qt的4.8 。 ](qfont.html#HintingPreference-enum) [**See also**](qfont.html#HintingPreference-enum) [setFontHintingPreference](qtextcharformat.html#setFontHintingPreference)（）[font](qtextcharformat.html#font)（）和[QFont.hintingPreference](qfont.html#hintingPreference)（）。 ``` bool QTextCharFormat.fontItalic (self) ``` 返回True如果文本格式的字體是斜體，否則返回False 。 **See also** [setFontItalic](qtextcharformat.html#setFontItalic)（）和[font](qtextcharformat.html#font)（）。 ``` bool QTextCharFormat.fontKerning (self) ``` 如果字體啟用字距調整，則返回True 。此功能被引入Qt的4.5 。 **See also** [setFontKerning](qtextcharformat.html#setFontKerning)（）和[font](qtextcharformat.html#font)（）。 ``` float QTextCharFormat.fontLetterSpacing (self) ``` 返回當前字母間距百分比。此功能被引入Qt的4.4 。 **See also** [setFontLetterSpacing](qtextcharformat.html#setFontLetterSpacing)（）。 ``` bool QTextCharFormat.fontOverline (self) ``` 返回True如果文本格式的字體是上劃線，否則返回False 。 **See also** [setFontOverline](qtextcharformat.html#setFontOverline)（）和[font](qtextcharformat.html#font)（）。 ``` float QTextCharFormat.fontPointSize (self) ``` 返回用于這種格式顯示文本的字體大小。 **See also** [setFontPointSize](qtextcharformat.html#setFontPointSize)（）和[font](qtextcharformat.html#font)（）。 ``` bool QTextCharFormat.fontStrikeOut (self) ``` 返回True如果文本格式的字體被剔除（有一個水平線通過它繪制的），否則返回False 。 **See also** [setFontStrikeOut](qtextcharformat.html#setFontStrikeOut)（）和[font](qtextcharformat.html#font)（）。 ``` QFont.StyleHint QTextCharFormat.fontStyleHint (self) ``` [ 返回的字體樣式提示。此功能被引入Qt的4.5 。 ](qfont.html#StyleHint-enum) [**See also**](qfont.html#StyleHint-enum) [setFontStyleHint](qtextcharformat.html#setFontStyleHint)（）和[font](qtextcharformat.html#font)（）。 ``` QFont.StyleStrategy QTextCharFormat.fontStyleStrategy (self) ``` [ 返回當前字體樣式的策略。此功能被引入Qt的4.5 。 ](qfont.html#StyleStrategy-enum) [**See also**](qfont.html#StyleStrategy-enum) [setFontStyleStrategy](qtextcharformat.html#setFontStyleStrategy)（）和[font](qtextcharformat.html#font)（）。 ``` bool QTextCharFormat.fontUnderline (self) ``` 返回True如果文本格式的字體下劃線，否則返回False 。 **See also** [setFontUnderline](qtextcharformat.html#setFontUnderline)（）和[font](qtextcharformat.html#font)（）。 ``` int QTextCharFormat.fontWeight (self) ``` 返回文本格式的字體粗細。 **See also** [setFontWeight](qtextcharformat.html#setFontWeight)（）[font](qtextcharformat.html#font)（）和[QFont.Weight](qfont.html#Weight-enum)。 ``` float QTextCharFormat.fontWordSpacing (self) ``` 返回當前的字間距值。此功能被引入Qt的4.4 。 **See also** [setFontWordSpacing](qtextcharformat.html#setFontWordSpacing)（）。 ``` bool QTextCharFormat.isAnchor (self) ``` 返回True如果文本被格式化為一個錨，否則返回False 。 **See also** [setAnchor](qtextcharformat.html#setAnchor)（）[setAnchorHref](qtextcharformat.html#setAnchorHref)（）和[setAnchorNames](qtextcharformat.html#setAnchorNames)（）。 ``` bool QTextCharFormat.isValid (self) ``` 返回True如果這個字符格式是有效的，否則返回False 。 ``` QTextCharFormat.setAnchor (self, bool?anchor) ``` If _anchor_是真的，文字這種格式表示錨，并格式化適當的方式，否則文本通常格式化。（錨是這往往顯示下劃線，并以不同的顏色從純文本的超鏈接。）文本呈現的方式是獨立的格式是否有定義的有效支撐點。使用[setAnchorHref](qtextcharformat.html#setAnchorHref)（），以及任選[setAnchorNames](qtextcharformat.html#setAnchorNames)（）來創建一個超文本鏈接。 **See also** [isAnchor](qtextcharformat.html#isAnchor)（）。 ``` QTextCharFormat.setAnchorHref (self, QString?value) ``` 設置超文本鏈接的文本格式，以給定的_value_。這通常是像“ http://example.com/index.html ”的URL。錨將與被顯示_value_作為其顯示文本，如果你想顯示不同的文本調用[setAnchorNames](qtextcharformat.html#setAnchorNames)（）。格式化文本作為超鏈接的使用[setAnchor](qtextcharformat.html#setAnchor)（）。 **See also** [anchorHref](qtextcharformat.html#anchorHref)（）。 ``` QTextCharFormat.setAnchorName (self, QString?name) ``` ``` QTextCharFormat.setAnchorNames (self, QStringList?names) ``` 設置文本格式的錨_names_。對于錨的工作作為一個超鏈接時，目標必須與設置[setAnchorHref](qtextcharformat.html#setAnchorHref)（）和所述錨定必須被啟用[setAnchor](qtextcharformat.html#setAnchor)（）。此功能被引入Qt的4.3 。 **See also** [anchorNames](qtextcharformat.html#anchorNames)（）。 ``` QTextCharFormat.setFont (self, QFont?font) ``` 設置文本格式的_font_。 **See also** [font](qtextcharformat.html#font)（）。 ``` QTextCharFormat.setFontCapitalization (self, QFont.Capitalization?capitalization) ``` 設置apppears在這種字體的文本的大小寫_capitalization_。字體的大小寫使文本顯示在選定資本化模式。此功能被引入Qt的4.4 。 **See also** [fontCapitalization](qtextcharformat.html#fontCapitalization)（）。 ``` QTextCharFormat.setFontFamily (self, QString?family) ``` 設置文本格式的字體_family_。 **See also** [fontFamily](qtextcharformat.html#fontFamily)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontFixedPitch (self, bool?fixedPitch) ``` If _fixedPitch_誠然，設置文本格式的字體是固定的間距，否則非固定間距字體。 **See also** [fontFixedPitch](qtextcharformat.html#fontFixedPitch)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontHintingPreference (self, QFont.HintingPreference?hintingPreference) ``` 設置文本格式的字體是的暗示偏好_hintingPreference_。此功能被引入Qt的4.8 。 **See also** [fontHintingPreference](qtextcharformat.html#fontHintingPreference)（）[setFont](qtextcharformat.html#setFont)（）和[QFont.setHintingPreference](qfont.html#setHintingPreference)（）。 ``` QTextCharFormat.setFontItalic (self, bool?italic) ``` If _italic_誠然，設置文本格式的字體是斜體，否則字體將非斜體。 **See also** [fontItalic](qtextcharformat.html#fontItalic)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontKerning (self, bool?enable) ``` 啟用字距這個字體，如果_enable_為True，否則禁用它。如果啟用字距調整，字形度量對不上號了，即使是拉丁文字。換句話說，該寬度（' a'）的寬度+ （' b'）中的假設是等于寬度（ “AB” ）是不neccesairly真。此功能被引入Qt的4.5 。 **See also** [fontKerning](qtextcharformat.html#fontKerning)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontLetterSpacing (self, float?spacing) ``` 設置此格式的字母間距為給定的_spacing_，以百分比表示。值為100表示默認間距; 200的值加倍的一封信需要的空間量。此功能被引入Qt的4.4 。 **See also** [fontLetterSpacing](qtextcharformat.html#fontLetterSpacing)（）。 ``` QTextCharFormat.setFontOverline (self, bool?overline) ``` If _overline_誠然，設置文本格式的字體要上劃線，否則顯示的字體不上劃線。 **See also** [fontOverline](qtextcharformat.html#fontOverline)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontPointSize (self, float?size) ``` 設置文本格式的字體_size_。 **See also** [fontPointSize](qtextcharformat.html#fontPointSize)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontStrikeOut (self, bool?strikeOut) ``` If _strikeOut_誠然，設置文本格式的字體與剔除啟用（有橫線穿過它），否則將顯示不帶刪除線。 **See also** [fontStrikeOut](qtextcharformat.html#fontStrikeOut)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontStyleHint (self, QFont.StyleHint?hint, QFont.StyleStrategy?strategy?=?QFont.PreferDefault) ``` 設置字體樣式_hint_和_strategy_。 Qt不支持樣式提示在X11 ，因為沒有提供窗口系統信息。此功能被引入Qt的4.5 。 **See also** [fontStyleHint](qtextcharformat.html#fontStyleHint)（）[setFont](qtextcharformat.html#setFont)（）和[QFont.setStyleHint](qfont.html#setStyleHint)（）。 ``` QTextCharFormat.setFontStyleStrategy (self, QFont.StyleStrategy?strategy) ``` 設置字體樣式_strategy_。此功能被引入Qt的4.5 。 **See also** [fontStyleStrategy](qtextcharformat.html#fontStyleStrategy)（）[setFont](qtextcharformat.html#setFont)（）和[QFont.setStyleStrategy](qfont.html#setStyleStrategy)（）。 ``` QTextCharFormat.setFontUnderline (self, bool?underline) ``` If _underline_誠然，設置文本格式的字體加下劃線，否則將顯示非下劃線。 **See also** [fontUnderline](qtextcharformat.html#fontUnderline)（）和[setFont](qtextcharformat.html#setFont)（）。 ``` QTextCharFormat.setFontWeight (self, int?weight) ``` 設置文本格式的字體重量_weight_。 **See also** [fontWeight](qtextcharformat.html#fontWeight)（）[setFont](qtextcharformat.html#setFont)（）和[QFont.Weight](qfont.html#Weight-enum)。 ``` QTextCharFormat.setFontWordSpacing (self, float?spacing) ``` 設置此格式的字間距為給定的_spacing_，以像素為單位。此功能被引入Qt的4.4 。 **See also** [fontWordSpacing](qtextcharformat.html#fontWordSpacing)（）。 ``` QTextCharFormat.setTableCellColumnSpan (self, int?atableCellColumnSpan) ``` ``` QTextCharFormat.setTableCellRowSpan (self, int?atableCellRowSpan) ``` ``` QTextCharFormat.setTextOutline (self, QPen?pen) ``` 設置用于繪制人物的輪廓給定的筆_pen_。 **See also** [textOutline](qtextcharformat.html#textOutline)（）。 ``` QTextCharFormat.setToolTip (self, QString?tip) ``` 工具提示文本的片段設置為給定_text_。此功能被引入Qt的4.3 。 **See also** [toolTip](qtextcharformat.html#toolTip)（）。 ``` QTextCharFormat.setUnderlineColor (self, QColor?color) ``` 設置用于與此格式的字符的下劃線顏色_color_規定。 **See also** [underlineColor](qtextcharformat.html#underlineColor)（）。 ``` QTextCharFormat.setUnderlineStyle (self, UnderlineStyle?style) ``` 設置下劃線的文本的樣式_style_。這個函數中引入了Qt 4.2中。 **See also** [underlineStyle](qtextcharformat.html#underlineStyle)（）。 ``` QTextCharFormat.setVerticalAlignment (self, VerticalAlignment?alignment) ``` 設置用于與此格式的字符的垂直對齊方式_alignment_規定。 **See also** [verticalAlignment](qtextcharformat.html#verticalAlignment)（）。 ``` int QTextCharFormat.tableCellColumnSpan (self) ``` ``` int QTextCharFormat.tableCellRowSpan (self) ``` ``` QPen QTextCharFormat.textOutline (self) ``` [ 返回用于繪制人物的輪廓在這種格式的筆。 ](qpen.html) [**See also**](qpen.html) [setTextOutline](qtextcharformat.html#setTextOutline)（）。 ``` QString QTextCharFormat.toolTip (self) ``` 返回顯示的文本片段的工具提示。此功能被引入Qt的4.3 。 **See also** [setToolTip](qtextcharformat.html#setToolTip)（）。 ``` QColor QTextCharFormat.underlineColor (self) ``` [ 返回用于強調這種格式的字符的顏色。 ](qcolor.html) [**See also**](qcolor.html) [setUnderlineColor](qtextcharformat.html#setUnderlineColor)（）。 ``` UnderlineStyle QTextCharFormat.underlineStyle (self) ``` [ 返回強調文本的樣式。這個函數中引入了Qt 4.2中。 ](qtextcharformat.html#UnderlineStyle-enum) [**See also**](qtextcharformat.html#UnderlineStyle-enum) [setUnderlineStyle](qtextcharformat.html#setUnderlineStyle)（）。 ``` VerticalAlignment QTextCharFormat.verticalAlignment (self) ``` [ 返回用于與此格式字符的垂直對齊方式。 ](qtextcharformat.html#VerticalAlignment-enum) [**See also**](qtextcharformat.html#VerticalAlignment-enum) [setVerticalAlignment](qtextcharformat.html#setVerticalAlignment)（）。