# QDeclarativeView Class Reference ## [[QtDeclarative](index.htm) module] 該QDeclarativeView類提供了一個小工具來顯示一個Qt聲明式的用戶界面。[More...](#details) 繼承[QGraphicsView](qgraphicsview.html)。 ### Types * `enum ResizeMode { SizeViewToRootObject, SizeRootObjectToView }` * `enum Status { Null, Ready, Loading, Error }` ### Methods * `__init__ (self, QWidget?parent?=?None)` * `__init__ (self, QUrl?source, QWidget?parent?=?None)` * `QDeclarativeEngine engine (self)` * `list-of-QDeclarativeError errors (self)` * `bool eventFilter (self, QObject?watched, QEvent?e)` * `QSize initialSize (self)` * `paintEvent (self, QPaintEvent?event)` * `resizeEvent (self, QResizeEvent)` * `ResizeMode resizeMode (self)` * `QDeclarativeContext rootContext (self)` * `QGraphicsObject rootObject (self)` * `setResizeMode (self, ResizeMode)` * `setSource (self, QUrl)` * `QSize sizeHint (self)` * `QUrl source (self)` * `Status status (self)` * `timerEvent (self, QTimerEvent)` ### Qt Signals * `void sceneResized (QSize)` * `void statusChanged (QDeclarativeView::Status)` * * * ## Detailed Description 該QDeclarativeView類提供了一個小工具來顯示一個Qt聲明式的用戶界面。 [QDeclarativeItem](qdeclarativeitem.html)對象可以被放置在一個標準[QGraphicsScene](qgraphicsscene.html)并與顯示[QGraphicsView](qgraphicsview.html)。 QDeclarativeView是[QGraphicsView](qgraphicsview.html)子類提供方便顯示QML文件和QML和C + +的Qt對象之間的連接。 QDeclarativeView提供： * Management of [QDeclarativeComponent](qdeclarativecomponent.html) loading and object creation * Initialization of [QGraphicsView](qgraphicsview.html) for optimal performance with QML using these settings: * QGraphicsView.setOptimizationFlags([QGraphicsView.DontSavePainterState](qgraphicsview.html#OptimizationFlag-enum)) * QGraphicsView.setViewportUpdateMode([QGraphicsView.BoundingRectViewportUpdate](qgraphicsview.html#ViewportUpdateMode-enum)) * QGraphicsScene.setItemIndexMethod([QGraphicsScene.NoIndex](qgraphicsscene.html#ItemIndexMethod-enum)) * Initialization of [QGraphicsView](qgraphicsview.html) for QML key handling using these settings: * [QGraphicsView.viewport](qabstractscrollarea.html#viewport)()->setFocusPolicy([Qt.NoFocus](qt.html#FocusPolicy-enum)) * QGraphicsView.setFocusPolicy([Qt.StrongFocus](qt.html#FocusPolicy-enum)) * QGraphicsScene.setStickyFocus(true) 典型的用法： ``` QDeclarativeView *view = new QDeclarativeView; view->setSource([QUrl](qurl.html).fromLocalFile("myqmlfile.qml")); view->show(); ``` 由于QDeclarativeView是[QWidget](qwidget.html)基類時，它可以被用來在顯示QML接口[QWidget](qwidget.html)基于GUI的應用程序不使用圖形視圖框架。 要獲得有關加載和執行QML與QDeclarativeView錯誤，您可以連接到[statusChanged](qdeclarativeview.html#statusChanged)（ ）信號和顯示器[QDeclarativeView.Error](qdeclarativeview.html#Status-enum)。這些錯誤通過可[QDeclarativeView.errors](qdeclarativeview.html#errors)（ ） 。 如果你使用你自己的[QGraphicsScene](qgraphicsscene.html)基于場景QDeclarativeView ，記得讓現場的粘對焦模式和設置itemIndexMethod到[QGraphicsScene.NoIndex](qgraphicsscene.html#ItemIndexMethod-enum)。 * * * ## Type Documentation ``` QDeclarativeView.ResizeMode ``` 此枚舉指定如何調整視圖。 | Constant | Value | Description | | --- | --- | --- | | `QDeclarativeView.SizeViewToRootObject` | `0` | 該視圖調整大小與在QML根項目。 | | `QDeclarativeView.SizeRootObjectToView` | `1` | 該視圖會自動調整根項到視圖的大小。 | ``` QDeclarativeView.Status ``` 指定的加載狀態[QDeclarativeView](qdeclarativeview.html)。 | Constant | Value | Description | | --- | --- | --- | | `QDeclarativeView.Null` | `0` | This [QDeclarativeView](qdeclarativeview.html)沒有源集。 | | `QDeclarativeView.Ready` | `1` | This [QDeclarativeView](qdeclarativeview.html)已加載并創建了QML組件。 | | `QDeclarativeView.Loading` | `2` | This [QDeclarativeView](qdeclarativeview.html)正在加載網絡數據。 | | `QDeclarativeView.Error` | `3` | 已發生一個或多個錯誤。通話[errors](qdeclarativeview.html#errors)（）來檢索錯誤的列表。 | * * * ## Method Documentation ``` QDeclarativeView.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個[QDeclarativeView](qdeclarativeview.html)用給定的_parent_。 ``` QDeclarativeView.__init__ (self, QUrl?source, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個[QDeclarativeView](qdeclarativeview.html)用給定的QML_source_和_parent_。 ``` QDeclarativeEngine QDeclarativeView.engine (self) ``` [](qdeclarativeengine.html) [返回一個指針](qdeclarativeengine.html)[QDeclarativeEngine](qdeclarativeengine.html)用于實例化QML組件。 ``` list-of-QDeclarativeError QDeclarativeView.errors (self) ``` 返回的最后一個編譯期間發生的錯誤的列表或創建操作。當狀態不是錯誤，則返回一個空列表。 ``` bool QDeclarativeView.eventFilter (self, QObject?watched, QEvent?e) ``` ``` QSize QDeclarativeView.initialSize (self) ``` [ 返回根對象的初始大小 ``` QDeclarativeView.paintEvent (self, QPaintEvent?event) ``` ``` QDeclarativeView.resizeEvent (self, QResizeEvent) ``` ](qsize.html) ``` ResizeMode QDeclarativeView.resizeMode (self) ``` [](qdeclarativeview.html#ResizeMode-enum) ``` QDeclarativeContext QDeclarativeView.rootContext (self) ``` [](qdeclarativecontext.html) [該函數返回上下文層次結構的根。每個QML組件實例化的](qdeclarativecontext.html)[QDeclarativeContext](qdeclarativecontext.html)。[QDeclarativeContext](qdeclarativecontext.html)的是將數據傳遞到QML組件是必不可少的。在QML中，上下文是分級排列并且這種層次結構是由管理[QDeclarativeEngine](qdeclarativeengine.html)。 ``` QGraphicsObject QDeclarativeView.rootObject (self) ``` [](qgraphicsobject.html) [返回視圖的根](qgraphicsobject.html)[item](qgraphicsobject.html)。 ``` QDeclarativeView.setResizeMode (self, ResizeMode) ``` ``` QDeclarativeView.setSource (self, QUrl) ``` ``` QSize QDeclarativeView.sizeHint (self) ``` [](qsize.html) ``` QUrl QDeclarativeView.source (self) ``` [](qurl.html) ``` Status QDeclarativeView.status (self) ``` [ ``` QDeclarativeView.timerEvent (self, QTimerEvent) ``` * * * ## Qt Signal Documentation ``` void sceneResized (QSize) ``` 這是該信號的默認超載。 當視圖改變到這一信號被發射_size_。 ``` void statusChanged (QDeclarativeView::Status) ``` 這是該信號的默認超載。 這個信號被發射時，該組件的電流_status_變化。 ](qdeclarativeview.html#Status-enum)