QFont Class Reference · PyQt4 中文文檔

# QFont Class Reference ## [[QtGui](index.htm) module] 該QFont類指定用于繪制文本的字體。[More...](#details) ### Types * `enum Capitalization { MixedCase, AllUppercase, AllLowercase, SmallCaps, Capitalize }` * `enum HintingPreference { PreferDefaultHinting, PreferNoHinting, PreferVerticalHinting, PreferFullHinting }` * `enum SpacingType { PercentageSpacing, AbsoluteSpacing }` * `enum Stretch { UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, ..., UltraExpanded }` * `enum Style { StyleNormal, StyleItalic, StyleOblique }` * `enum StyleHint { Helvetica, SansSerif, Times, Serif, ..., Fantasy }` * `enum StyleStrategy { PreferDefault, PreferBitmap, PreferDevice, PreferOutline, ..., ForceIntegerMetrics }` * `enum Weight { Light, Normal, DemiBold, Bold, Black }` ### Methods * `__init__ (self)` * `__init__ (self, QString?family, int?pointSize?=?-1, int?weight?=?-1, bool?italic?=?False)` * `__init__ (self, QFont, QPaintDevice?pd)` * `__init__ (self, QFont)` * `__init__ (self, QVariant?variant)` * `bool bold (self)` * `Capitalization capitalization (self)` * `QString defaultFamily (self)` * `bool exactMatch (self)` * `QString family (self)` * `bool fixedPitch (self)` * `bool fromString (self, QString)` * `int handle (self)` * `HintingPreference hintingPreference (self)` * `bool isCopyOf (self, QFont)` * `bool italic (self)` * `bool kerning (self)` * `QString key (self)` * `QString lastResortFamily (self)` * `QString lastResortFont (self)` * `float letterSpacing (self)` * `SpacingType letterSpacingType (self)` * `bool overline (self)` * `int pixelSize (self)` * `int pointSize (self)` * `float pointSizeF (self)` * `bool rawMode (self)` * `QString rawName (self)` * `QFont resolve (self, QFont)` * `setBold (self, bool?enable)` * `setCapitalization (self, Capitalization)` * `setFamily (self, QString)` * `setFixedPitch (self, bool)` * `setHintingPreference (self, HintingPreference?hintingPreference)` * `setItalic (self, bool?b)` * `setKerning (self, bool)` * `setLetterSpacing (self, SpacingType?type, float?spacing)` * `setOverline (self, bool)` * `setPixelSize (self, int)` * `setPointSize (self, int)` * `setPointSizeF (self, float)` * `setRawMode (self, bool)` * `setRawName (self, QString)` * `setStretch (self, int)` * `setStrikeOut (self, bool)` * `setStyle (self, Style?style)` * `setStyleHint (self, StyleHint?hint, StyleStrategy?strategy?=?QFont.PreferDefault)` * `setStyleName (self, QString?styleName)` * `setStyleStrategy (self, StyleStrategy?s)` * `setUnderline (self, bool)` * `setWeight (self, int)` * `setWordSpacing (self, float?spacing)` * `int stretch (self)` * `bool strikeOut (self)` * `Style style (self)` * `StyleHint styleHint (self)` * `QString styleName (self)` * `StyleStrategy styleStrategy (self)` * `QString toString (self)` * `bool underline (self)` * `int weight (self)` * `float wordSpacing (self)` ### Static Methods * `cacheStatistics ()` * `cleanup ()` * `initialize ()` * `insertSubstitution (QString, QString)` * `insertSubstitutions (QString, QStringList)` * `removeSubstitution (QString)` * `QString substitute (QString)` * `QStringList substitutes (QString)` * `QStringList substitutions ()` ### Special Methods * `bool __eq__ (self, QFont)` * `bool __ge__ (self, QFont)` * `bool __lt__ (self, QFont)` * `bool __ne__ (self, QFont)` * * * ## Detailed Description 該QFont類指定用于繪制文本的字體。當你創建一個QFont對象，你指定你想要的字體有不同的屬性。 Qt會使用的字體與指定的屬性，或者如果沒有匹配的字體存在， Qt會使用最接近的匹配安裝的字體。實際使用的字體的屬性是由可回收[QFontInfo](qfontinfo.html)對象。如果窗口系統提供的精確匹配[exactMatch](qfont.html#exactMatch)（）返回True 。使用[QFontMetrics](qfontmetrics.html)以獲得測量值，例如使用字符串的像素長度[QFontMetrics.width](qfontmetrics.html#width)（）。請注意，一個[QApplication](qapplication.html)實例必須存在一個QFont才能使用。您可以設置應用程序的默認字體，[QApplication.setFont](qapplication.html#setFont)（）。如果選擇的字體不包括所有需要顯示的字符， QFont將試圖找到在最接近的字體的字符。當[QPainter](qpainter.html)繪制一個字符從字體QFont會報告它是否有性格，如果沒有的話，[QPainter](qpainter.html)將繪制一個空心的方形。創建這樣QFonts ： ``` QFont serifFont("Times", 10, QFont.Bold); QFont sansFont("Helvetica [Cronyx]", 12); ``` 在構造函數中設置的屬性也可以在以后設置，例如：[setFamily](qfont.html#setFamily)（）[setPointSize](qfont.html#setPointSize)（）[setPointSizeFloat](index.htm#setPointSizeFloat)（）[setWeight](qfont.html#setWeight)（）和[setItalic](qfont.html#setItalic)（）。其馀的屬性后，必須contstruction ，例如設置[setBold](qfont.html#setBold)（）[setUnderline](qfont.html#setUnderline)（）[setOverline](qfont.html#setOverline)（）[setStrikeOut](qfont.html#setStrikeOut)（）和[setFixedPitch](qfont.html#setFixedPitch)（）。[QFontInfo](qfontinfo.html)要創建的對象_after_字體的屬性已被置位。一[QFontInfo](qfontinfo.html)對象將不會改變，即使改變字體的屬性。相應的“獲取”功能，例如[family](qfont.html#family)（）[pointSize](qfont.html#pointSize)（）等等，返回已設置的值，即使所使用的值可能不同。的實際值可以從一個[QFontInfo](qfontinfo.html)對象。如果請求的字體系列不可用，你可以影響[font matching algorithm](#fontmatching)通過選擇一個特定的[QFont.StyleHint](qfont.html#StyleHint-enum)和[QFont.StyleStrategy](qfont.html#StyleStrategy-enum)同[setStyleHint](qfont.html#setStyleHint)（）。缺省家族（對應于當前樣式的提示）被返回[defaultFamily](qfont.html#defaultFamily)（）。字體匹配算法有[lastResortFamily](qfont.html#lastResortFamily)（）和[lastResortFont](qfont.html#lastResortFont)（）在一個合適的匹配不能被發現的情況。您可以提供替代使用字體系列名稱[insertSubstitution](qfont.html#insertSubstitution)（）和[insertSubstitutions](qfont.html#insertSubstitutions)（）。取代基可以與被刪除[removeSubstitution](qfont.html#removeSubstitution)（）。使用[substitute](qfont.html#substitute)（）來獲取一個家庭的第一替補，或姓本身，如果它沒有替代品。使用[substitutes](qfont.html#substitutes)（）來獲取一個家庭的替代品列表（可能為空）。每QFont有[key](qfont.html#key)（），它可以使用，例如，如在高速緩存或字典中的鍵。如果你想存儲用戶的字體首選項，您可以使用[QSettings](qsettings.html)，與寫入的字體信息[toString](qfont.html#toString)（），并閱讀它帶回來[fromString](qfont.html#fromString)（）。該運算符\u003c\u003c （）和operator \u003e\u003e （）功能也都具備，但他們的數據流工作。它可以設置在屏幕上顯示的字符，以像素為單位的指定數量的高度與[setPixelSize](qfont.html#setPixelSize)（），但是使用[setPointSize](qfont.html#setPointSize)（）也有類似的效果，并提供設備獨立性。在X11中，您可以使用其系統的具體名稱與設置字體[setRawName](qfont.html#setRawName)（）。加載中字體可以是昂貴的，特別是在X11 。 QFont包含大量的優化，以使QFont的復制對象快，緩存它依賴于緩慢窗口系統功能的結果。字體匹配算法的工作原理如下： 1. 指定字體系列中搜索。 2. 如果沒有找到，[styleHint](qfont.html#styleHint)（）是用來選擇一個替換的家庭。 3. 每次更換字體系列中搜索。 4. 如果沒有這些被發現或沒有[styleHint](qfont.html#styleHint)（）， “黑體”將搜索。 5. 如果找不到“黑體” Qt會嘗試[lastResortFamily](qfont.html#lastResortFamily)（）。 6. 如果[lastResortFamily](qfont.html#lastResortFamily)（）沒有找到Qt會嘗試[lastResortFont](qfont.html#lastResortFont)（）將總是返回某種類型的名稱。請注意，實際的字體匹配算法變化從平臺到平臺。在Windows的“信使”字體的請求將被自動更改為“宋體” ，快遞的改進版本，它允許平滑縮放。舊的“信使”位圖字體可以通過設置選擇[PreferBitmap](qfont.html#StyleStrategy-enum)風格策略（見[setStyleStrategy](qfont.html#setStyleStrategy)（））。一旦字體被發現，其馀的屬性是匹配的優先順序： 1. [fixedPitch](qfont.html#fixedPitch)（） 2. [pointSize](qfont.html#pointSize)（）（見下文） 3. [weight](qfont.html#weight)（） 4. [style](qfont.html#style)（）如果你有一個相匹配的家庭字體，即使沒有其他屬性匹配，該字體將選擇優先于字體不上家人匹配，但它確實對其他屬性的匹配。這是因為字體家族是佔主導地位的搜索條件。點的大小被定義為匹配，如果它是在所需的點尺寸的20％。當幾個字體匹配，并且只由點的大小區分，與最接近的點大小為所請求的字體將被選擇。用于繪制文本的實際家庭，字體大小，重量等字體屬性將取決于什么可供選擇的家庭下的窗口系統。一[QFontInfo](qfontinfo.html)對象可以被用來確定用于繪制文本的實際值。示例： ``` QFont f("Helvetica"); ``` 如果你同時有一個Adobe和Cronyx Helvetica字體，你可能會得到兩種。 ``` QFont f("Helvetica [Cronyx]"); ``` 您可以在家庭中的名稱來指定你想要的代工。在上面的例子中的字體F可以被設置為“黑體[ Cronyx ]” 。為了確定在窗口系統中實際使用的字體的屬性，使用[QFontInfo](qfontinfo.html)對象，例如 ``` [QFontInfo](qfontinfo.html) info(f1); [QString](qstring.html) family = info.family(); ``` 要了解字體規格使用[QFontMetrics](qfontmetrics.html)對象，例如 ``` [QFontMetrics](qfontmetrics.html) fm(f1); int textWidthInPixels = fm.width("How many pixels wide is this text?"); int textHeightInPixels = fm.height(); ``` 有關字體的常規信息，請參閱[comp.fonts FAQ.](http://nwalsh.com/comp.fonts/FAQ/)關于編碼的信息可以發現[Roman Czyborra's](http://czyborra.com/)頁面。 * * * ## Type Documentation ``` QFont.Capitalization ``` 渲染選項，這個文本字體適用于。 | Constant | Value | Description | | --- | --- | --- | | `QFont.MixedCase` | `0` | 這是沒有市值變化所應用的普通文本渲染選項。 | | `QFont.AllUppercase` | `1` | 這改變在全部大寫類型所要呈現的文本。 | | `QFont.AllLowercase` | `2` | 這會改變所有小寫類型所要呈現的文本。 | | `QFont.SmallCaps` | `3` | 這改變了在小型股型要呈現的文本。 | | `QFont.Capitalize` | `4` | 這改變與每個單詞的第一個字符被呈現為一個大寫字符的文本。 | 這個枚舉被引入或修改的Qt 4.4 。 ``` QFont.HintingPreference ``` 該枚舉描述暗示的不同級別，可以應用到字形，以提高易讀性的地方，否則可能由像素的密度來保證顯示器。 | Constant | Value | Description | | --- | --- | --- | | `QFont.PreferDefaultHinting` | `0` | 使用默認的暗示水平為目標平臺。 | | `QFont.PreferNoHinting` | `1` | 如果可能的話，渲染文本，而不提示字形的輪廓。文本布局將是印刷上準確的和可擴展性，使用與被使用，例如相同的度量打印時。 | | `QFont.PreferVerticalHinting` | `2` | 如果可能的話，呈現文本無水平暗示，但字形排列的像素網格在垂直方向上。該文字會出現在其中顯示的密度太低保鮮盒給予字形的準確渲染。但由于字形的水平度量unhinted ，文字的布局將擴展到更高密度的設備（如打印機），而不會影響細節，比如換行符。 | | `QFont.PreferFullHinting` | `3` | 如果可能的話，呈現文本與暗示在水平和垂直方向。該文本將被修改，以優化可讀性的目標設備上，但由于指標將取決于文本的目標大小，字形，換行符和其他排版細節的位置將無法擴展，這意味著文本的布局可能會與不同像素密度的設備不同。 | 請注意，此枚舉只描述一個偏好，以全方位暗示的水平上不支持所有的Qt支持的平臺的。下表載列于目標平臺的選定的一組給定的暗示偏好的影響。 | | PreferDefaultHinting | PreferNoHinting | PreferVerticalHinting | PreferFullHinting | | --- | --- | --- | --- | --- | | Windows Vista (w/o Platform Update) and earlier | Full hinting | Full hinting | Full hinting | Full hinting | | Windows 7 and Windows Vista (w/Platform Update) and DirectWrite enabled in Qt | Full hinting | Vertical hinting | Vertical hinting | Full hinting | | [FreeType](index.htm#freetype) | Operating System setting | No hinting | Vertical hinting (light) | Full hinting | | Cocoa on Mac OS X | No hinting | No hinting | No hinting | No hinting | **Note:**請注意，改變在Windows上提示的偏好可通過DirectWrite的字體引擎。這是適用于Windows Vista上安裝平臺更新后，和Windows 7 。為了使用這個擴展，配置Qt的使用， DirectWrite的。然后，目標應用程序將取決于DirectWrite中的目標系統上的可用性。這個枚舉被引入或修改的Qt 4.8 。 ``` QFont.SpacingType ``` | Constant | Value | Description | | --- | --- | --- | | `QFont.PercentageSpacing` | `0` | 100的值將保持間距不變;值200將人物本身的寬度的字符后擴大的間距。 | | `QFont.AbsoluteSpacing` | `1` | 正值增加字母間距由相應的像素;負值減小的間距。 | 這個枚舉被引入或修改的Qt 4.4 。 ``` QFont.Stretch ``` 按照CSS的命名約定的預定義的拉伸值。該值越高，越伸文字是。 | Constant | Value | Description | | --- | --- | --- | | `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 | **See also** [setStretch](qfont.html#setStretch)（）和[stretch](qfont.html#stretch)（）。 ``` QFont.Style ``` 這個枚舉變量描述了不同風格的字形，用于顯示文本。 | Constant | Value | Description | | --- | --- | --- | | `QFont.StyleNormal` | `0` | 在無樣式的文本中使用的正常字形。 | | `QFont.StyleItalic` | `1` | 斜體字形專為代表斜體文本的目的而設計的。 | | `QFont.StyleOblique` | `2` | 字形與通常基于無樣式字形，但微調來表示斜體文本的目的，斜體的外觀。 | **See also** [Weight](qfont.html#Weight-enum)。 ``` QFont.StyleHint ``` 風格提示所使用的[font matching](qfont.html)算法來找到一個合適的默認的家庭，如果選擇的字體系列不可用。 | Constant | Value | Description | | --- | --- | --- | | `QFont.AnyStyle` | ？ | 離開的字體匹配算法來選擇家庭。這是默認的。 | | `QFont.SansSerif` | `Helvetica` | 字體匹配更喜歡無襯線字體。 | | `QFont.Helvetica` | `0` | 是同義詞`SansSerif`。 | | `QFont.Serif` | `Times` | 字體匹配更喜歡serif字體。 | | `QFont.Times` | ？ | 是同義詞`Serif`。 | | `QFont.TypeWriter` | `Courier` | 字體匹配更喜歡固定的間距字體。 | | `QFont.Courier` | ？ | 同義詞`TypeWriter`。 | | `QFont.OldEnglish` | ？ | 字體匹配更喜歡裝飾性字體。 | | `QFont.Decorative` | `OldEnglish` | 是同義詞`OldEnglish`。 | | `QFont.Monospace` | ？ | 字體匹配傾向于映射到CSS通用字體家庭“等寬”字體。 | | `QFont.Fantasy` | ？ | 字體匹配傾向于映射到CSS通用字體家族'幻想'字型。 | | `QFont.Cursive` | ？ | 字體匹配傾向于映射到CSS通用字體家族“草書”字體。 | | `QFont.System` | ？ | 字體匹配喜歡的系統字體。 | ``` QFont.StyleStrategy ``` 風格策略告訴[font matching](qfont.html)算法是什么類型的字體應該被用來找到一個合適的默認的家人。以下策略可供選擇： | Constant | Value | Description | | --- | --- | --- | | `QFont.PreferDefault` | `0x0001` | 默認樣式的策略。它不喜歡的任何類型的字體。 | | `QFont.PreferBitmap` | `0x0002` | 喜歡點陣字體（相對于輪廓字體）。 | | `QFont.PreferDevice` | `0x0004` | 喜歡的設備字體。 | | `QFont.PreferOutline` | `0x0008` | 喜歡輪廓字體（相對于位圖字體）。 | | `QFont.ForceOutline` | `0x0010` | 強制使用輪廓字體。 | | `QFont.NoAntialias` | `0x0100` | 不消除鋸齒的字體。 | | `QFont.PreferAntialias` | `0x0080` | 如果可能的話反鋸齒。 | | `QFont.OpenGLCompatible` | `0x0200` | 強制使用兼容OpenGL字體。 | | `QFont.NoFontMerging` | `0x8000` | If the font selected for a certain writing system does not contain a character requested to draw, then Qt automatically chooses a similar looking font that contains the character. The NoFontMerging flag disables this feature. Please note that enabling this flag will not prevent Qt from automatically picking a suitable font when the selected font does not support the writing system of the text. | 任何這些可能是或的結果與這些標志之一： | Constant | Value | Description | | --- | --- | --- | | `QFont.PreferMatch` | `0x0020` | 喜歡的精確匹配。字體匹配器將嘗試使用已指定的確切的字體大小。 | | `QFont.PreferQuality` | `0x0040` | 喜歡最優質的字體。字體匹配器將使用該字體支持的最接近的標準點的大小。 | | `QFont.ForceIntegerMetrics` | `0x0400` | 部隊在支持小數字體規格的字體引擎中使用的整數值。 | ``` QFont.Weight ``` Qt使用加權刻度從0到99類似，但不一樣的，在Windows或CSS中使用的尺度。 0的重量為超輕，而99將是一個非常黑。這個枚舉包含預定義字體粗細： | Constant | Value | Description | | --- | --- | --- | | `QFont.Light` | `25` | 25 | | `QFont.Normal` | `50` | 50 | | `QFont.DemiBold` | `63` | 63 | | `QFont.Bold` | `75` | 75 | | `QFont.Black` | `87` | 87 | * * * ## Method Documentation ``` QFont.__init__ (self) ``` 構造一個使用應用程序的默認字體的字體對象。 **See also** [QApplication.setFont](qapplication.html#setFont)（）和[QApplication.font](qapplication.html#font)（）。 ``` QFont.__init__ (self, QString?family, int?pointSize?=?-1, int?weight?=?-1, bool?italic?=?False) ``` 構造一個字體對象與指定的_family_，_pointSize_，_weight_和_italic_設置。 If _pointSize_是零或負值，則字體的點大小被設定為一個系統有關的默認值。一般來說，這是12個點，除了在Symbian它是7分。該_family_名稱可以任選還包括一個鑄造廠的名稱，例如“黑體[ Cronyx ]” 。如果_family_可從一個以上的鑄造和未指明的鑄造，任意鑄造被選擇。如果家庭不具備的家庭將使用設置的[font matching](qfont.html)算法。 **See also** [Weight](qfont.html#Weight-enum)，[setFamily](qfont.html#setFamily)（）[setPointSize](qfont.html#setPointSize)（）[setWeight](qfont.html#setWeight)（）[setItalic](qfont.html#setItalic)（）[setStyleHint](qfont.html#setStyleHint)（）和[QApplication.font](qapplication.html#font)（）。 ``` QFont.__init__ (self, QFont, QPaintDevice?pd) ``` 構造一個從字體_font_供漆設備上使用_pd_。 ``` QFont.__init__ (self, QFont) ``` 構造一個字體是副本_font_。 ``` QFont.__init__ (self, QVariant?variant) ``` ``` bool QFont.bold (self) ``` 返回True如果[weight](qfont.html#weight)（）是一個大于[QFont.Normal](qfont.html#Weight-enum)否則返回False 。 **See also** [weight](qfont.html#weight)（）[setBold](qfont.html#setBold)（）和[QFontInfo.bold](qfontinfo.html#bold)（）。 ``` QFont.cacheStatistics () ``` ``` Capitalization QFont.capitalization (self) ``` [ 返回該字體的當前市值類型。此功能被引入Qt的4.4 。 ](qfont.html#Capitalization-enum) [**See also**](qfont.html#Capitalization-enum) [setCapitalization](qfont.html#setCapitalization)（）。 ``` QFont.cleanup () ``` ``` QString QFont.defaultFamily (self) ``` 返回對應于當前樣式提示的姓。 **See also** [StyleHint](qfont.html#StyleHint-enum)，[styleHint](qfont.html#styleHint)（）和[setStyleHint](qfont.html#setStyleHint)（）。 ``` bool QFont.exactMatch (self) ``` 返回True如果一個窗口系統字體完全匹配該字體的設置是可用的。 **See also** [QFontInfo](qfontinfo.html)。 ``` QString QFont.family (self) ``` 返回請求的字體系列名稱，即名稱在構造或最后個setFont （）調用設置。 **See also** [setFamily](qfont.html#setFamily)（）[substitutes](qfont.html#substitutes)（）和[substitute](qfont.html#substitute)（）。 ``` bool QFont.fixedPitch (self) ``` 返回True如果固定攤位已經被置位，否則返回False 。 **See also** [setFixedPitch](qfont.html#setFixedPitch)（）和[QFontInfo.fixedPitch](qfontinfo.html#fixedPitch)（）。 ``` bool QFont.fromString (self, QString) ``` 設置該字體相匹配的說明_descrip_。該說明是用逗號分隔的字體屬性列表，返回的[toString](qfont.html#toString)（）。 **See also** [toString](qfont.html#toString)（）。 ``` int QFont.handle (self) ``` 返回窗口的系統句柄的字體，對于低級別的訪問。使用此功能是_not_便攜。 ``` HintingPreference QFont.hintingPreference (self) ``` [ 返回字形與此字體渲染當前的優選暗示的水平。此功能被引入Qt的4.8 。 ](qfont.html#HintingPreference-enum) [**See also**](qfont.html#HintingPreference-enum) [setHintingPreference](qfont.html#setHintingPreference)（）。 ``` QFont.initialize () ``` ``` QFont.insertSubstitution (QString, QString) ``` Inserts _substituteName_成家庭中的替換表_familyName_。 **See also** [insertSubstitutions](qfont.html#insertSubstitutions)（）[removeSubstitution](qfont.html#removeSubstitution)（）[substitutions](qfont.html#substitutions)（）[substitute](qfont.html#substitute)（）和[substitutes](qfont.html#substitutes)（）。 ``` QFont.insertSubstitutions (QString, QStringList) ``` 插入家庭的名單_substituteNames_入替換列表_familyName_。 **See also** [insertSubstitution](qfont.html#insertSubstitution)（）[removeSubstitution](qfont.html#removeSubstitution)（）[substitutions](qfont.html#substitutions)（）和[substitute](qfont.html#substitute)（）。 ``` bool QFont.isCopyOf (self, QFont) ``` 返回True如果這個字體和_f_是彼此的副本，即，其中的一個被創建為其它既不以來已經被修改的副本。這比平等更嚴格的。 **See also** [operator=](qfont.html#operator-eq)（）和[operator==](qfont.html#operator-eq-eq)（）。 ``` bool QFont.italic (self) ``` 返回True如果[style](qfont.html#style)字體的（）不是[QFont.StyleNormal](qfont.html#Style-enum) **See also** [setItalic](qfont.html#setItalic)（）和[style](qfont.html#style)（）。 ``` bool QFont.kerning (self) ``` 返回True如果字距應繪制文本使用此字體時使用。 **See also** [setKerning](qfont.html#setKerning)（）。 ``` QString QFont.key (self) ``` 返回字體的按鍵，字體的文字表述。它通常被用作密鑰對字體的高速緩存或字典。 **See also** [QMap](index.htm)。 ``` QString QFont.lastResortFamily (self) ``` 返回“最后手段”字體系列名稱。當前的實現嘗試多種常見的字體，返回的第一個發現。是有可能是沒有家人在這種情況下，一個空字符串，則返回找到。 **See also** [lastResortFont](qfont.html#lastResortFont)（）。 ``` QString QFont.lastResortFont (self) ``` 對于字體匹配算法返回一個“不得已而為之”的字體名稱??。這是使用，如果不得已家人不可用。它總是返回一個名稱，如果需要返回類似于“固定”或“系統” 。當前的實現嘗試多種常見的字體，返回的第一個發現。實現可以在任何時候改變，但這個函數總是返回包含一些字符串。這在理論上是可能的，是不是真的有一個lastResortFont （）在這種情況下， Qt會顯示一條錯誤消息中止。我們一直無法識別的情況下發生這種情況。請[report it as a bug](index.htm)如果是的話，最好用你安裝的字體列表。 **See also** [lastResortFamily](qfont.html#lastResortFamily)（）和[rawName](qfont.html#rawName)（）。 ``` float QFont.letterSpacing (self) ``` 返回字母間距的字體。此功能被引入Qt的4.4 。 **See also** [setLetterSpacing](qfont.html#setLetterSpacing)（）[letterSpacingType](qfont.html#letterSpacingType)（）和[setWordSpacing](qfont.html#setWordSpacing)（）。 ``` SpacingType QFont.letterSpacingType (self) ``` [ 返回用于字母間距的間距類型。此功能被引入Qt的4.4 。 ](qfont.html#SpacingType-enum) [**See also**](qfont.html#SpacingType-enum) [letterSpacing](qfont.html#letterSpacing)（）[setLetterSpacing](qfont.html#setLetterSpacing)（）和[setWordSpacing](qfont.html#setWordSpacing)（）。 ``` bool QFont.overline (self) ``` 返回True如果劃線已經被置位，否則返回False 。 **See also** [setOverline](qfont.html#setOverline)（）。 ``` int QFont.pixelSize (self) ``` 返回該字體的像素大小，如果它被設置以[setPixelSize](qfont.html#setPixelSize)（）。返回-1，如果將尺寸設定與[setPointSize](qfont.html#setPointSize)（）或[setPointSizeF](qfont.html#setPointSizeF)（）。 **See also** [setPixelSize](qfont.html#setPixelSize)（）[pointSize](qfont.html#pointSize)（）[QFontInfo.pointSize](qfontinfo.html#pointSize)（）和[QFontInfo.pixelSize](qfontinfo.html#pixelSize)（）。 ``` int QFont.pointSize (self) ``` 返回字體的點數大小。返回-1，如果字體大小被以像素為單位指定的。 **See also** [setPointSize](qfont.html#setPointSize)（）和[pointSizeF](qfont.html#pointSizeF)（）。 ``` float QFont.pointSizeF (self) ``` 返回字體的點數大小。返回-1，如果字體大小被以像素為單位指定的。 **See also** [pointSize](qfont.html#pointSize)（）[setPointSizeF](qfont.html#setPointSizeF)（）[pixelSize](qfont.html#pixelSize)（）[QFontInfo.pointSize](qfontinfo.html#pointSize)（）和[QFontInfo.pixelSize](qfontinfo.html#pixelSize)（）。 ``` bool QFont.rawMode (self) ``` 返回True如果原始模式用于字體名稱匹配，否則返回False 。 **See also** [setRawMode](qfont.html#setRawMode)（）和[rawName](qfont.html#rawName)（）。 ``` QString QFont.rawName (self) ``` 返回底層窗口系統中的字體的名稱。在X11上，這個函數會返回一個空字符串，如果Qt的是建立與fontconfig的支持，否則XLFD （ X邏輯字體描述）被返回。使用這個函數的返回值通常是_not_ _portable_。 **See also** [setRawName](qfont.html#setRawName)（）。 ``` QFont.removeSubstitution (QString) ``` 刪除所有的換人_familyName_。 **See also** [insertSubstitutions](qfont.html#insertSubstitutions)（）[insertSubstitution](qfont.html#insertSubstitution)（）[substitutions](qfont.html#substitutions)（）和[substitute](qfont.html#substitute)（）。 ``` QFont QFont.resolve (self, QFont) ``` [](qfont.html) [返回一個新的](qfont.html)[QFont](qfont.html)具有從屬性復制_other_還沒有對這種字體被預先設定。 ``` QFont.setBold (self, bool?enable) ``` If _enable_是真正的設置字體的重量[QFont.Bold](qfont.html#Weight-enum)否則設置的權重[QFont.Normal](qfont.html#Weight-enum)。為了更好的氣魄控制使用[setWeight](qfont.html#setWeight)（）。 **See also** [bold](qfont.html#bold)（）和[setWeight](qfont.html#setWeight)（）。 ``` QFont.setCapitalization (self, Capitalization) ``` 在設置該字體的文字，以資本化_caps_。字體的大小寫使文本顯示在選定資本化模式。此功能被引入Qt的4.4 。 **See also** [capitalization](qfont.html#capitalization)（）。 ``` QFont.setFamily (self, QString) ``` 設置字體的系列名稱。該名稱是區分大小寫的，并且可能包括代工的名稱。該_family_名稱可以任選還包括一個鑄造廠的名稱，例如“黑體[ Cronyx ]” 。如果_family_可從一個以上的鑄造和未指明的鑄造，任意鑄造被選擇。如果家庭不具備的家庭將使用設置的[font matching](qfont.html)算法。 **See also** [family](qfont.html#family)（）[setStyleHint](qfont.html#setStyleHint)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setFixedPitch (self, bool) ``` If _enable_誠然，在設置固定間距，否則套固定攤位了。 **See also** [fixedPitch](qfont.html#fixedPitch)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setHintingPreference (self, HintingPreference?hintingPreference) ``` 偏愛字形的暗示級別設置為_hintingPreference_。這是一個暗示，底層的字體渲染系統使用暗示一定水平，并且跨平臺具有不同的支持。請參閱下表說明文檔中的[QFont.HintingPreference](qfont.html#HintingPreference-enum)更多的細節。默認暗示偏好[QFont.PreferDefaultHinting](qfont.html#HintingPreference-enum)。此功能被引入Qt的4.8 。 **See also** [hintingPreference](qfont.html#hintingPreference)（）。 ``` QFont.setItalic (self, bool?b) ``` 設置[style](qfont.html#style)的字體（）來[QFont.StyleItalic](qfont.html#Style-enum)如果_enable_是真的，否則樣式設置為[QFont.StyleNormal](qfont.html#Style-enum)。 **See also** [italic](qfont.html#italic)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setKerning (self, bool) ``` 啟用字距這個字體，如果_enable_為True，否則禁用它。默認情況下，啟用字距調整。如果啟用字距調整，字形度量對不上號了，即使是拉丁文字。換句話說，該寬度（' a'）的寬度+ （' b'）中的假設是等于寬度（ “AB” ）是不neccesairly真。 **See also** [kerning](qfont.html#kerning)（）和[QFontMetrics](qfontmetrics.html)。 ``` QFont.setLetterSpacing (self, SpacingType?type, float?spacing) ``` 設置字母間距的字體_spacing_和間距的類型_type_。字母間距改變了字體個別字母之間的默認間距。字母之間的間距可以做得更小以及更大。此功能被引入Qt的4.4 。 **See also** [letterSpacing](qfont.html#letterSpacing)（）[letterSpacingType](qfont.html#letterSpacingType)（）和[setWordSpacing](qfont.html#setWordSpacing)（）。 ``` QFont.setOverline (self, bool) ``` If _enable_誠然，在設置上劃線，否則套劃線了。 **See also** [overline](qfont.html#overline)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setPixelSize (self, int) ``` 設置字體大小_pixelSize_像素。使用此功能使字體與設備相關。使用[setPointSize](qfont.html#setPointSize)（）或[setPointSizeF](qfont.html#setPointSizeF)（）來設置的字體大小的設備中獨立的方式。 **See also** [pixelSize](qfont.html#pixelSize)（）。 ``` QFont.setPointSize (self, int) ``` 設置點的大小_pointSize_。點的大小必須大于零。 **See also** [pointSize](qfont.html#pointSize)（）和[setPointSizeF](qfont.html#setPointSizeF)（）。 ``` QFont.setPointSizeF (self, float) ``` 設置點的大小_pointSize_。點的大小必須大于零。所要求的精度可能無法在所有平臺上實現。 **See also** [pointSizeF](qfont.html#pointSizeF)（）[setPointSize](qfont.html#setPointSize)（）和[setPixelSize](qfont.html#setPixelSize)（）。 ``` QFont.setRawMode (self, bool) ``` If _enable_是真的，將原始的模式，否則將原始模式關閉。此功能只有在X11下的效果。如果原始模式被激活， Qt會尋找一個X字體具有完整的字體名匹配的姓，忽略了設置的所有其他值[QFont](qfont.html)。如果字體名稱匹配多種字體， Qt會使用由十傳回的第一個字體[QFontInfo](qfontinfo.html) _cannot_用于獲取有關信息[QFont](qfont.html)使用原始模式（它會返回在設置的值[QFont](qfont.html)對于所有參數，包括姓）。 **Warning:**不要使用原始模式，除非你真的需要它！在大多數（如果不是全部）的情況下，[setRawName](qfont.html#setRawName)（）是一個更好的選擇。 **See also** [rawMode](qfont.html#rawMode)（）和[setRawName](qfont.html#setRawName)（）。 ``` QFont.setRawName (self, QString) ``` 其系統的具體名稱設置字體。在X下該功能是非常有用的，其中系統字體設置（例如X資源）通常可在XLFD （ X邏輯字體描述）唯一形式。你可以傳遞一個XLFD為_name_此功能。設置setRawName字體（）仍然是一個全功能的[QFont](qfont.html)。它可以查詢（例如用[italic](qfont.html#italic)（））或修改（例如，利用[setItalic](qfont.html#setItalic)（）），因此也適合用于呈現富文本。如果Qt的內部字體數據庫無法解析的原始名稱，字體變成了原始的字體，_name_作為其家人。需要注意的是，本實施中不XLFD的處理通配符很好，而且字體別名（文件`fonts.alias`在X11 ）字體目錄不支持。 **See also** [rawName](qfont.html#rawName)（）[setRawMode](qfont.html#setRawMode)（）和[setFamily](qfont.html#setFamily)（）。 ``` QFont.setStretch (self, int) ``` 設置為字體的拉伸因子。伸展因子變化的字體中的所有字符的寬度_factor_個百分點。例如，設置_factor_150導致在字體被（即150 ％）的1.5倍更寬的所有字符。默認拉伸系數為100 。最小拉伸因子是1 ，最大伸長率是4000 。上的伸長率是只適用于輪廓字體。拉伸系數被忽略的位圖字體。注意：[QFont](qfont.html)不能伸展XLFD字體。當裝載在X11 XLFD字體，拉伸系數匹配一組預定義的值的XLFD的SETWIDTH_NAME領域。 **See also** [stretch](qfont.html#stretch)（）和[QFont.Stretch](qfont.html#Stretch-enum)。 ``` QFont.setStrikeOut (self, bool) ``` If _enable_是真的，套三振上，否則套三振了。 **See also** [strikeOut](qfont.html#strikeOut)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setStyle (self, Style?style) ``` 設置字體的樣式_style_。 **See also** [style](qfont.html#style)（）[italic](qfont.html#italic)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setStyleHint (self, StyleHint?hint, StyleStrategy?strategy?=?QFont.PreferDefault) ``` 設置風格提示和策略，_hint_和_strategy_元。如果這些都沒有明確設定的樣式提示將默認為`AnyStyle`和風格策略，`PreferDefault`。 Qt不支持樣式提示在X11 ，因為沒有提供窗口系統信息。 **See also** [StyleHint](qfont.html#StyleHint-enum)，[styleHint](qfont.html#styleHint)（）[StyleStrategy](qfont.html#StyleStrategy-enum)，[styleStrategy](qfont.html#styleStrategy)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setStyleName (self, QString?styleName) ``` 設置字體的樣式名稱，以給定的_styleName_。就像當設置，其他樣式屬性[style](qfont.html#style)（）和[weight](qfont.html#weight)（）將被忽略字體匹配。此功能被引入Qt的4.8 。 **See also** [styleName](qfont.html#styleName)（）。 ``` QFont.setStyleStrategy (self, StyleStrategy?s) ``` 設置樣式戰略字體_s_。 **See also** [styleStrategy](qfont.html#styleStrategy)（）和[QFont.StyleStrategy](qfont.html#StyleStrategy-enum)。 ``` QFont.setUnderline (self, bool) ``` If _enable_是真的，套下劃線上，否則設置下劃線關閉。 **See also** [underline](qfont.html#underline)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setWeight (self, int) ``` 設置權重的字體_weight_，這應該是從一個值[QFont.Weight](qfont.html#Weight-enum)枚舉。 **See also** [weight](qfont.html#weight)（）和[QFontInfo](qfontinfo.html)。 ``` QFont.setWordSpacing (self, float?spacing) ``` 設置字間距的字體_spacing_。字間距改變個別單詞之間的默認間距。正值增加了字間距由像素的相應金額，而負值減小跨字相應的間距。字間距將不適用于書寫系統，其中indiviaul話是不是由空格分隔。此功能被引入Qt的4.4 。 **See also** [wordSpacing](qfont.html#wordSpacing)（）和[setLetterSpacing](qfont.html#setLetterSpacing)（）。 ``` int QFont.stretch (self) ``` 返回的字體拉伸因子。 **See also** [setStretch](qfont.html#setStretch)（）。 ``` bool QFont.strikeOut (self) ``` 返回True如果三振出局已定，否則返回False 。 **See also** [setStrikeOut](qfont.html#setStrikeOut)（）。 ``` Style QFont.style (self) ``` [ 返回字體的風格。 ](qfont.html#Style-enum) [**See also**](qfont.html#Style-enum) [setStyle](qfont.html#setStyle)（）。 ``` StyleHint QFont.styleHint (self) ``` [](qfont.html#StyleHint-enum) [返回](qfont.html#StyleHint-enum)[StyleHint](qfont.html#StyleHint-enum)。風格暗示的影響[font matching](qfont.html)算法。看[QFont.StyleHint](qfont.html#StyleHint-enum)對于可用的提示的列表。 **See also** [setStyleHint](qfont.html#setStyleHint)（）[QFont.StyleStrategy](qfont.html#StyleStrategy-enum)和[QFontInfo.styleHint](qfontinfo.html#styleHint)（）。 ``` QString QFont.styleName (self) ``` 返回請求的字體樣式名稱，它將被用來配合不規則樣式的字體（即不能在其他樣式屬性進行歸一化）。這取決于系統字體的支持，因此僅適用于Mac OS X和X11至今。在Windows中不規則的樣式將被添加為單獨的字體系列所以沒有這種需要。此功能被引入Qt的4.8 。 **See also** [setStyleName](qfont.html#setStyleName)（）[setFamily](qfont.html#setFamily)（）和[setStyle](qfont.html#setStyle)（）。 ``` StyleStrategy QFont.styleStrategy (self) ``` [](qfont.html#StyleStrategy-enum) [返回](qfont.html#StyleStrategy-enum)[StyleStrategy](qfont.html#StyleStrategy-enum)。風格策略的影響[font matching](qfont.html)算法。看[QFont.StyleStrategy](qfont.html#StyleStrategy-enum)可用策略的列表。 **See also** [setStyleStrategy](qfont.html#setStyleStrategy)（）[setStyleHint](qfont.html#setStyleHint)（）和[QFont.StyleHint](qfont.html#StyleHint-enum)。 ``` QString QFont.substitute (QString) ``` 返回第一個系列名稱中使用時_familyName_是指定的。查找不區分大小寫。如果沒有取代_familyName_，_familyName_返回。取得替換使用列表[substitutes](qfont.html#substitutes)（）。 **See also** [setFamily](qfont.html#setFamily)（）[insertSubstitutions](qfont.html#insertSubstitutions)（）[insertSubstitution](qfont.html#insertSubstitution)（）和[removeSubstitution](qfont.html#removeSubstitution)（）。 ``` QStringList QFont.substitutes (QString) ``` 返回姓氏的情況下使用時的清單_familyName_是指定的。查找不區分大小寫。如果沒有取代_familyName_，則返回空列表。 **See also** [substitute](qfont.html#substitute)（）[insertSubstitutions](qfont.html#insertSubstitutions)（）[insertSubstitution](qfont.html#insertSubstitution)（）和[removeSubstitution](qfont.html#removeSubstitution)（）。 ``` QStringList QFont.substitutions () ``` 返回取代姓氏排序的列表。 **See also** [insertSubstitution](qfont.html#insertSubstitution)（）[removeSubstitution](qfont.html#removeSubstitution)（）和[substitute](qfont.html#substitute)（）。 ``` QString QFont.toString (self) ``` 返回該字體的描述。描述是一個以逗號分隔的屬性，非常適合使用在列表[QSettings](qsettings.html)。 **See also** [fromString](qfont.html#fromString)（）。 ``` bool QFont.underline (self) ``` 返回True如果底線已經被置位，否則返回False 。 **See also** [setUnderline](qfont.html#setUnderline)（）。 ``` int QFont.weight (self) ``` 從返回的是枚舉值中的一個字體的重量[QFont.Weight](qfont.html#Weight-enum)。 **See also** [setWeight](qfont.html#setWeight)（）[Weight](qfont.html#Weight-enum)和[QFontInfo](qfontinfo.html)。 ``` float QFont.wordSpacing (self) ``` 返回字間距字體。此功能被引入Qt的4.4 。 **See also** [setWordSpacing](qfont.html#setWordSpacing)（）和[setLetterSpacing](qfont.html#setLetterSpacing)（）。 ``` bool QFont.__eq__ (self, QFont) ``` ``` bool QFont.__ge__ (self, QFont) ``` ``` bool QFont.__lt__ (self, QFont) ``` ``` bool QFont.__ne__ (self, QFont) ```