QFontDatabase Class Reference · PyQt4 中文文檔

# QFontDatabase Class Reference ## [[QtGui](index.htm) module] 該QFontDatabase類提供有關在底層窗口系統中可用的字體信息。[More...](#details) ### Types * `enum WritingSystem { Any, Latin, Greek, Cyrillic, ..., Nko }` ### Methods * `__init__ (self)` * `__init__ (self, QFontDatabase)` * `bool bold (self, QString?family, QString?style)` * `QStringList families (self, WritingSystem?writingSystem?=?QFontDatabase.Any)` * `QFont font (self, QString?family, QString?style, int?pointSize)` * `bool isBitmapScalable (self, QString?family, QString?style?=?QString())` * `bool isFixedPitch (self, QString?family, QString?style?=?QString())` * `bool isScalable (self, QString?family, QString?style?=?QString())` * `bool isSmoothlyScalable (self, QString?family, QString?style?=?QString())` * `bool italic (self, QString?family, QString?style)` * `list-of-int pointSizes (self, QString?family, QString?style?=?QString())` * `list-of-int smoothSizes (self, QString?family, QString?style)` * `QStringList styles (self, QString?family)` * `QString styleString (self, QFont?font)` * `QString styleString (self, QFontInfo?fontInfo)` * `int weight (self, QString?family, QString?style)` * `list-of-QFontDatabase.WritingSystem writingSystems (self)` * `list-of-QFontDatabase.WritingSystem writingSystems (self, QString?family)` ### Static Methods * `int addApplicationFont (QString?fileName)` * `int addApplicationFontFromData (QByteArray?fontData)` * `QStringList applicationFontFamilies (int?id)` * `bool removeAllApplicationFonts ()` * `bool removeApplicationFont (int?id)` * `list-of-int standardSizes ()` * `bool supportsThreadedFontRendering ()` * `QString writingSystemName (WritingSystem?writingSystem)` * `QString writingSystemSample (WritingSystem?writingSystem)` * * * ## Detailed Description 該QFontDatabase類提供有關在底層窗口系統中可用的字體信息。這個類最常見的用途是在數據庫中查詢字體的列表[families](qfontdatabase.html#families)（）和用于[pointSizes](qfontdatabase.html#pointSizes)（）和[styles](qfontdatabase.html#styles)（），可為每個家庭。一種替代[pointSizes](qfontdatabase.html#pointSizes)（）是[smoothSizes](qfontdatabase.html#smoothSizes)（）返回的大小在其中一個給定的系列和樣式看起來有吸引力。如果字體家族可從兩個或兩個以上的代工廠代工名稱包含在家庭名稱，例如： “黑體[點擊]”和“黑體[ Cronyx ]” 。當您指定一個家庭，你可以使用舊的復姓“代工家庭”的形式或方括號內的“家庭[鑄造]”格式，例如： “ Cronyx -黑體”或“宋體[ Cronyx ]” 。如果家里有一個鑄造它使用括號內的格式總是返回，這與返回的值的情況下[families](qfontdatabase.html#families)（）。該[font](qfontdatabase.html#font)（）函數返回一個[QFont](qfont.html)給一個家庭，樣式和點大小。一個家庭和樣式的組合可以進行檢查，看它是否是[italic](qfontdatabase.html#italic)（）或[bold](qfontdatabase.html#bold)（），并檢索其[weight](qfontdatabase.html#weight)（）。同樣，我們可以調用[isBitmapScalable](qfontdatabase.html#isBitmapScalable)（）[isSmoothlyScalable](qfontdatabase.html#isSmoothlyScalable)（）[isScalable](qfontdatabase.html#isScalable)（）和[isFixedPitch](qfontdatabase.html#isFixedPitch)（）。使用[styleString](qfontdatabase.html#styleString)（）來獲取一個樣式的文本版本。該QFontDatabase類還支持一些靜態的功能，例如，[standardSizes](qfontdatabase.html#standardSizes)（）。您可以使用檢索書寫系統的描述[writingSystemName](qfontdatabase.html#writingSystemName)（），和一個在書寫系統的字符樣本[writingSystemSample](qfontdatabase.html#writingSystemSample)（）。例如： ``` QFontDatabase database; [QTreeWidget](qtreewidget.html) fontTree; fontTree.setColumnCount(2); fontTree.setHeaderLabels([QStringList](qstringlist.html)() << "Font" << "Smooth Sizes"); foreach (const [QString](qstring.html) &family, database.families()) { [QTreeWidgetItem](qtreewidgetitem.html) *familyItem = new [QTreeWidgetItem](qtreewidgetitem.html)(&fontTree); familyItem->setText(0, family); foreach (const [QString](qstring.html) &style, database.styles(family)) { [QTreeWidgetItem](qtreewidgetitem.html) *styleItem = new [QTreeWidgetItem](qtreewidgetitem.html)(familyItem); styleItem->setText(0, style); [QString](qstring.html) sizes; foreach (int points, database.smoothSizes(family, style)) sizes += [QString](qstring.html).number(points) + " "; styleItem->setText(1, sizes.trimmed()); } } ``` 此示例獲取字體系列，樣式為每個家庭的名單，以及可用于家庭和風格的各種組合的點尺寸列表中，在樹視圖中顯示此信息。 * * * ## Type Documentation ``` QFontDatabase.WritingSystem ``` | Constant | Value | Description | | --- | --- | --- | | `QFontDatabase.Any` | `0` | ? | | `QFontDatabase.Latin` | `1` | ? | | `QFontDatabase.Greek` | `2` | ? | | `QFontDatabase.Cyrillic` | `3` | ? | | `QFontDatabase.Armenian` | `4` | ? | | `QFontDatabase.Hebrew` | `5` | ? | | `QFontDatabase.Arabic` | `6` | ? | | `QFontDatabase.Syriac` | `7` | ? | | `QFontDatabase.Thaana` | `8` | ? | | `QFontDatabase.Devanagari` | `9` | ? | | `QFontDatabase.Bengali` | `10` | ? | | `QFontDatabase.Gurmukhi` | `11` | ? | | `QFontDatabase.Gujarati` | `12` | ? | | `QFontDatabase.Oriya` | `13` | ? | | `QFontDatabase.Tamil` | `14` | ? | | `QFontDatabase.Telugu` | `15` | ? | | `QFontDatabase.Kannada` | `16` | ? | | `QFontDatabase.Malayalam` | `17` | ? | | `QFontDatabase.Sinhala` | `18` | ? | | `QFontDatabase.Thai` | `19` | ? | | `QFontDatabase.Lao` | `20` | ? | | `QFontDatabase.Tibetan` | `21` | ? | | `QFontDatabase.Myanmar` | `22` | ? | | `QFontDatabase.Georgian` | `23` | ? | | `QFontDatabase.Khmer` | `24` | ? | | `QFontDatabase.SimplifiedChinese` | `25` | ? | | `QFontDatabase.TraditionalChinese` | `26` | ? | | `QFontDatabase.Japanese` | `27` | ? | | `QFontDatabase.Korean` | `28` | ? | | `QFontDatabase.Vietnamese` | `29` | ? | | `QFontDatabase.Symbol` | `30` | ? | | `QFontDatabase.Other` | `Symbol` | （同符號） | | `QFontDatabase.Ogham` | ？ | ? | | `QFontDatabase.Runic` | ？ | ? | | `QFontDatabase.Nko` | ？ | ? | * * * ## Method Documentation ``` QFontDatabase.__init__ (self) ``` 創建字體數據庫對象。 ``` QFontDatabase.__init__ (self, QFontDatabase) ``` ``` int QFontDatabase.addApplicationFont (QString?fileName) ``` 從指定的文件加載字體_fileName_并使得它的應用程序可用。一個ID被返回的，可用于與再除去字體[removeApplicationFont](qfontdatabase.html#removeApplicationFont)（）或檢索包含在字體族名稱的列表。該函數返回-1，如果無法加載的字體。目前只有TrueType字體， TrueType字體的集合，和OpenType字體的支持。 **Note:**增加對UNIX/X11平臺上的應用程序的字體而不fontconfig的目前不支持。 **Note:**在Symbian ，字體系列名稱被截斷為20個字符的長度。這個函數中引入了Qt 4.2中。 **See also** [addApplicationFontFromData](qfontdatabase.html#addApplicationFontFromData)（）[applicationFontFamilies](qfontdatabase.html#applicationFontFamilies)（）和[removeApplicationFont](qfontdatabase.html#removeApplicationFont)（）。 ``` int QFontDatabase.addApplicationFontFromData (QByteArray?fontData) ``` 加載從指定的二進制數據的字體_fontData_并使得它的應用程序可用。一個ID被返回的，可用于與再除去字體[removeApplicationFont](qfontdatabase.html#removeApplicationFont)（）或檢索包含在字體族名稱的列表。該函數返回-1，如果無法加載的字體。目前，只有TrueType字體和TrueType字體集合的支持。 **Note:**增加對UNIX/X11平臺上的應用程序的字體而不fontconfig的目前不支持。 **Note:**在Symbian ，字體系列名稱被截斷為20個字符的長度。這個函數中引入了Qt 4.2中。 **See also** [addApplicationFont](qfontdatabase.html#addApplicationFont)（）[applicationFontFamilies](qfontdatabase.html#applicationFontFamilies)（）和[removeApplicationFont](qfontdatabase.html#removeApplicationFont)（）。 ``` QStringList QFontDatabase.applicationFontFamilies (int?id) ``` 返回字體系列的確定給定應用程序的字體列表_id_。這個函數中引入了Qt 4.2中。 **See also** [addApplicationFont](qfontdatabase.html#addApplicationFont)（）和[addApplicationFontFromData](qfontdatabase.html#addApplicationFontFromData)（）。 ``` bool QFontDatabase.bold (self, QString?family, QString?style) ``` 返回True如果有家庭的字體_family_和風格_style_是大膽的，否則返回False 。 **See also** [italic](qfontdatabase.html#italic)（）和[weight](qfontdatabase.html#weight)（）。 ``` QStringList QFontDatabase.families (self, WritingSystem?writingSystem?=?QFontDatabase.Any) ``` 返回其支持的可用字體家族的排序列表_writingSystem_。如果一個家庭中存在幾個代工廠，該字體返回的名稱的形式為“家庭[鑄造]” 。例如：“時代[點擊]” ， “時代[ Cronyx ]” ， “帕拉天奴” 。 **See also** [writingSystems](qfontdatabase.html#writingSystems)（）。 ``` QFont QFontDatabase.font (self, QString?family, QString?style, int?pointSize) ``` [](qfont.html) [返回](qfont.html)[QFont](qfont.html)對象有家庭_family_，式_style_和點大小_pointSize_。如果可以創建沒有匹配的字體，一[QFont](qfont.html)使用該應用程序的默認字體對象被返回。 ``` bool QFontDatabase.isBitmapScalable (self, QString?family, QString?style?=?QString()) ``` 返回True如果有家庭的字體_family_和風格_style_是一個可擴展的位圖字體，否則返回False 。縮放的位圖字體，通常會產生不吸引人幾乎不可讀的結果，因為該字體的像素進行縮放。如果您需要縮放位圖字體，最好是將其擴展到返回的固定尺寸之一[smoothSizes](qfontdatabase.html#smoothSizes)（）。 **See also** [isScalable](qfontdatabase.html#isScalable)（）和[isSmoothlyScalable](qfontdatabase.html#isSmoothlyScalable)（）。 ``` bool QFontDatabase.isFixedPitch (self, QString?family, QString?style?=?QString()) ``` 返回True如果有家庭的字體_family_和風格_style_是固定攤位，否則返回False 。 ``` bool QFontDatabase.isScalable (self, QString?family, QString?style?=?QString()) ``` 返回True如果有家庭的字體_family_和風格_style_具有可擴展性，否則返回False 。 **See also** [isBitmapScalable](qfontdatabase.html#isBitmapScalable)（）和[isSmoothlyScalable](qfontdatabase.html#isSmoothlyScalable)（）。 ``` bool QFontDatabase.isSmoothlyScalable (self, QString?family, QString?style?=?QString()) ``` 返回True如果有家庭的字體_family_和風格_style_為順利擴展性，否則返回False 。如果這個函數返回True ，它的安全擴展該字體到任何尺寸，結果總是看起來有吸引力。 **See also** [isScalable](qfontdatabase.html#isScalable)（）和[isBitmapScalable](qfontdatabase.html#isBitmapScalable)（）。 ``` bool QFontDatabase.italic (self, QString?family, QString?style) ``` 返回True如果有家庭的字體_family_和風格_style_是斜體，否則返回False 。 **See also** [weight](qfontdatabase.html#weight)（）和[bold](qfontdatabase.html#bold)（）。 ``` list-of-int QFontDatabase.pointSizes (self, QString?family, QString?style?=?QString()) ``` 返回點尺寸的可用于與所述給定字體的列表_family_和_style_。該列表可能是空的。 **See also** [smoothSizes](qfontdatabase.html#smoothSizes)（）和[standardSizes](qfontdatabase.html#standardSizes)（）。 ``` bool QFontDatabase.removeAllApplicationFonts () ``` 刪除所有應用程序的本地字體先前添加的使用[addApplicationFont](qfontdatabase.html#addApplicationFont)（）和[addApplicationFontFromData](qfontdatabase.html#addApplicationFontFromData)（）。返回True如果字體卸載成功，否則返回False 。這個函數中引入了Qt 4.2中。 **See also** [removeApplicationFont](qfontdatabase.html#removeApplicationFont)（）[addApplicationFont](qfontdatabase.html#addApplicationFont)（）和[addApplicationFontFromData](qfontdatabase.html#addApplicationFontFromData)（）。 ``` bool QFontDatabase.removeApplicationFont (int?id) ``` 刪除確定以前加載的應用程序字體_id_。返回True如果字體卸載成功，否則返回False 。這個函數中引入了Qt 4.2中。 **See also** [removeAllApplicationFonts](qfontdatabase.html#removeAllApplicationFonts)（）[addApplicationFont](qfontdatabase.html#addApplicationFont)（）和[addApplicationFontFromData](qfontdatabase.html#addApplicationFontFromData)（）。 ``` list-of-int QFontDatabase.smoothSizes (self, QString?family, QString?style) ``` 返回一個字體的磅值與給定_family_和_style_這將看起來有吸引力。該列表可能是空的。對于非可縮放字體和位圖可縮放字體，這個功能相當于[pointSizes](qfontdatabase.html#pointSizes)（）。 **See also** [pointSizes](qfontdatabase.html#pointSizes)（）和[standardSizes](qfontdatabase.html#standardSizes)（）。 ``` list-of-int QFontDatabase.standardSizes () ``` 返回標準字體大小的列表。 **See also** [smoothSizes](qfontdatabase.html#smoothSizes)（）和[pointSizes](qfontdatabase.html#pointSizes)（）。 ``` QStringList QFontDatabase.styles (self, QString?family) ``` 返回的款式可供字體系列列表_family_。一些示例風格： “輕” ， “輕斜體” ， “粗體” ， “斜” ， “黛咪” 。該列表可能是空的。 **See also** [families](qfontdatabase.html#families)（）。 ``` QString QFontDatabase.styleString (self, QFont?font) ``` 返回描述的風格字符串_font_。例如， “粗斜體” ， “粗體” ， “斜體”或“正常” 。一個空字符串可以被返回。 ``` QString QFontDatabase.styleString (self, QFontInfo?fontInfo) ``` 返回描述的風格字符串_fontInfo_。例如， “粗斜體” ， “粗體” ， “斜體”或“正常” 。一個空字符串可以被返回。 ``` bool QFontDatabase.supportsThreadedFontRendering () ``` 如果字體渲染支持GUI線程，否則為False以外，則返回True 。換句話說，假返回值意味著所有[QPainter.drawText](qpainter.html#drawText)（） GUI線程之外調用不會產生可讀的輸出。此功能被引入Qt的4.4 。 **See also** [Painting In Threads](index.htm#painting-in-threads)。 ``` int QFontDatabase.weight (self, QString?family, QString?style) ``` 返回具有家族字體的粗細_family_和風格_style_。如果沒有這樣的家庭和樣式的組合，則返回-1 。 **See also** [italic](qfontdatabase.html#italic)（）和[bold](qfontdatabase.html#bold)（）。 ``` QString QFontDatabase.writingSystemName (WritingSystem?writingSystem) ``` 返回名稱_writingSystem_（例如，用于顯示在對話框的用戶）。 ``` list-of-QFontDatabase.WritingSystem QFontDatabase.writingSystems (self) ``` 返回可用的書寫系統的排序列表。這是從有關系統上所有已安裝的字體的信息生成列表。 **See also** [families](qfontdatabase.html#families)（）。 ``` list-of-QFontDatabase.WritingSystem QFontDatabase.writingSystems (self, QString?family) ``` 返回書寫系統由給定的字體支持的排序列表_family_。 **See also** [families](qfontdatabase.html#families)（）。 ``` QString QFontDatabase.writingSystemSample (WritingSystem?writingSystem) ``` 返回一個字符串，從樣品字符_writingSystem_。