# QFrame Class Reference ## [[QtGui](index.htm) module] 該QFrame類是基類的小部件，可以有一個框架。[More...](#details) 繼承[QWidget](qwidget.html)。 通過繼承[QAbstractScrollArea](qabstractscrollarea.html)，[QLabel](qlabel.html)，[QLCDNumber](qlcdnumber.html)，[QSplitter](qsplitter.html)，[QStackedWidget](qstackedwidget.html)和[QToolBox](qtoolbox.html)。 ### Types * `enum Shadow { Plain, Raised, Sunken }` * `enum Shape { NoFrame, Box, Panel, WinPanel, ..., StyledPanel }` * `enum StyleMask { Shadow_Mask, Shape_Mask }` ### Methods * `__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `changeEvent (self, QEvent)` * `drawFrame (self, QPainter)` * `bool event (self, QEvent?e)` * `QRect frameRect (self)` * `Shadow frameShadow (self)` * `Shape frameShape (self)` * `int frameStyle (self)` * `int frameWidth (self)` * `int lineWidth (self)` * `int midLineWidth (self)` * `paintEvent (self, QPaintEvent)` * `setFrameRect (self, QRect)` * `setFrameShadow (self, Shadow)` * `setFrameShape (self, Shape)` * `setFrameStyle (self, int)` * `setLineWidth (self, int)` * `setMidLineWidth (self, int)` * `QSize sizeHint (self)` * * * ## Detailed Description 該QFrame類是基類的小部件，可以有一個框架。 [QMenu](qmenu.html)使用它來“養”周圍的屏幕上方的菜單。[QProgressBar](qprogressbar.html)有一個“沉沒”的樣子。[QLabel](qlabel.html)具有平坦的外觀。像這樣的小部件的幀可以被改變。 ``` [QLabel](qlabel.html) label(...); label.setFrameStyle(QFrame.Panel | QFrame.Raised); label.setLineWidth(2); [QProgressBar](qprogressbar.html) pbar(...); label.setFrameStyle(QFrame.NoFrame); ``` 該QFrame類也可以直接使用，無需任何內容創建簡單的佔位符框架。 邊框樣式是由一個指定的[frame shape](qframe.html#Shape-enum)和[shadow style](qframe.html#Shadow-enum)是，用于在視覺上的幀從周圍的部件中分離出來。這些屬性可以設置一起使用[setFrameStyle](qframe.html#setFrameStyle)（）函數和讀取[frameStyle](qframe.html#frameStyle)（ ） 。 該框架形狀[NoFrame](qframe.html#Shape-enum)，[Box](qframe.html#Shape-enum)，[Panel](qframe.html#Shape-enum)，[StyledPanel](qframe.html#Shape-enum)，[HLine](qframe.html#Shape-enum)和[VLine](qframe.html#Shape-enum);陰影樣式[Plain](qframe.html#Shadow-enum)，[Raised](qframe.html#Shadow-enum)和[Sunken](qframe.html#Shadow-enum)。 一幀小部件都有描述邊框的厚度三個屬性：[lineWidth](qframe.html#lineWidth-prop)，[midLineWidth](qframe.html#midLineWidth-prop)和[frameWidth](qframe.html#frameWidth-prop)。 * The line width is the width of the frame border. It can be modified to customize the frame's appearance. * The mid-line width specifies the width of an extra line in the middle of the frame, which uses a third color to obtain a special 3D effect. Notice that a mid-line is only drawn for [Box](qframe.html#Shape-enum), [HLine](qframe.html#Shape-enum) and [VLine](qframe.html#Shape-enum) frames that are raised or sunken. * The frame width is determined by the frame style, and the [frameWidth](qframe.html#frameWidth-prop)() function is used to obtain the value defined for the style used. 該幀的幀和內容之間的邊緣可以與被定制[QWidget.setContentsMargins](qwidget.html#setContentsMargins)（）函數。 該表顯示了一些款式和線寬的組合：  * * * ## Type Documentation ``` QFrame.Shadow ``` 該枚舉類型定義了用于給一個3D效果的幀陰影的類型。 | Constant | Value | Description | | --- | --- | --- | | `QFrame.Plain` | `0x0010` | 框架和內容，出現與周圍環境水平;繪制使用的調色板[QPalette.WindowText](qpalette.html#ColorRole-enum)顏色（無任何3D效果） | | `QFrame.Raised` | `0x0020` | 框架和內容出現上調;使用當前顏色組的光與暗的顏色繪制3D凸起線 | | `QFrame.Sunken` | `0x0030` | 框架和內容出現凹陷，使用當前顏色組的光與暗的顏色繪制一個三維線沉沒 | 陰影交互[QFrame.Shape](qframe.html#Shape-enum)時，[lineWidth](qframe.html#lineWidth-prop)（ ）和[midLineWidth](qframe.html#midLineWidth-prop)（ ） 。看到在主類文件的幀的圖片。 **See also** [QFrame.Shape](qframe.html#Shape-enum)，[lineWidth](qframe.html#lineWidth-prop)（）和[midLineWidth](qframe.html#midLineWidth-prop)（ ） 。 ``` QFrame.Shape ``` 這個枚舉類型定義框架提供的形狀。 | Constant | Value | Description | | --- | --- | --- | | `QFrame.NoFrame` | `0` | [QFrame](qframe.html)借鑒什么 | | `QFrame.Box` | `0x0001` | [QFrame](qframe.html)周圍繪制其內容的盒子 | | `QFrame.Panel` | `0x0002` | [QFrame](qframe.html)繪制一個面板，使內容出現凸起或凹陷 | | `QFrame.StyledPanel` | `0x0006` | 繪制一個矩形面板，一看就是取決于當前圖形用戶界面風格。它可以凸起或凹陷。 | | `QFrame.HLine` | `0x0004` | [QFrame](qframe.html)繪制一條水平線，沒有幀（作為分隔符有用） | | `QFrame.VLine` | `0x0005` | [QFrame](qframe.html)繪制了框架沒有一條垂直線（如分離器很有用） | | `QFrame.WinPanel` | `0x0003` | 繪制一個矩形面板可以凸起或凹陷的像那些在Windows 2000。指定此形狀設置線寬為2像素。 WinPanel提供了一種用于兼容性。對于GUI風格的獨立性，我們建議使用StyledPanel代替。 | 當它不叫[QStyle](qstyle.html)，外形與互動[QFrame.Shadow](qframe.html#Shadow-enum)時，[lineWidth](qframe.html#lineWidth-prop)（ ）和[midLineWidth](qframe.html#midLineWidth-prop)（ ）創建的總成績。看到在主類文件的幀的圖片。 **See also** [QFrame.Shadow](qframe.html#Shadow-enum)，[QFrame.style](qwidget.html#style)（）和[QStyle.drawPrimitive](qstyle.html#drawPrimitive)（ ） 。 ``` QFrame.StyleMask ``` 該枚舉定義了可以用來提取的兩個組成部分的兩個常數[frameStyle](qframe.html#frameStyle)（）： | Constant | Value | Description | | --- | --- | --- | | `QFrame.Shadow_Mask` | `0x00f0` | 該[Shadow](qframe.html#Shadow-enum)的一部分[frameStyle](qframe.html#frameStyle)（ ） | | `QFrame.Shape_Mask` | `0x000f` | 該[Shape](qframe.html#Shape-enum)的一部分[frameStyle](qframe.html#frameStyle)（ ） | 通常情況下，你并不需要使用這些，因為[frameShadow](qframe.html#frameShadow-prop)（）和[frameShape](qframe.html#frameShape-prop)（ ）已提取[Shadow](qframe.html#Shadow-enum)和[Shape](qframe.html#Shape-enum)部分[frameStyle](qframe.html#frameStyle)（ ） 。 **See also** [frameStyle](qframe.html#frameStyle)（）和[setFrameStyle](qframe.html#setFrameStyle)（ ） 。 * * * ## Method Documentation ``` QFrame.__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個框架部件與框架樣式[NoFrame](qframe.html#Shape-enum)和一個1像素邊框寬度。 該_parent_和_f_參數被傳遞到[QWidget](qwidget.html)構造函數。 ``` QFrame.changeEvent (self, QEvent) ``` 從重新實現[QWidget.changeEvent](qwidget.html#changeEvent)（ ） 。 ``` QFrame.drawFrame (self, QPainter) ``` ``` bool QFrame.event (self, QEvent?e) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` QRect QFrame.frameRect (self) ``` [](qrect.html) ``` Shadow QFrame.frameShadow (self) ``` [](qframe.html#Shadow-enum) ``` Shape QFrame.frameShape (self) ``` [ ``` int QFrame.frameStyle (self) ``` 返回框架風格。 ](qframe.html#Shape-enum) [缺省值是](qframe.html#Shape-enum)[QFrame.Plain](qframe.html#Shadow-enum)。 **See also** [setFrameStyle](qframe.html#setFrameStyle)（ ）[frameShape](qframe.html#frameShape-prop)（）和[frameShadow](qframe.html#frameShadow-prop)（ ） 。 ``` int QFrame.frameWidth (self) ``` ``` int QFrame.lineWidth (self) ``` ``` int QFrame.midLineWidth (self) ``` ``` QFrame.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QFrame.setFrameRect (self, QRect) ``` ``` QFrame.setFrameShadow (self, Shadow) ``` ``` QFrame.setFrameShape (self, Shape) ``` ``` QFrame.setFrameStyle (self, int) ``` 設置框架樣式_style_。 該_style_是按位或一個框的形狀和框架陰影樣式之間。看到在主類文件的幀的圖片。 在框架形狀在給定的[QFrame.Shape](qframe.html#Shape-enum)并且在陰影樣式[QFrame.Shadow](qframe.html#Shadow-enum)。 如果一個中等寬度小于指定0越大，附加線的繪制[Raised](qframe.html#Shadow-enum) or [Sunken](qframe.html#Shadow-enum) [Box](qframe.html#Shape-enum)，[HLine](qframe.html#Shape-enum)和[VLine](qframe.html#Shape-enum)幀。當前顏色組的中間色用于繪制中間線。 **See also** [frameStyle](qframe.html#frameStyle)（ ） 。 ``` QFrame.setLineWidth (self, int) ``` ``` QFrame.setMidLineWidth (self, int) ``` ``` QSize QFrame.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。