Класс QQuickItem

Класс QQuickItem предоставляет самые базовые визуальные элементы в Qt Quick. Подробнее...

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

Открытые типы

Свойства

Открытые функции

Public Slots

Signals

Protected Functions

Реализованные защищённые функции

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

Все визуальные элементы в Qt Quick наследуются от QQuickItem. Хотя экземпляр QQuickItem не имеет визуального представления, он определяет все атрибуты, общие для визуальных элементов, такие как положение x и y, ширина и высота, привязка и поддержка обработки клавиш.

Вы можете подклассировать QQuickItem, чтобы предоставить собственный пользовательский визуальный элемент, который наследует эти функции.

Пользовательские элементы графика сцены

Все визуальные элементы QML отрисовываются с использованием графика сцены, по умолчанию реализующий низкоуровневый высокопроизводительный стек отрисовки, тесно связанный с ускоренными графическими API, такими как OpenGL, Vulkan, Metal или Direct 3D. Подклассы QQuickItem могут добавлять собственное содержимое в график сцены, установив флаг QQuickItem::ItemHasContents и переопределив функцию QQuickItem::updatePaintNode().

Обработка графических ресурсов

Лучший способ обработки очистки графических ресурсов, используемых в графике сцены, – это полагаться на автоматическую очистку узлов. QSGNode, возвращаемый из QQuickItem::updatePaintNode(), автоматически удаляется в нужном потоке в нужное время. Деревья экземпляров QSGNode управляются с помощью QSGNode::OwnedByParent, который по умолчанию установлен. Таким образом, для большинства пользовательских элементов графика сцены дополнительных действий не потребуется.

Реализации, хранящие графические ресурсы вне дерева узлов, такие как элемент, реализующий QQuickItem::textureProvider(), должны позаботиться об их правильной очистке в зависимости от использования элемента в QML. Следует обработать следующие ситуации:

• График сцены делает недействительным; Это может произойти в зависимости от платформы и конфигурации QQuickWindow, когда окно скрывается с помощью QQuickWindow::hide() или когда оно закрывается. Если класс элемента реализует слот с именем slot, этот слот будет вызван в потоке отрисовки, в то время как поток GUI заблокирован. Это эквивалентно подключению к QQuickWindow::sceneGraphInvalidated(). При отрисовке через OpenGL контекст OpenGL окна этого элемента будет привязан, когда вызывается этот слот. Исключением является случай, когда собственный OpenGL был уничтожен вне контроля Qt, например, через EGL_CONTEXT_LOST.
• Элемент удаляется из сцены; Если элемент удаляется из сцены, например, потому что его родитель был установлен в null, или элемент находится в другом окне, то в потоке GUI будет вызван QQuickItem::releaseResources(). Для планирования задач очистки ресурсов отрисовки необходимо использовать QQuickWindow::scheduleRenderJob().
• Элемент удаляется; Когда выполняется деструктор элемента, он должен удалить все графические ресурсы, которые он имеет. Если ни одно из двух условий выше еще не было выполнено, элемент будет частью окна, и можно использовать QQuickWindow::scheduleRenderJob(), чтобы обеспечить их очистку. Если реализация игнорирует вызов QQuickItem::releaseResources(), в большинстве случаев элемент больше не будет иметь доступа к QQuickWindow, и таким образом не будет иметь возможности запланировать очистку.

При планировании очистки графических ресурсов с помощью QQuickWindow::scheduleRenderJob(), следует использовать либо QQuickWindow::BeforeSynchronizingStage, либо QQuickWindow::AfterSynchronizingStage. Стадия синхронизации — это момент, когда граф сцены изменяется в результате изменений в дереве QML. Если очистка запланирована в любое другое время, это может привести к тому, что другие части графа сцены будут ссылаться на только что удалённые объекты, так как эти части не были обновлены.

Настраиваемые элементы QPainter

QQuickItem предоставляет подкласс QQuickPaintedItem, который позволяет пользователям рендерить содержимое с помощью QPainter.

Анимации поведения

Если ваш элемент использует тип Behavior для определения анимаций изменений свойств, всегда используйте QObject::setProperty(), QQmlProperty() или QMetaProperty::write() при необходимости изменения этих свойств из C++. Это гарантирует, что движок QML знает об изменении свойства. В противном случае движок не сможет выполнить запрошенную анимацию. Обратите внимание, что эти функции несут небольшую нагрузку на производительность. Для получения более подробной информации см. Доступ к членам типа объекта QML из C++.

См. также QQuickWindow и QQuickPaintedItem.

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

перечисление QQuickItem::Flagфлаги QQuickItem::Flags

Этот тип перечисления используется для указания различных свойств элементов.

Тип Flags — это typedef для QFlags<Flag>. Он хранит комбинацию значений Flag с помощью операции OR.

См. также setFlag(), setFlags() и flags().

перечисление QQuickItem::ItemChange

Используется совместно с QQuickItem::itemChange() для уведомления элемента об определённых типах изменений.

перечисление QQuickItem::TransformOrigin

Управляет точкой, относительно которой применяются простые преобразования, такие как масштабирование.

См. также transformOrigin() и setTransformOrigin().

// Label.qml
import QtQuick 2.0

Item {
    property alias icon: image.source
    property alias label: text.text
    implicitWidth: text.implicitWidth + image.implicitWidth
    implicitHeight: Math.max(text.implicitHeight, image.implicitHeight)
    Image { id: image }
    Text {
        id: text
        wrapMode: Text.Wrap
        anchors.left: image.right; anchors.right: parent.right
        anchors.verticalCenter: parent.verticalCenter
    }
}

import QtQuick 2.0

Rectangle {
    width: 100; height: 100

    FocusScope {
        focus: true

        TextInput {
            id: input
            focus: true
        }
    }
}

Item {
    x: 50
    y: 100

    // prints: QRectF(-10, -20, 30, 40)
    Component.onCompleted: print(childrenRect)

    Item {
        x: -10
        y: -20
        width: 30
        height: 40
    }
}

Q_INVOKABLE bool contains(const QPointF &point) const;

import QtQuick 2.0

Rectangle {
    width: 100; height: 100

    FocusScope {
        id: scope

        TextInput {
            id: input
            focus: true
        }
    }
}

Rectangle {
    width: 100; height: 100

    TextInput {
          id: input
          focus: true
    }
}

Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
        Rectangle {
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

Item {
    Rectangle {
        opacity: 0.5
        color: "red"
        width: 100; height: 100
        Rectangle {
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

Rectangle {
    color: "blue"
    width: 100; height: 100
    Rectangle {
        color: "red"
        x: 25; y: 25; width: 50; height: 50
        rotation: 30
    }
}

import QtQuick 2.0

Rectangle {
    color: "blue"
    width: 100; height: 100

    Rectangle {
        color: "green"
        width: 25; height: 25
    }

    Rectangle {
        color: "red"
        x: 25; y: 25; width: 50; height: 50
        scale: 1.4
    }
}

Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
    }
    Rectangle {
        color: "blue"
        x: 50; y: 50; width: 100; height: 100
    }
}

Item {
    Rectangle {
        z: 1
        color: "red"
        width: 100; height: 100
    }
    Rectangle {
        color: "blue"
        x: 50; y: 50; width: 100; height: 100
    }
}

Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
        Rectangle {
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
        Rectangle {
            z: -1
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

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

QQuickItem::QQuickItem(QQuickItem *parent = nullptr)

Создаёт QQuickItem с заданным parent.

parent будет использоваться как визуальный родитель и родитель QObject.

[slot] void QQuickItem::update()

Планирует вызов updatePaintNode() для данного элемента.

Вызов QQuickItem::updatePaintNode() всегда будет происходить, если элемент отображается в QQuickWindow.

Вызывать QQuickItem::update() разрешено только для элементов, которые задают QQuickItem::ItemHasContents.

[signal] void QQuickItem::windowChanged(QQuickWindow *window)

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

[override virtual] QQuickItem::~QQuickItem()

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

bool QQuickItem::acceptHoverEvents() const

Возвращает значение, указывающее, принимаются ли события наведения курсора этим элементом.

Значение по умолчанию — ложь.

Если значение ложь, то элемент не получит никаких событий наведения курсора через функции hoverEnterEvent(), hoverMoveEvent() и hoverLeaveEvent().

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

[since 5.10] bool QQuickItem::acceptTouchEvents() const

Возвращает значение, указывающее, принимаются ли события касания этим элементом.

Значение по умолчанию — false.

Если значение false, то элемент не получит никаких событий касания через функцию touchEvent().

Эта функция была добавлена в Qt 5.10.

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

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

Возвращает кнопки мыши, принимаемые этим элементом.

Значение по умолчанию — Qt::NoButton; то есть, никакие кнопки мыши не принимаются.

Если элемент не принимает кнопку мыши для определённого события мыши, то событие мыши не будет передано элементу и будет передано следующему элементу в иерархии элементов.

См. также setAcceptedMouseButtons() и acceptTouchEvents().

[invokable] QQuickItem *QQuickItem::childAt(qreal x, qreal y) const

Возвращает первый видимый дочерний элемент, найденный в точке (x, y) в системе координат этого элемента.

Возвращает nullptr если такого элемента нет.

Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

QList<QQuickItem *> QQuickItem::childItems() const

Возвращает дочерние элементы этого элемента.

[virtual protected] bool QQuickItem::childMouseEventFilter(QQuickItem *item, QEvent *event)

Переопределите этот метод для фильтрации событий указателя, получаемых дочерними элементами этого элемента.

Этот метод будет вызван только если filtersChildMouseEvents() равно true.

Возвращайте true если указанное событие event не должно передаваться указанному дочернему элементу item и false в противном случае.

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

[override virtual protected] void QQuickItem::classBegin()

Реализует: QQmlParserStatus::classBegin().

Производные классы должны вызвать метод базового класса перед добавлением собственного действия, которое должно быть выполнено при classBegin.

[override virtual protected] void QQuickItem::componentComplete()

Реализует: QQmlParserStatus::componentComplete().

Производные классы должны вызвать метод базового класса перед добавлением собственных действий, которые должны быть выполнены при componentComplete.

[virtual invokable] bool QQuickItem::contains(const QPointF &point) const

Возвращает true если этот элемент содержит point, который находится в локальных координатах; в противном случае возвращает false.

Этот метод может быть переопределён для обработки столкновений точек в элементах с пользовательскими формами. По умолчанию проверяется, находится ли точка внутри containmentMask() (если он установлен) или внутри ограничивающей рамки в противном случае.

Примечание: Этот метод может вызываться через метаобъектную систему и из QML. См. Q_INVOKABLE.

QCursor QQuickItem::cursor() const

Возвращает форму курсора для данного элемента.

Курсор мыши примет эту форму, когда он будет над этим элементом, если не установлен курсор-замена. Список предопределённых объектов курсора можно найти в списке предопределённых объектов курсора .

Если форма курсора не установлена, возвращается курсор с формой Qt::ArrowCursor, однако может отображаться другая форма курсора, если перекрывающий элемент имеет действительную форму курсора.

См. также setCursor() и unsetCursor().

[virtual protected] void QQuickItem::dragEnterEvent(QDragEnterEvent *event)

Этот обработчик событий может быть переопределен в подклассе для получения событий drag-enter для элемента. Информация об событии предоставляется параметром event.

События перетаскивания и опускания предоставляются только в том случае, если для данного элемента установлен флаг ItemAcceptsDrops.

Событие принимается по умолчанию, поэтому не нужно явно принимать событие, если вы переопределяете эту функцию. Если вы не принимаете событие, вызовите event->ignore().

См. также Drag и Перетаскивание и опускание.

[virtual protected] void QQuickItem::dragLeaveEvent(QDragLeaveEvent *event)

Этот обработчик событий может быть переопределен в подклассе для получения событий drag-leave для элемента. Информация об событии предоставляется параметром event.

События перетаскивания и опускания предоставляются только в том случае, если для данного элемента установлен флаг ItemAcceptsDrops.

Событие принимается по умолчанию, поэтому не нужно явно принимать событие, если вы переопределяете эту функцию. Если вы не принимаете событие, вызовите event->ignore().

См. также Drag и Перетаскивание и опускание.

[virtual protected] void QQuickItem::dragMoveEvent(QDragMoveEvent *event)

Этот обработчик событий может быть переопределен в подклассе для получения событий drag-move для элемента. Информация об событии предоставляется параметром event.

События перетаскивания и опускания предоставляются только в том случае, если для данного элемента установлен флаг ItemAcceptsDrops.

Событие принимается по умолчанию, поэтому не нужно явно принимать событие, если вы переопределяете эту функцию. Если вы не принимаете событие, вызовите event->ignore().

См. также Drag и Перетаскивание и опускание.

[virtual protected] void QQuickItem::dropEvent(QDropEvent *event)

Этот обработчик событий может быть переопределен в подклассе для получения событий drop для элемента. Информация об событии предоставляется параметром event.

События перетаскивания и опускания предоставляются только в том случае, если для данного элемента установлен флаг ItemAcceptsDrops.

Событие принимается по умолчанию, поэтому не нужно явно принимать событие, если вы переопределяете эту функцию. Если вы не принимаете событие, вызовите event->ignore().

См. также Drag и Перетаскивание и опускание.

[override virtual protected] bool QQuickItem::event(QEvent *ev)

Реализует: QObject::event(QEvent *e).

bool QQuickItem::filtersChildMouseEvents() const

Возвращает значение, указывающее, должны ли события, предназначенные для дочерних элементов этого элемента, фильтроваться через этот элемент.

Если и у данного элемента, и у дочернего элемента включено acceptTouchEvents() true, то при взаимодействии с прикосновением, этот элемент отфильтрует событие касания. Но если ни данный элемент, ни дочерний элемент не могут обрабатывать события касания, childMouseEventFilter() будет вызван с синтезированным событием мыши.

См. также setFiltersChildMouseEvents() и childMouseEventFilter().

QQuickItem::Flags QQuickItem::flags() const

Возвращает флаги элемента для этого элемента.

См. также setFlags() и setFlag().

[virtual protected] void QQuickItem::focusInEvent(QFocusEvent *)

Этот обработчик событий может быть переопределен в подклассе для получения событий focus-in для элемента. Информация об событии предоставляется параметром event.

Событие принимается по умолчанию, поэтому не нужно явно принимать событие, если вы переопределяете эту функцию. Если вы не принимаете событие, вызовите event->ignore().

Если вы переопределяете эту функцию, вам следует вызвать реализацию базового класса.

[virtual protected] void QQuickItem::focusOutEvent(QFocusEvent *)

Этот обработчик событий может быть переопределен в подклассе для получения событий focus-out для элемента. Информация об событии предоставляется параметром event.

Событие принимается по умолчанию, поэтому не нужно явно принимать событие, если вы переопределяете эту функцию. Если вы не принимаете событие, вызовите event->ignore().

[invokable] void QQuickItem::forceActiveFocus()

Принудительно устанавливает активный фокус на элемент.

Этот метод устанавливает фокус на элемент и гарантирует, что все родительские объекты FocusScope в иерархии объектов также получают focus.

Причина изменения фокуса будет Qt::OtherFocusReason. Используйте перегруженный метод для указания причины изменения фокуса, чтобы обеспечить лучшее его обработку.

Примечание: Этот метод может вызываться через метаобъектную систему и из QML. См. Q_INVOKABLE.

См. также activeFocus.

[invokable, since 5.1] void QQuickItem::forceActiveFocus(Qt::FocusReason reason)

Это перегруженный метод.

Принудительно устанавливает активный фокус на элемент с заданной причиной reason.

Этот метод устанавливает фокус на элемент и гарантирует, что все родительские объекты FocusScope в иерархии объектов также получают focus.

Примечание: Этот метод может вызываться через метаобъектную систему и из QML. См. Q_INVOKABLE.

Этот метод был добавлен в Qt 5.1.

См. также activeFocus и Qt::FocusReason.

[virtual protected, since 6.0] void QQuickItem::geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry)

Этот метод вызывается для обработки изменений геометрии этого элемента от oldGeometry до newGeometry. Если две геометрии одинаковы, ничего не происходит.

Производные классы должны вызвать метод базового класса в своей реализации.

Этот метод был добавлен в Qt 6.0.

QSharedPointer<QQuickItemGrabResult> QQuickItem::grabToImage(const QSize &targetSize = QSize())

Захватывает элемент в изображение в оперативной памяти.

Захват происходит асинхронно, и сигнал QQuickItemGrabResult::ready() генерируется, когда захват завершен.

Используйте targetSize для задания размера целевого изображения. По умолчанию результат будет иметь такой же размер, как и элемент.

Если захват не может быть инициирован, функция возвращает null.

См. также QQuickWindow::grabWindow().

[protected] bool QQuickItem::heightValid() const

Возвращает значение, указывающее, был ли явно задан свойство высоты.

[virtual protected] void QQuickItem::hoverEnterEvent(QHoverEvent *event)

Обработчик этого события может быть переопределён в подклассе для получения событий входа мыши для элемента. Информация о событии предоставляется параметром event.

События наведения отображаются только если acceptHoverEvents() имеет значение true.

Событие по умолчанию принимается, поэтому явное принятие события при переопределении этой функции не требуется. Если вы не хотите принять событие, вызовите event->ignore().

[virtual protected] void QQuickItem::hoverLeaveEvent(QHoverEvent *event)

Обработчик этого события может быть переопределён в подклассе для получения событий выхода мыши для элемента. Информация о событии предоставляется параметром event.

События наведения отображаются только если acceptHoverEvents() имеет значение true.

Событие по умолчанию принимается, поэтому явное принятие события при переопределении этой функции не требуется. Если вы не хотите принять событие, вызовите event->ignore().

[virtual protected] void QQuickItem::hoverMoveEvent(QHoverEvent *event)

Обработчик этого события может быть переопределён в подклассе для получения событий перемещения мыши для элемента. Информация о событии предоставляется параметром event.

События наведения отображаются только если acceptHoverEvents() имеет значение true.

Событие по умолчанию принимается, поэтому явное принятие события при переопределении этой функции не требуется. Если вы не хотите принять событие, вызовите event->ignore().

qreal QQuickItem::implicitWidth() const

Возвращает ширину элемента, которая подразумевается другими свойствами, определяющими содержимое.

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

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

[virtual protected] void QQuickItem::inputMethodEvent(QInputMethodEvent *event)

Обработчик этого события может быть переопределён в подклассе для получения событий методов ввода для элемента. Информация о событии предоставляется параметром event.

Событие по умолчанию принимается, поэтому явное принятие события при переопределении этой функции не требуется. Если вы не хотите принять событие, вызовите event->ignore().

[virtual] QVariant QQuickItem::inputMethodQuery(Qt::InputMethodQuery query) const

Этот метод важен только для элементов ввода.

Если этот элемент является элементом ввода, этот метод должен быть переопределён для возврата соответствующих флагов метода ввода для заданного query.

См. также QWidget::inputMethodQuery().

[since 5.7] bool QQuickItem::isAncestorOf(const QQuickItem *child) const

Возвращает true, если этот элемент является предком child (т.е., если этот элемент является родителем child или одним из предков родителя child).

Эта функция была введена в Qt 5.7.

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

[protected] bool QQuickItem::isComponentComplete() const

Возвращает true, если построение QML-компонента завершено; в противном случае возвращает false.

Часто желательно отложить некоторую обработку до завершения компонента.

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

bool QQuickItem::isFocusScope() const

Возвращает true, если этот элемент является областью фокуса, и false в противном случае.

[virtual] bool QQuickItem::isTextureProvider() const

Возвращает true, если этот элемент является поставщиком текстур. По умолчанию возвращает false.

Эта функция может вызываться из любого потока.

[virtual protected] void QQuickItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value)

Вызывается при наступлении события change для этого элемента.

value содержит дополнительную информацию, относящуюся к изменению, если применимо.

Если вы переопределяете этот метод в подклассе, убедитесь, что вызываете

QQuickItem::itemChange(change, value);

обычно в конце вашей реализации, чтобы убедиться, что сигнал windowChanged() будет выпущен.

bool QQuickItem::keepMouseGrab() const

Возвращает значение, указывающее, следует ли сохранить захват мыши исключительно этим элементом.

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

bool QQuickItem::keepTouchGrab() const

Возвращает значение, указывающее, следует ли сохранить точки касания, захваченные этим элементом, исключительно этим элементом.

См. также setKeepTouchGrab() и keepMouseGrab().

[virtual protected] void QQuickItem::keyPressEvent(QKeyEvent *event)

Обработчик этого события может быть переопределён в подклассе для получения событий нажатия клавиш для элемента. Информация о событии предоставляется параметром event.

Событие по умолчанию принимается, поэтому явное принятие события при переопределении этой функции не требуется. Если вы не хотите принять событие, вызовите event->ignore().

[virtual protected] void QQuickItem::keyReleaseEvent(QKeyEvent *event)

Обработчик этого события может быть переопределён в подклассе для получения событий отпускания клавиш для элемента. Информация о событии предоставляется параметром event.

Событие по умолчанию принимается, поэтому явное принятие события при переопределении этой функции не требуется. Если вы не хотите принять событие, вызовите event->ignore().

[since 5.7] QPointF QQuickItem::mapFromGlobal(const QPointF &point) const

Преобразует заданную точку point в глобальной системе координат экрана в эквивалентную точку в системе координат этого элемента и возвращает преобразованную координату.

В преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

Например, это может быть полезно для добавления всплывающего окна к компоненту Qt Quick.

Эта функция была введена в Qt 5.7.

См. также Концепции - Визуальные координаты в Qt Quick.

QPointF QQuickItem::mapFromItem(const QQuickItem *item, const QPointF &point) const

Преобразует заданную точку point в системе координат item в эквивалентную точку в системе координат этого элемента и возвращает преобразованную координату.

В преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

Если item равен 0, это преобразует point из системы координат сцены.

См. также Концепции - Визуальные координаты в Qt Quick.

QPointF QQuickItem::mapFromScene(const QPointF &point) const

Преобразует заданную точку point в системе координат сцены в эквивалентную точку в системе координат этого элемента и возвращает преобразованную координату.

В преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

См. также Концепции — Визуальные координаты в Qt Quick.

QRectF QQuickItem::mapRectFromItem(const QQuickItem *item, const QRectF &rect) const

Преобразует заданный прямоугольник rect в системе координат элемента item в эквивалентную прямоугольную область в системе координат текущего элемента и возвращает преобразованный прямоугольник.

При преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

Если item равен 0, преобразование выполняется из системы координат сцены.

См. также Концепции — Визуальные координаты в Qt Quick.

QRectF QQuickItem::mapRectFromScene(const QRectF &rect) const

Преобразует заданный прямоугольник rect в системе координат сцены в эквивалентную прямоугольную область в системе координат текущего элемента и возвращает преобразованный прямоугольник.

При преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

См. также Концепции — Визуальные координаты в Qt Quick.

QRectF QQuickItem::mapRectToItem(const QQuickItem *item, const QRectF &rect) const

Преобразует заданный прямоугольник rect в системе координат текущего элемента в эквивалентную прямоугольную область в системе координат элемента item и возвращает преобразованный прямоугольник.

При преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

Если item равен 0, преобразование выполняется в систему координат сцены.

См. также Концепции — Визуальные координаты в Qt Quick.

QRectF QQuickItem::mapRectToScene(const QRectF &rect) const

Преобразует заданный прямоугольник rect в системе координат текущего элемента в эквивалентную прямоугольную область в системе координат сцены и возвращает преобразованный прямоугольник.

При преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

См. также Концепции — Визуальные координаты в Qt Quick.

[since 5.7] QPointF QQuickItem::mapToGlobal(const QPointF &point) const

Преобразует заданную точку point в системе координат текущего элемента в эквивалентную точку в глобальной системе координат экрана и возвращает преобразованную координату.

При преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

Например, это может быть полезно для добавления всплывающего окна к компоненту Qt Quick.

Функция была добавлена в Qt 5.7.

См. также Концепции — Визуальные координаты в Qt Quick.

QPointF QQuickItem::mapToItem(const QQuickItem *item, const QPointF &point) const

Преобразует заданную точку point в системе координат текущего элемента в эквивалентную точку в системе координат элемента item и возвращает преобразованную координату.

При преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

Если item равен 0, преобразование выполняется в систему координат сцены.

См. также Концепции — Визуальные координаты в Qt Quick.

QPointF QQuickItem::mapToScene(const QPointF &point) const

Преобразует заданную точку point в системе координат текущего элемента в эквивалентную точку в системе координат сцены и возвращает преобразованную координату.

При преобразовании используются следующие свойства элемента: x, y, scale, rotation, transformOrigin и transform.

См. также Концепции — Визуальные координаты в Qt Quick.

[virtual protected] void QQuickItem::mouseDoubleClickEvent(QMouseEvent *event)

Обработчик событий может быть переопределен в подклассе для получения событий двойного щелчка мыши для элемента. Информация о событии предоставляется параметром event.

Событие по умолчанию обрабатывается, поэтому явное принятие события при переопределении функции не требуется. Если вы не хотите обрабатывать событие, вызовите event->ignore().

[virtual protected] void QQuickItem::mouseMoveEvent(QMouseEvent *event)

Обработчик событий может быть переопределен в подклассе для получения событий перемещения мыши для элемента. Информация о событии предоставляется параметром event.

Для получения событий перемещения мыши предыдущее событие нажатия мыши должно быть принято (например, путём переопределения mousePressEvent() ), и acceptedMouseButtons() должно возвращать соответствующую кнопку мыши.

Событие по умолчанию обрабатывается, поэтому явное принятие события при переопределении функции не требуется. Если вы не хотите обрабатывать событие, вызовите event->ignore().

[virtual protected] void QQuickItem::mousePressEvent(QMouseEvent *event)

Обработчик событий может быть переопределен в подклассе для получения событий нажатия мыши для элемента. Информация о событии предоставляется параметром event.

Для получения событий нажатия мыши acceptedMouseButtons() должно возвращать соответствующую кнопку мыши.

Событие по умолчанию обрабатывается, поэтому явное принятие события при переопределении функции не требуется. Если вы не хотите обрабатывать событие, вызовите event->ignore().

[virtual protected] void QQuickItem::mouseReleaseEvent(QMouseEvent *event)

Обработчик событий может быть переопределен в подклассе для получения событий отпускания мыши для элемента. Информация о событии предоставляется параметром event.

Для получения событий отпускания мыши предыдущее событие нажатия мыши должно быть принято (например, путём переопределения mousePressEvent() ), и acceptedMouseButtons() должно возвращать соответствующую кнопку мыши.

Событие по умолчанию обрабатывается, поэтому явное принятие события при переопределении функции не требуется. Если вы не хотите обрабатывать событие, вызовите event->ignore().

[virtual protected] void QQuickItem::mouseUngrabEvent()

Этот обработчик событий может быть переопределен в подклассе для получения уведомления о событии отпускания захвата мыши этим элементом.

[invokable] QQuickItem *QQuickItem::nextItemInFocusChain(bool forward = true)

Возвращает элемент в цепочке фокуса, следующий за этим элементом. Если forward равно true, или не указано, то это следующий элемент в прямом направлении. Если forward равно false, то это следующий элемент в обратном направлении.

Примечание: К этой функции можно обратиться через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QQuickItem::polish()

Планирует событие полирования для этого элемента.

При обработке запроса графическим деревом сцены он вызовет updatePolish() для этого элемента.

См. также updatePolish() и QQuickTest::qIsPolishScheduled().

[virtual protected] void QQuickItem::releaseResources()

Этот метод вызывается, когда элемент должен освободить графические ресурсы, которые еще не управляются узлами, возвращаемыми из QQuickItem::updatePaintNode().

Это происходит, когда элемент собирается быть удалённым из окна, в котором он ранее отображался. Гарантируется, что у элемента есть окно, когда этот метод вызывается.

Этот метод вызывается в потоке GUI, и состояние потока отрисовки, если оно используется, неизвестно. Объекты не должны удаляться напрямую, а вместо этого должны быть запланированы для очистки с помощью QQuickWindow::scheduleRenderJob().

См. также Обработка графических ресурсов.

QQuickItem *QQuickItem::scopedFocusItem() const

Если этот элемент является областью фокуса, этот метод возвращает элемент в его цепочке фокуса, который в данный момент имеет фокус.

Возвращает nullptr если этот элемент не является областью фокуса.

void QQuickItem::setAcceptHoverEvents(bool enabled)

Если enabled имеет значение true, это устанавливает элемент для приема событий наведения; в противном случае события наведения не принимаются этим элементом.

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

[since 5.10] void QQuickItem::setAcceptTouchEvents(bool enabled)

Если enabled имеет значение true, это устанавливает элемент для приема событий касания; в противном случае события касания не принимаются этим элементом.

Этот метод был введён в Qt 5.10.

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

void QQuickItem::setAcceptedMouseButtons(Qt::MouseButtons buttons)

Устанавливает принимаемые этим элементом кнопки мыши на buttons.

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

void QQuickItem::setCursor(const QCursor &cursor)

Устанавливает форму cursor для этого элемента.

См. также cursor() и unsetCursor().

void QQuickItem::setFiltersChildMouseEvents(bool filter)

Устанавливает, должны ли события указателя, предназначенные для дочерних элементов этого элемента, фильтроваться через этот элемент.

Если filter имеет значение true, childMouseEventFilter() будет вызываться при возникновении события указателя для дочернего элемента.

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

void QQuickItem::setFlag(QQuickItem::Flag flag, bool enabled = true)

Включает указанный флаг flag для этого элемента, если enabled имеет значение true; если enabled имеет значение false, флаг отключается.

Они предоставляют различные подсказки для элемента; например, флаг ItemClipsChildrenToShape указывает, что все дочерние элементы этого элемента должны обрезаться для соответствия области элемента.

void QQuickItem::setFlags(QQuickItem::Flags flags)

Включает указанные флаги flags для этого элемента.

См. также flags() и setFlag().

void QQuickItem::setKeepMouseGrab(bool keep)

Устанавливает, должно ли взаимодействие с мышью оставаться исключительно с этим элементом.

Это полезно для элементов, которые хотят захватить и удерживать взаимодействие с мышью после выполнения определённого жеста. Например, элемент, который заинтересован в горизонтальном движении мыши, может установить keepMouseGrab в значение true, как только будет превышен порог. После того, как keepMouseGrab будет установлено в значение true, фильтрующие элементы не будут реагировать на события мыши.

Если keep имеет значение false, фильтрующий элемент может захватить управление. Например, Flickable может попытаться захватить управление мышью, если обнаружит, что пользователь начал перемещать область просмотра.

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

void QQuickItem::setKeepTouchGrab(bool keep)

Устанавливает, должны ли точки касания, захваченные этим элементом, оставаться исключительно с этим элементом.

Это полезно для элементов, которые хотят захватить и удерживать определённые точки касания после выполнения определённого жеста. Например, элемент, который заинтересован в горизонтальном перемещении точек касания, может установить setKeepTouchGrab в значение true, как только будет превышен порог. После того, как setKeepTouchGrab будет установлено в значение true, фильтрующие элементы не будут реагировать на соответствующие точки касания.

Если keep имеет значение false, фильтрующий элемент может захватить управление. Например, Flickable может попытаться захватить управление точкой касания, если обнаружит, что пользователь начал перемещать область просмотра.

См. также keepTouchGrab() и setKeepMouseGrab().

[since 5.10] void QQuickItem::setSize(const QSizeF &size)

Устанавливает размер элемента на size. Этот метод сохраняет любые существующие привязки к ширине и высоте; таким образом, любое изменение, которое приводит к повторному выполнению привязки, перепишет установленные значения.

Этот метод был введён в Qt 5.10.

См. также size, setWidth и setHeight.

[since 5.10] QSizeF QQuickItem::size() const

Возвращает размер элемента.

Этот метод был введён в Qt 5.10.

См. также setSize, width и height.

void QQuickItem::stackAfter(const QQuickItem *sibling)

Перемещает указанный элемент sibling на индекс после этого элемента в списке дочерних элементов. Порядок дочерних элементов влияет как на порядок визуального расположения, так и на порядок навигации по табу.

Предполагая, что значения z обоих элементов одинаковы, это приведет к тому, что sibling будет отрисовываться ниже этого элемента.

Если у обоих элементов установлено activeFocusOnTab в true, это также изменит порядок фокуса по табу, и sibling получит фокус перед этим элементом.

Указанный sibling должен быть дочерним элементом этого элемента; то есть они должны иметь того же непосредственного родителя.

См. также Концепции - Визуальный родитель в Qt Quick.

void QQuickItem::stackBefore(const QQuickItem *sibling)

Перемещает указанный элемент sibling на индекс перед этим элементом в списке дочерних элементов. Порядок дочерних элементов влияет как на порядок визуального расположения, так и на порядок навигации по табу.

Предполагая, что значения z обоих элементов одинаковы, это приведет к тому, что sibling будет отрисовываться над этим элементом.

Если у обоих элементов установлено activeFocusOnTab в true, это также изменит порядок фокуса по табу, и sibling получит фокус после этого элемента.

Указанный sibling должен быть дочерним элементом этого элемента; то есть они должны иметь того же непосредственного родителя.

См. также Концепции - Визуальный родитель в Qt Quick.

[virtual] QSGTextureProvider *QQuickItem::textureProvider() const

Возвращает провайдер текстур для элемента. Реализация по умолчанию возвращает nullptr.

Этот метод может быть вызван только в потоке отрисовки.

[virtual protected] void QQuickItem::touchEvent(QTouchEvent *event)

Этот обработчик событий может быть переопределен в подклассе для получения событий касания для элемента. Информация об событии предоставляется параметром event.

Событие принимается по умолчанию, поэтому нет необходимости явно принимать событие, если вы переопределяете этот метод. Если вы не принимаете событие, вызовите event->ignore().

[virtual protected] void QQuickItem::touchUngrabEvent()

Этот обработчик событий может быть переопределён в подклассе для получения уведомления о событии отпускания захвата касания для этого элемента.

void QQuickItem::unsetCursor()

Очищает форму курсора для этого элемента.

См. также cursor() и setCursor().

[protected] void QQuickItem::updateInputMethod(Qt::InputMethodQueries queries = Qt::ImQueryInput)

Уведомить метод ввода о обновлённых значениях запроса, если это необходимо. queries указывает изменённые атрибуты.

[virtual protected] QSGNode *QQuickItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *updatePaintNodeData)

Вызывается в потоке отрисовки, когда необходимо синхронизировать состояние элемента с деревом сцены.

Функция вызывается в результате QQuickItem::update(), если пользователь установил флаг QQuickItem::ItemHasContents для элемента.

Функция должна вернуть корень поддерева сцены для этого элемента. Большинство реализаций вернут один QSGGeometryNode, содержащий визуальное представление этого элемента. oldNode — узел, возвращённый в прошлый раз при вызове функции. updatePaintNodeData предоставляет указатель на QSGTransformNode, связанный с этим QQuickItem.

QSGNode *MyItem::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
{
    QSGSimpleRectNode *n = static_cast<QSGSimpleRectNode *>(node);
    if (!n) {
        n = new QSGSimpleRectNode();
        n->setColor(Qt::red);
    }
    n->setRect(boundingRect());
    return n;
}

Основной поток заблокирован во время выполнения этой функции, поэтому безопасно считывать значения из экземпляра QQuickItem и других объектов в основном потоке.

Если ни один вызов QQuickItem::updatePaintNode() не привёл к фактическим изменениям в дереве сцены, например, к вызову QSGNode::markDirty() или добавлению и удалению узлов, то реализация может решить не перерисовывать сцену, так как визуальный результат будет идентичным.

См. также QSGMaterial, QSGGeometryNode, QSGGeometry, QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty() и Обработка графических ресурсов.

[virtual protected] void QQuickItem::updatePolish()

Эта функция должна выполнять любой необходимый для данного элемента макет.

Когда вызывается polish(), дерево сцены планирует событие polish для этого элемента. Когда дерево сцены готово отобразить этот элемент, оно вызывает updatePolish(), чтобы выполнить макет элемента перед отрисовкой следующего кадра.

[virtual protected] void QQuickItem::wheelEvent(QWheelEvent *event)

Этот обработчик событий может быть переопределён в подклассе для получения событий прокрутки для элемента. Информация об событии предоставляется параметром event.

Событие принимается по умолчанию, поэтому нет необходимости явно принимать событие, если вы переопределили эту функцию. Если вы не принимаете событие, вызовите event->ignore().

[protected] bool QQuickItem::widthValid() const

Возвращает, была ли явно задана ширина свойства.

QQuickWindow *QQuickItem::window() const

Возвращает окно, в котором отображается этот элемент.

У элемента нет окна, пока он не назначен в сцену. Сигнал windowChanged() предоставляет уведомление как при входе элемента в сцену, так и при его удалении из сцены.