# QScrollArea Class Reference ## [[QtGui](index.htm) module] 該QScrollArea類提供了一個滾動視圖到另一個部件。[More...](#details) 繼承[QAbstractScrollArea](qabstractscrollarea.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `Qt.Alignment alignment (self)` * `ensureVisible (self, int?x, int?y, int?xMargin?=?50, int?yMargin?=?50)` * `ensureWidgetVisible (self, QWidget?childWidget, int?xMargin?=?50, int?yMargin?=?50)` * `bool event (self, QEvent)` * `bool eventFilter (self, QObject, QEvent)` * `bool focusNextPrevChild (self, bool?next)` * `resizeEvent (self, QResizeEvent)` * `scrollContentsBy (self, int?dx, int?dy)` * `setAlignment (self, Qt.Alignment)` * `setWidget (self, QWidget?w)` * `setWidgetResizable (self, bool?resizable)` * `QSize sizeHint (self)` * `QWidget takeWidget (self)` * `QWidget widget (self)` * `bool widgetResizable (self)` * * * ## Detailed Description 該QScrollArea類提供了一個滾動視圖到另一個部件。 一種渦旋式區域用于一幀中顯示的子插件的內容。如果窗口部件超過該幀的大小，該視圖可以提供滾動條，以使子部件的整個區域，可以被觀看。孩子小部件必須被指定[setWidget](qscrollarea.html#setWidget)（ ） 。例如： ``` [QLabel](qlabel.html) *imageLabel = new [QLabel](qlabel.html); [QImage](qimage.html) image("happyguy.png"); imageLabel->setPixmap([QPixmap](qpixmap.html).fromImage(image)); scrollArea = new QScrollArea; scrollArea->setBackgroundRole([QPalette](qpalette.html).Dark); scrollArea->setWidget(imageLabel); ``` 上面的代碼創建一個包含一個圖像標籤的滾動區域（在下面的圖片所示） 。當縮放該圖像，該滾動區域可以提供必要的滾動條： |  |  |  | 滾動條的外觀取決于當前設置的[scroll bar policies](qt.html#ScrollBarPolicy-enum)。你可以控制使用從繼承的功能滾動條的外觀[QAbstractScrollArea](qabstractscrollarea.html)。 例如，您可以設置[QAbstractScrollArea.horizontalScrollBarPolicy](qabstractscrollarea.html#horizontalScrollBarPolicy-prop)和[QAbstractScrollArea.verticalScrollBarPolicy](qabstractscrollarea.html#verticalScrollBarPolicy-prop)屬性。或者，如果你想要滾動條來動態地調整時的滾動區域的內容改變，則可以使用[horizontalScrollBar()](qabstractscrollarea.html#horizontalScrollBar)和[verticalScrollBar()](qabstractscrollarea.html#verticalScrollBar)功能（這使您可以訪問滾動條），并設置每當滾動區域的內容改變滾動條的價值觀，用[QScrollBar.setValue](qabstractslider.html#value-prop)（）函數。 您可以使用檢索子插件的[widget](qscrollarea.html#widget)（）函數。該視圖可以用來被調整大小與[setWidgetResizable](qscrollarea.html#widgetResizable-prop)（）函數。窗口小部件的取向可以與指定的[setAlignment](qscrollarea.html#alignment-prop)（ ） 。 兩個便利的函數[ensureVisible](qscrollarea.html#ensureVisible)（）和[ensureWidgetVisible](qscrollarea.html#ensureWidgetVisible)（）保證的內容的特定區域是在視口內可見的，通過在必要時滾動的內容。 ### Size Hints and Layouts 當使用一個滾動區域來顯示一個自定義的窗口小部件的內容，它保證是重要的[size hint](qwidget.html#sizeHint-prop)兒童的插件被設置為一個合適的值。如果一個標準[QWidget](qwidget.html)用于子部件，它可能需要調用[QWidget.setMinimumSize](qwidget.html#minimumSize-prop)（）以確保該窗口小部件的內容被滾動區域內的正確顯示。 如果一個滾動區域用于顯示包含配置在布局子部件一個部件的內容，但要認識到，在布局的大小政策也將確定小窗口的大小是很重要的。如果你打算來動態改變布局的內容，這是特別有用的就知道了。在這種情況下，設置布局的[size constraint](qlayout.html#sizeConstraint-prop)屬性之一，它提供的最小和/或布局的最大尺寸（例如，限制，[QLayout.SetMinAndMaxSize](qlayout.html#SizeConstraint-enum)）將導致滾動面積的大小進行更新時的布局變更的內容。 對于使用QScrollArea類的完整示例，請參見[Image Viewer](index.htm)例子。該示例顯示了如何結合[QLabel](qlabel.html)和QScrollArea以顯示圖像。 * * * ## Method Documentation ``` QScrollArea.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造具有給定一個空的滾動區域_parent_。 **See also** [setWidget](qscrollarea.html#setWidget)（ ） 。 ``` Qt.Alignment QScrollArea.alignment (self) ``` [ ``` QScrollArea.ensureVisible (self, int?x, int?y, int?xMargin?=?50, int?yMargin?=?50) ``` 滾動滾動區域的內容，使該點（_x_，_y_）是由以像素為單位指定頁邊距視口的區域內可見_xmargin_和_ymargin_。如果指定的點不能達到，其內容被滾動到最近的有效位置。兩個邊距的默認值是50個像素。 ``` QScrollArea.ensureWidgetVisible (self, QWidget?childWidget, int?xMargin?=?50, int?yMargin?=?50) ``` ](index.htm) [滾動滾動區域的內容，這樣_childWidget_的](index.htm)[QScrollArea.widget](qscrollarea.html#widget)（ ）是通過以像素為單位指定頁邊距視口內可見_xmargin_和_ymargin_。如果指定的點不能達到，其內容被滾動到最近的有效位置。兩個邊距的默認值是50個像素。 這個函數中引入了Qt 4.2中。 ``` bool QScrollArea.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` bool QScrollArea.eventFilter (self, QObject, QEvent) ``` 從重新實現[QObject.eventFilter](qobject.html#eventFilter)（ ） 。 ``` bool QScrollArea.focusNextPrevChild (self, bool?next) ``` 從重新實現[QWidget.focusNextPrevChild](qwidget.html#focusNextPrevChild)（ ） 。 ``` QScrollArea.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` QScrollArea.scrollContentsBy (self, int?dx, int?dy) ``` 從重新實現[QAbstractScrollArea.scrollContentsBy](qabstractscrollarea.html#scrollContentsBy)（ ） 。 ``` QScrollArea.setAlignment (self, Qt.Alignment) ``` ``` QScrollArea.setWidget (self, QWidget?w) ``` 該_w_說法有它的所有權轉移給Qt的。 設置滾動區域的_widget_。 該_widget_成為滾動區域的一個孩子，當滾動區域被刪除或者當一個新的widget設定將被破壞。 widget的[autoFillBackground](qwidget.html#autoFillBackground-prop)屬性將被設置為`true`。 如果滾動區域是可見的，當_widget_是說，你必須[show()](qwidget.html#show)它明確。 請注意，您必須添加的布局_widget_在打電話之前此功能，如果您以后添加吧，_widget_將不可見 - 無論何時你的[show()](qwidget.html#show)滾動區域。在這種情況下，你也可以不[show()](qwidget.html#show)該_widget_后來。 **See also** [widget](qscrollarea.html#widget)（ ） 。 ``` QScrollArea.setWidgetResizable (self, bool?resizable) ``` ``` QSize QScrollArea.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` QWidget QScrollArea.takeWidget (self) ``` [ 該_QWidget_結果 消除了滾動區域的窗口小部件，并通過小部件的所有權給調用者。 ](qwidget.html) [**See also**](qwidget.html) [widget](qscrollarea.html#widget)（ ） 。 ``` QWidget QScrollArea.widget (self) ``` [ 返回滾動區域的窗口小部件，或者0，如果是沒有的。 ](qwidget.html) [**See also**](qwidget.html) [setWidget](qscrollarea.html#setWidget)（ ） 。 ``` bool QScrollArea.widgetResizable (self) ```