QGraphicsScene Class

멤버 함수 문서

QGraphicsScene::QGraphicsScene(QObject *parent = nullptr)

QGraphicsScene 객체를 생성합니다. parent 파라미터는 QObject 의 생성자에 전달됩니다.

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

씬 사각형에 sceneRect 을 사용하여 QGraphicsScene 객체를 생성합니다. parent 파라미터는 QObject 의 생성자에 전달됩니다.

sceneRect도 참조하십시오 .

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

(x, y)로 지정된 사각형과 주어진 width 및 height 을 씬 사각형으로 사용하여 QGraphicsScene 객체를 생성합니다. parent 파라미터는 QObject 의 생성자에 전달됩니다.

sceneRect도 참조하십시오 .

[virtual noexcept] 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()가 참을 반환하는 경우) 제어가 이벤트 루프로 돌아가면 QGraphicsScene 은 changed()를 방출합니다.

항목이 이미 다른 장면에 있는 경우, 먼저 이전 장면에서 제거된 다음 이 장면에 최상위 레벨로 추가됩니다.

QGraphicsScene 씬에 추가되는 동안 item 으로 ItemSceneChange 알림을 보냅니다. 항목이 현재 씬에 속하지 않은 경우 알림이 한 번만 전송됩니다. 이미 씬에 속해 있는 경우(즉, 이 씬으로 이동한 경우), QGraphicsScene 은 이전 씬에서 항목이 제거될 때 추가 알림을 보냅니다.

항목이 패널이고 씬이 활성화되어 있으며 씬에 활성 패널이 없는 경우 항목이 활성화됩니다.

removeItem(), addEllipse(), addLine(), addPath(), addPixmap(), addRect(), addText(), addWidget() 및 Sorting 을참조하십시오 .

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())

widget 에 대해 QGraphicsProxyWidget 를 새로 생성하여 씬에 추가하고 프록시에 대한 포인터를 반환합니다. wFlags 임베딩 프록시 위젯의 기본 창 플래그를 설정합니다.

항목의 위치는 (0, 0)으로 초기화됩니다.

항목이 표시되면(즉, QGraphicsItem::isVisible() true), 제어가 이벤트 루프로 돌아가면 QGraphicsScene changed () 을 반환합니다.

Qt::WA_PaintOnScreen 위젯 속성이 설정된 위젯과 외부 애플리케이션 또는 컨트롤러를 래핑하는 위젯은 지원되지 않습니다. 예를 들어 QOpenGLWidget 및 QAxWidget이 있습니다.

addEllipse(), addLine(), addPixmap(), addPixmap(), addRect(), addText(), addSimpleText(), addItem()도 참조하세요 .

[slot] void QGraphicsScene::advance()

이 슬롯은 씬의 모든 항목에 대해 QGraphicsItem::advance()를 호출하여 씬을 한 단계 진행시킵니다. 이 작업은 두 단계로 수행됩니다. 첫 번째 단계에서는 모든 항목에 장면이 곧 변경될 것임을 알리고, 두 번째 단계에서는 모든 항목에 이동이 가능하다는 알림을 보냅니다. 첫 번째 단계에서는 0 값을 인수로 전달하여 QGraphicsItem::advance()를 호출하고, 두 번째 단계에서는 1을 전달합니다.

애니메이션에는 애니메이션 프레임워크를 사용할 수도 있습니다.

QGraphicsItem::advance() 및 QTimeLine 을참조하세요 .

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

이 신호는 씬 콘텐츠가 변경되면 제어가 이벤트 루프에 도달하면 QGraphicsScene 에서 발신합니다. region 매개변수에는 변경된 영역을 나타내는 장면 사각형 목록이 포함되어 있습니다.

QGraphicsView::updateScene()도 참조하세요 .

[slot] void QGraphicsScene::clear()

씬에서 모든 항목을 제거하고 삭제하지만 그렇지 않으면 씬의 상태를 변경하지 않고 그대로 유지합니다.

addItem()도 참조하세요 .

void QGraphicsScene::clearFocus()

장면에서 초점을 지웁니다. 이 함수가 호출될 때 초점이 있는 항목이 있으면 초점을 잃고 장면이 다시 초점을 잡으면 다시 초점을 되찾습니다.

초점이 없는 장면은 주요 이벤트를 무시합니다.

hasFocus(), setFocus() 및 setFocusItem()도 참조하십시오 .

[slot] void QGraphicsScene::clearSelection()

현재 선택 항목을 지웁니다.

setSelectionArea() 및 selectedItems()도 참조하세요 .

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

item 와 충돌하는 모든 항목의 목록을 반환합니다. 충돌 여부는 QGraphicsItem::collidesWithItem()를 호출하여 결정되며, 충돌 감지는 mode 에 의해 결정됩니다. 기본적으로 모양이 item 와 교차하거나 item 의 모양 안에 포함된 모든 항목이 반환됩니다.

항목은 내림차순으로 반환됩니다(즉, 목록의 첫 번째 항목이 가장 위쪽 항목이고 마지막 항목이 가장 아래쪽 항목입니다).

items(), itemAt(), QGraphicsItem::collidesWithItem() 및 Sorting도 참조하세요 .

[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 에 대한 이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 장면에 대한 드래그 입력 이벤트를 수신할 수 있습니다.

기본 구현은 이벤트를 수락하고 장면이 드래그 이동 이벤트를 수락하도록 준비합니다.

QGraphicsItem::dragEnterEvent(), dragMoveEvent(), dragLeaveEvent() 및 dropEvent()도 참조하세요 .

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

이벤트 event 에 대한 이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 씬에 대한 드래그 아웃 이벤트를 수신할 수 있습니다.

QGraphicsItem::dragLeaveEvent(), dragEnterEvent(), dragMoveEvent() 및 dropEvent()도 참조하세요 .

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

이벤트 event 에 대한 이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 장면에 대한 드래그 이동 이벤트를 수신할 수 있습니다.

참고: 이 함수가 표시되는 것으로 간주되는 항목에 대한 정의는 items()를 참조하세요.

QGraphicsItem::dragMoveEvent(), dragEnterEvent(), dragLeaveEvent() 및 dropEvent()도 참조하세요 .

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

아이템과 전경이 그려지기 전에 painter 를 사용하여 장면의 배경을 그립니다. 이 함수를 다시 구현하여 장면에 사용자 지정 배경을 제공합니다.

모든 페인팅은 장면 좌표에서 수행됩니다. rect 매개 변수는 노출된 사각형입니다.

배경의 색상, 텍스처 또는 그라데이션만 정의하려는 경우 setBackgroundBrush()를 대신 호출할 수 있습니다.

drawForeground() 및 drawItems()도 참조하세요 .

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

배경과 모든 항목이 그려진 후 painter 를 사용하여 장면의 전경을 그립니다. 이 함수를 다시 구현하여 장면의 사용자 지정 전경을 제공합니다.

모든 페인팅은 장면 좌표에서 수행됩니다. rect 매개 변수는 노출된 사각형입니다.

전경에 색상, 텍스처 또는 그라데이션만 정의하려는 경우 setForegroundBrush()를 대신 호출할 수 있습니다.

drawBackground() 및 drawItems()도 참조하세요 .

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

이벤트 event 에 대한 이 이벤트 핸들러를 하위 클래스에서 다시 구현하여 씬에 대한 드롭 이벤트를 수신할 수 있습니다.

QGraphicsItem::dropEvent(), dragEnterEvent(), dragMoveEvent() 및 dragLeaveEvent()도 참조하세요 .

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

다시 구현합니다: QObject::event(QEvent *e).

event 이벤트를 처리하여 각 이벤트 핸들러로 전송합니다.

이 함수는 편의 이벤트 핸들러를 호출하는 것 외에도 마우스 그래버 아이템이 없을 때 마우스 이동 이벤트를 호버 이벤트로 변환하는 역할을 담당합니다. 호버 이벤트는 아이템에 직접 전달되며, 이에 대한 편의 기능은 없습니다.

QWidget 와 달리 QGraphicsScene 에는 enterEvent() 및 leaveEvent() 편의 함수가 없습니다. 대신 이 함수를 사용하여 해당 이벤트를 가져옵니다.

event 이 인식되어 처리된 경우 true 을 반환하고, 그렇지 않으면 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()도 참조하십시오 .

[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 가 참이면 이 함수는 앞으로 검색하고 next 가 거짓이면 뒤로 검색합니다.

QGraphicsScene 의 서브클래스에서 이 함수를 다시 구현하여 씬 내에서 탭 포커스가 어떻게 전달되는지 세밀하게 제어할 수 있습니다. 기본 구현은 QGraphicsWidget::setTabOrder()에 정의된 탭 포커스 체인을 기반으로 합니다.

[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()도 참조하세요 .

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

현장에서 rect 의 layers 을 무효화하고 다시 그리기를 예약합니다. 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 참조 ). 이 함수는 BackgroundLayer 이외의 레이어가 전달된 경우 update()를 호출하는 것과 동일합니다.

QGraphicsView::resetCachedContent()도 참조하세요 .

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

장면이 활성화된 경우(예: 활성화된 QGraphicsView 하나 이상에서 본 경우) true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

QGraphicsItem::isActive() 및 QWidget::isActiveWindow()도 참조하세요 .

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

지정된 position, 또는 이 위치에 항목이 없는 경우 nullptr 에서 가장 위에 표시되는 항목을 반환합니다.

deviceTransform 는 뷰에 적용되는 변환이며, 장면에 변환을 무시하는 항목이 포함된 경우 제공해야 합니다.

참고: 이 함수가 표시되는 것으로 간주되는 항목에 대한 정의는 items()를 참조하십시오.

items(), collidingItems() 및 Sorting 를참조하십시오 .

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() 및 Sorting 를참조하세요 .

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 을 사용하여 정렬된 목록으로 반환합니다. 이 경우 "visible"은 isVisible()이 true, effectiveOpacity()가 0.0보다 큰 값(완전 투명)을 반환하고 상위 항목이 클리핑하지 않는 항목을 정의합니다.

mode 의 기본값은 Qt::IntersectsItemShape 이며, 정확한 모양이 pos 와 교차하는 모든 항목이 반환됩니다.

deviceTransform 는 뷰에 적용되는 변환이며, 장면에 변환을 무시하는 항목이 포함된 경우 제공해야 합니다.

itemAt() 및 Sorting 을참조하십시오 .

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 을 사용하여 정렬된 목록으로 반환합니다. 이 경우 "visible"은 isVisible()이 true 을 반환하고, effectiveOpacity()가 0.0보다 큰 값(완전 투명)을 반환하며, 상위 항목이 해당 항목을 잘라내지 않는 항목을 정의합니다.

mode 의 기본값은 Qt::IntersectsItemShape 이며, 정확한 모양이 path 와 교차하거나 에 포함된 모든 항목이 반환됩니다.

deviceTransform 는 뷰에 적용되는 변형이며, 장면에 변형을 무시하는 항목이 포함된 경우 제공해야 합니다.

itemAt() 및 Sorting 을참조하십시오 .

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 을 사용하여 정렬된 목록으로 반환합니다. 이 경우 "visible"은 isVisible()이 true 을 반환하고, effectiveOpacity()가 0.0보다 큰 값(완전 투명)을 반환하며, 상위 항목이 해당 항목을 잘라내지 않는 항목을 정의합니다.

mode 의 기본값은 Qt::IntersectsItemShape 이며, 정확한 모양이 polygon 와 교차하거나 에 포함된 모든 항목이 반환됩니다.

deviceTransform 는 뷰에 적용되는 변형이며, 장면에 변형을 무시하는 항목이 포함된 경우 제공해야 합니다.

itemAt() 및 Sorting 을참조하십시오 .

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 을 사용하여 정렬된 목록으로 반환합니다. 이 경우 "visible"은 isVisible()이 true 을 반환하고, effectiveOpacity()가 0.0보다 큰 값(완전 투명)을 반환하며, 상위 항목이 해당 항목을 잘라내지 않는 항목을 정의합니다.

mode 의 기본값은 Qt::IntersectsItemShape 이며, 정확한 모양이 rect 와 교차하거나 에 포함된 모든 항목이 반환됩니다.

deviceTransform 는 뷰에 적용되는 변형이며, 장면에 변형을 무시하는 항목이 포함된 경우 제공해야 합니다.

itemAt() 및 Sorting 을참조하십시오 .

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 을 사용하여 정렬된 목록으로 반환합니다. 이 경우 "visible"은 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)

painter 을 사용하여 장면의 source 직사각형을 target 으로 렌더링합니다. 이 기능은 씬의 내용을 QImage 와 같은 페인트 장치로 캡처하거나(예: 스크린샷을 찍기 위해) QPrinter로 인쇄할 때 유용합니다. 예를 들어

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

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

source 가 널 직사각형인 경우 이 함수는 sceneRect()를 사용하여 렌더링할 내용을 결정합니다. target 가 null rect인 경우 painter 의 페인트 장치의 치수가 사용됩니다.

소스 사각형 콘텐츠는 aspectRatioMode 에 따라 대상 사각형에 맞게 변형됩니다. 기본적으로 가로 세로 비율은 유지되며 source 은 target 에 맞게 크기가 조정됩니다.

QGraphicsView::render()도 참조하세요 .

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

이 신호는 씬 직사각형이 변경될 때마다 QGraphicsScene 에서 발신합니다. rect 매개변수는 새 씬 사각형입니다.

QGraphicsView::updateSceneRect()도 참조하세요 .

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

현재 선택된 모든 항목의 목록을 반환합니다. 항목은 특정 순서 없이 반환됩니다.

setSelectionArea()도 참조하세요 .

QPainterPath QGraphicsScene::selectionArea() const

이전에 setSelectionArea()로 설정한 선택 영역을 반환하거나, 선택 영역이 설정되지 않은 경우 빈 QPainterPath 을 반환합니다.

setSelectionArea()도 참조하세요 .

[signal] void QGraphicsScene::selectionChanged()

이 신호는 선택 항목이 변경될 때마다 QGraphicsScene 에서 전송됩니다. selectedItems ()를 호출하여 선택한 항목의 새 목록을 가져올 수 있습니다.

항목이 선택 또는 선택 해제되거나 선택 영역이 설정, 지워지거나 기타 방식으로 변경되거나 미리 선택된 항목이 장면에 추가되거나 선택된 항목이 장면에서 제거될 때마다 선택 항목이 변경됩니다.

QGraphicsScene 그룹 선택 작업의 경우 이 신호를 한 번만 방출합니다. 예를 들어 선택 영역을 설정하거나 QGraphicsItemGroup 을 선택 또는 선택 취소하거나 선택한 여러 항목이 포함된 상위 항목을 장면에서 추가 또는 제거하는 경우, selectionChanged()는 각 항목에 대해 한 번이 아니라 작업이 완료된 후 한 번만 발생합니다(각 항목마다 한 번이 아닌).

setSelectionArea(), selectedItems() 및 QGraphicsItem::setSelected()도 참조하세요 .

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

가능한 이벤트 필터를 통해 event 이벤트를 item 항목으로 전송합니다.

이벤트는 항목이 활성화된 경우에만 전송됩니다.

이벤트가 필터링되었거나 항목이 비활성화된 경우 false 을 반환합니다. 그렇지 않으면 이벤트 핸들러에서 반환된 값을 반환합니다.

QGraphicsItem::sceneEvent() 및 QGraphicsItem::sceneEventFilter()도 참조하세요 .

void QGraphicsScene::setActivePanel(QGraphicsItem *item)

이 장면의 항목이어야 하는 item 을 활성화합니다. item 에 0을 전달할 수도 있으며, 이 경우 QGraphicsScene 은 현재 활성화된 모든 패널을 비활성화합니다.

장면이 현재 비활성 상태인 경우 item 는 장면이 활성화될 때까지 비활성 상태로 유지됩니다(또는 item 이 nullptr 인 경우 항목이 활성화되지 않음).

activePanel(), isActive() 및 QGraphicsItem::isActive()도 참조하세요 .

void QGraphicsScene::setActiveWindow(QGraphicsWidget *widget)

이 장면에서 위젯이어야 하는 widget 을 활성화합니다. 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 플래그가 활성화되지 않은 경우) 보이지 않거나 활성화되지 않은 경우 이 함수는 이전 포커스 항목에서 포커스만 제거합니다.

항목이 nullptr 이 아니고 장면에 현재 포커스가 없는 경우(즉, hasFocus()가 false 를 반환하는 경우) 이 함수는 자동으로 setFocus()를 호출합니다.

focusItem(), hasFocus() 및 setFocus()도 참조하십시오 .

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

선택 영역을 path 로 설정합니다. 이 영역 안의 모든 항목은 즉시 선택되고 바깥의 모든 항목은 선택 해제됩니다. selectedItems ()를 호출하여 선택한 모든 항목의 목록을 가져올 수 있습니다.

deviceTransform 는 뷰에 적용되는 변환이며, 장면에 변환을 무시하는 항목이 포함된 경우 제공해야 합니다.

항목을 선택하려면 선택 가능 (QGraphicsItem::ItemIsSelectable)으로 표시해야 합니다.

clearSelection() 및 selectionArea()도 참조하십시오 .

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

이 기능은 과부하된 기능입니다.

mode 을 사용하여 선택 영역을 path 으로 설정하여 선택 영역에 항목이 포함되는지 확인합니다.

deviceTransform 는 뷰에 적용되는 변환이며, 장면에 변환을 무시하는 항목이 포함된 경우 제공해야 합니다.

selectionOperation 는 현재 선택된 항목으로 수행할 작업을 결정합니다.

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()도 참조하세요 .

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

장면에서 rect 영역을 다시 그리도록 예약합니다.

sceneRect() 및 changed()도 참조하세요 .

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()도 참조하세요 .