Класс QGraphicsItem

Класс QGraphicsItem является базовым классом для всех графических элементов в QGraphicsScene. Подробнее...

Этот класс был представлен в Qt 4.2.

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

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

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

Protected Functions

Related Non-Members

Detailed Description

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

Для удобства Qt предоставляет набор стандартных графических элементов для наиболее распространённых форм. Это:

• QGraphicsEllipseItem предоставляет эллиптический элемент
• QGraphicsLineItem предоставляет линейный элемент
• QGraphicsPathItem предоставляет элемент произвольной траектории
• QGraphicsPixmapItem предоставляет элемент пиксельного изображения
• QGraphicsPolygonItem предоставляет элемент многоугольника
• QGraphicsRectItem предоставляет прямоугольный элемент
• QGraphicsSimpleTextItem предоставляет простой текстовый метку элемент
• QGraphicsTextItem предоставляет расширенный текстовый элемент просмотра

Вся геометрическая информация элемента основана на его локальной системе координат. Позиция элемента, pos(), — единственная функция, которая не работает в локальных координатах, так как она возвращает позицию в координатах родителя. Система координат Визуализации графики подробно описывает систему координат.

Вы можете указать, должен ли элемент быть видимым (т.е. отображаться и принимать события), вызвав setVisible(). Скрытие элемента также скроет его дочерние элементы. Аналогично, вы можете включить или отключить элемент, вызвав setEnabled(). Если вы отключите элемент, все его дочерние элементы также будут отключены. По умолчанию элементы одновременно видимые и активные. Чтобы переключить, выбран ли элемент или нет, сначала включите выбор, установив флаг ItemIsSelectable, а затем вызовите setSelected(). Обычно выбор переключается сценой в результате взаимодействия пользователя.

Чтобы написать свой собственный графический элемент, вы сначала создаёте подкласс QGraphicsItem, а затем начинаете с реализации двух своих чисто виртуальных общедоступных функций: boundingRect(), которая возвращает оценку области, нарисованной элементом, и paint(), которая реализует фактическое рисование. Например:

class SimpleItem : public QGraphicsItem
{
public:
    QRectF boundingRect() const override
    {
        qreal penWidth = 1;
        return QRectF(-10 - penWidth / 2, -10 - penWidth / 2,
                      20 + penWidth, 20 + penWidth);
    }

    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option,
               QWidget *widget) override
    {
        painter->drawRoundedRect(-10, -10, 20, 20, 5, 5);
    }
};

Функция boundingRect() имеет много разных целей. QGraphicsScene основывает свой индекс элемента на boundingRect(), а QGraphicsView использует её как для отсечения невидимых элементов, так и для определения области, которая должна быть перекомпонована при рисовании перекрывающихся элементов. Кроме того, механизмы обнаружения столкновений QGraphicsItem используют boundingRect() для обеспечения эффективной отсечки. Точная алгоритм столкновений в collidesWithItem() основан на вызове shape(), которое возвращает точный контур формы элемента в виде QPainterPath.

QGraphicsScene ожидает, что все элементы boundingRect() и shape() останутся неизменными, пока не будет уведомлено. Если вы хотите изменить геометрию элемента каким-либо образом, вы должны сначала вызвать prepareGeometryChange(), чтобы позволить QGraphicsScene обновить свою учётную запись.

Обнаружение столкновений можно осуществить двумя способами:

1. Переопределите shape(), чтобы вернуть точную форму для вашего элемента, и опирайтесь на стандартную реализацию collidesWithItem() для выполнения пересечения формы с формой. Это может быть довольно дорогостоящим, если формы сложные.
2. Переопределите collidesWithItem(), чтобы предоставить собственный алгоритм столкновения элемента и формы.

Функцию contains() можно вызвать, чтобы определить, содержит ли элемент точку или нет. Эту функцию также можно переопределить в элементе. По умолчанию поведение функции contains() основано на вызове функции shape().

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

Преобразования

QGraphicsItem поддерживает проективные преобразования помимо своего базового положения, pos(). Существует несколько способов изменения преобразования элемента. Для простых преобразований можно вызвать удобные функции setRotation() или setScale(), или передать любую матрицу преобразования в setTransform(). Для расширенного управления преобразованием также можно задать несколько комбинированных преобразований, вызвав setTransformations().

Преобразования элементов накапливаются от родителя к дочернему элементу, поэтому если как родительский, так и дочерний элемент повернуты на 90 градусов, общее преобразование дочернего элемента будет составлять 180 градусов. Аналогично, если родительский элемент масштабируется в 2 раза относительно своего исходного размера, дочерние элементы также будут в два раза больше. Преобразование элемента не влияет на его собственную локальную геометрию; все геометрические функции (например, contains(), update() и все функции отображения) по-прежнему работают в локальных координатах. Для удобства QGraphicsItem предоставляет функции sceneTransform(), которая возвращает общую матрицу преобразования элемента (включая его положение и положения и преобразования всех родителей), и scenePos(), которая возвращает его положение в координатах сцены. Для сброса матрицы элемента вызовите resetTransform().

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

• Применяется базовое преобразование элемента (transform())
• Список преобразований элемента применяется в порядке следования (transformations())
• Элемент вращается относительно точки начала преобразования (rotation(), transformOriginPoint())
• Элемент масштабируется относительно точки начала преобразования (scale(), transformOriginPoint())

Отрисовка

Функция paint() вызывается QGraphicsView для отрисовки содержимого элемента. У элемента нет собственного фона или заливки по умолчанию; всё, что находится за элементом, будет просвечивать сквозь все области, которые явно не отрисованы в этой функции. Вы можете вызвать update() для планирования перерисовки, необязательно передав прямоугольник, который необходимо перерисовать. В зависимости от того, виден ли элемент в представлении, он может или не может быть перерисован; нет эквивалента QWidget::repaint() в QGraphicsItem.

Элементы отрисовываются представлением, начиная с родительских элементов, а затем отрисовываются дочерние элементы в порядке возрастания порядка наложения. Вы можете установить порядок наложения элемента, вызвав setZValue(), и проверить его, вызвав zValue(), где элементы с низкими значениями z отрисовываются перед элементами с высокими значениями z. Порядок наложения применяется к соседним элементам; родители всегда отрисовываются перед своими детьми.

Сортировка

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

Дочерние элементы элемента накладываются поверх родительского элемента, а соседние элементы накладываются в порядке вставки (т.е. в том же порядке, в котором они были добавлены в сцену или в родительский элемент). Если вы добавите элемент A, а затем B, то B будет поверх A. Если затем вы добавите C, порядок наложения элементов будет A, затем B, затем C.

В этом примере показан порядок наложения всех конечностей робота из примера Drag and Drop Robot. Туловище является корневым элементом (все остальные элементы являются дочерними или потомками туловища), поэтому оно отрисовывается первым. Затем отрисовывается голова, так как это первый элемент в списке дочерних элементов туловища. Затем рисуется левая верхняя рука. Так как нижняя рука является дочерним элементом верхней руки, нижняя рука отрисовывается затем, за ней — следующая сестра верхней руки, которая является правой верхней рукой, и так далее.

Для продвинутых пользователей существуют способы изменения того, как сортируются ваши элементы:

• Вы можете вызвать setZValue() для элемента, чтобы явно расположить его поверх или под другими соседними элементами. Значение Z по умолчанию для элемента равно 0. Элементы с одинаковым значением Z накладываются в порядке вставки.
• Вы можете вызвать stackBefore(), чтобы изменить порядок списка дочерних элементов. Это напрямую изменит порядок вставки.
• Вы можете установить флаг ItemStacksBehindParent, чтобы поместить дочерний элемент позади своего родительского элемента.

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

События

QGraphicsItem получает события от QGraphicsScene через виртуальную функцию sceneEvent(). Эта функция распределяет наиболее распространённые события по набору удобных обработчиков событий:

• contextMenuEvent() обрабатывает события контекстного меню
• focusInEvent() и focusOutEvent() обрабатывают события ввода и выхода фокуса
• hoverEnterEvent(), hoverMoveEvent() и hoverLeaveEvent() обрабатывают события ввода, перемещения и выхода с области наведения
• inputMethodEvent() обрабатывает события ввода для поддержки доступности
• keyPressEvent() и keyReleaseEvent() обрабатывают события нажатия и отпускания клавиш
• mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent() и mouseDoubleClickEvent() обрабатывают события нажатия, перемещения, отпускания, щелчка и двойного щелчка мыши

Вы можете фильтровать события для любого другого элемента, установив фильтры событий. Эта функциональность отделена от стандартных фильтров событий Qt (см. QObject::installEventFilter()), которые работают только с подклассами QObject. После установки вашего элемента в качестве фильтра событий для другого элемента, вызвав installSceneEventFilter(), отфильтрованные события будут получены виртуальной функцией sceneEventFilter(). Вы можете удалить фильтры событий элемента, вызвав removeSceneEventFilter().

Пользовательские данные

Иногда бывает полезно зарегистрировать пользовательские данные с элементом, будь то пользовательский элемент или стандартный. Вы можете вызвать setData() для любого элемента, чтобы сохранить данные в нём с помощью пары ключ-значение (ключ — целое число, а значение — QVariant). Чтобы получить пользовательские данные из элемента, вызовите data(). Эта функциональность полностью не затрагивается Qt; она предоставляется для удобства пользователя.

См. также QGraphicsScene, QGraphicsView и Графическая система отображения.

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

enum QGraphicsItem::CacheMode

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

Это перечисление было введено или изменено в Qt 4.4.

См. также QGraphicsItem::setCacheMode().

enum QGraphicsItem::GraphicsItemChange

Этот перечисление описывает изменения состояния, о которых уведомляет QGraphicsItem::itemChange(). Уведомления отправляются по мере изменения состояния, и в некоторых случаях можно внести коррективы (см. документацию по каждому изменению для подробностей).

Примечание: будьте осторожны при вызове функций на самом QGraphicsItem внутри itemChange(), так как определенные вызовы функций могут привести к нежелательной рекурсии. Например, вы не можете вызвать setPos() в itemChange() при уведомлении об изменении позиции элемента, так как функция setPos() снова вызовет itemChange(ItemPositionChange). Вместо этого вы можете вернуть новую, скорректированную позицию из itemChange().

enum QGraphicsItem::GraphicsItemFlagflags QGraphicsItem::GraphicsItemFlags

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

Все флаги по умолчанию отключены.

Примечание: Этот флаг аналогичен ItemContainsChildrenInShape, но дополнительно принудительно устанавливает ограничение, обрезая дочерние элементы.

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

Примечание: Если оба флага, этот и ItemClipsChildrenToShape, установлены, обрезка будет выполнена. Это эквивалентно установке только ItemClipsChildrenToShape.

Этот флаг был введён в Qt 5.4.

Тип GraphicsItemFlags является псевдонимом для QFlags<GraphicsItemFlag>. Он хранит логическое ИЛИ сочетание значений GraphicsItemFlag.

перечисление QGraphicsItem::PanelModality

Это перечисление определяет поведение модальной панели. Модальная панель — это панель, которая блокирует ввод на другие панели. Обратите внимание, что элементы, являющиеся дочерними элементами модальной панели, не блокируются.

Значения:

Это перечисление было введено или изменено в Qt 4.6.

См. также QGraphicsItem::setPanelModality(), QGraphicsItem::panelModality(), и QGraphicsItem::ItemIsPanel.

enum QGraphicsItem::anonymous

Значение, возвращаемое виртуальной функцией type() в стандартных классах графических элементов в Qt. Все такие стандартные классы графических элементов в Qt ассоциированы с уникальным значением для Type, например, значение, возвращаемое QGraphicsPathItem::type(), равно 2.

class QGraphicsPathItem : public QAbstractGraphicsShapeItem
{
 public:
  enum { Type = 2 };
    int type() const override { return Type; }
  ...
};

class CustomItem : public QGraphicsItem
{
public:
   enum { Type = UserType + 1 };

   int type() const override
   {
       // Enable the use of qgraphicsitem_cast with this item.
       return Type;
   }
   ...
};

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

QGraphicsItem::QGraphicsItem(QGraphicsItem *parent = nullptr)

Конструирует QGraphicsItem с заданным элементом parent. Он не изменяет объект родителя, возвращаемый QObject::parent().

Если parent равен nullptr, вы можете добавить элемент в сцену, вызвав QGraphicsScene::addItem(). Тогда элемент станет верхним элементом.

См. также QGraphicsScene::addItem() и setParentItem().

[virtual] QGraphicsItem::~QGraphicsItem()

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

Примечание: Более эффективно удалить элемент из QGraphicsScene перед уничтожением элемента.

bool QGraphicsItem::acceptDrops() const

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

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

bool QGraphicsItem::acceptHoverEvents() const

Возвращает true, если элемент принимает события наведения (QGraphicsSceneHoverEvent); в противном случае, возвращает false. По умолчанию элементы не принимают события наведения.

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

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

bool QGraphicsItem::acceptTouchEvents() const

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

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

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

Qt::MouseButtons QGraphicsItem::acceptedMouseButtons() const

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

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

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

[virtual] void QGraphicsItem::advance(int phase)

Эта виртуальная функция вызывается дважды для всех элементов слотом QGraphicsScene::advance(). В первом цикле все элементы вызываются с phase == 0, что указывает на то, что элементы на сцене должны перейти к следующему состоянию, а затем все элементы вызываются с phase == 1. Переопределите эту функцию, чтобы обновить свой элемент, если вам нужна простая анимация, управляемая сценой.

По умолчанию функция ничего не делает.

Функция предназначена для анимации. Альтернативой является множественное наследование от QObject и QGraphicsItem и использование фреймворка анимации.

См. также QGraphicsScene::advance() и QTimeLine.

[pure virtual] QRectF QGraphicsItem::boundingRect() const

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

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

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

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

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

Пример:

QRectF CircleItem::boundingRect() const
{
    qreal penWidth = 1;
    return QRectF(-radius - penWidth / 2, -radius - penWidth / 2,
                  diameter + penWidth, diameter + penWidth);
}

См. также boundingRegion(), shape(), contains(), Система координат графического представления и prepareGeometryChange().

QRegion QGraphicsItem::boundingRegion(const QTransform &itemToDeviceTransform) const

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

Область границ описывает грубую границу визуального содержимого элемента. Хотя вычисление этой области дорогостоящее, она также более точная, чем boundingRect(), и может помочь избежать ненужной перерисовки при обновлении элемента. Это особенно эффективно для тонких элементов (например, линий или простых полигонов). Вы можете настроить зернистость области границ, вызвав setBoundingRegionGranularity(). По умолчанию зернистость равна 0; в этом случае область границ элемента такая же, как и прямоугольник границ.

itemToDeviceTransform — преобразование из координат элемента в координаты устройства. Если вы хотите, чтобы эта функция возвращала QRegion в координатах сцены, вы можете передать sceneTransform() в качестве аргумента.

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

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

qreal QGraphicsItem::boundingRegionGranularity() const

Возвращает зернистость области границ элемента; значение от 0 до 1 включительно. Значение по умолчанию равно 0 (т.е. наименьшая зернистость, где область границ соответствует прямоугольнику границ элемента).

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

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

QGraphicsItem::CacheMode QGraphicsItem::cacheMode() const

Возвращает режим кеширования для этого элемента. Режим по умолчанию — NoCache (т.е. кеширование отключено, и вся отрисовка происходит немедленно).

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

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

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

Возвращает список дочерних элементов этого элемента.

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

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

См. также setParentItem(), zValue() и Сортировка.

QRectF QGraphicsItem::childrenBoundingRect() const

Возвращает прямоугольник границ потомков этого элемента (т.е. его детей, их детей и т. д.) в локальных координатах. Прямоугольник будет содержать всех потомков после их отображения в локальных координатах. Если у элемента нет потомков, эта функция возвращает пустой QRectF.

Это не включает собственный прямоугольник границ этого элемента; она возвращает только накопленный прямоугольник границ его потомков. Если вам нужно включить прямоугольник границ этого элемента, можно добавить boundingRect() к childrenBoundingRect() с помощью QRectF::operator|().

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

См. также boundingRect() и sceneBoundingRect().

void QGraphicsItem::clearFocus()

Убирает фокус ввода с клавиатуры у элемента.

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

Только элементы, установившие флаг ItemIsFocusable, или виджеты, установившие соответствующую политику фокуса, могут принять фокус клавиатуры.

См. также setFocus(), hasFocus() и QGraphicsWidget::focusPolicy.

QPainterPath QGraphicsItem::clipPath() const

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

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

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

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

См. также isClipped(), shape() и setFlags().

[virtual] bool QGraphicsItem::collidesWithItem(const QGraphicsItem *other, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

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

Режим mode применяется к элементу other, а полученная форма или ограничивающая прямоугольник затем сравниваются с формой этого элемента. Значение по умолчанию для mode — Qt::IntersectsItemShape; элемент other сталкивается с этим элементом, если он либо пересекает, либо содержит, либо содержится формой этого элемента (см. Qt::ItemSelectionMode для получения подробной информации).

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

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

См. также contains() и shape().

[virtual] bool QGraphicsItem::collidesWithPath(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

Возвращает true, если этот элемент сталкивается с path.

Столкновение определяется по mode. Значение по умолчанию для mode — Qt::IntersectsItemShape; path сталкивается с этим элементом, если он либо пересекает, либо содержит, либо содержится формой этого элемента.

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

См. также collidesWithItem(), contains() и shape().

QList<QGraphicsItem *> QGraphicsItem::collidingItems(Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

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

Способ обнаружения столкновений определяется путем применения mode к элементам, которые сравниваются с этим элементом, т. е. форма или ограничивающий прямоугольник каждого элемента проверяется относительно формы этого элемента. Значение по умолчанию для mode — Qt::IntersectsItemShape.

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

QGraphicsItem *QGraphicsItem::commonAncestorItem(const QGraphicsItem *other) const

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

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

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

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

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

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

См. также shape(), boundingRect() и collidesWithPath().

[virtual protected] void QGraphicsItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)

Этот обработчик событий может быть переопределён в подклассе для обработки событий контекстного меню. Параметр event содержит сведения об обрабатываемом событии.

Если вы игнорируете событие (т. е., вызывая QEvent::ignore()), событие event будет передано любому элементу под этим элементом. Если ни один элемент не примет событие, оно будет проигнорировано сценой и будет передано в вид.

Обычно для ответа на событие контекстного меню открывается QMenu. Пример:

void CustomItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)
{
    QMenu menu;
    QAction *removeAction = menu.addAction("Remove");
    QAction *markAction = menu.addAction("Mark");
    QAction *selectedAction = menu.exec(event->screenPos());
    // ...
}

Реализация по умолчанию игнорирует событие.

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

QCursor QGraphicsItem::cursor() const

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

Элемент редактора может использовать курсор «прямая с точкой»:

item->setCursor(Qt::IBeamCursor);

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

См. также setCursor(), hasCursor(), unsetCursor(), QWidget::cursor и QApplication::overrideCursor().

QVariant QGraphicsItem::data(int key) const

Возвращает пользовательские данные этого элемента для ключа key в качестве QVariant.

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

static const int ObjectName = 0;

QGraphicsItem *item = scene.itemAt(100, 50);
if (item->data(ObjectName).toString().isEmpty()) {
    if (qgraphicsitem_cast<ButtonItem *>(item))
        item->setData(ObjectName, "Button");
}

Qt не использует эту функцию для хранения данных; она предоставляется только для удобства пользователя.

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

QTransform QGraphicsItem::deviceTransform(const QTransform &viewportTransform) const

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

Пример:

QGraphicsRectItem rect;
rect.setPos(100, 100);

rect.deviceTransform(view->viewportTransform()).map(QPointF(0, 0));
// returns the item's (0, 0) point in view's viewport coordinates

rect.deviceTransform(view->viewportTransform()).inverted().map(QPointF(100, 100));
// returns view's viewport's (100, 100) coordinate in item coordinates

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

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

См. также transform(), setTransform(), scenePos(), Система координат виджета графического просмотра и itemTransform().

[virtual protected] void QGraphicsItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event)

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

Приняв событие (т. е., вызвав QEvent::accept()), элемент примет события выгрузки, помимо получения событий перемещения и выхода из перетаскивания. В противном случае событие будет проигнорировано и передано элементу, расположенному ниже. Если событие принято, элемент получит событие перемещения перетаскивания, прежде чем управление вернётся в цикл событий.

Типичная реализация dragEnterEvent принимает или игнорирует event в зависимости от связанных данных MIME в event. Пример:

CustomItem::CustomItem()
{
    setAcceptDrops(true);
    ...
}

void CustomItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event)
{
    event->setAccepted(event->mimeData()->hasFormat("text/plain"));
}

Элементы не получают события перетаскивания и выгрузки по умолчанию; для включения этой функции вызовите setAcceptDrops(true).

Реализация по умолчанию ничего не делает.

См. также dropEvent(), dragMoveEvent() и dragLeaveEvent().

[virtual protected] void QGraphicsItem::dragLeaveEvent(QGraphicsSceneDragDropEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event не имеет эффекта.

Элементы по умолчанию не получают события перетаскивания и выгрузки; для включения этой функции вызовите setAcceptDrops(true).

Реализация по умолчанию ничего не делает.

См. также dragEnterEvent(), dropEvent() и dragMoveEvent().

[virtual protected] void QGraphicsItem::dragMoveEvent(QGraphicsSceneDragDropEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event переключает возможность приема опускания элемента в заданной позиции. По умолчанию, event принимается, что означает, что элемент допускает опускания в указанной позиции.

Элементы по умолчанию не получают события перетаскивания и опускания; для включения этой функции вызовите setAcceptDrops(true).

Реализация по умолчанию ничего не делает.

См. также dropEvent(), dragEnterEvent() и dragLeaveEvent().

[virtual protected] void QGraphicsItem::dropEvent(QGraphicsSceneDragDropEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event не имеет эффекта.

Элементы по умолчанию не получают события перетаскивания и опускания; для включения этой функции вызовите setAcceptDrops(true).

Реализация по умолчанию ничего не делает.

См. также dragEnterEvent(), dragMoveEvent() и dragLeaveEvent().

qreal QGraphicsItem::effectiveOpacity() const

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

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

См. также opacity(), setOpacity(), paint(), ItemIgnoresParentOpacity и ItemDoesntPropagateOpacityToChildren.

void QGraphicsItem::ensureVisible(const QRectF &rect = QRectF(), int xmargin = 50, int ymargin = 50)

Если этот элемент является частью сцены, отображаемой с помощью QGraphicsView, эта вспомогательная функция попытается прокрутить представление, чтобы убедиться, что rect виден внутри области просмотра. Если rect — пустой прямоугольник (по умолчанию), QGraphicsItem использует прямоугольник ограничивающей области элемента. xmargin и ymargin — количество пикселей для отступов.

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

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

См. также QGraphicsView::ensureVisible().

void QGraphicsItem::ensureVisible(qreal x, qreal y, qreal w, qreal h, int xmargin = ..., int ymargin = ...)

Эта вспомогательная функция эквивалентна вызову ensureVisible(QRectF(x, y, w, h), xmargin, ymargin).

bool QGraphicsItem::filtersChildEvents() const

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

Значение по умолчанию — false; события дочерних элементов не фильтруются.

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

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

QGraphicsItem::GraphicsItemFlags QGraphicsItem::flags() const

Возвращает флаги этого элемента. Флаги описывают, какие настраиваемые функции элемента включены. Например, если флаги включают ItemIsFocusable, элемент может получать фокус.

По умолчанию флаги не включены.

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

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

Этот обработчик событий event может быть переопределен для получения событий фокусировки для данного элемента. Реализация по умолчанию вызывает ensureVisible().

См. также focusOutEvent(), sceneEvent() и setFocus().

QGraphicsItem *QGraphicsItem::focusItem() const

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

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

См. также hasFocus(), setFocus() и QWidget::focusWidget().

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

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

См. также focusInEvent(), sceneEvent() и setFocus().

QGraphicsItem *QGraphicsItem::focusProxy() const

Возвращает прокси-элемент фокуса этого элемента или nullptr, если у этого элемента нет прокси-элемента фокуса.

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

См. также setFocusProxy(), setFocus() и hasFocus().

void QGraphicsItem::grabKeyboard()

Захватывает ввод с клавиатуры.

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

• Элемент становится невидимым
• Элемент удаляется из сцены
• Элемент удаляется
• Элемент вызывает ungrabKeyboard()
• Другой элемент вызывает grabKeyboard(); элемент получит обратно захват клавиатуры, когда другой элемент вызовет ungrabKeyboard().

Когда элемент получает захват клавиатуры, он получает событие QEvent::GrabKeyboard. Когда он теряет захват клавиатуры, он получает событие QEvent::UngrabKeyboard. Эти события могут использоваться для обнаружения случаев, когда ваш элемент получает или теряет захват клавиатуры помимо получения фокуса.

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

Обратите внимание, что только видимые элементы могут захватывать ввод с клавиатуры. Вызов grabKeyboard() для невидимого элемента не имеет эффекта.

События клавиатуры не затрагиваются.

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

См. также ungrabKeyboard(), grabMouse() и setFocus().

void QGraphicsItem::grabMouse()

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

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

• Элемент становится невидимым
• Элемент удаляется из сцены
• Элемент удаляется
• Элемент вызывает ungrabMouse()
• Другой элемент вызывает grabMouse(); элемент получит обратно захват мыши, когда другой элемент вызовет ungrabMouse().

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

Почти никогда нет необходимости явно захватывать мышь в Qt, так как Qt делает это разумно. В частности, Qt захватывает мышь при нажатии кнопки мыши и держит её захваченной до отпускания последней кнопки мыши. Кроме того, виджеты Qt::Popup неявно вызывают grabMouse() при отображении и ungrabMouse() при скрытии.

Обратите внимание, что только видимые элементы могут захватывать ввод с мыши. Вызов grabMouse() для невидимого элемента не имеет эффекта.

События клавиатуры не затрагиваются.

См. также QGraphicsScene::mouseGrabberItem(), ungrabMouse() и grabKeyboard().

QGraphicsEffect *QGraphicsItem::graphicsEffect() const

Возвращает указатель на эффект этого элемента, если он есть; в противном случае nullptr.

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

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

QGraphicsItemGroup *QGraphicsItem::group() const

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

См. также setGroup(), QGraphicsItemGroup и QGraphicsScene::createItemGroup().

bool QGraphicsItem::hasCursor() const

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

По умолчанию у элементов курсор не установлен. cursor() вернёт стандартный курсор указателя.

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

bool QGraphicsItem::hasFocus() const

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

См. также focusItem(), setFocus(), QGraphicsScene::setFocusItem() и isActive().

void QGraphicsItem::hide()

Скрывает элемент (элементы отображаются по умолчанию).

Эта функция-удобство эквивалентна вызову setVisible(false).

См. также show() и setVisible().

[virtual protected] void QGraphicsItem::hoverEnterEvent(QGraphicsSceneHoverEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event не оказывает никакого эффекта.

См. также hoverMoveEvent(), hoverLeaveEvent(), sceneEvent() и setAcceptHoverEvents().

[virtual protected] void QGraphicsItem::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event не оказывает никакого эффекта.

См. также hoverEnterEvent(), hoverMoveEvent(), sceneEvent() и setAcceptHoverEvents().

[virtual protected] void QGraphicsItem::hoverMoveEvent(QGraphicsSceneHoverEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event не оказывает никакого эффекта.

См. также hoverEnterEvent(), hoverLeaveEvent(), sceneEvent() и setAcceptHoverEvents().

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

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

См. также inputMethodQuery() и sceneEvent().

Qt::InputMethodHints QGraphicsItem::inputMethodHints() const

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

Подсказки ввода имеют значение только для элементов ввода. Подсказки используются методом ввода для указания, как он должен работать. Например, если установлен флаг Qt::ImhNumbersOnly, метод ввода может изменить свои визуальные компоненты, чтобы отразить, что можно вводить только цифры.

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

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

См. также setInputMethodHints() и inputMethodQuery().

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

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

См. также inputMethodEvent() и QInputMethodEvent.

void QGraphicsItem::installSceneEventFilter(QGraphicsItem *filterItem)

Устанавливает фильтр событий для данного элемента на filterItem, вызывая все события для этого элемента сначала через функцию sceneEventFilter() filterItem.

Для фильтрации событий другого элемента установите этот элемент в качестве фильтра событий для другого элемента. Пример:

QGraphicsScene scene;
QGraphicsEllipseItem *ellipse = scene.addEllipse(QRectF(-10, -10, 20, 20));
QGraphicsLineItem *line = scene.addLine(QLineF(-10, -10, 20, 20));

line->installSceneEventFilter(ellipse);
// line's events are filtered by ellipse's sceneEventFilter() function.

ellipse->installSceneEventFilter(line);
// ellipse's events are filtered by line's sceneEventFilter() function.

Элемент может фильтровать только события для других элементов в той же сцене. Также элемент не может фильтровать свои собственные события; вместо этого вы можете напрямую переопределить sceneEvent().

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

См. также removeSceneEventFilter(), sceneEventFilter() и sceneEvent().

bool QGraphicsItem::isActive() const

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

Элемент может быть активным только если сцена активна. Элемент активен, если он или является потомком активной панели. Элементы в неактивных панелях не активны.

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

Только активные элементы могут получить фокус ввода.

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

См. также QGraphicsScene::isActive(), QGraphicsScene::activePanel(), panel() и isPanel().

bool QGraphicsItem::isAncestorOf(const QGraphicsItem *child) const

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

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

bool QGraphicsItem::isBlockedByModalPanel(QGraphicsItem **blockingPanel = nullptr) const

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

Эта функция всегда возвращает false для элементов, которые не находятся в сцене.

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

См. также panelModality(), setPanelModality() и PanelModality.

bool QGraphicsItem::isClipped() const

Возвращает true, если данный элемент обрезан. Элемент обрезан, если он установил флаг ItemClipsToShape или если он или любой из его предков установил флаг ItemClipsChildrenToShape.

Обрезка влияет на внешний вид элемента (то есть, отрисовку), а также на доставку событий мыши и наведения.

См. также clipPath(), shape() и setFlags().

bool QGraphicsItem::isEnabled() const

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

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

bool QGraphicsItem::isObscured(const QRectF &rect = QRectF()) const

Это перегруженная функция.

Возвращает true, если rect полностью скрыта непрозрачной формой любого из элементов столкновения над ним (то есть, с более высоким значением Z, чем у данного элемента).

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

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

bool QGraphicsItem::isObscured(qreal x, qreal y, qreal w, qreal h) const

Это перегруженная функция.

Эта функция-удобство эквивалентна вызову isObscured(QRectF(x, y, w, h)).

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

[virtual] bool QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const

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

Базовая реализация отображает opaqueArea() элемента item в системе координат данного элемента, а затем проверяет, полностью ли содержится boundingRect() данного элемента внутри отображённой формы.

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

См. также opaqueArea() и isObscured().

bool QGraphicsItem::isPanel() const

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

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

См. также QGraphicsItem::panel() и ItemIsPanel.

bool QGraphicsItem::isSelected() const

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

Элементы, которые входят в группу, наследуют состояние выделения группы.

Элементы по умолчанию не выделены.

См. также setSelected() и QGraphicsScene::setSelectionArea().

bool QGraphicsItem::isUnderMouse() const

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

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

См. также QGraphicsScene::views() и QCursor::pos().

bool QGraphicsItem::isVisible() const

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

Обратите внимание, что общая видимость элемента не зависит от того, отображается ли он в настоящее время QGraphicsView.

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

bool QGraphicsItem::isVisibleTo(const QGraphicsItem *parent) const

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

Элемент может быть невидимым для своих предков, даже если isVisible() равно true. Он также может быть видимым для своих предков, даже если isVisible() равно false. Если любой предок скрыт, сам элемент будет неявным образом скрыт, в этом случае функция вернёт false.

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

См. также isVisible() и setVisible().

bool QGraphicsItem::isWidget() const

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

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

bool QGraphicsItem::isWindow() const

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

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

См. также QGraphicsWidget::windowFlags().

[virtual protected] QVariant QGraphicsItem::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)

Этот виртуальный метод вызывается QGraphicsItem для уведомления пользовательских элементов о том, что изменилась какая-то часть состояния элемента. Переопределяя этот метод, вы можете отреагировать на изменение, и в некоторых случаях (в зависимости от change) произвести корректировки.

change — параметр меняемого элемента. value — новое значение; тип значения зависит от change.

Пример:

QVariant Component::itemChange(GraphicsItemChange change, const QVariant &value)
{
    if (change == ItemPositionChange && scene()) {
        // value is the new position.
        QPointF newPos = value.toPointF();
        QRectF rect = scene()->sceneRect();
        if (!rect.contains(newPos)) {
            // Keep the item inside the scene rect.
            newPos.setX(qMin(rect.right(), qMax(newPos.x(), rect.left())));
            newPos.setY(qMin(rect.bottom(), qMax(newPos.y(), rect.top())));
            return newPos;
        }
    }
    return QGraphicsItem::itemChange(change, value);
}

По умолчанию реализация ничего не делает и возвращает value.

Примечание: Некоторые функции QGraphicsItem нельзя вызывать в переопределении этого метода; см. документацию по GraphicsItemChange для получения подробной информации.

См. также GraphicsItemChange.

QTransform QGraphicsItem::itemTransform(const QGraphicsItem *other, bool *ok = nullptr) const

Возвращает QTransform, отображающий координаты из данного элемента в other. Если ok не равен null и такого преобразования не существует, boolean, на который указывает ok, будет установлен в false; в противном случае он будет установлен в true.

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

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

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

См. также mapToItem(), mapFromItem() и deviceTransform().

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

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

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

См. также keyReleaseEvent(), setFocus(), QGraphicsScene::setFocusItem() и sceneEvent().

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

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

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

См. также keyPressEvent(), setFocus(), QGraphicsScene::setFocusItem() и sceneEvent().

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

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

Если item равен nullptr, эта функция возвращает то же самое, что и mapFromScene().

См. также itemTransform(), mapFromParent(), mapFromScene(), transform(), mapToItem() и Систему координат графического представления.

QPolygonF QGraphicsItem::mapFromItem(const QGraphicsItem *item, const QRectF &rect) const

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

Если item равен nullptr, эта функция возвращает то же самое, что и mapFromScene().

См. также itemTransform(), mapToItem(), mapFromParent(), transform() и Систему координат графического представления.

QPolygonF QGraphicsItem::mapFromItem(const QGraphicsItem *item, const QPolygonF &polygon) const

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

Если item равен nullptr, эта функция возвращает то же самое, что и mapFromScene().

См. также itemTransform(), mapToItem(), mapFromParent(), transform() и Систему координат графического представления.

QPainterPath QGraphicsItem::mapFromItem(const QGraphicsItem *item, const QPainterPath &path) const

Преобразует путь path, который задан в системе координат объекта item, в систему координат текущего объекта и возвращает преобразованный путь.

Если item равен nullptr, эта функция возвращает то же самое, что и mapFromScene().

См. также itemTransform(), mapFromParent(), mapFromScene(), mapToItem() и Система координат виджета Graphics View.

QPointF QGraphicsItem::mapFromItem(const QGraphicsItem *item, qreal x, qreal y) const

Это перегруженная функция.

Эта функция-помощник эквивалентна вызову mapFromItem(item, QPointF(x, y)).

QPolygonF QGraphicsItem::mapFromItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

Эта функция-помощник эквивалентна вызову mapFromItem(item, QRectF(x, y, w, h)).

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

QPointF QGraphicsItem::mapFromParent(const QPointF &point) const

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

См. также mapFromItem(), mapFromScene(), transform(), mapToParent() и Система координат виджета Graphics View.

QPolygonF QGraphicsItem::mapFromParent(const QRectF &rect) const

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

См. также mapToParent(), mapFromItem(), transform() и Система координат виджета Graphics View.

QPolygonF QGraphicsItem::mapFromParent(const QPolygonF &polygon) const

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

См. также mapToParent(), mapToItem(), transform() и Система координат виджета Graphics View.

QPainterPath QGraphicsItem::mapFromParent(const QPainterPath &path) const

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

См. также mapFromScene(), mapFromItem(), mapToParent() и Система координат виджета Graphics View.

QPointF QGraphicsItem::mapFromParent(qreal x, qreal y) const

Это перегруженная функция.

Эта функция-помощник эквивалентна вызову mapFromParent(QPointF(x, y)).

QPolygonF QGraphicsItem::mapFromParent(qreal x, qreal y, qreal w, qreal h) const

Эта функция-помощник эквивалентна вызову mapFromItem(QRectF(x, y, w, h)).

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

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

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

См. также mapFromItem(), mapFromParent(), transform(), mapToScene() и Система координат виджета Graphics View.

QPolygonF QGraphicsItem::mapFromScene(const QRectF &rect) const

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

См. также mapToScene(), mapFromItem(), transform() и Система координат виджета Graphics View.

QPolygonF QGraphicsItem::mapFromScene(const QPolygonF &polygon) const

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

См. также mapToScene(), mapFromParent(), transform() и Система координат виджета Graphics View.

QPainterPath QGraphicsItem::mapFromScene(const QPainterPath &path) const

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

См. также mapFromParent(), mapFromItem(), mapToScene() и Система координат виджета Graphics View.

QPointF QGraphicsItem::mapFromScene(qreal x, qreal y) const

Это перегруженная функция.

Эта функция-помощник эквивалентна вызову mapFromScene(QPointF(x, y)).

QPolygonF QGraphicsItem::mapFromScene(qreal x, qreal y, qreal w, qreal h) const

Эта функция-помощник эквивалентна вызову mapFromScene(QRectF(x, y, w, h)).

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

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

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

Если item равен nullptr, эта функция возвращает то же самое, что и mapRectFromScene().

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

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem() и Система координат виджета Graphics View.

QRectF QGraphicsItem::mapRectFromItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

Эта функция-утилита эквивалентна вызову mapRectFromItem(item, QRectF(x, y, w, h)).

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

QRectF QGraphicsItem::mapRectFromParent(const QRectF &rect) const

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

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

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem(), и Систему координат Виджета Графики.

QRectF QGraphicsItem::mapRectFromParent(qreal x, qreal y, qreal w, qreal h) const

Эта функция-утилита эквивалентна вызову mapRectFromParent(QRectF(x, y, w, h)).

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

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

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

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

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem(), и Систему координат Виджета Графики.

QRectF QGraphicsItem::mapRectFromScene(qreal x, qreal y, qreal w, qreal h) const

Эта функция-утилита эквивалентна вызову mapRectFromScene(QRectF(x, y, w, h)).

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

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

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

Если item это nullptr, эта функция возвращает то же, что и mapRectToScene().

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

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem(), и Систему координат Виджета Графики.

QRectF QGraphicsItem::mapRectToItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

Эта функция-утилита эквивалентна вызову mapRectToItem(item, QRectF(x, y, w, h)).

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

QRectF QGraphicsItem::mapRectToParent(const QRectF &rect) const

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

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

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem(), и Систему координат Виджета Графики.

QRectF QGraphicsItem::mapRectToParent(qreal x, qreal y, qreal w, qreal h) const

Эта функция-утилита эквивалентна вызову mapRectToParent(QRectF(x, y, w, h)).

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

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

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

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

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem(), и Систему координат Виджета Графики.

QRectF QGraphicsItem::mapRectToScene(qreal x, qreal y, qreal w, qreal h) const

Эта функция-утилита эквивалентна вызову mapRectToScene(QRectF(x, y, w, h)).

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

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

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

Если item это nullptr, эта функция возвращает то же, что и mapToScene().

См. также itemTransform(), mapToParent(), mapToScene(), transform(), mapFromItem(), и Систему координат Виджета Графики.

QPolygonF QGraphicsItem::mapToItem(const QGraphicsItem *item, const QRectF &rect) const

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

Если item это nullptr, эта функция возвращает то же, что и mapToScene().

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem(), и Систему координат Виджета Графики.

QPolygonF QGraphicsItem::mapToItem(const QGraphicsItem *item, const QPolygonF &polygon) const

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

Если item это nullptr, эта функция возвращает то же, что и mapToScene().

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem(), и Систему координат Виджета Графики.

QPainterPath QGraphicsItem::mapToItem(const QGraphicsItem *item, const QPainterPath &path) const

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

Если item равен nullptr, эта функция возвращает то же значение, что и mapToScene().

См. также itemTransform(), mapToParent(), mapToScene(), mapFromItem() и Систему координат виджета Graphics View.

QPointF QGraphicsItem::mapToItem(const QGraphicsItem *item, qreal x, qreal y) const

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

Эта вспомогательная функция эквивалентна вызову mapToItem(item, QPointF(x, y)).

QPolygonF QGraphicsItem::mapToItem(const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

Эта вспомогательная функция эквивалентна вызову mapToItem(item, QRectF(x, y, w, h)).

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

QPointF QGraphicsItem::mapToParent(const QPointF &point) const

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

См. также mapToItem(), mapToScene(), transform(), mapFromParent() и Систему координат виджета Graphics View.

QPolygonF QGraphicsItem::mapToParent(const QRectF &rect) const

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

См. также mapToScene(), mapToItem(), mapFromParent() и Систему координат виджета Graphics View.

QPolygonF QGraphicsItem::mapToParent(const QPolygonF &polygon) const

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

См. также mapToScene(), mapToItem(), mapFromParent() и Систему координат виджета Graphics View.

QPainterPath QGraphicsItem::mapToParent(const QPainterPath &path) const

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

См. также mapToScene(), mapToItem(), mapFromParent() и Систему координат виджета Graphics View.

QPointF QGraphicsItem::mapToParent(qreal x, qreal y) const

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

Эта вспомогательная функция эквивалентна вызову mapToParent(QPointF(x, y)).

QPolygonF QGraphicsItem::mapToParent(qreal x, qreal y, qreal w, qreal h) const

Эта вспомогательная функция эквивалентна вызову mapToParent(QRectF(x, y, w, h)).

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

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

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

См. также mapToItem(), mapToParent(), transform(), mapFromScene() и Систему координат виджета Graphics View.

QPolygonF QGraphicsItem::mapToScene(const QRectF &rect) const

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

См. также mapToParent(), mapToItem(), mapFromScene() и Систему координат виджета Graphics View.

QPolygonF QGraphicsItem::mapToScene(const QPolygonF &polygon) const

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

См. также mapToParent(), mapToItem(), mapFromScene() и Систему координат виджета Graphics View.

QPainterPath QGraphicsItem::mapToScene(const QPainterPath &path) const

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

См. также mapToParent(), mapToItem(), mapFromScene() и Систему координат виджета Graphics View.

QPointF QGraphicsItem::mapToScene(qreal x, qreal y) const

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

Эта вспомогательная функция эквивалентна вызову mapToScene(QPointF(x, y)).

QPolygonF QGraphicsItem::mapToScene(qreal x, qreal y, qreal w, qreal h) const

Эта вспомогательная функция эквивалентна вызову mapToScene(QRectF(x, y, w, h)).

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

[virtual protected] void QGraphicsItem::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)

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

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

Вызов QEvent::ignore() или QEvent::accept() для event не оказывает никакого влияния.

По умолчанию вызывается mousePressEvent(). Если вы хотите сохранить базовый реализацию при переопределении этой функции, вызовите QGraphicsItem::mouseDoubleClickEvent() в вашем переопределении.

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

См. также mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent() и sceneEvent().

[virtual protected] void QGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event не имеет эффекта.

Стандартная реализация обрабатывает базовое взаимодействие с элементами, такое как выделение и перемещение. Если вы хотите сохранить базовую реализацию при переопределении этой функции, вызовите QGraphicsItem::mouseMoveEvent() в вашей реализации.

Обратите внимание, что mousePressEvent() определяет, какой графический элемент получает события мыши. Подробности см. в описании mousePressEvent().

См. также mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent() и sceneEvent().

[virtual protected] void QGraphicsItem::mousePressEvent(QGraphicsSceneMouseEvent *event)

Этот обработчик событий, для события event, может быть переопределен для получения событий нажатия мыши для данного элемента. События нажатия мыши доставляются только тем элементам, которые принимают нажатую кнопку мыши. По умолчанию элемент принимает все кнопки мыши, но вы можете изменить это, вызвав setAcceptedMouseButtons().

Событие нажатия мыши определяет, какой элемент должен стать захватом мыши (см. QGraphicsScene::mouseGrabberItem()). Если вы не переопределите эту функцию, событие нажатия будет распространено на любой верхний элемент под этим элементом, и никакие другие события мыши не будут доставлены этому элементу.

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

Стандартная реализация обрабатывает базовое взаимодействие с элементами, такое как выделение и перемещение. Если вы хотите сохранить базовую реализацию при переопределении этой функции, вызовите QGraphicsItem::mousePressEvent() в вашей реализации.

Событие игнорируется (QEvent::ignore()) для элементов, которые не являются ни перемещаемыми, ни выделяемыми.

См. также mouseMoveEvent(), mouseReleaseEvent(), mouseDoubleClickEvent() и sceneEvent().

[virtual protected] void QGraphicsItem::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)

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

Вызов QEvent::ignore() или QEvent::accept() для event не имеет эффекта.

Стандартная реализация обрабатывает базовое взаимодействие с элементами, такое как выделение и перемещение. Если вы хотите сохранить базовую реализацию при переопределении этой функции, вызовите QGraphicsItem::mouseReleaseEvent() в вашей реализации.

Обратите внимание, что mousePressEvent() определяет, какой графический элемент получает события мыши. Подробности см. в описании mousePressEvent().

См. также mousePressEvent(), mouseMoveEvent(), mouseDoubleClickEvent() и sceneEvent().

void QGraphicsItem::moveBy(qreal dx, qreal dy)

Перемещает элемент на dx точек по горизонтали и dy точек по вертикали. Эта функция эквивалентна вызову setPos(pos() + QPointF(dx, dy)).

qreal QGraphicsItem::opacity() const

Возвращает локальную непрозрачность этого элемента, которая находится в диапазоне от 0,0 (прозрачный) до 1,0 (непрозрачный). Это значение комбинируется с родительскими и предковыми значениями в effectiveOpacity(). Эффективная непрозрачность определяет, как отображается элемент, а также влияет на его видимость при запросе такими функциями, как QGraphicsView::items().

Свойство opacity определяет состояние кисти, переданной функции paint(). Если элемент кэшируется, т.е. ItemCoordinateCache или DeviceCoordinateCache, эффективное свойство будет применено к кэшу элемента при его отрисовке.

Значение непрозрачности по умолчанию равно 1,0; полностью непрозрачный.

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

См. также setOpacity(), paint(), ItemIgnoresParentOpacity и ItemDoesntPropagateOpacityToChildren.

[virtual] QPainterPath QGraphicsItem::opaqueArea() const

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

Эта функция используется функцией isObscuredBy(), которая вызывается базовыми элементами для определения, скрывается ли этот элемент другим элементом.

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

См. также isObscuredBy(), isObscured() и shape().

[pure virtual] void QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = ...)

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

Переопределите эту функцию в подклассе QGraphicsItem, чтобы обеспечить реализацию рисования элемента, используя painter. Параметр option предоставляет параметры стиля для элемента, такие как его состояние, видимая область и подсказки уровня детализации. Аргумент widget необязателен. Если он предоставлен, он указывает на виджет, на котором рисуется; в противном случае он равен 0. При кэшировании рисования widget всегда равен 0.

void RoundRectItem::paint(QPainter *painter,
                          const QStyleOptionGraphicsItem *option,
                          QWidget *widget)
{
    painter->drawRoundedRect(-10, -10, 20, 20, 5, 5);
}

Кисть художника по умолчанию имеет ширину 0, а ее кисть инициализируется кистью QPalette::Text из палитры устройства рисования. Кисть инициализируется кистью QPalette::Window.

Убедитесь, что все рисование ограничено границами boundingRect(), чтобы избежать артефактов (так как QGraphicsView не обрезает для вас кисть художника). В частности, когда QPainter рисует контур фигуры с помощью заданной QPen, половина контура будет нарисована снаружи, а половина внутри фигуры, которую вы рисуете (например, при ширине пера 2 единицы, вы должны нарисовать контуры на 1 единицу внутри boundingRect()). QGraphicsItem не поддерживает использование декоративных перьев с ненулевой шириной.

Все рисование выполняется в локальных координатах.

Примечание: Элемент всегда должен перерисовывать себя точно так же, если только не был вызван update(), в противном случае могут возникнуть визуальные артефакты. Другими словами, два последовательных вызова paint() должны всегда генерировать одинаковый результат, если между ними не был вызван update().

Примечание: Включение кэширования для элемента не гарантирует, что paint() будет вызываться только один раз фреймворком Graphics View, даже без явного вызова update(). Подробнее см. документацию setCacheMode().

См. также setCacheMode(), QPen::width(), Координаты элементов и ItemUsesExtendedStyleOption.

QGraphicsItem *QGraphicsItem::panel() const

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

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

См. также isPanel() и ItemIsPanel.

QGraphicsItem::PanelModality QGraphicsItem::panelModality() const

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

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

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

QGraphicsItem *QGraphicsItem::parentItem() const

Возвращает указатель на родительский элемент этого элемента. Если у этого элемента нет родителя, возвращается nullptr.

См. также setParentItem() и childItems().

QGraphicsObject *QGraphicsItem::parentObject() const

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

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

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

QGraphicsWidget *QGraphicsItem::parentWidget() const

Возвращает указатель на родительский виджет элемента. Родительским виджетом элемента является ближайший родительский элемент, который является виджетом.

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

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

QPointF QGraphicsItem::pos() const

Возвращает положение элемента в координатах родителя. Если у элемента нет родителя, его положение задаётся в координатах сцены.

Положение элемента описывает его начало (локальная координата (0, 0)) в координатах родителя; эта функция возвращает то же, что и mapToParent(0, 0).

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

См. также x(), y(), setPos(), transform(), и Систему координат виджета отображения графических элементов.

[protected] void QGraphicsItem::prepareGeometryChange()

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

prepareGeometryChange() вызовет update(), если это необходимо.

Пример:

void CircleItem::setRadius(qreal newRadius)
{
    if (radius != newRadius) {
        prepareGeometryChange();
        radius = newRadius;
    }
}

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

void QGraphicsItem::removeSceneEventFilter(QGraphicsItem *filterItem)

Удаляет фильтр событий этого элемента из filterItem.

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

void QGraphicsItem::resetTransform()

Сбрасывает матрицу преобразования этого элемента до единичной матрицы или все свойства преобразования до их значений по умолчанию. Это эквивалентно вызову setTransform(QTransform()).

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

См. также setTransform() и transform().

qreal QGraphicsItem::rotation() const

Возвращает поворот по часовой стрелке в градусах вокруг оси Z. Значение по умолчанию равно 0 (т.е. элемент не повернут).

Поворот комбинируется с масштабированием элемента scale(), transform() и transformations() для отображения системы координат элемента в системе координат родительского элемента.

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

См. также setRotation(), transformOriginPoint(), и Преобразования.

qreal QGraphicsItem::scale() const

Возвращает коэффициент масштабирования элемента. Значение коэффициента масштабирования по умолчанию равно 1.0 (т.е. элемент не масштабируется).

Масштабирование комбинируется с вращением элемента rotation(), transform() и transformations() для отображения системы координат элемента в системе координат родительского элемента.

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

См. также setScale(), rotation() и Преобразования.

QGraphicsScene *QGraphicsItem::scene() const

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

Чтобы добавить или переместить элемент в сцену, вызовите QGraphicsScene::addItem().

QRectF QGraphicsItem::sceneBoundingRect() const

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

См. также boundingRect() и Систему координат виджета отображения графических элементов.

[virtual protected] bool QGraphicsItem::sceneEvent(QEvent *event)

Этот виртуальный метод получает события для этого элемента. Переопределите этот метод, чтобы перехватить события перед их отправкой специализированным обработчикам событий contextMenuEvent(), focusInEvent(), focusOutEvent(), hoverEnterEvent(), hoverMoveEvent(), hoverLeaveEvent(), keyPressEvent(), keyReleaseEvent(), mousePressEvent(), mouseReleaseEvent(), mouseMoveEvent() и mouseDoubleClickEvent().

Возвращает true, если событие было распознано и обработано; в противном случае (например, если тип события не был распознан) возвращается false.

event — перехваченное событие.

[virtual protected] bool QGraphicsItem::sceneEventFilter(QGraphicsItem *watched, QEvent *event)

Фильтры событий для элемента watched. event — отфильтрованное событие.

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

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

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

QPointF QGraphicsItem::scenePos() const

Возвращает положение элемента в координатах сцены. Это эквивалентно вызову mapToScene(0, 0).

См. также pos(), sceneTransform(), и Систему координат виджета отображения графических элементов.

QTransform QGraphicsItem::sceneTransform() const

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

Пример:

QGraphicsRectItem rect;
rect.setPos(100, 100);

rect.sceneTransform().map(QPointF(0, 0));
// returns QPointF(100, 100);

rect.sceneTransform().inverted().map(QPointF(100, 100));
// returns QPointF(0, 0);

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

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

См. также transform(), setTransform(), scenePos(), Систему координат виджета отображения графических элементов и Преобразования.

void QGraphicsItem::scroll(qreal dx, qreal dy, const QRectF &rect = QRectF())

Прокручивает содержимое rect на dx, dy. Если rect — пустой прямоугольник (значение по умолчанию), прокручивается ограничивающий прямоугольник элемента.

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

После прокрутки элемент выведет обновление для новых открытых областей. Если прокрутка не поддерживается (например, вы рисуете в области просмотра OpenGL, которая не использует оптимизации прокрутки), эта функция эквивалентна вызову update(rect).

Примечание: Прокрутка поддерживается только при включённом QGraphicsItem::ItemCoordinateCache; во всех других случаях вызов этой функции эквивалентен вызову update(rect). Если вы уверены, что элемент непрозрачный и не перекрывается другими элементами, вы можете отобразить rect в координатах области просмотра и прокрутить область просмотра.

QTransform xform = item->deviceTransform(view->viewportTransform());
QRect deviceRect = xform.mapRect(rect).toAlignedRect();
view->viewport()->scroll(dx, dy, deviceRect);

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

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

void QGraphicsItem::setAcceptDrops(bool on)

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

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

void QGraphicsItem::setAcceptHoverEvents(bool enabled)

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

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

Родительские элементы получают события входа наведения курсора перед своими дочерними элементами, а события выхода — после. Однако родительский элемент не получает события выхода наведения курсора, если курсор входит в дочерний элемент; родительский элемент остаётся «под наведением» до тех пор, пока курсор не покинет его область, включая области его дочерних элементов.

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

QGraphicsWidget с декорациями окна будет принимать события наведения курсора независимо от значения acceptHoverEvents().

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

См. также acceptHoverEvents(), hoverEnterEvent(), hoverMoveEvent() и hoverLeaveEvent().

void QGraphicsItem::setAcceptTouchEvents(bool enabled)

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

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

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

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

Устанавливает кнопки мыши buttons, для которых этот элемент принимает события мыши.

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

Чтобы отключить события мыши для элемента (т.е. сделать его прозрачным для событий мыши), вызовите setAcceptedMouseButtons(0).

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

void QGraphicsItem::setActive(bool active)

Если active имеет значение true, и сцена активна, панель этого элемента будет активирована. В противном случае панель деактивируется.

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

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

См. также isPanel(), QGraphicsScene::setActivePanel() и QGraphicsScene::isActive().

void QGraphicsItem::setBoundingRegionGranularity(qreal granularity)

Устанавливает точность области ограничивающей области до granularity; значение от 0 до 1 включительно. Значение по умолчанию равно 0 (т.е. наименьшая точность, где ограничивающая область соответствует прямоугольнику ограничивающей области элемента).

Точность используется функцией boundingRegion() для расчёта того, насколько подробной должна быть ограничивающая область элемента. Максимально достижимая точность — 1, где boundingRegion() вернёт наилучший контур, возможный для устройства (например, для QGraphicsView viewport, это даёт вам область ограничивающей области с точностью до пикселя). Минимальная возможная точность — 0. Значение granularity описывает отношение между разрешением устройства и разрешением области ограничивающей области (например, значение 0,25 обеспечит область, где каждый фрагмент соответствует 4x4 единицам/пикселям устройства).

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

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

void QGraphicsItem::setCacheMode(QGraphicsItem::CacheMode mode, const QSize &logicalCacheSize = QSize())

Устанавливает режим кэширования элемента до mode.

Необязательный аргумент logicalCacheSize используется только в режиме ItemCoordinateCache и описывает разрешение буфера кэша; если logicalCacheSize имеет значение (100, 100), QGraphicsItem поместит элемент в 100x100 пикселей в графической памяти, независимо от логического размера самого элемента. По умолчанию QGraphicsItem использует размер boundingRect(). Для всех режимов кэширования, отличных от ItemCoordinateCache, logicalCacheSize игнорируется.

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

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

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

Подробнее о различных режимах кэширования можно узнать в документации CacheMode.

Примечание: Включение кэширования не означает, что функция paint() элемента будет вызываться только в ответ на явный вызов update(). Например, под давлением памяти Qt может решить отказаться от некоторых данных кэша; в таких случаях функция paint() элемента будет вызываться даже если не было вызова update() (то есть точно так же, как если бы кэширование не было включено).

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

См. также cacheMode(), CacheMode и QPixmapCache::setCacheLimit().

void QGraphicsItem::setCursor(const QCursor &cursor)

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

Элемент редактора может захотеть использовать курсор I-пучка:

item->setCursor(Qt::IBeamCursor);

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

См. также cursor(), hasCursor(), unsetCursor(), QWidget::cursor и QApplication::overrideCursor().

void QGraphicsItem::setData(int key, const QVariant &value)

Устанавливает пользовательские данные элемента для ключа key до значения value.

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

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

void QGraphicsItem::setEnabled(bool enabled)

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

Выключенные элементы отображаются, но не получают никаких событий, не могут получить фокус и не могут быть выбраны. События мыши отбрасываются; они не распространяются, если элемент также невидим или если он не принимает событий мыши (см. acceptedMouseButtons()). Выключенный элемент не может стать получателем событий мыши, и в результате этого элемент теряет захват, если он захватывал мышь, когда был выключен, так же как он теряет фокус, если у него был фокус, когда он был выключен.

Выключенные элементы традиционно отображаются с серыми цветами (см. QPalette::Disabled).

Если вы выключаете родительский элемент, все его дочерние элементы также будут выключены. Если вы включаете родительский элемент, все дочерние элементы будут включены, если только они не были явно выключены (т.е. если вы вызываете setEnabled(false) для дочернего элемента, он не будет повторно включён, если его родительский элемент выключен и затем снова включён).

Элементы включены по умолчанию.

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

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

void QGraphicsItem::setFiltersChildEvents(bool enabled)

Если enabled имеет значение true, этот элемент настроен для фильтрации всех событий для всех его дочерних элементов (т.е., все события, предназначенные для любого из его дочерних элементов, вместо этого отправляются этому элементу); в противном случае, если enabled имеет значение false, этот элемент будет обрабатывать только свои собственные события. Значение по умолчанию — false.

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

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

void QGraphicsItem::setFlag(QGraphicsItem::GraphicsItemFlag flag, bool enabled = true)

Если enabled имеет значение true, флаг элемента flag включён; в противном случае — выключен.

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

void QGraphicsItem::setFlags(QGraphicsItem::GraphicsItemFlags flags)

Устанавливает флаги элемента на flags. Все флаги в flags включены; все флаги, отсутствующие в flags, выключены.

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

По умолчанию флаги не включены. (QGraphicsWidget включает флаг ItemSendsGeometryChanges по умолчанию для отслеживания изменений положения.)

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

void QGraphicsItem::setFocus(Qt::FocusReason focusReason = Qt::OtherFocusReason)

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

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

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

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

См. также clearFocus(), hasFocus(), focusItem() и focusProxy().

void QGraphicsItem::setFocusProxy(QGraphicsItem *item)

Устанавливает фокус-заместителя элемента на item.

Если у элемента есть фокус-заместитель, фокус-заместитель получит фокус ввода, когда элемент получит фокус ввода. Сам элемент по-прежнему будет иметь фокус (т.е., hasFocus() вернет true), но только фокус-заместитель получит ввод с клавиатуры.

Фокус-заместитель может сам иметь фокус-заместителя, и так далее. В таком случае ввод с клавиатуры будет обрабатываться внешним фокус-заместителем.

Фокус-заместитель item должен принадлежать той же сцене, что и этот элемент.

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

См. также focusProxy(), setFocus() и hasFocus().

void QGraphicsItem::setGraphicsEffect(QGraphicsEffect *effect)

Устанавливает effect в качестве эффекта элемента. Если на этом элементе уже установлен эффект, QGraphicsItem удалит существующий эффект перед установкой нового effect. Вы можете удалить существующий эффект, вызвав setGraphicsEffect(nullptr).

Если effect является установленным эффектом на другом элементе, setGraphicsEffect() удалит эффект с элемента и установит его на этот элемент.

QGraphicsItem принимает владение effect.

Примечание: Эта функция применит эффект к себе и всем своим дочерним элементам.

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

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

void QGraphicsItem::setGroup(QGraphicsItemGroup *group)

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

См. также group() и QGraphicsScene::createItemGroup().

void QGraphicsItem::setInputMethodHints(Qt::InputMethodHints hints)

Устанавливает текущие подсказки метода ввода для этого элемента на hints.

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

См. также inputMethodHints() и inputMethodQuery().

void QGraphicsItem::setOpacity(qreal opacity)

Устанавливает локальную прозрачность этого элемента, от 0,0 (прозрачный) до 1,0 (непрозрачный). Локальная непрозрачность элемента объединяется с непрозрачностью родительских и предковых элементов в effectiveOpacity().

По умолчанию прозрачность передается от родителя к дочернему элементу, поэтому если прозрачность родителя равна 0,5, а дочернего элемента также 0,5, эффективная прозрачность дочернего элемента будет равна 0,25.

Свойство opacity определяет состояние художника, переданного функции paint(). Если элемент кэшируется, т.е. ItemCoordinateCache или DeviceCoordinateCache, эффективное свойство будет применено к кэшу элемента при его отрисовке.

Существует два флага элемента, которые влияют на то, как прозрачность элемента объединяется с прозрачностью родителя: ItemIgnoresParentOpacity и ItemDoesntPropagateOpacityToChildren.

Примечание: Установка непрозрачности элемента в 0 не сделает элемент невидимым (согласно isVisible()), но элемент будет обрабатываться как невидимый. См. документацию setVisible() для получения дополнительной информации.

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

См. также opacity(), effectiveOpacity() и setVisible().

void QGraphicsItem::setPanelModality(QGraphicsItem::PanelModality panelModality)

Устанавливает режим работы для этого элемента на panelModality.

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

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

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

void QGraphicsItem::setParentItem(QGraphicsItem *newParent)

Устанавливает родительский элемент этого элемента на newParent. Если у этого элемента уже есть родитель, он сначала удаляется из предыдущего родителя. Если newParent равен 0, этот элемент станет верхним элементом.

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

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

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

void QGraphicsItem::setPos(const QPointF &pos)

Устанавливает положение элемента на pos, которое находится в координатах родителя. Для элементов без родителя pos находится в координатах сцены.

Положение элемента описывает его начало (локальные координаты (0, 0)) в координатах родителя.

См. также pos(), scenePos() и Систему координат Graphics View.

void QGraphicsItem::setPos(qreal x, qreal y)

Это перегруженная функция.

Эта вспомогательная функция эквивалентна вызову setPos(QPointF(x, y)).

void QGraphicsItem::setRotation(qreal angle)

Устанавливает поворот по часовой стрелке angle, в градусах, вокруг оси Z. Значение по умолчанию — 0 (т.е., элемент не повернут). Присвоение отрицательного значения повернёт элемент против часовой стрелки. Обычно угол поворота находится в диапазоне (-360, 360), но также возможно присвоение значений за пределами этого диапазона (например, поворот на 370 градусов эквивалентен повороту на 10 градусов).

Элемент поворачивается вокруг точки начала преобразования, которая по умолчанию находится в (0, 0). Вы можете выбрать другую точку начала преобразования, вызвав setTransformOriginPoint().

Поворот комбинируется с масштабом элемента scale(), transform() и transformations() для отображения системы координат элемента в родительском элементе.

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

См. также rotation(), setTransformOriginPoint(), и Преобразования.

void QGraphicsItem::setScale(qreal factor)

Устанавливает масштаб factor элемента. Значение масштаба по умолчанию — 1,0 (т.е. элемент не масштабируется). Масштаб 0,0 сжимает элемент до одной точки. Если вы используете отрицательный масштаб, элемент будет перевернут и отображён зеркально (т.е. повернут на 180 градусов).

Масштабирование элемента происходит относительно точки начала преобразования, которая по умолчанию равна (0, 0). Вы можете выбрать другую точку начала преобразования, вызвав setTransformOriginPoint().

Масштаб комбинируется с поворотом элемента rotation(), преобразованием transform() и преобразованиями transformations() для отображения системы координат элемента в родительском элементе.

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

См. также scale(), setTransformOriginPoint(), и Пример преобразований.

void QGraphicsItem::setSelected(bool selected)

Если selected равно true и этот элемент выбираем, он выбирается; в противном случае — отменяется выбор.

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

Выбираться могут только видимые, активные и выбираемые элементы. Если selected равно true, а элемент невидим, неактивен или невыбираем, эта функция ничего не делает.

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

Эта функция предназначена для удобства, позволяя индивидуально переключать состояние выбора элемента. Однако более распространённый способ выбора элементов — вызвать QGraphicsScene::setSelectionArea(), который вызовет эту функцию для всех видимых, активных и выбираемых элементов в заданной области сцены.

См. также isSelected() и QGraphicsScene::selectedItems().

void QGraphicsItem::setToolTip(const QString &toolTip)

Устанавливает подсказку элемента на toolTip. Если toolTip пустая, подсказка элемента очищается.

См. также toolTip() и QToolTip.

void QGraphicsItem::setTransform(const QTransform &matrix, bool combine = false)

Устанавливает текущую матрицу преобразования элемента на matrix.

Если combine равно true, то matrix комбинируется с текущей матрицей; в противном случае matrix заменяет текущую матрицу. По умолчанию combine равно false.

Для упрощения взаимодействия с элементами, использующими преобразованный вид, QGraphicsItem предоставляет функции mapTo... и mapFrom..., которые могут преобразовывать координаты элементов и сцены. Например, вы можете вызвать mapToScene() для преобразования координаты элемента в координату сцены или mapFromScene() для преобразования координат сцены в координаты элемента.

Матрица преобразования комбинируется с поворотом rotation(), масштабированием scale() и преобразованиями transformations() элемента в комбинированное преобразование, которое отображает систему координат элемента в его родительском элементе.

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

См. также transform(), setRotation(), setScale(), setTransformOriginPoint(), Система координат виджета Graphics View и Преобразования.

void QGraphicsItem::setTransformOriginPoint(const QPointF &origin)

Устанавливает точку origin начала преобразования в координатах элемента.

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

См. также transformOriginPoint() и Преобразования.

void QGraphicsItem::setTransformOriginPoint(qreal x, qreal y)

Это перегруженная функция.

Устанавливает точку начала преобразования в координатах элемента. Это эквивалентно вызову setTransformOriginPoint(QPointF(x, y)).

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

См. также setTransformOriginPoint() и Преобразования.

void QGraphicsItem::setTransformations(const QList<QGraphicsTransform *> &transformations)

Устанавливает список графических transformations (QGraphicsTransform), которые в данный момент применяются к этому элементу.

Если вам нужно только повернуть или масштабировать элемент, вы должны вызвать setRotation() или setScale() вместо этого. Если вы хотите установить произвольное преобразование на элемент, вы можете вызвать setTransform().

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

Преобразования комбинируются с поворотом rotation(), масштабированием scale() и преобразованием transform() элемента для отображения системы координат элемента в родительском элементе.

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

См. также transformations(), scale(), setTransformOriginPoint(), и Преобразования.

void QGraphicsItem::setVisible(bool visible)

Если visible равно true, элемент отображается. В противном случае, элемент скрыт. Скрытые элементы не отрисовываются и не получают никаких событий. В частности, события мыши проходят прямо через скрытые элементы и доставляются любому элементу, который может быть за ним. Скрытые элементы также невыбираемы, не могут получить фокус и не обнаруживаются функциями расположения элементов QGraphicsScene.

Если элемент становится невидимым во время захвата мыши (т.е. когда он получает события мыши), он автоматически потеряет захват мыши, и захват не восстанавливается, сделав элемент видимым снова; для его повторного захвата мыши необходимо новое нажатие мыши.

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

Если вы скрываете родительский элемент, все его дочерние элементы также будут скрыты. Если вы показываете родительский элемент, все дочерние элементы будут отображаться, если они не были явно скрыты (т.е. если вы вызовете setVisible(false) для дочернего элемента, он не будет повторно отображён даже если его родительский элемент скрыт, а затем снова отображается).

Элементы отображаются по умолчанию; нет необходимости вызывать setVisible() для нового элемента.

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

См. также isVisible(), show(), hide(), и setOpacity().

void QGraphicsItem::setX(qreal x)

Устанавливает координату x позиции элемента. Эквивалентно вызову setPos(x, y()).

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

См. также x() и setPos().

void QGraphicsItem::setY(qreal y)

Устанавливает координату y позиции элемента. Эквивалентно вызову setPos(x(), y).

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

См. также y(), x(), и setPos().

void QGraphicsItem::setZValue(qreal z)

Устанавливает значение Z элемента на z. Значение Z определяет порядок следования элементов-братьев (соседних) элементов. Элемент-брат с высоким значением Z всегда будет отрисовываться поверх другого элемента-брата с меньшим значением Z.

Если вы восстановите значение Z, порядок вставки элемента определит его порядок следования.

Значение Z никак не влияет на размер элемента.

Значение Z по умолчанию равно 0.

См. также zValue(), Сортировка, stackBefore(), и ItemStacksBehindParent.

QPainterPath QGraphicsItem::shape() const

Возвращает форму этого элемента в виде QPainterPath в локальных координатах. Форма используется для многих целей, включая обнаружение столкновений, проверки попадания и функции QGraphicsScene::items().

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

QPainterPath RoundItem::shape() const
{
    QPainterPath path;
    path.addEllipse(boundingRect());
    return path;
}

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

Эта функция вызывается в реализациях по умолчанию для contains() и collidesWithPath().

См. также boundingRect(), contains(), prepareGeometryChange() и QPainterPathStroker.

void QGraphicsItem::show()

Отображает элемент (элементы отображаются по умолчанию).

Эта вспомогательная функция эквивалентна вызову setVisible(true).

См. также hide() и setVisible().

void QGraphicsItem::stackBefore(const QGraphicsItem *sibling)

Размещает этот элемент перед элементом sibling, который должен быть элементом-«братом» (т. е., два элемента должны иметь одного родительского элемента или быть верхнеуровневыми элементами). Элемент sibling должен иметь тот же значение Z, что и этот элемент, в противном случае вызов этой функции не окажет никакого влияния.

По умолчанию все элементы-«братья» размещаются в порядке вставки (т. е., первый добавленный элемент рисуется перед следующим добавленным элементом). Если значения Z двух элементов отличаются, то элемент с наибольшим значением Z рисуется поверх других. Когда значения Z одинаковы, порядок вставки определяет порядок размещения.

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

См. также setZValue(), ItemStacksBehindParent и Сортировка.

QGraphicsObject *QGraphicsItem::toGraphicsObject()

Возвращает элемент графического объекта, преобразованный к QGraphicsObject, если класс фактически является графическим объектом, в противном случае 0.

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

const QGraphicsObject *QGraphicsItem::toGraphicsObject() const

Возвращает элемент графического объекта, преобразованный к QGraphicsObject, если класс фактически является графическим объектом, в противном случае 0.

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

QString QGraphicsItem::toolTip() const

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

См. также setToolTip() и QToolTip.

QGraphicsItem *QGraphicsItem::topLevelItem() const

Возвращает верхнеуровневый элемент этого элемента. Верхнеуровневый элемент — это самый верхний родительский элемент, у которого родительский элемент является nullptr. Если у элемента нет родителя, возвращается его собственный указатель (т. е., верхнеуровневый элемент — это его собственный верхнеуровневый элемент).

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

QGraphicsWidget *QGraphicsItem::topLevelWidget() const

Возвращает указатель на виджет верхнего уровня элемента (т. е., предка, у которого родительским элементом является nullptr или чей родитель не является виджетом), или nullptr, если у этого элемента нет виджета верхнего уровня. Если элемент сам является виджетом верхнего уровня, эта функция возвращает указатель на сам элемент.

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

QTransform QGraphicsItem::transform() const

Возвращает матрицу преобразования этого элемента.

Матрица преобразования комбинируется с вращением rotation(), масштабированием scale() и преобразованиями transformations() в комбинированные преобразования для элемента.

Матрица преобразования по умолчанию — это единичная матрица.

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

См. также setTransform() и sceneTransform().

QPointF QGraphicsItem::transformOriginPoint() const

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

По умолчанию это QPointF(0,0).

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

См. также setTransformOriginPoint() и Преобразования.

QList<QGraphicsTransform *> QGraphicsItem::transformations() const

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

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

Преобразования комбинируются с вращением rotation(), масштабированием scale() и преобразованием transform() для отображения системы координат элемента в родительском элементе.

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

См. также setTransformations(), scale(), rotation(), transformOriginPoint() и Преобразования.

[virtual] int QGraphicsItem::type() const

Возвращает тип элемента в виде целого числа. Все стандартные классы graphicsitem ассоциированы с уникальным значением; см. QGraphicsItem::Type. Эта информация о типе используется функцией qgraphicsitem_cast() для различения типов.

Реализация по умолчанию (в QGraphicsItem) возвращает UserType.

Для использования qgraphicsitem_cast() с настраиваемым элементом переопределите эту функцию и объявите значение перечисления Type, равное типу вашего настраиваемого элемента. Пользовательские элементы должны возвращать значение, большее или равное UserType (65536).

Например:

class CustomItem : public QGraphicsItem
{
public:
   enum { Type = UserType + 1 };

   int type() const override
   {
       // Enable the use of qgraphicsitem_cast with this item.
       return Type;
   }
   ...
};

См. также UserType.

void QGraphicsItem::ungrabKeyboard()

Освобождает захват клавиатуры.

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

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

void QGraphicsItem::ungrabMouse()

Освобождает захват мыши.

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

См. также grabMouse() и ungrabKeyboard().

void QGraphicsItem::unsetCursor()

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

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

void QGraphicsItem::update(const QRectF &rect = QRectF())

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

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

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

Если элемент невидим (т. е., isVisible() возвращает false), эта функция ничего не делает.

См. также paint() и boundingRect().

void QGraphicsItem::update(qreal x, qreal y, qreal width, qreal height)

Это перегруженная функция.

Эта вспомогательная функция эквивалентна вызову update(QRectF(x, y, width, height)).

[protected] void QGraphicsItem::updateMicroFocus()

Обновляет микрофокус элемента.

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

См. также QInputMethod.

[virtual protected] void QGraphicsItem::wheelEvent(QGraphicsSceneWheelEvent *event)

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

Если вы проигнорируете событие (т.е., вызвав QEvent::ignore()), оно будет распространяться на любой элемент ниже этого элемента. Если ни один элемент не примет событие, оно будет проигнорировано сценой и будет распространено на представление (например, на вертикальную полосу прокрутки представления).

Реализация по умолчанию игнорирует событие.

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

QGraphicsWidget *QGraphicsItem::window() const

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

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

См. также QGraphicsWidget::isWindow().

qreal QGraphicsItem::x() const

Эта вспомогательная функция эквивалентна вызову pos().x().

См. также setX() и y().

qreal QGraphicsItem::y() const

Эта вспомогательная функция эквивалентна вызову pos().y().

См. также setY() и x().

qreal QGraphicsItem::zValue() const

Возвращает значение Z элемента. Значение Z влияет на порядок расположения элементов-собратьев (соседних) элементов.

Значение Z по умолчанию равно 0.

См. также setZValue(), Сортировка, stackBefore() и ItemStacksBehindParent.