Класс QQuickView

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

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

Общедоступные типы

Свойства

• resizeMode : ResizeMode
• source : QUrl
• status : const Status

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

Общедоступные функции

• 31 общедоступная функция унаследована от QQuickWindow
• 85 общедоступных функций унаследовано от QWindow
• 34 общедоступных функций унаследовано от QObject
• 6 общедоступных функций унаследовано от QSurface

Общедоступные слоты

• 2 общедоступных слота унаследовано от QQuickWindow
• 24 общедоступных слота унаследовано от QWindow
• 1 общедоступный слот унаследовано от QObject

Сигналы

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

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

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

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

• 1 общедоступная переменная унаследована от QWindow
• 1 общедоступная переменная унаследована от QObject
• 7 статических общедоступных членов унаследовано от QQuickWindow
• 3 статических общедоступных члена унаследовано от QWindow
• 10 статических общедоступных членов унаследовано от QObject
• 14 защищённых функций унаследовано от QQuickWindow
• 18 защищённых функций унаследовано от QWindow
• 9 защищённых функций унаследовано от QObject
• 2 защищённых переменных унаследовано от QObject
• 2 защищённых переменных унаследовано от QSurface

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

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

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

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

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

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

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

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

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

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

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

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

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

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

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

QQuickView::QQuickView(QWindow *parent = nullptr)

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

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

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

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

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

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

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

[override virtual] QQuickView::~QQuickView()

Удаляет QQuickView.

QQmlEngine *QQuickView::engine() const

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

QList<QQmlError> QQuickView::errors() const

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

QSize QQuickView::initialSize() const

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

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

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

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

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

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

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

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

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

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

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

Переопределено из QQuickWindow::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.