Класс QQuickItem

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

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

Публичные типы

Свойства

• 1 свойство унаследовано от QObject

Публичные функции

• 32 публичные функции, унаследованные от QObject
• 2 публичные функции, унаследованные от QQmlParserStatus

Публичные слоты

• 1 публичный слот, унаследованный от QObject

Сигналы

• 2 сигнала, унаследованные от QObject

Защищённые функции

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

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

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

• 11 статических публичных членов, унаследованных от QObject

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

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

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

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

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

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

Предупреждение: Крайне важно, чтобы операции OpenGL и взаимодействие с графиком сцены происходили исключительно в потоке отрисовки, в основном во время вызова updatePaintNode(). Лучшее правило — использовать только классы с префиксом "QSG" внутри функции QQuickItem::updatePaintNode().

Примечание: Все классы с префиксом QSG должны использоваться только в потоке отрисовки графика сцены. Дополнительную информацию см. в разделе График сцены и отрисовка.

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

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

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

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

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

Примечание: Не рекомендуется использовать QObject::deleteLater() для очистки графических ресурсов, так как это выполняется в произвольное время, и неизвестно, будет ли привязан контекст OpenGL к моменту удаления.

Пользовательские элементы QPainter

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

Предупреждение: Использование QQuickPaintedItem использует косвенную 2D-поверхность для отрисовки содержимого, либо с помощью программной растризации, либо с помощью объекта буфера кадра OpenGL (FBO), поэтому отрисовка является двухэтапной операцией. Сначала растрируйте поверхность, затем отрисуйте поверхность. Использование API графической сцены напрямую всегда значительно быстрее.

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

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

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

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

enum QQuickItem::Flagflags QQuickItem::Flags

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

Тип Flags является типом-синонимом для QFlags<Flag>. Он хранит логическое ИЛИ комбинацию значений Flag.

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

enum QQuickItem::ItemChange

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

enum QQuickItem::TransformOrigin

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

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

import QtQuick 2.0

Rectangle {
    width: 100; height: 100

    FocusScope {
        focus: true

        TextInput {
            id: input
            focus: true
        }
    }
}

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
    }
}

// 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
    }
}

// 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
    }
}

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 = Q_NULLPTR)

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

[virtual] QQuickItem::~QQuickItem()

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

bool QQuickItem::acceptHoverEvents() const

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

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

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

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

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

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

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

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

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

QQuickItem *QQuickItem::childAt(qreal x, qreal y) const

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

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

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

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

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

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

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

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

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

[virtual protected] void QQuickItem::classBegin()

Переопределено из QQmlParserStatus::classBegin().

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

[virtual protected] void QQuickItem::componentComplete()

Переопределено из QQmlParserStatus::componentComplete().

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

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

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

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

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

QCursor QQuickItem::cursor() const

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

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

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

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

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

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

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

См. также Перетаскивание и Перетаскивание и сброс.

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

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

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

См. также Перетаскивание и Перетаскивание и сброс.

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

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

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

См. также Перетаскивание и Перетаскивание и сброс.

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

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

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

См. также Перетаскивание и Перетаскивание и сброс.

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

Переопределено из QObject::event().

bool QQuickItem::filtersChildMouseEvents() const

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

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

Flags QQuickItem::flags() const

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

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

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

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

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

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

void QQuickItem::forceActiveFocus()

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

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

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

См. также activeFocus.

void QQuickItem::forceActiveFocus(Qt::FocusReason reason)

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

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

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

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

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

[virtual protected] void QQuickItem::geometryChanged(const QRectF &newGeometry, const QRectF &oldGeometry)

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

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

void QQuickItem::grabMouse()

Захватывает ввод мыши.

Этот элемент будет получать все события мыши до вызова ungrabMouse(). Обычно вызывать эту функцию не нужно, так как прием, например, события нажатия мыши гарантирует, что последующие события будут доставлены элементу. Если элемент хочет захватить события мыши от текущего получателя, ему нужно вызвать эту функцию.

Предупреждение: Эту функцию следует использовать с осторожностью.

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

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

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

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

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

Примечание: Эта функция будет рендерить элемент на внеэкранной поверхности и копировать эту поверхность из памяти GPU в память CPU, что может быть довольно дорого. Для "живого" предварительного просмотра используйте слои или ShaderEffectSource.

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

void QQuickItem::grabTouchPoints(const QVector<int> &ids)

Захватывает точки касания, указанные в ids.

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

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

[protected] bool QQuickItem::heightValid() const

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

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

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

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

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

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

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

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

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

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

qreal QQuickItem::implicitWidth() const

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

Примечание: Метод-получатель свойства implicitWidth.

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

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

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

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

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

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

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

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(ItemChange change, const 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.

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

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

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

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

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

Примечание: Размещение окна выполняется менеджером окон, и это значение рассматривается только как подсказка. Поэтому фактическое положение окна может отличаться от ожидаемого.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание: Размещение окна выполняется менеджером окон, и это значение рассматривается только как подсказка. Поэтому фактическое положение окна может отличаться от ожидаемого.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[virtual protected] void QQuickItem::mouseUngrabEvent()

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

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

QQuickItem *QQuickItem::nextItemInFocusChain(bool forward = true)

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

void QQuickItem::polish()

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

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

[virtual protected] void QQuickItem::releaseResources()

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

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

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

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

QQuickItem *QQuickItem::scopedFocusItem() const

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

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

void QQuickItem::setAcceptHoverEvents(bool enabled)

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

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

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(Flag flag, bool enabled = true)

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

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

void QQuickItem::setFlags(Flags flags)

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

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

void QQuickItem::setKeepMouseGrab(bool keep)

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

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

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

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

void QQuickItem::setKeepTouchGrab(bool keep)

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

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

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

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

void QQuickItem::stackAfter(const QQuickItem *sibling)

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

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

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

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

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

void QQuickItem::stackBefore(const QQuickItem *sibling)

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

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

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

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

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

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

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

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

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

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

[virtual protected] void QQuickItem::touchUngrabEvent()

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

void QQuickItem::ungrabMouse()

Освобождает захват мыши после вызова grabMouse().

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

void QQuickItem::ungrabTouchPoints()

Освобождает захват точек касания, принадлежащих этому элементу.

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

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

void QQuickItem::unsetCursor()

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

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

[slot] void QQuickItem::update()

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

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

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

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

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

[virtual protected] QSGNode *QQuickItem::updatePaintNode(QSGNode *oldNode, 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() или добавлению и удалению узлов, то реализация может принять решение не перерисовывать сцену, так как визуальный результат идентичен.

Предупреждение: Крайне важно, чтобы операции OpenGL и взаимодействие с графическим деревом происходили исключительно в потоке отрисовки, в первую очередь во время вызова QQuickItem::updatePaintNode(). Лучшее правило — использовать только классы с префиксом «QSG» внутри функции QQuickItem::updatePaintNode().

Предупреждение: Эта функция вызывается в потоке отрисовки. Это означает, что все QObjects или локальные переменные, созданные в ней, будут привязаны к потоку отрисовки, поэтому будьте внимательны, когда делаете что-либо помимо отрисовки в этой функции. Аналогично, сигналы будут испускаться в потоке отрисовки и часто будут доставляться с помощью очереди.

Примечание: Все классы с префиксом QSG должны использоваться только в потоке отрисовки графического дерева. Подробнее см. Графическое дерево и отрисовка.

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

[virtual protected] void QQuickItem::updatePolish()

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

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

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

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

[protected] bool QQuickItem::widthValid() const

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

QQuickWindow *QQuickItem::window() const

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

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

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

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