QFontMetrics Class Reference · PyQt4 中文文檔

# QFontMetrics Class Reference ## [[QtGui](index.htm) module] 該QFontMetrics類提供的字體度量信息。[More...](#details) ### Methods * `__init__ (self, QFont)` * `__init__ (self, QFont, QPaintDevice?pd)` * `__init__ (self, QFontMetrics)` * `int ascent (self)` * `int averageCharWidth (self)` * `QRect boundingRect (self, QChar)` * `QRect boundingRect (self, QString?text)` * `QRect boundingRect (self, QRect?rect, int?flags, QString?text, int?tabStops?=?0, list-of-int?tabArray?=?0)` * `QRect boundingRect (self, int?x, int?y, int?width, int?height, int?flags, QString?text, int?tabStops?=?0, list-of-int?tabArray?=?0)` * `QRect boundingRectChar (self, QChar)` * `int charWidth (self, QString?str, int?pos)` * `int descent (self)` * `QString elidedText (self, QString?text, Qt.TextElideMode?mode, int?width, int?flags?=?0)` * `int height (self)` * `bool inFont (self, QChar)` * `bool inFontUcs4 (self, int?character)` * `int leading (self)` * `int leftBearing (self, QChar)` * `int lineSpacing (self)` * `int lineWidth (self)` * `int maxWidth (self)` * `int minLeftBearing (self)` * `int minRightBearing (self)` * `int overlinePos (self)` * `int rightBearing (self, QChar)` * `QSize size (self, int?flags, QString?text, int?tabStops?=?0, list-of-int?tabArray?=?0)` * `int strikeOutPos (self)` * `QRect tightBoundingRect (self, QString?text)` * `int underlinePos (self)` * `int width (self, QChar)` * `int width (self, QString?text, int?length?=?-1)` * `int widthChar (self, QChar)` * `int xHeight (self)` ### Special Methods * `bool __eq__ (self, QFontMetrics?other)` * `bool __ne__ (self, QFontMetrics?other)` * * * ## Detailed Description 該QFontMetrics類提供的字體度量信息。 QFontMetrics函數計算字符和字符串給定字體的大小。有三種方法可以創建一個QFontMetrics對象： 1. 調用QFontMetrics構造帶[QFont](qfont.html)創建一個字體規格對象的屏幕兼容的字體，即字體不能為打印機字體。如果字體是后來改，字體規格對象_not_更新。（注：如果您使用的打印機字體返回的值可能是不準確的打印機字體并不總是那么訪問最近的屏幕字體時使用打印機字體提供。） 2. [QWidget.fontMetrics](qwidget.html#fontMetrics)（）返回的字體度量一個小部件的字體。這相當于QFontMetrics （插件 - \u003e字體（））。如果控件的字體是后來改，字體規格對象_not_更新。 3. [QPainter.fontMetrics](qpainter.html#fontMetrics)（）返回的字體規格為一個畫家的當前字體。如果畫家的字體后來改變，字體規格對象_not_更新。一旦創建，該對象提供了訪問字體，它的字符，并在字體渲染字符串的各個指標。有跡象表明，在字體上運行幾個功能：[ascent](qfontmetrics.html#ascent)（）[descent](qfontmetrics.html#descent)（）[height](qfontmetrics.html#height)（）[leading](qfontmetrics.html#leading)（）和[lineSpacing](qfontmetrics.html#lineSpacing)（）返回字體的基本大小屬性。該[underlinePos](qfontmetrics.html#underlinePos)（）[overlinePos](qfontmetrics.html#overlinePos)（）[strikeOutPos](qfontmetrics.html#strikeOutPos)（）和[lineWidth](qfontmetrics.html#lineWidth)（）函數，返回強調， overlines或撞擊出的字符的行的屬性。這些功能都是快。也有一些對集合中的字體字形的操作一些功能：[minLeftBearing](qfontmetrics.html#minLeftBearing)（）[minRightBearing](qfontmetrics.html#minRightBearing)（）和[maxWidth](qfontmetrics.html#maxWidth)（）。這些都是必然緩慢，我們建議避免他們，如果可能的。對于每一個字符，就可以得到其[width](qfontmetrics.html#width)（）[leftBearing](qfontmetrics.html#leftBearing)（）和[rightBearing](qfontmetrics.html#rightBearing)（），并找出是否是在使用字體[inFont](qfontmetrics.html#inFont)（）。您也可以把字符作為字符串，并使用字符串函數就可以了。字符串函數包括：[width](qfontmetrics.html#width)（），返回字符串的寬度以像素為單位（或點，用于打印機）[boundingRect](qfontmetrics.html#boundingRect)（）返回一個矩形足夠大，以包含所呈現的串，并[size](qfontmetrics.html#size)（），以返回該矩形的大小。例如： ``` [QFont](qfont.html) font("times", 24); QFontMetrics fm(font); int pixelsWide = fm.width("What's the width of this text?"); int pixelsHigh = fm.height(); ``` * * * ## Method Documentation ``` QFontMetrics.__init__ (self, QFont) ``` 構造一個字體規格對象為_font_。字體規格將與用于創建paintdevice兼容_font_。字體規格對象持有，在它被創建的時候被傳遞在構造函數中的字體的信息，并且不更新，如果字體的屬性后來改。使用[QFontMetrics](qfontmetrics.html)（常量[QFont](qfont.html)＆，[QPaintDevice](qpaintdevice.html)*）來獲取字體度量標準，具有一定的繪圖設備兼容。 ``` QFontMetrics.__init__ (self, QFont, QPaintDevice?pd) ``` 構造一個字體規格對象為_font_和_paintdevice_。字體規格將與通過paintdevice兼容。如果_paintdevice_為0時，度量將屏幕兼容的，即得。你得到，如果你使用的字體在繪制文本的指標[widgets](qwidget.html) or [pixmaps](qpixmap.html)，而不是在[QPicture](qpicture.html) or [QPrinter](qprinter.html)。字體規格對象持有，在它被創建的時候被傳遞在構造函數中的字體的信息，并且不更新，如果字體的屬性后來改。 ``` QFontMetrics.__init__ (self, QFontMetrics) ``` 構造的副本_fm_。 ``` int QFontMetrics.ascent (self) ``` 返回字體的上升。字體的上升是從基線到最高位置的字符延伸到距離。在實踐中，有些字體設計師打破了這個規則，如當他們把一個以上的口音就一個字之上，或者以適應異國的語言不同尋常的性格，所以它是可能的（雖然很少），這個值將是太小了。 **See also** [descent](qfontmetrics.html#descent)（）。 ``` int QFontMetrics.averageCharWidth (self) ``` 返回字形在字體的平均寬度。這個函數中引入了Qt 4.2中。 ``` QRect QFontMetrics.boundingRect (self, QChar) ``` [ 返回復蓋油墨的矩形，如果字符_ch_分別在坐標系的原點被繪制。請注意，邊框可能會延伸到（ 0 ， 0 ）（例如，斜體字體）的左側，該文本輸出可能復蓋_all_像素的邊界矩形。對于一個空格字符的矩形通常是空的。請注意，矩形通常既基線的上方和下方延伸。 ](qrect.html) [**Warning:**返回的矩形的寬度不是字符的超前寬度。使用boundingRect （常量](qrect.html)[QString](qstring.html)＆）或[width](qfontmetrics.html#width)（）來代替。 **See also** [width](qfontmetrics.html#width)（）。 ``` QRect QFontMetrics.boundingRect (self, QString?text) ``` [ 返回字符的邊框由指定的字符串中_text_。邊界矩形總是至少復蓋的像素集合的文本將涵蓋如果畫在（ 0 ， 0 ）。 ](qrect.html) [注意，邊框可以延伸到的（0，0 ），例如左斜體字體，返回的矩形的寬度可能比什么不同](qrect.html)[width](qfontmetrics.html#width)（）方法返回。如果你想知道字符串的超前寬度（布局彼此相鄰一組字符串），使用[width](qfontmetrics.html#width)（）來代替。換行符的處理方法與普通字符，_not_作為換行符。的邊界矩形的高度至少一樣大，返回的值[height](qfontmetrics.html#height)（）。 **See also** [width](qfontmetrics.html#width)（）[height](qfontmetrics.html#height)（）[QPainter.boundingRect](qpainter.html#boundingRect)（）和[tightBoundingRect](qfontmetrics.html#tightBoundingRect)（）。 ``` QRect QFontMetrics.boundingRect (self, QRect?rect, int?flags, QString?text, int?tabStops?=?0, list-of-int?tabArray?=?0) ``` [ 該_tabArray_參數也可能沒有。 ](qrect.html) ``` QRect QFontMetrics.boundingRect (self, int?x, int?y, int?width, int?height, int?flags, QString?text, int?tabStops?=?0, list-of-int?tabArray?=?0) ``` [ 該_tabArray_參數也可能沒有。 ](qrect.html) ``` QRect QFontMetrics.boundingRectChar (self, QChar) ``` [ ``` int QFontMetrics.charWidth (self, QString?str, int?pos) ``` ``` int QFontMetrics.descent (self) ``` 返回字體的血統。的下降是從基準線到最低點的字符延伸到距離。在實踐中，有些字體設計師打破了這個規則，如以容納在一個異乎尋常的語言不尋常的字符，所以它是可能的（雖然很少），該值將是太小。 ](qrect.html) [**See also**](qrect.html) [ascent](qfontmetrics.html#ascent)（）。 ``` QString QFontMetrics.elidedText (self, QString?text, Qt.TextElideMode?mode, int?width, int?flags?=?0) ``` 如果字符串_text_比更寬_width_，返回字符串的省略版本（即，在用“ ...... ”一個字符串）。否則，返回原始字符串。該_mode_參數指定的文本是省略左側（如“ ......技術” ），中間（例如，“風帆... CH” ），或在右邊（例如，“ TROL ...” ）。該_width_指定以像素為單位，而不是以字符。該_flags_參數是可選的，并且目前只支持[Qt.TextShowMnemonic](qt.html#TextFlag-enum)作為值。艾萊德的標志將按照[layout direction](qt.html#LayoutDirection-enum);這將是在右側的文本從右到左的布局，并在左側為從右到左的布局。請注意，這種行為是獨立的文本語言。這個函數中引入了Qt 4.2中。 ``` int QFontMetrics.height (self) ``` 返回字體的高度。這總是等于[ascent](qfontmetrics.html#ascent)（）+[descent](qfontmetrics.html#descent)（） 1 （ 1是基準線）。 **See also** [leading](qfontmetrics.html#leading)（）和[lineSpacing](qfontmetrics.html#lineSpacing)（）。 ``` bool QFontMetrics.inFont (self, QChar) ``` 返回True如果字符_ch_在字體中的有效字符，否則返回False 。 ``` bool QFontMetrics.inFontUcs4 (self, int?character) ``` 返回True如果給定的_character_編碼UCS-4/UTF-32是在字體中的有效字符，否則返回False 。此功能被引入Qt的4.8 。 ``` int QFontMetrics.leading (self) ``` 返回字體的領先。這是自然的線間間距。 **See also** [height](qfontmetrics.html#height)（）和[lineSpacing](qfontmetrics.html#lineSpacing)（）。 ``` int QFontMetrics.leftBearing (self, QChar) ``` 返回字符的左軸承_ch_在字體。左邊的軸承是從字符的邏輯原點的字符的最左邊的像素的右支距離。這個值是負的，如果該字符的像素延伸到邏輯原點的左邊。見寬（[QChar](qchar.html)）這個度量的圖形化描述。 **See also** [rightBearing](qfontmetrics.html#rightBearing)（）[minLeftBearing](qfontmetrics.html#minLeftBearing)（）和[width](qfontmetrics.html#width)（）。 ``` int QFontMetrics.lineSpacing (self) ``` 返回從一個基線的距離下。該值始終等于[leading](qfontmetrics.html#leading)（）+[height](qfontmetrics.html#height)（）。 **See also** [height](qfontmetrics.html#height)（）和[leading](qfontmetrics.html#leading)（）。 ``` int QFontMetrics.lineWidth (self) ``` 返回下劃線和刪除線，調整字體的點大小的寬度。 **See also** [underlinePos](qfontmetrics.html#underlinePos)（）[overlinePos](qfontmetrics.html#overlinePos)（）和[strikeOutPos](qfontmetrics.html#strikeOutPos)（）。 ``` int QFontMetrics.maxWidth (self) ``` 返回最寬的字符的字體的寬度。 ``` int QFontMetrics.minLeftBearing (self) ``` 返回字體的最小左軸承。這是字體中的所有字符的最小leftBearing （字符）。請注意，此功能可能會非常緩慢，如果字體很大。 **See also** [minRightBearing](qfontmetrics.html#minRightBearing)（）和[leftBearing](qfontmetrics.html#leftBearing)（）。 ``` int QFontMetrics.minRightBearing (self) ``` 返回字體的最低右側軸承。這是字體中的所有字符的最小rightBearing （字符）。請注意，此功能可能會非常緩慢，如果字體很大。 **See also** [minLeftBearing](qfontmetrics.html#minLeftBearing)（）和[rightBearing](qfontmetrics.html#rightBearing)（）。 ``` int QFontMetrics.overlinePos (self) ``` 返回從基線的距離，其中一個上劃線應繪制。 **See also** [underlinePos](qfontmetrics.html#underlinePos)（）[strikeOutPos](qfontmetrics.html#strikeOutPos)（）和[lineWidth](qfontmetrics.html#lineWidth)（）。 ``` int QFontMetrics.rightBearing (self, QChar) ``` 返回字符的右側軸承_ch_在字體。右軸承是由一個后續字符的邏輯原點的最右邊的像素的字符的左病房距離。這個值是負的，如果該字符的像素延伸到的權[width](qfontmetrics.html#width)的字符（）。 See [width](qfontmetrics.html#width)（）這個指標的圖形化描述。 **See also** [leftBearing](qfontmetrics.html#leftBearing)（）[minRightBearing](qfontmetrics.html#minRightBearing)（）和[width](qfontmetrics.html#width)（）。 ``` QSize QFontMetrics.size (self, int?flags, QString?text, int?tabStops?=?0, list-of-int?tabArray?=?0) ``` [ 該_tabArray_參數也可能沒有。返回該尺寸中的像素_text_。該_flags_參數是下列標志的按位或： ](qsize.html) [](qsize.html) * [](qsize.html)[Qt.TextSingleLine](qt.html#TextFlag-enum) ignores newline characters. * [Qt.TextExpandTabs](qt.html#TextFlag-enum) expands tabs (see below) * [Qt.TextShowMnemonic](qt.html#TextFlag-enum) interprets "&x" as <u>x</u>; i.e., underlined. * Qt.TextWordBreak breaks the text to fit the rectangle. If [Qt.TextExpandTabs](qt.html#TextFlag-enum)在設置_flags_，則：如果_tabArray_不為null ，它指定了一個0結尾的像素位置的選項卡順序，否則，如果_tabStops_是非零的，它被用作標籤間距（以像素為單位）。換行字符處理為換行符。盡管在不同的實際字符的高度，的邊界矩形的高度“是”， “是”是相同的。 **See also** [boundingRect](qfontmetrics.html#boundingRect)（）。 ``` int QFontMetrics.strikeOutPos (self) ``` 返回從基準線的距離，其中應繪制的三振線。 **See also** [underlinePos](qfontmetrics.html#underlinePos)（）[overlinePos](qfontmetrics.html#overlinePos)（）和[lineWidth](qfontmetrics.html#lineWidth)（）。 ``` QRect QFontMetrics.tightBoundingRect (self, QString?text) ``` [ 返回字符周圍緊張的邊界矩形被指定的字符串中_text_。邊界矩形總是至少復蓋的像素集合的文本將涵蓋如果畫在（ 0 ， 0 ）。 ](qrect.html) [注意，邊框可以延伸到的（0，0 ），例如左斜體字體，返回的矩形的寬度可能比什么不同](qrect.html)[width](qfontmetrics.html#width)（）方法返回。如果你想知道字符串的超前寬度（布局彼此相鄰一組字符串），使用[width](qfontmetrics.html#width)（）來代替。換行符的處理方法與普通字符，_not_作為換行符。 **Warning:**調用此方法將是非常緩慢的Windows 。此功能被引入Qt的4.3 。 **See also** [width](qfontmetrics.html#width)（）[height](qfontmetrics.html#height)（）和[boundingRect](qfontmetrics.html#boundingRect)（）。 ``` int QFontMetrics.underlinePos (self) ``` 返回從基線的距離，其中一個底線應繪制。 **See also** [overlinePos](qfontmetrics.html#overlinePos)（）[strikeOutPos](qfontmetrics.html#strikeOutPos)（）和[lineWidth](qfontmetrics.html#lineWidth)（）。 ``` int QFontMetrics.width (self, QChar) ``` 返回該寬度在所述第一像素_len_字符_text_。如果_len_是負的（默認值），則整個字符串被使用。注意，該值是_not_等于[boundingRect](qfontmetrics.html#boundingRect)（）寬（）;[boundingRect](qfontmetrics.html#boundingRect)（）返回一個描述像素的矩形這個字符串將復蓋而寬度（）返回的距離應在其中繪制的下一個字符串。 **See also** [boundingRect](qfontmetrics.html#boundingRect)（）。 ``` int QFontMetrics.width (self, QString?text, int?length?=?-1) ``` ``` int QFontMetrics.widthChar (self, QChar) ``` ``` int QFontMetrics.xHeight (self) ``` 返回字體的'X'的高度。這是常常但不總是相同的字符“X”的高度。 ``` bool QFontMetrics.__eq__ (self, QFontMetrics?other) ``` ``` bool QFontMetrics.__ne__ (self, QFontMetrics?other) ```