Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

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.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)

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变化。