内容

公共函数
信号
详细描述

QQmlExpression Class

QQmlExpression class evaluates JavaScript in a QML context. 更多...

头：	#include <QQmlExpression>
qmake:	QT += qml
Since:	Qt 5.0
继承：	QObject

所有成员列表，包括继承成员

公共函数

	QQmlExpression ()
	QQmlExpression (QQmlContext * ctxt , QObject * scope , const QString & expression , QObject * parent = Q_NULLPTR)
	QQmlExpression (const QQmlScriptString & script , QQmlContext * ctxt = Q_NULLPTR, QObject * scope = Q_NULLPTR, QObject * parent = Q_NULLPTR)
virtual	~QQmlExpression ()
void	clearError ()
int	columnNumber () const
QQmlContext *	context () const
QQmlEngine *	engine () const
QQmlError	error () const
QVariant	evaluate (bool * valueIsUndefined = Q_NULLPTR)
QString	expression () const
bool	hasError () const
int	lineNumber () const
bool	notifyOnValueChanged () const
QObject *	scopeObject () const
void	setExpression (const QString & expression )
void	setNotifyOnValueChanged (bool notifyOnChange )
void	setSourceLocation (const QString & url , int line , int column = 0)
QString	sourceFile () const

32 公共函数继承自 QObject

信号

void	valueChanged ()

2 信号继承自 QObject

额外继承成员

1 特性继承自 QObject
1 公共槽继承自 QObject
11 静态公共成员继承自 QObject
9 保护函数继承自 QObject

详细描述

QQmlExpression class evaluates JavaScript in a QML context.

For example, given a file main.qml 像这样：

import QtQuick 2.0
Item {
    width: 200; height: 200
}

The following code evaluates a JavaScript expression in the context of the above QML:

QQmlEngine *engine = new QQmlEngine;
QQmlComponent component(engine, QUrl::fromLocalFile("main.qml"));
QObject *myObject = component.create();
QQmlExpression *expr = new QQmlExpression(engine->rootContext(), myObject, "width * 2");
int result = expr->evaluate().toInt();  // result = 400

注意， Qt Quick 1 version is called QDeclarativeExpression.

成员函数文档编制

QQmlExpression:: QQmlExpression ()

Create an invalid QQmlExpression .

As the expression will not have an associated QQmlContext , this will be a null expression object and its value will always be an invalid QVariant .

QQmlExpression:: QQmlExpression ( QQmlContext * ctxt , QObject * scope , const QString & expression , QObject * parent = Q_NULLPTR)

创建 QQmlExpression object that is a child of parent .

expression JavaScript will be executed in the ctxt QQmlContext . If specified, the scope object's properties will also be in scope during the expression's execution.

QQmlExpression:: QQmlExpression (const QQmlScriptString & script , QQmlContext * ctxt = Q_NULLPTR, QObject * scope = Q_NULLPTR, QObject * parent = Q_NULLPTR)

创建 QQmlExpression object that is a child of parent .

script provides the expression to be evaluated, the context to evaluate it in, and the scope object to evaluate it with. If provided, ctxt and scope will override the context and scope object provided by script .

另请参阅 QQmlScriptString .

`[virtual]` QQmlExpression:: ~QQmlExpression ()

Destroy the QQmlExpression 实例。

void QQmlExpression:: clearError ()

Clear any expression errors. Calls to hasError () following this will return false.

另请参阅 hasError () 和 error ().

int QQmlExpression:: columnNumber () const

Returns the source file column number for this expression. The source location must have been previously set by calling setSourceLocation ().

QQmlContext *QQmlExpression:: context () const

返回 QQmlContext this expression is associated with, or 0 if there is no association or the QQmlContext has been destroyed.

QQmlEngine *QQmlExpression:: engine () const

返回 QQmlEngine this expression is associated with, or 0 if there is no association or the QQmlEngine has been destroyed.

QQmlError QQmlExpression:: error () const

Return any error from the last call to evaluate (). If there was no error, this returns an invalid QQmlError 实例。

另请参阅 hasError () 和 clearError ().

QVariant QQmlExpression:: evaluate ( bool * valueIsUndefined = Q_NULLPTR)

Evaulates the expression, returning the result of the evaluation, or an invalid QVariant if the expression is invalid or has an error.

valueIsUndefined is set to true if the expression resulted in an undefined value.

另请参阅 hasError () 和 error ().

QString QQmlExpression:: expression () const

Returns the expression string.

另请参阅 setExpression ().

bool QQmlExpression:: hasError () const

Returns true if the last call to evaluate () resulted in an error, otherwise false.

另请参阅 error () 和 clearError ().

int QQmlExpression:: lineNumber () const

Returns the source file line number for this expression. The source location must have been previously set by calling setSourceLocation ().

bool QQmlExpression:: notifyOnValueChanged () const

返回 true 若 valueChanged () signal is emitted when the expression's evaluated value changes.

另请参阅 setNotifyOnValueChanged ().

QObject *QQmlExpression:: scopeObject () const

Returns the expression's scope object, if provided, otherwise 0.

In addition to data provided by the expression's QQmlContext , the scope object's properties are also in scope during the expression's evaluation.

void QQmlExpression:: setExpression (const QString & expression )

Set the expression to expression .

另请参阅 expression ().

void QQmlExpression:: setNotifyOnValueChanged ( bool notifyOnChange )

Sets whether the valueChanged () signal is emitted when the expression's evaluated value changes.

若 notifyOnChange is true, the QQmlExpression will monitor properties involved in the expression's evaluation, and emit QQmlExpression::valueChanged () if they have changed. This allows an application to ensure that any value associated with the result of the expression remains up to date.

若 notifyOnChange is false (default), the QQmlExpression will not montitor properties involved in the expression's evaluation, and QQmlExpression::valueChanged () will never be emitted. This is more efficient if an application wants a "one off" evaluation of the expression.

另请参阅 notifyOnValueChanged ().

void QQmlExpression:: setSourceLocation (const QString & url , int line , int column = 0)

Set the location of this expression to line and column of url . This information is used by the script engine.

QString QQmlExpression:: sourceFile () const

Returns the source file URL for this expression. The source location must have been previously set by calling setSourceLocation ().

`[signal]` void QQmlExpression:: valueChanged ()

Emitted each time the expression value changes from the last time it was evaluated. The expression must have been evaluated at least once (by calling QQmlExpression::evaluate ()) before this signal will be emitted.

内容