| 頭： | #include <QFont> |
注意： 此類的所有函數 可重入 .
| 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 { AnyStyle, SansSerif, Helvetica, Serif, ..., System } |
| enum | StyleStrategy { PreferDefault, PreferBitmap, PreferDevice, PreferOutline, ..., ForceIntegerMetrics } |
| enum | Weight { Light, Normal, DemiBold, Bold, Black } |
| QFont () | |
| QFont (const QString & family , int pointSize = -1, int weight = -1, bool italic = false) | |
| QFont (const QFont & font , QPaintDevice * pd ) | |
| QFont (const QFont & font ) | |
| ~QFont () | |
| bool | bold () const |
| Capitalization | capitalization () const |
| QString | defaultFamily () const |
| bool | exactMatch () const |
| QString | family () const |
| bool | fixedPitch () const |
| FT_Face | freetypeFace () const |
| bool | fromString (const QString & descrip ) |
| HFONT | handle () const |
| HintingPreference | hintingPreference () const |
| bool | isCopyOf (const QFont & f ) const |
| bool | italic () const |
| bool | kerning () const |
| QString | key () const |
| QString | lastResortFamily () const |
| QString | lastResortFont () const |
| qreal | letterSpacing () const |
| SpacingType | letterSpacingType () const |
| quint32 | macFontID () const |
| bool | overline () const |
| int | pixelSize () const |
| int | pointSize () const |
| qreal | pointSizeF () const |
| bool | rawMode () const |
| QString | rawName () const |
| QFont | resolve (const QFont & other ) const |
| void | setBold (bool enable ) |
| void | setCapitalization (Capitalization caps ) |
| void | setFamily (const QString & family ) |
| void | setFixedPitch (bool enable ) |
| void | setHintingPreference (HintingPreference hintingPreference ) |
| void | setItalic (bool enable ) |
| void | setKerning (bool enable ) |
| void | setLetterSpacing (SpacingType type , qreal spacing ) |
| void | setOverline (bool enable ) |
| void | setPixelSize (int pixelSize ) |
| void | setPointSize (int pointSize ) |
| void | setPointSizeF (qreal pointSize ) |
| void | setRawMode (bool enable ) |
| void | setRawName (const QString & name ) |
| void | setStretch (int factor ) |
| void | setStrikeOut (bool enable ) |
| void | setStyle (Style style ) |
| void | setStyleHint (StyleHint hint , StyleStrategy strategy = PreferDefault) |
| void | setStyleName (const QString & styleName ) |
| void | setStyleStrategy (StyleStrategy s ) |
| void | setUnderline (bool enable ) |
| void | setWeight (int weight ) |
| void | setWordSpacing (qreal spacing ) |
| int | stretch () const |
| bool | strikeOut () const |
| Style | style () const |
| StyleHint | styleHint () const |
| QString | styleName () const |
| StyleStrategy | styleStrategy () const |
| QString | toString () const |
| bool | underline () const |
| int | weight () const |
| qreal | wordSpacing () const |
| operator QVariant () const | |
| bool | operator!= (const QFont & f ) const |
| bool | operator< (const QFont & f ) const |
| QFont & | operator= (const QFont & font ) |
| QFont & | operator= (QFont && other ) |
| bool | operator== (const QFont & f ) const |
| void | insertSubstitution (const QString & familyName , const QString & substituteName ) |
| void | insertSubstitutions (const QString & familyName , const QStringList & substituteNames ) |
| void | removeSubstitution (const QString & familyName ) |
| QString | substitute (const QString & familyName ) |
| QStringList | substitutes (const QString & familyName ) |
| QStringList | substitutions () |
| QDataStream & | operator<< (QDataStream & s , const QFont & font ) |
| QDataStream & | operator>> (QDataStream & s , QFont & font ) |
The QFont 類指定用於繪製文本的字體。
當創建 QFont 對象時，可指定想要字體擁有的各種屬性。Qt 將使用帶有指定屬性的字體，或者若不存在匹配字體，Qt 將使用最接近匹配的安裝字體。實際使用的字體屬性檢索自 QFontInfo 對象。若窗口係統提供的準確匹配 exactMatch () returns true. Use QFontMetrics 能獲取度量值，如：字符串的像素長度是使用 QFontMetrics::width ().
注意， QApplication 實例必須存在先於 QFont 可以使用。可以設置應用程序的默認字體采用 QApplication::setFont ().
若所選字體不包括需要顯示的所有字符， QFont 將試著查找最接近等效字體的字符。當 QPainter 繪製字符來自字體 QFont 將報告它是否擁有該字符；若沒有， QPainter 將繪製未填充正方形。
創建 QFont 像這樣：
QFont serifFont("Times", 10, QFont::Bold); QFont sansFont("Helvetica [Cronyx]", 12);
在構造函數中設置的屬性也可以稍後設置，如 setFamily (), setPointSize (), setPointSizeFloat (), setWeight () 和 setItalic ()。剩餘屬性必須在構造後設置，如 setBold (), setUnderline (), setOverline (), setStrikeOut () 和 setFixedPitch (). QFontInfo 對象應該被創建 after 字體屬性已設置。 QFontInfo 對象不改變，即使更改字體的屬性。相應 get 函數，如 family (), pointSize () 等，返迴設置值，即使使用的值可能不同。實際值可以獲取自 QFontInfo 對象。
若請求字體係列不可用，可以影響 字體匹配算法 通過選取特定 QFont::StyleHint and QFont::StyleStrategy with setStyleHint ()。默認係列 (對應當前樣式提示) 的返迴是通過 defaultFamily ().
字體匹配算法有 lastResortFamily () 和 lastResortFont () 在無法找到閤適匹配的情況下。可以提供代入字體係列名使用 insertSubstitution () 和 insertSubstitutions ()。可以移除代入采用 removeSubstitution ()。使用 substitute () 檢索係列的第一代入，或檢索係列名稱自身若沒有代入。使用 substitutes () 檢索係列的代入列錶 (可能為空)。
Every QFont 擁有 key () which you can use, for example, as the key in a cache or dictionary. If you want to store a user's font preferences you could use QSettings , writing the font information with toString () and reading it back with fromString (). The operator<<() and operator>>() functions are also available, but they work on a data stream.
It is possible to set the height of characters shown on the screen to a specified number of pixels with setPixelSize (); however using setPointSize () has a similar effect and provides device independence.
In X11 you can set a font using its system specific name with setRawName ().
Loading fonts can be expensive, especially on X11. QFont contains extensive optimizations to make the copying of QFont objects fast, and to cache the results of the slow window system functions it depends upon.
字體匹配算法工作如下：
Note that the actual font matching algorithm varies from platform to platform.
In Windows a request for the "Courier" font is automatically changed to "Courier New", an improved version of Courier that allows for smooth scaling. The older "Courier" bitmap font can be selected by setting the PreferBitmap 樣式對策 (見 setStyleStrategy ()).
一旦找到字體，剩餘屬性將按優先級次序匹配：
If you have a font which matches on family, even if none of the other attributes match, this font will be chosen in preference to a font which doesn't match on family but which does match on the other attributes. This is because font family is the dominant search criteria.
The point size is defined to match if it is within 20% of the requested point size. When several fonts match and are only distinguished by point size, the font with the closest point size to the one requested will be chosen.
The actual family, font size, weight and other font attributes used for drawing text will depend on what's available for the chosen family under the window system. A QFontInfo object can be used to determine the actual values used for drawing the text.
範例：
QFont f("Helvetica");
若擁有 Adobe 和 Cronyx Helvetica 兩者，可以獲取任一。
QFont f("Helvetica [Cronyx]");
You can specify the foundry you want in the family name. The font f in the above example will be set to "Helvetica [Cronyx]".
To determine the attributes of the font actually used in the window system, use a QFontInfo 對象，如
QFontInfo info(f1); QString family = info.family();
要找齣字體規格，使用 QFontMetrics 對象，如
QFontMetrics fm(f1); int textWidthInPixels = fm.width("How many pixels wide is this text?"); int textHeightInPixels = fm.height();
對於字體的更多一般信息，見 comp.fonts FAQ. Information on encodings can be found from Roman Czyborra's 頁麵。
另請參閱 QFontComboBox , QFontMetrics , QFontInfo , QFontDatabase ，和 字符映射範例 .
此字體應用於文本的渲染選項。
| 常量 | 值 | 描述 |
|---|---|---|
QFont::MixedCase
|
0
|
This is the normal text rendering option where no capitalization change is applied. |
QFont::AllUppercase
|
1
|
這以全大寫類型方式更改要渲染文本。 |
QFont::AllLowercase
|
2
|
這以全小寫類型方式更改要渲染文本。 |
QFont::SmallCaps
|
3
|
This alters the text to be rendered in small-caps type. |
QFont::Capitalize
|
4
|
This alters the text to be rendered with the first character of each word as an uppercase character. |
該枚舉在 Qt 4.4 引入或被修改。
This enum describes the different levels of hinting that can be applied to glyphs to improve legibility on displays where it might be warranted by the density of pixels.
| 常量 | 值 | 描述 |
|---|---|---|
QFont::PreferDefaultHinting
|
0
|
Use the default hinting level for the target platform. |
QFont::PreferNoHinting
|
1
|
If possible, render text without hinting the outlines of the glyphs. The text layout will be typographically accurate and scalable, using the same metrics as are used e.g. when printing. |
QFont::PreferVerticalHinting
|
2
|
If possible, render text with no horizontal hinting, but align glyphs to the pixel grid in the vertical direction. The text will appear crisper on displays where the density is too low to give an accurate rendering of the glyphs. But since the horizontal metrics of the glyphs are unhinted, the text's layout will be scalable to higher density devices (such as printers) without impacting details such as line breaks. |
QFont::PreferFullHinting
|
3
|
If possible, render text with hinting in both horizontal and vertical directions. The text will be altered to optimize legibility on the target device, but since the metrics will depend on the target size of the text, the positions of glyphs, line breaks, and other typographical detail will not scale, meaning that a text layout may look different on devices with different pixel densities. |
Please note that this enum only describes a preference, as the full range of hinting levels are not supported on all of Qt's supported platforms. The following table details the effect of a given hinting preference on a selected set of target platforms.
| PreferDefaultHinting | PreferNoHinting | PreferVerticalHinting | PreferFullHinting | |
|---|---|---|---|---|
| Windows Vista (w/o 平颱更新) 及更早版本 | 完整提示 | 完整提示 | 完整提示 | 完整提示 |
| Windows 7 和 Windows Vista (w/平颱更新) 及 Qt 啓用的 DirectWrite | 完整提示 | 垂直提示 | 垂直提示 | 完整提示 |
| FreeType | 操作係統設置 | 不提示 | Vertical hinting (light) | 完整提示 |
| Cocoa on Mac OS X | 不提示 | 不提示 | 不提示 | 不提示 |
注意： Please be aware that altering the hinting preference on Windows is available through the DirectWrite font engine. This is available on Windows Vista after installing the platform update, and on Windows 7. In order to use this extension, configure Qt using -directwrite. The target application will then depend on the availability of DirectWrite on the target system.
該枚舉在 Qt 4.8 引入或被修改。
| 常量 | 值 | 描述 |
|---|---|---|
QFont::PercentageSpacing
|
0
|
值 100 將保持間距不變；值 200 將字符後間距擴大到字符本身寬度。 |
QFont::AbsoluteSpacing
|
1
|
正值遞增相應像素的字母間距；負值遞減間距。 |
該枚舉在 Qt 4.4 引入或被修改。
遵循 CSS 命名約定的預定義拉伸值。值越高，文本拉伸更多。
| 常量 | 值 | 描述 |
|---|---|---|
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 |
另請參閱 setStretch () 和 stretch ().
此枚舉描述用於顯示文本的不同字形樣式。
| 常量 | 值 | 描述 |
|---|---|---|
QFont::StyleNormal
|
0
|
用於無樣式文本的 Normal (正常) 字形。 |
QFont::StyleItalic
|
1
|
為斜體文本錶示目的，專門設計的 Italic (斜體) 字形。 |
QFont::StyleOblique
|
2
|
具有斜體外觀的字形通常是基於無樣式的字形，但未對斜體文本錶示目的進行微調。 |
另請參閱 Weight .
樣式提示用於 字體匹配 算法以查找適當默認係列，若選中的字體係列不可用。
| 常量 | 值 | 描述 |
|---|---|---|
QFont::AnyStyle
|
? | 讓字體匹配算法選擇係列。這是默認。 |
QFont::SansSerif
|
Helvetica
|
字體匹配器首選 SansSerif 字體。 |
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 一般字體係列 Monospace (等寬) 的字體。 |
QFont::Fantasy
|
? | 字體匹配器首選映射到 CSS 一般字體係列 Fantasy (幻想) 的字體。 |
QFont::Cursive
|
? | 字體匹配器首選映射到 CSS 一般字體係列 Cursive (草書) 的字體。 |
QFont::System
|
? | 字體匹配器首選係統字體。 |
樣式對策告訴 字體匹配 算法應使用什麼類型字體以查找閤適默認係列。
下列對策可用：
| 常量 | 值 | 描述 |
|---|---|---|
QFont::PreferDefault
|
0x0001
|
默認樣式戰略。它不首選任何類型的字體。 |
QFont::PreferBitmap
|
0x0002
|
首選位圖字體 (而不是輪廓字體)。 |
QFont::PreferDevice
|
0x0004
|
首選設備字體。 |
QFont::PreferOutline
|
0x0008
|
首選輪廓字體 (而不是位圖字體)。 |
QFont::ForceOutline
|
0x0010
|
強製使用輪廓字體。 |
QFont::NoAntialias
|
0x0100
|
不對字體抗鋸齒。 |
QFont::PreferAntialias
|
0x0080
|
抗鋸齒，若可能的話。 |
QFont::OpenGLCompatible
|
0x0200
|
forces the use of OpenGL compatible fonts. |
QFont::NoFontMerging
|
0x8000
|
若為某種書寫係統選擇的字體不包含請求繪製的字符，那麼 Qt 會自動選取包含該字符的外觀類似字體。NoFontMerging 標誌會禁用此特徵。請注意，啓用此標誌不會阻止 Qt 自動拾取閤適字體，當所選字體不支持文本書寫係統時。 |
這些中的任何標誌可以與以下標誌之一 OR 組閤：
| 常量 | 值 | 描述 |
|---|---|---|
QFont::PreferMatch
|
0x0020
|
首選準確匹配。字體匹配器將試著使用已指定的準確字體大小。 |
QFont::PreferQuality
|
0x0040
|
首選最佳品質字體。字體匹配器將使用字體支持的最接近標準點大小。 |
QFont::ForceIntegerMetrics
|
0x0400
|
強製在支持 Fractional (分數) 字體規格的字體引擎中，使用整數值。 |
Qt uses a weighting scale from 0 to 99 similar to, but not the same as, the scales used in Windows or CSS. A weight of 0 is ultralight, whilst 99 will be an extremely black.
此枚舉包含預定義的字體粗細：
| 常量 | 值 | 描述 |
|---|---|---|
QFont::Light
|
25
|
25 |
QFont::Normal
|
50
|
50 |
QFont::DemiBold
|
63
|
63 |
QFont::Bold
|
75
|
75 |
QFont::Black
|
87
|
87 |
使用應用程序默認字體，構造字體對象。
另請參閱 QApplication::setFont () 和 QApplication::font ().
構造字體對象采用指定 family , pointSize , weight and italic 設置。
若 pointSize is zero or negative, the point size of the font is set to a system-dependent default value. Generally, this is 12 points, except on Symbian where it is 7 points.
The family 名稱還可以可選包括代工廠名稱，如 Helvetica[Cronyx]。若 family 可以從多個代工廠獲得但未指定代工廠，可以選擇任意代工廠。若係列不可用，將設置係列使用 字體匹配 算法。
另請參閱 Weight , setFamily (), setPointSize (), setWeight (), setItalic (), setStyleHint ()，和 QApplication::font ().
構造字體從 font 為用於描繪設備 pd .
構造副本字體為 font .
銷毀字體對象並釋放所有分配資源。
返迴 true 若 weight () 值大於 QFont::Normal ；否則返迴 false。
另請參閱 weight (), setBold ()，和 QFontInfo::bold ().
返迴字體的當前大寫類型。
該函數在 Qt 4.4 引入。
另請參閱 setCapitalization ().
返迴當前樣式提示對應的係列名稱。
另請參閱 StyleHint , styleHint ()，和 setStyleHint ().
Returns true if a window system font exactly matching the settings of this font is available.
另請參閱 QFontInfo .
返迴請求的字體係列名，即：在構造函數中設置或最後一次調用 setFont() 的名稱。
另請參閱 setFamily (), substitutes ()，和 substitute ().
Returns true if fixed pitch has been set; otherwise returns false.
另請參閱 setFixedPitch () 和 QFontInfo::fixedPitch ().
Returns the handle to the primary FreeType face of the font. If font merging is not disabled a QFont can contain several physical fonts.
Returns 0 if the font does not contain a FreeType face.
注意： This function is only available on platforms that provide the FreeType library; i.e., X11 and some Embedded Linux platforms.
設置此字體以匹配描述 descrip . The description is a comma-separated list of the font attributes, as returned by toString ().
另請參閱 toString ().
Returns the window system handle to the font, for low-level access. Using this function is not portable.
返迴目前采用此字體，渲染字形的首選提示級彆。
該函數在 Qt 4.8 引入。
另請參閱 setHintingPreference ().
[static]
void
QFont::
insertSubstitution
(const
QString
&
familyName
, const
QString
&
substituteName
)
插入 substituteName 進代入錶為係列 familyName .
另請參閱 insertSubstitutions (), removeSubstitution (), substitutions (), substitute ()，和 substitutes ().
[static]
void
QFont::
insertSubstitutions
(const
QString
&
familyName
, const
QStringList
&
substituteNames
)
Inserts the list of families substituteNames into the substitution list for familyName .
另請參閱 insertSubstitution (), removeSubstitution (), substitutions ()，和 substitute ().
Returns true if this font and f are copies of each other, i.e. one of them was created as a copy of the other and neither has been modified since. This is much stricter than equality.
另請參閱 operator= () 和 operator== ().
返迴 true 若 style () of the font is not QFont::StyleNormal
Returns true if kerning should be used when drawing text with this font.
另請參閱 setKerning ().
Returns the font's key, a textual representation of a font. It is typically used as the key for a cache or dictionary of fonts.
另請參閱 QMap .
返迴 LastResort (最後手段) 字體係列名稱。
The current implementation tries a wide variety of common fonts, returning the first one it finds. Is is possible that no family is found in which case an empty string is returned.
另請參閱 lastResortFont ().
Returns a "last resort" font name for the font matching algorithm. This is used if the last resort family is not available. It will always return a name, if necessary returning something like "fixed" or "system".
The current implementation tries a wide variety of common fonts, returning the first one it finds. The implementation may change at any time, but this function will always return a string containing something.
It is theoretically possible that there really isn't a lastResortFont() in which case Qt will abort with an error message. We have not been able to identify a case where this happens. Please report it as a bug if it does, preferably with a list of the fonts you have installed.
另請參閱 lastResortFamily () 和 rawName ().
返迴字體的字母間距。
該函數在 Qt 4.4 引入。
另請參閱 setLetterSpacing (), letterSpacingType ()，和 setWordSpacing ().
返迴用於字母間距的間距類型。
該函數在 Qt 4.4 引入。
另請參閱 letterSpacing (), setLetterSpacing ()，和 setWordSpacing ().
Returns an ATSUFontID
Returns true if overline has been set; otherwise returns false.
另請參閱 setOverline ().
返迴字體的像素大小，若它有設置采用 setPixelSize ()。返迴 -1 若大小的設置是采用 setPointSize () 或 setPointSizeF ().
另請參閱 setPixelSize (), pointSize (), QFontInfo::pointSize ()，和 QFontInfo::pixelSize ().
返迴字體的點大小。返迴 -1 若以像素為單位指定字體大小。
另請參閱 setPointSize () 和 pointSizeF ().
返迴字體的點大小。返迴 -1 若以像素為單位指定字體大小。
另請參閱 pointSize (), setPointSizeF (), pixelSize (), QFontInfo::pointSize ()，和 QFontInfo::pixelSize ().
Returns true if raw mode is used for font name matching; otherwise returns false.
另請參閱 setRawMode () 和 rawName ().
Returns the name of the font within the underlying window system.
On X11, this function will return an empty string if Qt is built with FontConfig support; otherwise the XLFD (X Logical Font Description) is returned.
Using the return value of this function is usually not portable .
另請參閱 setRawName ().
[static]
void
QFont::
removeSubstitution
(const
QString
&
familyName
)
移除所有代入為 familyName .
另請參閱 insertSubstitutions (), insertSubstitution (), substitutions ()，和 substitute ().
返迴新的 QFont that has attributes copied from other that have not been previously set on this font.
若 enable 為 true，將字體的權重設為 QFont::Bold ；否則將精細設為 QFont::Normal .
對於更精細粗體控製，使用 setWeight ().
將此字體中文本的首字母大小寫設為 caps .
字體大寫使文本以選中大寫模式齣現。
該函數在 Qt 4.4 引入。
另請參閱 capitalization ().
設置字體的係列名稱。名稱不區分大小寫且可能包括齣廠名稱。
The family 名稱還可以可選包括代工廠名稱，如 Helvetica[Cronyx]。若 family 可以從多個代工廠獲得但未指定代工廠，可以選擇任意代工廠。若係列不可用，將設置係列使用 字體匹配 算法。
另請參閱 family (), setStyleHint ()，和 QFontInfo .
若 enable 為 true，設置固定間距開；否則設置固定間距關。
另請參閱 fixedPitch () 和 QFontInfo .
將字形提示級彆首選設為 hintingPreference . This is a hint to the underlying font rendering system to use a certain level of hinting, and has varying support across platforms. See the table in the documentation for QFont::HintingPreference 瞭解更多細節。
默認提示首選 QFont::PreferDefaultHinting .
該函數在 Qt 4.8 引入。
另請參閱 hintingPreference ().
設置 style () 為字體到 QFont::StyleItalic if enable 為 true；否則樣式被設為 QFont::StyleNormal .
為此字體啓用字距調整，若 enable 為 true；否則禁用它。默認情況下，字距調整是啓用的。
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.
另請參閱 kerning () 和 QFontMetrics .
Sets the letter spacing for the font to spacing and the type of spacing to type .
Letter spacing changes the default spacing between individual letters in the font. The spacing between the letters can be made smaller as well as larger.
該函數在 Qt 4.4 引入。
另請參閱 letterSpacing (), letterSpacingType ()，和 setWordSpacing ().
若 enable 為 True，設置上劃綫打開；否則，設置上劃綫關閉。
另請參閱 overline () 和 QFontInfo .
將字體大小設為 pixelSize 像素。
使用此函數使字體設備從屬。使用 setPointSize () 或 setPointSizeF () 以按設備無關方式設置字體大小。
另請參閱 pixelSize ().
將點大小設為 pointSize 。點大小必須大於 0。
另請參閱 pointSize () 和 setPointSizeF ().
將點大小設為 pointSize 。點大小必須大於 0。請求精度不可能在所有平颱中達成。
另請參閱 pointSizeF (), setPointSize ()，和 setPixelSize ().
若 enable is true, turns raw mode on; otherwise turns raw mode off. This function only has an effect under X11.
If raw mode is enabled, Qt will search for an X font with a complete font name matching the family name, ignoring all other values set for the QFont . If the font name matches several fonts, Qt will use the first font returned by X. QFontInfo cannot be used to fetch information about a QFont using raw mode (it will return the values set in the QFont for all parameters, including the family name).
警告： Do not use raw mode unless you really, really need it! In most (if not all) cases, setRawName () is a much better choice.
另請參閱 rawMode () 和 setRawName ().
Sets a font by its system specific name. The function is particularly useful under X, where system font settings (for example X resources) are usually available in XLFD (X Logical Font Description) form only. You can pass an XLFD as name to this function.
A font set with setRawName() is still a full-featured QFont . It can be queried (for example with italic ()) or modified (for example with setItalic ()) and is therefore also suitable for rendering rich text.
If Qt's internal font database cannot resolve the raw name, the font becomes a raw font with name as its family.
Note that the present implementation does not handle wildcards in XLFDs well, and that font aliases (file
fonts.alias
in the font directory on X11) are not supported.
另請參閱 rawName (), setRawMode ()，和 setFamily ().
設置字體的拉伸因子。
The stretch factor changes the width of all characters in the font by factor 百分比。例如，設置 factor to 150 results in all characters in the font being 1.5 times (ie. 150%) wider. The default stretch factor is 100. The minimum stretch factor is 1, and the maximum stretch factor is 4000.
拉伸因子僅應用於輪廓字體。位圖字體會忽略拉伸因子。
NOTE: QFont cannot stretch XLFD fonts. When loading XLFD fonts on X11, the stretch factor is matched against a predefined set of values for the SETWIDTH_NAME field of the XLFD.
另請參閱 stretch () 和 QFont::Stretch .
若 enable 為 true，設置刪除綫打開；否則，設置刪除綫關閉。
另請參閱 strikeOut () 和 QFontInfo .
將字體樣式設為 style .
另請參閱 style (), italic ()，和 QFontInfo .
將樣式提示和對策設為 hint and strategy ，分彆。
If these aren't set explicitly the style hint will default to
AnyStyle
and the style strategy to
PreferDefault
.
Qt does not support style hints on X11 since this information is not provided by the window system.
另請參閱 StyleHint , styleHint (), StyleStrategy , styleStrategy ()，和 QFontInfo .
Sets the style name of the font to the given styleName . When set, other style properties like style () 和 weight () will be ignored for font matching.
該函數在 Qt 4.8 引入。
另請參閱 styleName ().
將字體樣式對策設為 s .
另請參閱 styleStrategy () 和 QFont::StyleStrategy .
若 enable 為 true，設置下劃綫開；否則設置下劃綫關。
另請參閱 underline () 和 QFontInfo .
Sets the weight the font to weight , which should be a value from the QFont::Weight 枚舉。
將字體單詞間距設為 spacing .
單詞間距改變單個單詞之間的默認間距。正值按相應像素數量遞增單詞間距，而負值相應遞減單詞間間距。
單詞間距不適用於書寫係統，其單個單詞不按空白分隔。
該函數在 Qt 4.4 引入。
另請參閱 wordSpacing () 和 setLetterSpacing ().
返迴字體的拉伸因子。
另請參閱 setStretch ().
Returns true if strikeout has been set; otherwise returns false.
另請參閱 setStrikeOut ().
返迴字體的樣式。
另請參閱 setStyle ().
返迴 StyleHint .
樣式提示影響 字體匹配 算法。見 QFont::StyleHint 瞭解可用提示列錶。
另請參閱 setStyleHint (), QFont::StyleStrategy ，和 QFontInfo::styleHint ().
Returns the requested font style name, it will be used to match the font with irregular styles (that can't be normalized in other style properties). It depends on system font support, thus only works for Mac OS X and X11 so far. On Windows irregular styles will be added as separate font families so there is no need for this.
該函數在 Qt 4.8 引入。
另請參閱 setStyleName (), setFamily ()，和 setStyle ().
返迴 StyleStrategy .
樣式對策影響 字體匹配 算法。見 QFont::StyleStrategy 瞭解可用戰略列錶。
另請參閱 setStyleStrategy (), setStyleHint ()，和 QFont::StyleHint .
[static]
QString
QFont::
substitute
(const
QString
&
familyName
)
返迴要使用的第一係列名稱每當 familyName 有指定。查找不區分大小寫。
若沒有代入對於 familyName , familyName 被返迴。
要獲得代入列錶使用 substitutes ().
另請參閱 setFamily (), insertSubstitutions (), insertSubstitution ()，和 removeSubstitution ().
[static]
QStringList
QFont::
substitutes
(const
QString
&
familyName
)
返迴要使用的係列名稱列錶每當 familyName 有指定。查找不區分大小寫。
若沒有代入對於 familyName ，返迴空列錶。
另請參閱 substitute (), insertSubstitutions (), insertSubstitution ()，和 removeSubstitution ().
[static]
QStringList
QFont::
substitutions
()
返迴代入係列名稱的排序列錶。
另請參閱 insertSubstitution (), removeSubstitution ()，和 substitute ().
返迴字體的描述。描述是逗號分隔的屬性列錶，非常適閤用於 QSettings .
另請參閱 fromString ().
Returns true if underline has been set; otherwise returns false.
另請參閱 setUnderline ().
Returns the weight of the font which is one of the enumerated values from QFont::Weight .
另請參閱 setWeight (), Weight ，和 QFontInfo .
返迴字體的單詞間距。
該函數在 Qt 4.4 引入。
另請參閱 setWordSpacing () 和 setLetterSpacing ().
返迴字體作為 QVariant
Returns true if this font is different from f ；否則返迴 false。
Two QFonts are considered to be different if their font attributes are different. If rawMode () is enabled for both fonts, only the family fields are compared.
另請參閱 operator== ().
提供任意比較為此字體和字體 f . All that is guaranteed is that the operator returns false if both fonts are equal and that (f1 < f2) == !(f2 < f1) if the fonts are not equal.
此函數在某些情況下很有用，例如，若想要使用 QFont 對象作為鍵在 QMap .
另請參閱 operator== (), operator!= ()，和 isCopyOf ().
賦值 font 到此字體並返迴它的引用。
Returns true if this font is equal to f ；否則返迴 false。
Two QFonts are considered equal if their font attributes are equal. If rawMode () is enabled for both fonts, only the family fields are compared.
另請參閱 operator!= () 和 isCopyOf ().
寫入字體 font 到數據流 s (toString() 寫入到文本流)。
另請參閱 QDataStream 運算符格式 .
讀取字體 font 從數據流 s (fromString() 讀取自文本流)。
另請參閱 QDataStream 運算符格式 .