QStaticText Class Reference · PyQt4 中文文檔

# QStaticText Class Reference ## [[QtGui](index.htm) module] 該QStaticText類使文本時，其布局是很少更新的文字最優化的繪圖。[More...](#details) ### Types * `enum PerformanceHint { ModerateCaching, AggressiveCaching }` ### Methods * `__init__ (self)` * `__init__ (self, QString?text)` * `__init__ (self, QStaticText?other)` * `PerformanceHint performanceHint (self)` * `prepare (self, QTransform?matrix?=?QTransform(), QFont?font?=?QFont())` * `setPerformanceHint (self, PerformanceHint?performanceHint)` * `setText (self, QString?text)` * `setTextFormat (self, Qt.TextFormat?textFormat)` * `setTextOption (self, QTextOption?textOption)` * `setTextWidth (self, float?textWidth)` * `QSizeF size (self)` * `QString text (self)` * `Qt.TextFormat textFormat (self)` * `QTextOption textOption (self)` * `float textWidth (self)` ### Special Methods * `bool __eq__ (self, QStaticText)` * `bool __ne__ (self, QStaticText)` * * * ## Detailed Description 該QStaticText類使文本時，其布局是很少更新的文字最優化的繪圖。 QStaticText提供了一種方法來緩存布局數據為文本塊，以便它可以通過使用更高效地繪制比[QPainter.drawText](qpainter.html#drawText)其中（）的布局信息重新計算每個呼叫。該類主要提供情況的文字，其字體和畫家的轉變是靜態的在幾個油漆事件的優化。如果文本或它的布局發生變化，每一次迭代，[QPainter.drawText](qpainter.html#drawText)（）是更有效的替代方案，由于靜態文本的布局就必須重新計算，以利用新的狀態考慮在內。翻譯的畫家不會導致重新計算文本的布局，但會造成drawStaticText一個非常小的性能影響（）。改變畫家的轉換或畫家的字體的任何其他部分將導致重新計算的靜態文本的布局。這應該被避免盡可能多地最大限度地利用QStaticText的性能優勢。此外，只有仿射變換是由drawStaticText （）的支持。上投射畫家調用drawStaticText （）將執行比使用常規的drawText （）調用略差，所以這應該被避免。 ``` class MyWidget: public [QWidget](qwidget.html) { public: MyWidget([QWidget](qwidget.html) *parent = 0) : [QWidget](qwidget.html)(parent), m_staticText("This is static text") protected: void paintEvent([QPaintEvent](qpaintevent.html) *) { [QPainter](qpainter.html) painter(this); painter.drawStaticText(0, 0, m_staticText); } private: QStaticText m_staticText; }; ``` 該QStaticText類可以用來模仿的行為[QPainter.drawText](qpainter.html#drawText)（）到一個特定的點，沒有界限，也當[QPainter.drawText](qpainter.html#drawText)（）被調用矩形邊框。如果不需要矩形邊框，創建一個QStaticText對象沒有設定一個首選的文本的寬度。那么文本將佔據一行。如果您在QStaticText對象上設置一個文本的寬度，這將勢必文本。該文本將被格式化，這樣行不超過給定的寬度。文本寬度為QStaticText設置將不會自動被用于裁剪。為了實現裁剪除了換行符，使用[QPainter.setClipRect](qpainter.html#setClipRect)（）。文字的位置是由傳遞給該參數決定[QPainter.drawStaticText](qpainter.html#drawStaticText)（），可以從呼叫改變對性能的影響微乎其微打電話。為了更加方便，可以使用所支持的HTML子集，以應用格式的文本[QTextDocument](qtextdocument.html)。 QStaticText會嘗試猜測輸入文本的使用格式[Qt.mightBeRichText](qt.html#mightBeRichText)（），并把它解釋為富文本，如果這個函數返回True。要強制QStaticText以顯示其內容為純文本或富文本，使用功能[QStaticText.setTextFormat](qstatictext.html#setTextFormat)（），并通過在分別[Qt.PlainText](qt.html#TextFormat-enum)和[Qt.RichText](qt.html#TextFormat-enum)。 QStaticText只能代表文本，它改變文本的布局或外觀所以只有HTML標籤會受到尊重。添加圖像輸入HTML格式，例如，將導致圖像被包括作為布局的一部分，從而影響文本的字符的位置，但它不會被顯示。其結果將是一個空的區域中的圖像的尺寸在輸出中。同樣，使用表將導致文本進行布局以表格的形式，但邊框將不會被繪制。如果是第一次的靜態文本繪制，或者如果靜態文本，或畫家的字體已經自最后一次修改它被繪制，文字的布局，必須重新計算。在某些涂料發動機，改變畫家的矩陣也將導致布局進行重新計算。特別是，這會發生于任何發動機除了OpenGL2涂料引擎。重新計算布局將強加的開銷[QPainter.drawStaticText](qpainter.html#drawStaticText)（）調用在那里發生。為了避免這種開銷在內線時，可以調用[prepare](qstatictext.html#prepare)（）的時間提前，以確保布局的計算方法。 * * * ## Type Documentation ``` QStaticText.PerformanceHint ``` 這個枚舉，可以在設置的不同性能的提示[QStaticText](qstatictext.html)。這些提示可以被用來指示該[QStaticText](qstatictext.html)應該使用額外的緩存，如果可能的話，在記憶的費用，以提高性能。特別是，在設置性能暗示AggressiveCaching上[QStaticText](qstatictext.html)使用OpenGL圖形系統或繪制到時將提高性能時[QGLWidget](qglwidget.html)。 | Constant | Value | Description | | --- | --- | --- | | `QStaticText.ModerateCaching` | `0` | 做基本的緩存高性能，低內存成本。 | | `QStaticText.AggressiveCaching` | `1` | 使用額外的緩存時可用。這可能在更高的存儲器成本提高性能。 | * * * ## Method Documentation ``` QStaticText.__init__ (self) ``` 構造一個空[QStaticText](qstatictext.html) ``` QStaticText.__init__ (self, QString?text) ``` 構造一個[QStaticText](qstatictext.html)與給定對象_text_。 ``` QStaticText.__init__ (self, QStaticText?other) ``` 構造一個[QStaticText](qstatictext.html)對象，這是一個拷貝_other_。 ``` PerformanceHint QStaticText.performanceHint (self) ``` [](qstatictext.html#PerformanceHint-enum) [它的性能提示設置為回報](qstatictext.html#PerformanceHint-enum)[QStaticText](qstatictext.html)。 **See also** [setPerformanceHint](qstatictext.html#setPerformanceHint)（）。 ``` QStaticText.prepare (self, QTransform?matrix?=?QTransform(), QFont?font?=?QFont()) ``` 準備[QStaticText](qstatictext.html)對于對象被繪制與給定_matrix_和給定的_font_避免架空當實際drawStaticText （）調用。當drawStaticText （）被調用時，的布局[QStaticText](qstatictext.html)將被重新計算，如果任何部分的[QStaticText](qstatictext.html)自從上一次被繪制的對象發生了變化。如果畫家的字體是不一樣的，因為它也將被重新計算時[QStaticText](qstatictext.html)被最后繪制，或在任何其他繪圖引擎比OpenGL2引擎，如果畫家的矩陣已經改變，因為靜態文本的最后繪制。為了避免創建布局中的第一次繪制的開銷[QStaticText](qstatictext.html)在進行更改后，您可以使用prepare （）函數，并傳入_matrix_和_font_你希望繪制文本時使用。 **See also** [QPainter.setFont](qpainter.html#setFont)（）和[QPainter.setMatrix](index.htm#setMatrix)（）。 ``` QStaticText.setPerformanceHint (self, PerformanceHint?performanceHint) ``` 設置的性能提示[QStaticText](qstatictext.html)根據本_performanceHint_提供。該_performanceHint_用于自定義多少緩存是在內部完成，以提高性能。默認值是[QStaticText.ModerateCaching](qstatictext.html#PerformanceHint-enum)。 **Note:**此功能將導致需要重新計算的文本的布局。 **See also** [performanceHint](qstatictext.html#performanceHint)（）。 ``` QStaticText.setText (self, QString?text) ``` 設置的文本[QStaticText](qstatictext.html)至_text_。 **Note:**此功能將導致需要重新計算的文本的布局。 **See also** [text](qstatictext.html#text)（）。 ``` QStaticText.setTextFormat (self, Qt.TextFormat?textFormat) ``` 設置的文本格式[QStaticText](qstatictext.html)至_textFormat_。如果_textFormat_被設置為[Qt.AutoText](qt.html#TextFormat-enum)（默認），文本格式將嘗試使用該功能來確定[Qt.mightBeRichText](qt.html#mightBeRichText)（）。如果文本格式是[Qt.PlainText](qt.html#TextFormat-enum)，則文本將顯示為是，則它會被解釋為HTML格式是否為[Qt.RichText](qt.html#TextFormat-enum)。該改變文本的字體，顏色，或者其布局的HTML標籤都受到支持[QStaticText](qstatictext.html)。 **Note:**此功能將導致需要重新計算的文本的布局。 **See also** [textFormat](qstatictext.html#textFormat)（）[setText](qstatictext.html#setText)（）和[text](qstatictext.html#text)（）。 ``` QStaticText.setTextOption (self, QTextOption?textOption) ``` 設置文本選項的結構，控制布局過程中給定的_textOption_。 **See also** [textOption](qstatictext.html#textOption)（）。 ``` QStaticText.setTextWidth (self, float?textWidth) ``` 設置此的首選寬度[QStaticText](qstatictext.html)。如果文本比指定的寬度更寬，它會被分成多行和垂直增長。如果文字不能拆分成多行，它會比指定的大_textWidth_。首選的文本寬度設置為負數會導致文本是無界的。使用[size](qstatictext.html#size)（）來獲取文本的實際大小。 **Note:**此功能將導致需要重新計算的文本的布局。 **See also** [textWidth](qstatictext.html#textWidth)（）和[size](qstatictext.html#size)（）。 ``` QSizeF QStaticText.size (self) ``` [](qsizef.html) [返回該邊界矩形的大小為這](qsizef.html)[QStaticText](qstatictext.html)。 **See also** [textWidth](qstatictext.html#textWidth)（）。 ``` QString QStaticText.text (self) ``` 返回的文本[QStaticText](qstatictext.html)。 **See also** [setText](qstatictext.html#setText)（）。 ``` Qt.TextFormat QStaticText.textFormat (self) ``` [](qt.html#TextFormat-enum) [返回的文本格式](qt.html#TextFormat-enum)[QStaticText](qstatictext.html)。 **See also** [setTextFormat](qstatictext.html#setTextFormat)（）[setText](qstatictext.html#setText)（）和[text](qstatictext.html#text)（）。 ``` QTextOption QStaticText.textOption (self) ``` [ 返回用于控制布局過程中的當前文本選項。 ](qtextoption.html) [**See also**](qtextoption.html) [setTextOption](qstatictext.html#setTextOption)（）。 ``` float QStaticText.textWidth (self) ``` 返回首選寬度為這個[QStaticText](qstatictext.html)。 **See also** [setTextWidth](qstatictext.html#setTextWidth)（）。 ``` bool QStaticText.__eq__ (self, QStaticText) ``` ``` bool QStaticText.__ne__ (self, QStaticText) ```