QDeclarativeView Class Reference

[QtDeclarative module]

该QDeclarativeView类提供了一个小工具来显示一个Qt声明式的用户界面。More…

继承QGraphicsView。

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对象可以被放置在一个标准QGraphicsScene并与显示QGraphicsView。 QDeclarativeView是QGraphicsView子类提供方便显示QML文件和QML和C + +的Qt对象之间的连接。

QDeclarativeView提供：

• Management of QDeclarativeComponent loading and object creation
• Initialization of QGraphicsView for optimal performance with QML using these settings:
  • QGraphicsView.setOptimizationFlags(QGraphicsView.DontSavePainterState)
  • QGraphicsView.setViewportUpdateMode(QGraphicsView.BoundingRectViewportUpdate)
  • QGraphicsScene.setItemIndexMethod(QGraphicsScene.NoIndex)
• Initialization of QGraphicsView for QML key handling using these settings:
  • QGraphicsView.viewport()->setFocusPolicy(Qt.NoFocus)
  • QGraphicsView.setFocusPolicy(Qt.StrongFocus)
  • QGraphicsScene.setStickyFocus(true)

典型的用法：

 QDeclarativeView *view = new QDeclarativeView;
 view->setSource([QUrl](docs_qurl.html).fromLocalFile("myqmlfile.qml"));
 view->show();

由于QDeclarativeView是QWidget基类时，它可以被用来在显示QML接口QWidget基于GUI的应用程序不使用图形视图框架。

要获得有关加载和执行QML与QDeclarativeView错误，您可以连接到statusChanged（ ）信号和显示器QDeclarativeView.Error。这些错误通过可QDeclarativeView.errors（ ） 。

如果你使用你自己的QGraphicsScene基于场景QDeclarativeView ，记得让现场的粘对焦模式和设置itemIndexMethod到QGraphicsScene.NoIndex。

Type Documentation

QDeclarativeView.ResizeMode

此枚举指定如何调整视图。

QDeclarativeView.Status

指定的加载状态QDeclarativeView。

Method Documentation

QDeclarativeView.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个QDeclarativeView用给定的parent。

QDeclarativeView.__init__ (self, QUrl source, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个QDeclarativeView用给定的QMLsource和parent。

QDeclarativeEngine QDeclarativeView.engine (self)

返回一个指针QDeclarativeEngine用于实例化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)

](docs_qsize.html)

ResizeMode QDeclarativeView.resizeMode (self)

QDeclarativeContext QDeclarativeView.rootContext (self)

该函数返回上下文层次结构的根。每个QML组件实例化的QDeclarativeContext。QDeclarativeContext的是将数据传递到QML组件是必不可少的。在QML中，上下文是分级排列并且这种层次结构是由管理QDeclarativeEngine。

QGraphicsObject QDeclarativeView.rootObject (self)

返回视图的根item。

QDeclarativeView.setResizeMode (self, ResizeMode)

QDeclarativeView.setSource (self, QUrl)

QSize QDeclarativeView.sizeHint (self)

QUrl QDeclarativeView.source (self)

Status QDeclarativeView.status (self)

[

QDeclarativeView.timerEvent (self, QTimerEvent)

Qt Signal Documentation

void sceneResized (QSize)

这是该信号的默认超载。

当视图改变到这一信号被发射size。

void statusChanged (QDeclarativeView::Status)

这是该信号的默认超载。

这个信号被发射时，该组件的电流status变化。

](docs_qdeclarativeview.html#Status-enum)