Класс QGraphicsScene

Класс QGraphicsScene предоставляет поверхность для управления большим количеством 2D графических элементов. Подробнее...

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

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

Свойства

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

Public Slots

Signals

Protected Functions

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

Защищённые слоты

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

Класс служит контейнером для QGraphicsItems. Он используется вместе с QGraphicsView для визуализации графических элементов, таких как линии, прямоугольники, текст или даже пользовательские элементы, на двумерной поверхности. QGraphicsScene является частью фреймворка просмотра графики.

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

Пример:

QGraphicsScene scene;
scene.addText("Hello, world!");

QGraphicsView view(&scene);
view.show();

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

Для добавления элементов на сцену вы начинаете с создания объекта QGraphicsScene. Затем у вас есть два варианта: либо добавьте существующие объекты QGraphicsItem, вызвав addItem(), или вы можете вызвать одну из функций-утилит addEllipse(), addLine(), addPath(), addPixmap(), addPolygon(), addRect() или addText(), которые все возвращают указатель на только что добавленный элемент. Размеры элементов, добавленных с помощью этих функций, относительны к системе координат элемента, а положение элементов инициализируется в (0, 0) на сцене.

Затем вы можете визуализировать сцену с помощью QGraphicsView. При изменении сцены (например, при перемещении или преобразовании элемента) QGraphicsScene испускает сигнал changed(). Чтобы удалить элемент, вызовите removeItem().

QGraphicsScene использует алгоритм индексирования для эффективного управления расположением элементов. По умолчанию используется дерево BSP (Binary Space Partitioning); алгоритм, подходящий для больших сцен, где большинство элементов остаются статичными (т. е. не перемещаются).

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

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

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

QGraphicsScene поддерживает информацию о выделении для сцены. Для выбора элементов вызовите setSelectionArea(), а для очистки текущего выделения — clearSelection(). Вызовите selectedItems(), чтобы получить список всех выделенных элементов.

Обработка и распространение событий

Ещё одна обязанность QGraphicsScene — распространять события от QGraphicsView. Чтобы отправить событие на сцену, вы создаёте событие, наследующее от QEvent, и отправляете его, например, с помощью QCoreApplication::sendEvent(). event() отвечает за рассылку события отдельным элементам. Некоторые общие события обрабатываются удобными обработчиками событий. Например, события нажатия клавиш обрабатываются keyPressEvent(), а события нажатия мыши — mousePressEvent().

События клавиш доставляются элементу фокуса. Чтобы установить фокусируемый элемент, вы можете либо вызвать setFocusItem(), передавая элемент, который принимает фокус, либо сам элемент может вызвать QGraphicsItem::setFocus(). Вызовите focusItem(), чтобы получить текущий фокусируемый элемент. Для совместимости с виджетами сцена также сохраняет свою собственную информацию о фокусе. По умолчанию у сцены нет фокуса, и все события нажатия клавиш игнорируются. Если вызывается setFocus() или если какой-либо элемент на сцене получает фокус, сцена автоматически получает фокус. Если у сцены есть фокус, hasFocus() вернёт true, и события нажатия клавиш будут переданы элементу фокуса, если таковой имеется. Если сцена теряет фокус (например, кто-то вызвал clearFocus()) в то время, когда элемент имеет фокус, сцена сохранит информацию о фокусе элемента, и как только сцена вновь получит фокус, она позаботится о том, чтобы последний фокусируемый элемент вновь получил фокус.

Для эффектов наведения курсора QGraphicsScene отправляет события наведения. Если элемент принимает события наведения (см. QGraphicsItem::acceptHoverEvents()), он получит событие GraphicsSceneHoverEnter, когда курсор войдёт в его область. По мере продолжения перемещения курсора внутри области элемента QGraphicsScene будет отправлять ему события GraphicsSceneHoverMove. Когда курсор покинет область элемента, элемент получит событие GraphicsSceneHoverLeave.

Все события мыши передаются текущему элементу-«захватчику мыши». Элемент становится захватчиком мыши сцены, если он принимает события мыши (см. QGraphicsItem::acceptedMouseButtons()), и на нём происходит нажатие мыши. Он остаётся захватчиком мыши до получения события отпускания мыши, когда другие кнопки мыши не нажаты. Вы можете вызвать mouseGrabberItem(), чтобы определить, какой элемент в данный момент захватывает мышь.

См. также QGraphicsItem и QGraphicsView.

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

перечисление QGraphicsScene::ItemIndexMethod

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

См. также setItemIndexMethod() и bspTreeDepth.

перечисление QGraphicsScene::SceneLayerфлаги QGraphicsScene::SceneLayers

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

Каждый слой представляет флаг, который можно объединить с помощью операции ИЛИ при вызове функций, таких как invalidate() или QGraphicsView::invalidateScene().

Тип SceneLayers является типом-синонимом для QFlags<SceneLayer>. Он хранит комбинацию значений SceneLayer, полученную с помощью операции ИЛИ.

См. также invalidate() и QGraphicsView::invalidateScene().

QGraphicsScene scene;
QGraphicsView view(&scene);
view.show();

// a blue background
scene.setBackgroundBrush(Qt::blue);

// a gradient background
QRadialGradient gradient(0, 0, 10);
gradient.setSpread(QGradient::RepeatSpread);
scene.setBackgroundBrush(gradient);

QSizeF segmentSize = sceneRect().size() / pow(2, depth - 1);

QGraphicsScene scene;
QGraphicsView view(&scene);
view.show();

// a white semi-transparent foreground
scene.setForegroundBrush(QColor(255, 255, 255, 127));

// a grid foreground
scene.setForegroundBrush(QBrush(Qt::lightGray, Qt::CrossPattern));

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

QGraphicsScene::QGraphicsScene(qreal x, qreal y, qreal width, qreal height, QObject *parent = nullptr)

Создаёт объект QGraphicsScene, используя прямоугольник, заданный координатами (x, y), и заданными width и height для прямоугольника сцены. Параметр parent передаётся конструктору QObject.

См. также sceneRect.

QGraphicsScene::QGraphicsScene(const QRectF &sceneRect, QObject *parent = nullptr)

Создаёт объект QGraphicsScene, используя sceneRect для прямоугольника сцены. Параметр parent передаётся конструктору QObject.

См. также sceneRect.

QGraphicsScene::QGraphicsScene(QObject *parent = nullptr)

Создаёт объект QGraphicsScene. Параметр parent передаётся конструктору QObject.

[slot] void QGraphicsScene::advance()

Этот слот продвигает сцену на один шаг, вызывая QGraphicsItem::advance() для всех элементов на сцене. Это выполняется в двух фазах: на первой фазе все элементы уведомляются о предстоящих изменениях сцены, а на второй фазе все элементы уведомляются о возможности перемещения. В первой фазе QGraphicsItem::advance() вызывается с аргументом 0, а во второй фазе передаётся 1.

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

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

[signal] void QGraphicsScene::changed(const QList<QRectF> &region)

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

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

[slot] void QGraphicsScene::clear()

Удаляет и удаляет все элементы со сцены, но при этом оставляет неизменным состояние сцены.

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

[slot] void QGraphicsScene::clearSelection()

Очищает текущий выбор.

См. также setSelectionArea() и selectedItems().

[signal] void QGraphicsScene::focusItemChanged(QGraphicsItem *newFocusItem, QGraphicsItem *oldFocusItem, Qt::FocusReason reason)

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

oldFocusItem — указатель на элемент, который ранее имел фокус, или 0, если ни один элемент не имел фокуса до испускания сигнала. newFocusItem — указатель на элемент, который получил фокус ввода, или nullptr если фокус был потерян. reason — причина изменения фокуса (например, если сцена была деактивирована, а поле ввода имело фокус, oldFocusItem указывает на элемент поля ввода, newFocusItem будет nullptr, а reason будет Qt::ActiveWindowFocusReason.

[virtual protected slot] bool QGraphicsScene::focusNextPrevChild(bool next)

Находит новый виджет для присвоения фокуса клавиатуры, соответствующим образом для клавиш Tab и Shift+Tab, и возвращает true если новый виджет найден, или false, если нет. Если next равно true, эта функция ищет вперёд; если next равно false, она ищет назад.

Вы можете переопределить эту функцию в подклассе QGraphicsScene, чтобы обеспечить тонкую настройку того, как фокус Tab передаётся внутри сцены. Стандартная реализация основана на цепочке фокуса Tab, определённой QGraphicsWidget::setTabOrder().

[slot] void QGraphicsScene::invalidate(const QRectF &rect = QRectF(), QGraphicsScene::SceneLayers layers = AllLayers)

Проверяет и планирует перерисовку layers в rect на сцене. Любое кэшированное содержимое в layers безусловно проверяется и перерисовывается.

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

Пример:

QRectF TileScene::rectForTile(int x, int y) const
{
    // Return the rectangle for the tile at position (x, y).
    return QRectF(x * tileWidth, y * tileHeight, tileWidth, tileHeight);
}

void TileScene::setTile(int x, int y, const QPixmap &pixmap)
{
    // Sets or replaces the tile at position (x, y) with pixmap.
    if (x >= 0 && x < numTilesH && y >= 0 && y < numTilesV) {
        tiles[y][x] = pixmap;
        invalidate(rectForTile(x, y), BackgroundLayer);
    }
}

void TileScene::drawBackground(QPainter *painter, const QRectF &exposed)
{
    // Draws all tiles that intersect the exposed area.
    for (int y = 0; y < numTilesV; ++y) {
        for (int x = 0; x < numTilesH; ++x) {
            QRectF rect = rectForTile(x, y);
            if (exposed.intersects(rect))
                painter->drawPixmap(rect.topLeft(), tiles[y][x]);
        }
    }
}

Обратите внимание, что QGraphicsView в настоящее время поддерживает кэширование фона только (см. QGraphicsView::CacheBackground). Эта функция эквивалентна вызову update() если передан любой слой, кроме BackgroundLayer.

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

[signal] void QGraphicsScene::sceneRectChanged(const QRectF &rect)

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

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

[signal] void QGraphicsScene::selectionChanged()

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

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

QGraphicsScene испускает этот сигнал только один раз для операций группового выделения. Например, если вы установили область выделения, выделили или сняли выделение с QGraphicsItemGroup, или если вы добавили или удалили из сцены родительский элемент, содержащий несколько выделенных элементов, selectionChanged() испускается только один раз после завершения операции (а не один раз для каждого элемента).

См. также setSelectionArea(), selectedItems() и QGraphicsItem::setSelected().

[slot] void QGraphicsScene::update(const QRectF &rect = QRectF())

Планирует перерисовку области rect на сцене.

См. также sceneRect() и changed().

[virtual] QGraphicsScene::~QGraphicsScene()

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

QGraphicsItem *QGraphicsScene::activePanel() const

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

См. также QGraphicsScene::setActivePanel().

QGraphicsWidget *QGraphicsScene::activeWindow() const

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

См. также QGraphicsScene::setActiveWindow().

QGraphicsEllipseItem *QGraphicsScene::addEllipse(const QRectF &rect, const QPen &pen = QPen(), const QBrush &brush = QBrush())

Создаёт и добавляет элемент эллипса в сцену и возвращает указатель на элемент. Геометрия эллипса определяется параметром rect, а его контур и заливка инициализируются параметрами pen и brush.

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

Если элемент виден (т.е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene будет испускать changed() после возвращения управления циклу событий.

См. также addLine(), addPath(), addPixmap(), addRect(), addText(), addItem() и addWidget().

QGraphicsEllipseItem *QGraphicsScene::addEllipse(qreal x, qreal y, qreal w, qreal h, const QPen &pen = QPen(), const QBrush &brush = QBrush())

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

void QGraphicsScene::addItem(QGraphicsItem *item)

Добавляет или перемещает элемент item и все его дочерние элементы в эту сцену. Эта сцена берёт на себя владение элементом item.

Если элемент виден (т.е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene будет испускать changed() после возвращения управления циклу событий.

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

QGraphicsScene будет отправлять уведомления ItemSceneChange элементу item во время его добавления в сцену. Если элемент в данный момент не принадлежит никакой сцене, отправляется только одно уведомление. Если он уже принадлежит сцене (т.е., он перемещается в эту сцену), QGraphicsScene отправит уведомление о добавлении, когда элемент будет удален из предыдущей сцены.

Если элемент является модулем, сцена активна, и нет активного модуля в сцене, тогда элемент будет активирован.

См. также removeItem(), addEllipse(), addLine(), addPath(), addPixmap(), addRect(), addText(), addWidget() и Сортировка.

QGraphicsLineItem *QGraphicsScene::addLine(const QLineF &line, const QPen &pen = QPen())

Создаёт и добавляет элемент прямой линии в сцену и возвращает указатель на элемент. Геометрия прямой линии определяется параметром line, а его контур инициализируется параметром pen.

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

Если элемент виден (т.е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene будет испускать changed() после возвращения управления циклу событий.

См. также addEllipse(), addPath(), addPixmap(), addRect(), addText(), addItem() и addWidget().

QGraphicsLineItem *QGraphicsScene::addLine(qreal x1, qreal y1, qreal x2, qreal y2, const QPen &pen = QPen())

Эта функция-удобство эквивалентна вызову addLine(QLineF(x1, y1, x2, y2), pen).

QGraphicsPathItem *QGraphicsScene::addPath(const QPainterPath &path, const QPen &pen = QPen(), const QBrush &brush = QBrush())

Создаёт и добавляет элемент пути в сцену и возвращает указатель на элемент. Геометрия пути определяется параметром path, а его контур и заливка инициализируются параметрами pen и brush.

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

Если элемент виден (т.е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene будет испускать changed() после возвращения управления циклу событий.

См. также addEllipse(), addLine(), addPixmap(), addRect(), addText(), addItem() и addWidget().

QGraphicsPixmapItem *QGraphicsScene::addPixmap(const QPixmap &pixmap)

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

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

Если элемент виден (т.е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene будет испускать changed() после возвращения управления циклу событий.

См. также addEllipse(), addLine(), addPath(), addRect(), addText(), addItem() и addWidget().

QGraphicsPolygonItem *QGraphicsScene::addPolygon(const QPolygonF &polygon, const QPen &pen = QPen(), const QBrush &brush = QBrush())

Создает и добавляет элемент многоугольника на сцену и возвращает указатель на элемент. Многоугольник определяется параметром polygon, а его контур и заливка инициализируются значениями pen и brush соответственно.

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

Если элемент видим (т. е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene отправит сигнал changed() после возвращения управления в цикл обработки событий.

См. также addEllipse(), addLine(), addPath(), addRect(), addText(), addItem() и addWidget().

QGraphicsRectItem *QGraphicsScene::addRect(const QRectF &rect, const QPen &pen = QPen(), const QBrush &brush = QBrush())

Создает и добавляет элемент прямоугольника на сцену и возвращает указатель на элемент. Геометрия прямоугольника определяется параметром rect, а его контур и заливка инициализируются значениями pen и brush соответственно.

Обратите внимание, что геометрия элемента задается в координатах элемента, а его положение инициализируется значением (0, 0). Например, если добавляется QRect(50, 50, 100, 100), его верхний левый угол будет расположен в точке (50, 50) относительно начала координат в системе координат элемента.

Если элемент видим (т. е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene отправит сигнал changed() после возвращения управления в цикл обработки событий.

См. также addEllipse(), addLine(), addPixmap(), addPixmap(), addText(), addItem() и addWidget().

QGraphicsRectItem *QGraphicsScene::addRect(qreal x, qreal y, qreal w, qreal h, const QPen &pen = QPen(), const QBrush &brush = QBrush())

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

QGraphicsSimpleTextItem *QGraphicsScene::addSimpleText(const QString &text, const QFont &font = QFont())

Создает и добавляет элемент QGraphicsSimpleTextItem на сцену и возвращает указатель на элемент. Строка текста инициализируется значением text, а шрифт — значением font.

Положение элемента инициализируется значением (0, 0).

Если элемент видим (т. е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene отправит сигнал changed() после возвращения управления в цикл обработки событий.

См. также addEllipse(), addLine(), addPixmap(), addPixmap(), addRect(), addItem() и addWidget().

QGraphicsTextItem *QGraphicsScene::addText(const QString &text, const QFont &font = QFont())

Создает и добавляет текстовый элемент на сцену и возвращает указатель на элемент. Строка текста инициализируется значением text, а шрифт — значением font.

Положение элемента инициализируется значением (0, 0).

Если элемент видим (т. е., QGraphicsItem::isVisible() возвращает true), QGraphicsScene отправит сигнал changed() после возвращения управления в цикл обработки событий.

См. также addEllipse(), addLine(), addPixmap(), addPixmap(), addRect(), addItem() и addWidget().

QGraphicsProxyWidget *QGraphicsScene::addWidget(QWidget *widget, Qt::WindowFlags wFlags = Qt::WindowFlags())

Создает новый QGraphicsProxyWidget для widget, добавляет его на сцену и возвращает указатель на прокси-объект. wFlags задают флаги окна по умолчанию для встроенного прокси-виджета.

Положение элемента инициализируется значением (0, 0).

Обратите внимание, что виджеты с установленным атрибутом виджета Qt::WA_PaintOnScreen и виджеты, которые оборачивают внешнее приложение или контроллер, не поддерживаются. Примерами являются QOpenGLWidget и QAxWidget.

См. также addEllipse(), addLine(), addPixmap(), addPixmap(), addRect(), addText(), addSimpleText() и addItem().

void QGraphicsScene::clearFocus()

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

Сцена, у которой нет фокуса, игнорирует события нажатия клавиш.

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

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

Возвращает список всех элементов, которые сталкиваются с элементом item. Столкновения определяются вызовом QGraphicsItem::collidesWithItem(); обнаружение столкновения определяется параметром mode. По умолчанию возвращаются все элементы, чья форма пересекается с формой item или находится внутри формы item.

Элементы возвращаются в порядке убывания стека (т. е., первый элемент в списке — самый верхний элемент, а последний — самый нижний).

См. также items(), itemAt(), QGraphicsItem::collidesWithItem() и Сортировка.

[virtual protected] void QGraphicsScene::contextMenuEvent(QGraphicsSceneContextMenuEvent *contextMenuEvent)

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

Примечание: см. items() для определения, какие элементы считаются видимыми этой функцией.

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

QGraphicsItemGroup *QGraphicsScene::createItemGroup(const QList<QGraphicsItem *> &items)

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

QGraphicsScene владеет элементом группы; вам не нужно его удалять. Чтобы разобрать (разобщить) группу, вызовите destroyItemGroup().

См. также destroyItemGroup() и QGraphicsItemGroup::addToGroup().

void QGraphicsScene::destroyItemGroup(QGraphicsItemGroup *group)

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

См. также createItemGroup() и QGraphicsItemGroup::removeFromGroup().

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

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

По умолчанию обработчик принимает событие и подготавливает сцену для приема событий drag move.

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

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

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

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

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

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

Примечание: См. items() для определения того, какие элементы считаются видимыми этой функцией.

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

[virtual protected] void QGraphicsScene::drawBackground(QPainter *painter, const QRectF &rect)

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

Все рисование выполняется в координатах scene. Параметр rect — это видимый прямоугольник.

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

См. также drawForeground() и drawItems().

[virtual protected] void QGraphicsScene::drawForeground(QPainter *painter, const QRectF &rect)

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

Все рисование выполняется в координатах scene. Параметр rect — это видимый прямоугольник.

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

См. также drawBackground() и drawItems().

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

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

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

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

Переопределяет: QObject::event(QEvent *e).

Обрабатывает событие event и рассылает его соответствующим обработчикам событий.

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

В отличие от QWidget, QGraphicsScene не имеет удобных функций enterEvent() и leaveEvent(). Используйте эту функцию для получения этих событий вместо этого.

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

См. также contextMenuEvent(), keyPressEvent(), keyReleaseEvent(), mousePressEvent(), mouseMoveEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), focusInEvent() и focusOutEvent().

[override virtual protected] bool QGraphicsScene::eventFilter(QObject *watched, QEvent *event)

Переопределяет: QObject::eventFilter(QObject *watched, QEvent *event).

QGraphicsScene фильтрует события QApplication для обнаружения изменений палитры и шрифтов.

[virtual protected] void QGraphicsScene::focusInEvent(QFocusEvent *focusEvent)

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

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

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

QGraphicsItem *QGraphicsScene::focusItem() const

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

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

См. также setFocusItem(), QGraphicsItem::hasFocus() и isActive().

[virtual protected] void QGraphicsScene::focusOutEvent(QFocusEvent *focusEvent)

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

По умолчанию снимает фокус с любого фокусируемого элемента, затем снимает фокус со сцены.

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

bool QGraphicsScene::hasFocus() const

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

См. также setFocus() и setFocusItem().

qreal QGraphicsScene::height() const

Эта вспомогательная функция эквивалентна вызову sceneRect().height().

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

[virtual protected] void QGraphicsScene::helpEvent(QGraphicsSceneHelpEvent *helpEvent)

Этот обработчик событий, для события helpEvent, может быть переопределен в подклассе для получения событий справки. События имеют тип QEvent::ToolTip, которые создаются при запросе всплывающей подсказки.

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

Примечание: См. items() для определения того, какие элементы считаются видимыми этой функцией.

См. также QGraphicsItem::toolTip() и QGraphicsSceneHelpEvent.

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

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

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

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

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

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

Параметр query указывает, какое свойство запрашивается.

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

void QGraphicsScene::invalidate(qreal x, qreal y, qreal w, qreal h, QGraphicsScene::SceneLayers layers = AllLayers)

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

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

bool QGraphicsScene::isActive() const

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

См. также QGraphicsItem::isActive() и QWidget::isActiveWindow().

QGraphicsItem *QGraphicsScene::itemAt(const QPointF &position, const QTransform &deviceTransform) const

Возвращает самый верхний видимый элемент в указанной position, или nullptr , если элементов в этой позиции нет.

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

Примечание: см. items() для определения, какие элементы считаются видимыми этой функцией.

См. также items(), collidingItems(), и Сортировка.

QGraphicsItem *QGraphicsScene::itemAt(qreal x, qreal y, const QTransform &deviceTransform) const

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

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

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

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

Примечание: см. items() для определения, какие элементы считаются видимыми этой функцией.

QList<QGraphicsItem *> QGraphicsScene::items(Qt::SortOrder order = Qt::DescendingOrder) const

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

См. также addItem(), removeItem(), и Сортировка.

QList<QGraphicsItem *> QGraphicsScene::items(const QPointF &pos, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

Возвращает все видимые элементы, которые, в зависимости от mode, находятся в указанной pos в списке, отсортированном по order. В этом случае «видимый» определяет элементы, для которых: isVisible() возвращает true, effectiveOpacity() возвращает значение больше 0.0 (полностью прозрачный), и родительский элемент не обрезает его.

Значение по умолчанию для mode — Qt::IntersectsItemShape; возвращаются все элементы, чья точная форма пересекается с pos.

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

См. также itemAt() и Сортировка.

QList<QGraphicsItem *> QGraphicsScene::items(const QRectF &rect, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

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

Возвращает все видимые элементы, которые, в зависимости от mode, находятся внутри или пересекаются с заданным rect в списке, отсортированном по order. В этом случае «видимый» определяет элементы, для которых: isVisible() возвращает true, effectiveOpacity() возвращает значение больше 0.0 (полностью прозрачный), и родительский элемент не обрезает его.

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

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

См. также itemAt() и Сортировка.

QList<QGraphicsItem *> QGraphicsScene::items(const QPolygonF &polygon, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

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

Возвращает все видимые элементы, которые, в зависимости от mode, находятся внутри или пересекаются с заданной polygon в списке, отсортированном по order. В этом случае «видимый» определяет элементы, для которых: isVisible() возвращает true, effectiveOpacity() возвращает значение больше 0.0 (полностью прозрачный), и родительский элемент не обрезает его.

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

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

См. также itemAt() и Сортировка.

QList<QGraphicsItem *> QGraphicsScene::items(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, Qt::SortOrder order = Qt::DescendingOrder, const QTransform &deviceTransform = QTransform()) const

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

Возвращает все видимые элементы, которые, в зависимости от mode, находятся внутри или пересекаются с заданной path в списке, отсортированном по order. В этом случае «видимый» определяет элементы, для которых: isVisible() возвращает true, effectiveOpacity() возвращает значение больше 0.0 (полностью прозрачный), и родительский элемент не обрезает его.

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

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

См. также itemAt() и Сортировка.

QList<QGraphicsItem *> QGraphicsScene::items(qreal x, qreal y, qreal w, qreal h, Qt::ItemSelectionMode mode, Qt::SortOrder order, const QTransform &deviceTransform = QTransform()) const

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

Возвращает все видимые элементы, которые, в зависимости от mode, находятся внутри или пересекаются с прямоугольником, определяемым x, y, w и h, в списке, отсортированном по order. В этом случае «видимый» определяет элементы, для которых: isVisible() возвращает true, effectiveOpacity() возвращает значение больше 0.0 (полностью прозрачный), и родительский элемент не обрезает его.

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

QRectF QGraphicsScene::itemsBoundingRect() const

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

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

[virtual protected] void QGraphicsScene::keyPressEvent(QKeyEvent *keyEvent)

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

См. также QGraphicsItem::keyPressEvent() и focusItem().

[virtual protected] void QGraphicsScene::keyReleaseEvent(QKeyEvent *keyEvent)

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

См. также QGraphicsItem::keyReleaseEvent() и focusItem().

[virtual protected] void QGraphicsScene::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *mouseEvent)

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

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

По умолчанию реализация похожа на mousePressEvent().

Примечание: См. items() для определения, какие элементы считаются видимыми этой функцией.

См. также QGraphicsItem::mousePressEvent(), QGraphicsItem::mouseMoveEvent(), QGraphicsItem::mouseReleaseEvent() и QGraphicsItem::setAcceptedMouseButtons().

QGraphicsItem *QGraphicsScene::mouseGrabberItem() const

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

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

• Если элемент получает событие отпускания мыши, когда не нажаты другие кнопки, он теряет захват мыши.
• Если элемент становится невидимым (т.е., кто-то вызывает item->setVisible(false)) или если он становится отключенным (т.е., кто-то вызывает item->setEnabled(false)), он теряет захват мыши.
• Если элемент удален со сцены, он теряет захват мыши.

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

[virtual protected] void QGraphicsScene::mouseMoveEvent(QGraphicsSceneMouseEvent *mouseEvent)

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

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

См. также QGraphicsItem::mousePressEvent(), QGraphicsItem::mouseReleaseEvent(), QGraphicsItem::mouseDoubleClickEvent() и QGraphicsItem::setAcceptedMouseButtons().

[virtual protected] void QGraphicsScene::mousePressEvent(QGraphicsSceneMouseEvent *mouseEvent)

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

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

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

Примечание: См. items() для определения, какие элементы считаются видимыми этой функцией.

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

[virtual protected] void QGraphicsScene::mouseReleaseEvent(QGraphicsSceneMouseEvent *mouseEvent)

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

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

См. также QGraphicsItem::mousePressEvent(), QGraphicsItem::mouseMoveEvent(), QGraphicsItem::mouseDoubleClickEvent() и QGraphicsItem::setAcceptedMouseButtons().

void QGraphicsScene::removeItem(QGraphicsItem *item)

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

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

void QGraphicsScene::render(QPainter *painter, const QRectF &target = QRectF(), const QRectF &source = QRectF(), Qt::AspectRatioMode aspectRatioMode = Qt::KeepAspectRatio)

Отображает прямоугольник source со сцены в target, используя painter. Эта функция полезна для захвата содержимого сцены на устройство рисования, например, QImage (например, для создания скриншота) или для печати с помощью QPrinter. Например:

QGraphicsScene scene;
scene.addItem(...
...
QPrinter printer(QPrinter::HighResolution);
printer.setPaperSize(QPrinter::A4);

QPainter painter(&printer);
scene.render(&painter);

Если source — пустой прямоугольник, эта функция будет использовать sceneRect() для определения того, что отображать. Если target — пустой прямоугольник, будут использоваться размеры устройства рисования painter.

Содержимое прямоугольника source будет преобразовываться в соответствии с aspectRatioMode для вписывания в прямоугольник target. По умолчанию сохраняется соотношение сторон, а source масштабируется для вписывания в target.

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

QList<QGraphicsItem *> QGraphicsScene::selectedItems() const

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

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

QPainterPath QGraphicsScene::selectionArea() const

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

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

bool QGraphicsScene::sendEvent(QGraphicsItem *item, QEvent *event)

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

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

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

См. также QGraphicsItem::sceneEvent() и QGraphicsItem::sceneEventFilter().

void QGraphicsScene::setActivePanel(QGraphicsItem *item)

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

Если сцена в данный момент неактивна, item остаётся неактивным до тех пор, пока сцена не станет активной (или, если item — nullptr, никакой элемент не будет активирован).

См. также activePanel(), isActive() и QGraphicsItem::isActive().

void QGraphicsScene::setActiveWindow(QGraphicsWidget *widget)

Активирует виджет, который должен быть виджетом в этой сцене. Также можно передать 0 для виджета, в этом случае QGraphicsScene деактивирует любое активное окно.

См. также activeWindow() и QGraphicsWidget::isActiveWindow().

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

Устанавливает фокус на сцену, отправив QFocusEvent в сцену, передав focusReason в качестве причины. Если сцена получает фокус после его потери, когда некоторый элемент имел фокус, последний элемент фокуса получит фокус с focusReason в качестве причины.

Если сцена уже имеет фокус, эта функция ничего не делает.

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

void QGraphicsScene::setFocusItem(QGraphicsItem *item, Qt::FocusReason focusReason = Qt::OtherFocusReason)

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

Если item равен nullptr, или если он не принимает фокус (т.е., у него не включён флаг QGraphicsItem::ItemIsFocusable), или он не виден или не активен, эта функция только удаляет фокус с любого предыдущего элемента фокуса.

Если item не равен nullptr, и сцена в данный момент не имеет фокуса (т.е., hasFocus() возвращает false), эта функция автоматически вызовет setFocus().

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

void QGraphicsScene::setSelectionArea(const QPainterPath &path, const QTransform &deviceTransform)

Устанавливает область выделения на path. Все элементы в этой области сразу же выбираются, а все элементы за пределами области — нет. Список всех выбранных элементов можно получить, вызвав selectedItems().

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

Чтобы элемент был выбран, он должен быть помечен как выбираемый (QGraphicsItem::ItemIsSelectable).

См. также clearSelection() и selectionArea().

[since 5.5] void QGraphicsScene::setSelectionArea(const QPainterPath &path, Qt::ItemSelectionOperation selectionOperation = Qt::ReplaceSelection, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape, const QTransform &deviceTransform = QTransform())

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

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

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

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

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

См. также clearSelection() и selectionArea().

void QGraphicsScene::setStyle(QStyle *style)

Устанавливает или заменяет стиль сцены на style и переродирует стиль в эту сцену. Любой ранее назначенный стиль удаляется. Стиль сцены по умолчанию — QApplication::style(), и он является стилем по умолчанию для всех элементов QGraphicsWidget в сцене.

Изменение стиля, как напрямую, вызывая эту функцию, так и косвенно, вызывая QApplication::setStyle(), автоматически обновит стиль для всех виджетов в сцене, у которых нет явно назначенного стиля.

Если style равен nullptr, QGraphicsScene вернётся к QApplication::style().

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

QStyle *QGraphicsScene::style() const

Возвращает стиль сцены или тот же, что и QApplication::style(), если сцене явно не был назначен стиль.

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

void QGraphicsScene::update(qreal x, qreal y, qreal w, qreal h)

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

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

QList<QGraphicsView *> QGraphicsScene::views() const

Возвращает список всех представлений, которые отображают эту сцену.

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

[virtual protected] void QGraphicsScene::wheelEvent(QGraphicsSceneWheelEvent *wheelEvent)

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

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

Примечание: см. items() для определения того, какие элементы считаются видимыми этой функцией.

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

qreal QGraphicsScene::width() const

Эта вспомогательная функция эквивалентна вызову sceneRect().width().

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