Класс QQuickView

Класс QQuickView предоставляет окно для отображения пользовательского интерфейса Qt Quick. Подробнее...

• Список всех членов, включая наследуемые

Типы public

Свойства

• resizeMode : ResizeMode
• source : QUrl
• status : const Статус

• 3 свойства унаследованы от QQuickWindow
• 16 свойств унаследовано от QWindow
• 1 свойство унаследовано от QObject

Функции public

• 28 функций public, унаследованных от QQuickWindow
• 78 функций public, унаследованных от QWindow
• 31 функция public, унаследованная от QObject
• 6 функций public, унаследованных от QSurface

Слот public

• 2 слота public, унаследованных от QQuickWindow
• 22 слота public, унаследованных от QWindow
• 1 слот public, унаследованный от QObject

Сигналы

• 14 сигналов, унаследованных от QQuickWindow
• 18 сигналов, унаследованных от QWindow
• 2 сигнала, унаследованных от QObject

Переопределенные защищенные функции

• 14 защищенных функций, унаследованных от QQuickWindow
• 18 защищенных функций, унаследованных от QWindow
• 9 защищенных функций, унаследованных от QObject

Дополнительные унаследованные члены

• 2 статических public члена, унаследованные от QQuickWindow
• 1 статический public член, унаследованный от QWindow
• 11 статических public членов, унаследованных от QObject
• 14 защищенных функций, унаследованных от QQuickWindow
• 18 защищенных функций, унаследованных от QWindow
• 9 защищенных функций, унаследованных от QObject

Подробное описание

Класс QQuickView предоставляет окно для отображения пользовательского интерфейса Qt Quick.

Это удобный подкласс QQuickWindow, который автоматически загрузит и отобразит сцену QML, если ему будет передан URL-адрес основного исходного файла. В качестве альтернативы, вы можете создать собственные объекты, используя QQmlComponent, и разместить их в вручную настроенном QQuickWindow.

Типичное использование:

QQuickView *view = new QQuickView;
view->setSource(QUrl::fromLocalFile("myqmlfile.qml"));
view->show();

Для получения ошибок, связанных с загрузкой и выполнением QML с помощью QQuickView, вы можете подключиться к сигналу statusChanged() и отслеживать QQuickView::Error. Ошибки доступны через QQuickView::errors().

QQuickView также управляет масштабированием представления и корневого объекта. По умолчанию resizeMode равен SizeViewToRootObject, что загрузит компонент и изменят его размер до размера представления. В качестве альтернативы, resizeMode можно установить в SizeRootObjectToView, что изменит размер представления до размера корневого объекта.

См. также Экспонирование атрибутов типов C++ в QML и QQuickWidget.

Документация по типу члена

Перечисление QQuickView::ResizeMode

Это перечисление определяет способ изменения размера представления.

Перечисление QQuickView::Статус

Определяет статус загрузки QQuickView.

Документация по членам-функциям

QQuickView::QQuickView(QWindow *parent = Q_NULLPTR)

Создает QQuickView с заданным parent. Значение по умолчанию для parent — 0.

QQuickView::QQuickView(QQmlEngine *engine, QWindow *parent)

Создает QQuickView с заданным QML engine и parent.

Примечание: в этом случае QQuickView не владеет объектом engine; ответственность за уничтожение объекта лежит на вызывающей стороне. Если engine удален до удаления просмотра, status() вернет QQuickView::Error.

См. также Status, status() и errors().

QQuickView::QQuickView(const QUrl &source, QWindow *parent = Q_NULLPTR)

Создаёт QQuickView с заданным QML source и parent. Значение по умолчанию для parent — 0.

[virtual] QQuickView::~QQuickView()

Уничтожает QQuickView.

QQmlEngine *QQuickView::engine() const

Возвращает указатель на QQmlEngine, используемый для создания QML-компонентов.

QList<QQmlError> QQuickView::errors() const

Возвращает список ошибок, произошедших во время последней операции компиляции или создания. Если статус не Error, возвращается пустой список.

QSize QQuickView::initialSize() const

Возвращает начальный размер корневого объекта.

Если resizeMode равен QQuickItem::SizeRootObjectToView, корневой объект будет изменён на размер просматриваемого элемента. initialSize содержит размер корневого объекта до изменения размера.

[virtual protected] void QQuickView::keyPressEvent(QKeyEvent *e)

Переопределено из QWindow::keyPressEvent().

[virtual protected] void QQuickView::keyReleaseEvent(QKeyEvent *e)

Переопределено из QWindow::keyReleaseEvent().

[virtual protected] void QQuickView::mouseMoveEvent(QMouseEvent *e)

Переопределено из QWindow::mouseMoveEvent().

[virtual protected] void QQuickView::mousePressEvent(QMouseEvent *e)

Переопределено из QWindow::mousePressEvent().

[virtual protected] void QQuickView::mouseReleaseEvent(QMouseEvent *e)

Переопределено из QWindow::mouseReleaseEvent().

QQmlContext *QQuickView::rootContext() const

Эта функция возвращает корень иерархии контекстов. Каждый QML-компонент создаётся в QQmlContext. QQmlContext'ы необходимы для передачи данных QML-компонентам. В QML контексты организованы иерархически, и эта иерархия управляется QQmlEngine.

QQuickItem *QQuickView::rootObject() const

Возвращает корневой элемент просмотра.

[slot] void QQuickView::setSource(const QUrl &url)

Устанавливает источник в url, загружает QML-компонент и создаёт его экземпляр.

Убедитесь, что предоставленный URL-адрес полный и правильный, особенно используйте QUrl::fromLocalFile(), при загрузке файла из локальной файловой системы.

Вызов этого метода несколько раз с одним и тем же url приведёт к повторному созданию экземпляра QML-компонента.

Примечание: Функция-установщик для свойства source.

См. также source().

QUrl QQuickView::source() const

Возвращает URL-адрес источника, если он задан.

Примечание: Функция-получатель для свойства source.

См. также setSource().

[signal] void QQuickView::statusChanged(QQuickView::Status status)

Этот сигнал излучается при изменении текущего status компонента.

Примечание: Сигнал уведомления для свойства status.