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()`가 `true`를 반환하는 경우), ` 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(), 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(), 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(), 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(), addRect(), addText(), addSimpleText() 및 addItem()도 참조하십시오 .

[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()도 참조하십시오 .

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 `가 `true`인 경우 이 함수는 앞으로 검색하고, ` next `가 `false`인 경우 뒤로 검색합니다.

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()을 호출하는 것과 동일합니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        graphicsScene, qOverload(&QGraphicsScene::invalidate));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        graphicsScene, [receiver = graphicsScene](const QRectF &rect, QGraphicsScene::SceneLayers layers) { receiver->invalidate(rect, layers); });

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 를 사용하여 정렬된 목록으로 반환합니다. 이 경우, “가시적”이란 다음 조건을 모두 충족하는 항목을 의미합니다: 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 를 사용하여 정렬된 목록으로 반환합니다. 이 경우 “가시”란 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 를 사용하여 정렬된 목록 형태로 반환합니다. 이 경우, “가시”란 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(someItem);
//...
QPrinter printer(QPrinter::HighResolution);
printer.setPageSize(QPageSize::A4);

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

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

소스 사각형의 내용은 대상 사각형에 맞도록 aspectRatioMode 에 따라 변환됩니다. 기본적으로 종횡비는 유지되며, source 는 target 에 맞도록 크기가 조정됩니다.

QGraphicsView::render()도 참조하십시오 .

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

이 신호는 장면 사각형(scene 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)

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

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

이벤트가 필터링되었거나 항목이 비활성화된 경우 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 플래그가 활성화되어 있지 않은 경우), 혹은 보이지 않거나 활성화되어 있지 않은 경우, 이 함수는 이전 포커스 항목에서 포커스만 제거합니다.

item이 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 영역에 대한 재렌더링을 예약합니다.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        graphicsScene, qOverload(&QGraphicsScene::update));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        graphicsScene, [receiver = graphicsScene](const QRectF &rect) { receiver->update(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()도 참조하십시오 .