# QLabel Class Reference ## [[QtGui](index.htm) module] 該QLABEL小部件提供了一個文本或圖像的顯示。[More...](#details) 繼承[QFrame](qframe.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `__init__ (self, QString?text, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `Qt.Alignment alignment (self)` * `QWidget buddy (self)` * `changeEvent (self, QEvent)` * `clear (self)` * `contextMenuEvent (self, QContextMenuEvent?ev)` * `bool event (self, QEvent?e)` * `focusInEvent (self, QFocusEvent?ev)` * `bool focusNextPrevChild (self, bool?next)` * `focusOutEvent (self, QFocusEvent?ev)` * `bool hasScaledContents (self)` * `bool hasSelectedText (self)` * `int heightForWidth (self, int)` * `int indent (self)` * `keyPressEvent (self, QKeyEvent?ev)` * `int margin (self)` * `QSize minimumSizeHint (self)` * `mouseMoveEvent (self, QMouseEvent?ev)` * `mousePressEvent (self, QMouseEvent?ev)` * `mouseReleaseEvent (self, QMouseEvent?ev)` * `QMovie movie (self)` * `bool openExternalLinks (self)` * `paintEvent (self, QPaintEvent)` * `QPicture picture (self)` * `QPixmap pixmap (self)` * `QString selectedText (self)` * `int selectionStart (self)` * `setAlignment (self, Qt.Alignment)` * `setBuddy (self, QWidget)` * `setIndent (self, int)` * `setMargin (self, int)` * `setMovie (self, QMovie?movie)` * `setNum (self, float)` * `setNum (self, int)` * `setOpenExternalLinks (self, bool?open)` * `setPicture (self, QPicture)` * `setPixmap (self, QPixmap)` * `setScaledContents (self, bool)` * `setSelection (self, int, int)` * `setText (self, QString)` * `setTextFormat (self, Qt.TextFormat)` * `setTextInteractionFlags (self, Qt.TextInteractionFlags?flags)` * `setWordWrap (self, bool?on)` * `QSize sizeHint (self)` * `QString text (self)` * `Qt.TextFormat textFormat (self)` * `Qt.TextInteractionFlags textInteractionFlags (self)` * `bool wordWrap (self)` ### Qt Signals * `void linkActivated (const QString&)` * `void linkHovered (const QString&)` * * * ## Detailed Description 該QLABEL小部件提供了一個文本或圖像的顯示。 QLABEL用于顯示文本或圖像。沒有提供用戶交互功能。標籤的視覺外觀可以以各種方式來配置，并且它可以用于指定一個焦點助記鍵另一小窗口。 一個QLABEL可以包含以下任一內容類型： | Content | Setting | | --- | --- | | Plain text | Pass a [QString](qstring.html) to [setText](qlabel.html#text-prop)(). | | Rich text | Pass a [QString](qstring.html) that contains rich text to [setText](qlabel.html#text-prop)(). | | A pixmap | Pass a [QPixmap](qpixmap.html) to [setPixmap](qlabel.html#pixmap-prop)(). | | A movie | Pass a [QMovie](qmovie.html) to [setMovie](qlabel.html#setMovie)(). | | A number | Pass an _int_ or a _double_ to [setNum](qlabel.html#setNum)(), which converts the number to plain text. | | Nothing | The same as an empty plain text. This is the default. Set by [clear](qlabel.html#clear)(). | **Warning:**當傳遞[QString](qstring.html)在構造函數或調用[setText](qlabel.html#text-prop)（ ） ，一定要凈化你的輸入， QLABEL試圖猜測它是否顯示文本為純文本或富文本。你可能需要調用[setTextFormat](qlabel.html#textFormat-prop)（ ）明確，例如如果你期望的文本是在平原的格式，但（顯示從Web加載數據時，例如）無法控制文本源。 當內容被任意使用這些功能的改變，以前的任何內容被清除。 默認情況下，標籤顯示[left-aligned, vertically-centered](qlabel.html#alignment-prop)文本和圖像，其中要顯示在文本的任何選項卡[automatically expanded](qt.html#TextFlag-enum)。然而， QLABEL的外觀可以調節和微調在幾個方面。 在QLABEL插件區域內的內容的定位可以與調諧[setAlignment](qlabel.html#alignment-prop)（）和[setIndent](qlabel.html#indent-prop)（ ） 。文本內容也可以沿包裹單詞邊界線[setWordWrap](qlabel.html#wordWrap-prop)（ ） 。例如，此代碼設置一個下沉式面板的右下角（這兩條線是用右側的標籤沖洗）兩行文字： ``` QLabel *label = new QLabel(this); label->setFrameStyle([QFrame](qframe.html).Panel | [QFrame](qframe.html).Sunken); label->setText("first line\nsecond line"); label->setAlignment([Qt](qt.html).AlignBottom | [Qt](qt.html).AlignRight); ``` 的性質和功能QLABEL從繼承[QFrame](qframe.html)也可用于指定要用于任何給定的標籤的小窗口框。 甲QLABEL常被用作用于交互式窗口小部件的標籤。對于這種使用QLABEL提供用于添加助記符一個有用的機制（見[QKeySequence](qkeysequence.html)） ，將設置鍵盤焦點到其它部件（稱為QLABEL的“夥伴” ） 。例如： ``` [QLineEdit](qlineedit.html)* phoneEdit = new [QLineEdit](qlineedit.html)(this); QLabel* phoneLabel = new QLabel("&Phone:", this); phoneLabel->setBuddy(phoneEdit); ``` 在該示例中，鍵盤焦點轉移到標籤的夥伴（在[QLineEdit](qlineedit.html)）當用戶按下ALT + P。如果好友是一個按鈕（繼承[QAbstractButton](qabstractbutton.html)） ，觸發記憶會模擬一個按鈕的點擊。 |  | A label shown in the [Macintosh widget style](index.htm). | |  | A label shown in the [Plastique widget style](index.htm). | |  | A label shown in the [Windows XP widget style](index.htm). | * * * ## Method Documentation ``` QLabel.__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個空標籤。 該_parent_和widget標志_f_，參數被傳遞到[QFrame](qframe.html)構造函數。 **See also** [setAlignment](qlabel.html#alignment-prop)（ ）[setFrameStyle](qframe.html#setFrameStyle)（）和[setIndent](qlabel.html#indent-prop)（ ） 。 ``` QLabel.__init__ (self, QString?text, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個顯示文本標籤，_text_。 該_parent_和widget標志_f_，參數被傳遞到[QFrame](qframe.html)構造函數。 **See also** [setText](qlabel.html#text-prop)（ ）[setAlignment](qlabel.html#alignment-prop)（ ）[setFrameStyle](qframe.html#setFrameStyle)（）和[setIndent](qlabel.html#indent-prop)（ ） 。 ``` Qt.Alignment QLabel.alignment (self) ``` [](index.htm) ``` QWidget QLabel.buddy (self) ``` [ 返回此標籤的哥們，或者0 ，如果沒有好友當前設置。 ](qwidget.html) [**See also**](qwidget.html) [setBuddy](qlabel.html#setBuddy)（ ） 。 ``` QLabel.changeEvent (self, QEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（ ） 。 ``` QLabel.clear (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void clear()`。 清除任何標籤的內容。 ``` QLabel.contextMenuEvent (self, QContextMenuEvent?ev) ``` 從重新實現[QWidget.contextMenuEvent](qwidget.html#contextMenuEvent)（ ） 。 ``` bool QLabel.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` QLabel.focusInEvent (self, QFocusEvent?ev) ``` 從重新實現[QWidget.focusInEvent](qwidget.html#focusInEvent)（ ） 。 ``` bool QLabel.focusNextPrevChild (self, bool?next) ``` 從重新實現[QWidget.focusNextPrevChild](qwidget.html#focusNextPrevChild)（ ） 。 ``` QLabel.focusOutEvent (self, QFocusEvent?ev) ``` 從重新實現[QWidget.focusOutEvent](qwidget.html#focusOutEvent)（ ） 。 ``` bool QLabel.hasScaledContents (self) ``` ``` bool QLabel.hasSelectedText (self) ``` ``` int QLabel.heightForWidth (self, int) ``` 從重新實現[QWidget.heightForWidth](qwidget.html#heightForWidth)（ ） 。 ``` int QLabel.indent (self) ``` ``` QLabel.keyPressEvent (self, QKeyEvent?ev) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（ ） 。 ``` int QLabel.margin (self) ``` ``` QSize QLabel.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（ ） 。 ``` QLabel.mouseMoveEvent (self, QMouseEvent?ev) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（ ） 。 ``` QLabel.mousePressEvent (self, QMouseEvent?ev) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（ ） 。 ``` QLabel.mouseReleaseEvent (self, QMouseEvent?ev) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（ ） 。 ``` QMovie QLabel.movie (self) ``` [ 返回一個指向標籤的電影，或者0，如果沒有電影已定。 ](qmovie.html) [**See also**](qmovie.html) [setMovie](qlabel.html#setMovie)（ ） 。 ``` bool QLabel.openExternalLinks (self) ``` ``` QLabel.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QPicture QLabel.picture (self) ``` [ 返回該標籤的頭像或0，如果標籤沒有圖片。 ](qpicture.html) [**See also**](qpicture.html) [setPicture](qlabel.html#setPicture)（ ） 。 ``` QPixmap QLabel.pixmap (self) ``` [ ``` QString QLabel.selectedText (self) ``` ``` int QLabel.selectionStart (self) ``` selectionStart （）返回在標籤中第一個選定字符或-1的索引，如果沒有選定的文本。 ](qpixmap.html) [**Note:**該](qpixmap.html)[textInteractionFlags](qlabel.html#textInteractionFlags-prop)標籤上的設置需要包含兩種TextSelectableByMouse或TextSelectableByKeyboard 。 此功能被引入Qt的4.7 。 **See also** [selectedText](qlabel.html#selectedText-prop)（ ） 。 ``` QLabel.setAlignment (self, Qt.Alignment) ``` ``` QLabel.setBuddy (self, QWidget) ``` 設置這個標籤的哥們_buddy_。 當用戶按下這個標籤所指示的快捷鍵，鍵盤焦點轉移到標籤的哥們部件。 哥們機制僅適用于包含在其中一個字符的前綴與符號文字QLabels ， '＆' 。此字符設置為快捷鍵。請參閱[QKeySequence.mnemonic](qkeysequence.html#mnemonic)（ ）文檔的詳細信息（顯示的實際符號，使用“\u0026\u0026” ） 。 在對話框中，可以創建兩個數據輸入部件，并為每個標籤，并設置了幾何布局，每個標籤就是它的數據輸入控件（它的“夥伴” ） ，例如左： ``` [QLineEdit](qlineedit.html) *nameEd = new [QLineEdit](qlineedit.html)(this); [QLabel](qlabel.html) *nameLb = new [QLabel](qlabel.html)("&Name:", this); nameLb->setBuddy(nameEd); [QLineEdit](qlineedit.html) *phoneEd = new [QLineEdit](qlineedit.html)(this); [QLabel](qlabel.html) *phoneLb = new [QLabel](qlabel.html)("&Phone:", this); phoneLb->setBuddy(phoneEd); // (layout setup not shown) ``` 與上面的代碼中，重點跳轉到Name字段，當用戶按下ALT + N，和電話字段，當用戶按下ALT + P。 來取消以前設置的哥們，調用該函數_buddy_設置為0。 **See also** [buddy](qlabel.html#buddy)（ ）[setText](qlabel.html#text-prop)（ ）[QShortcut](qshortcut.html)和[setAlignment](qlabel.html#alignment-prop)（ ） 。 ``` QLabel.setIndent (self, int) ``` ``` QLabel.setMargin (self, int) ``` ``` QLabel.setMovie (self, QMovie?movie) ``` 這種方法也是一個Qt槽與C + +的簽名`void setMovie(QMovie *)`。 設置標籤內容_movie_。任何以前的內容將被清除。標籤不走電影的所有權。 的哥們快捷方式，如果有的話，將被禁用。 **See also** [movie](qlabel.html#movie)（）和[setBuddy](qlabel.html#setBuddy)（ ） 。 ``` QLabel.setNum (self, float) ``` 這種方法也是一個Qt槽與C + +的簽名`void setNum(double)`。 設置標籤內容包含整數的文本表示純文本_num_。任何以前的內容將被清除。什么都不做，如果整數的字符串表示形式是相同的標籤的當前內容。 的哥們快捷方式，如果有的話，將被禁用。 **See also** [setText](qlabel.html#text-prop)（ ）[QString.setNum](qstring.html#setNum)（）和[setBuddy](qlabel.html#setBuddy)（ ） 。 ``` QLabel.setNum (self, int) ``` 這種方法也是一個Qt槽與C + +的簽名`void setNum(int)`。 這是一個重載函數。 設置標籤內容包含雙重的文字表述純文本_num_。任何以前的內容將被清除。請問咱這雙的字符串表示形式是相同的標籤的當前內容。 的哥們快捷方式，如果有的話，將被禁用。 **See also** [setText](qlabel.html#text-prop)（ ）[QString.setNum](qstring.html#setNum)（）和[setBuddy](qlabel.html#setBuddy)（ ） 。 ``` QLabel.setOpenExternalLinks (self, bool?open) ``` ``` QLabel.setPicture (self, QPicture) ``` 這種方法也是一個Qt槽與C + +的簽名`void setPicture(const QPicture&)`。 設置標籤內容_picture_。任何以前的內容將被清除。 的哥們快捷方式，如果有的話，將被禁用。 **See also** [picture](qlabel.html#picture)（）和[setBuddy](qlabel.html#setBuddy)（ ） 。 ``` QLabel.setPixmap (self, QPixmap) ``` 這種方法也是一個Qt槽與C + +的簽名`void setPixmap(const QPixmap&)`。 ``` QLabel.setScaledContents (self, bool) ``` ``` QLabel.setSelection (self, int, int) ``` 從位置選擇文本_start_和_length_字符。 **Note:**該[textInteractionFlags](qlabel.html#textInteractionFlags-prop)標籤上的設置需要包含兩種TextSelectableByMouse或TextSelectableByKeyboard 。 此功能被引入Qt的4.7 。 **See also** [selectedText](qlabel.html#selectedText-prop)（ ） 。 ``` QLabel.setText (self, QString) ``` 這種方法也是一個Qt槽與C + +的簽名`void setText(const QString&)`。 ``` QLabel.setTextFormat (self, Qt.TextFormat) ``` ``` QLabel.setTextInteractionFlags (self, Qt.TextInteractionFlags?flags) ``` ``` QLabel.setWordWrap (self, bool?on) ``` ``` QSize QLabel.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` QString QLabel.text (self) ``` ``` Qt.TextFormat QLabel.textFormat (self) ``` [](qt.html#TextFormat-enum) ``` Qt.TextInteractionFlags QLabel.textInteractionFlags (self) ``` [ ``` bool QLabel.wordWrap (self) ``` * * * ## Qt Signal Documentation ``` void linkActivated (const QString&) ``` 這是該信號的默認超載。 當用戶點擊一個鏈接這個信號被發射。由錨所指的URL傳遞中_link_。 這個函數中引入了Qt 4.2中。 ](index.htm) [**See also**](index.htm) [linkHovered](qlabel.html#linkHovered)（ ） 。 ``` void linkHovered (const QString&) ``` 這是該信號的默認超載。 當用戶將鼠標懸停在一個鏈接這個信號被發射。由錨所指的URL傳遞中_link_。 這個函數中引入了Qt 4.2中。 **See also** [linkActivated](qlabel.html#linkActivated)（ ） 。