QGraphicsView Class

멤버 함수 문서

QGraphicsView::QGraphicsView(QWidget *parent = nullptr)

QWidget 의 생성자에 parent 을 전달합니다.

QGraphicsView::QGraphicsView(QGraphicsScene *scene, QWidget *parent = nullptr)

시각화된 장면을 scene 로 설정하고 parent 을 QWidget 의 생성자에 전달합니다.

[virtual noexcept] QGraphicsView::~QGraphicsView()

QGraphicsView 객체를 파괴합니다.

void QGraphicsView::centerOn(const QPointF &pos)

뷰포트의 내용을 스크롤하여 장면 좌표 pos, 뷰의 중앙에 위치하도록 합니다.

pos 은 부동 소수점 좌표이고 스크롤 막대는 정수 좌표에서 작동하므로 가운데 위치는 근사치일 뿐입니다.

ensureVisible()도 참조하십시오 .

void QGraphicsView::centerOn(const QGraphicsItem *item)

이 함수는 과부하된 함수입니다.

뷰포트의 콘텐츠를 스크롤하여 item 이 뷰의 중앙에 오도록 합니다.

ensureVisible()도 참조하십시오 .

void QGraphicsView::centerOn(qreal x, qreal y)

이 기능은 과부하가 걸린 기능입니다.

이 함수는 편의를 위해 제공됩니다. 센터온(QPointF(x, y))을 호출하는 것과 같습니다.

[override virtual protected] void QGraphicsView::contextMenuEvent(QContextMenuEvent *event)

다시 구현합니다: QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e).

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

다시 구현합니다: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent * 이벤트).

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

다시 구현합니다: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent * 이벤트).

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

다시 구현합니다: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent * 이벤트).

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

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

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

모든 페인팅은 장면 좌표에서 이루어집니다. rect 은 노출된 사각형입니다.

기본 구현은 뷰의 backgroundBrush 을 사용하여 rect 을 채웁니다. 이러한 브러시가 정의되지 않은 경우(기본값) 장면의 drawBackground() 함수가 대신 호출됩니다.

drawForeground() 및 QGraphicsScene::drawBackground()도 참조하십시오 .

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

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

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

모든 페인팅은 장면 좌표에서 이루어집니다. rect 은 노출된 사각형입니다.

기본 구현은 뷰의 foregroundBrush 을 사용하여 rect 을 채웁니다. 이러한 브러시가 정의되어 있지 않은 경우(기본값) 장면의 drawForeground() 함수가 대신 호출됩니다.

drawBackground() 및 QGraphicsScene::drawForeground()도 참조하십시오 .

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

다시 구현합니다: QAbstractScrollArea::dropEvent(QDropEvent * 이벤트).

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

뷰포트의 내용을 스크롤하여 장면 사각형 rect 이 보이도록 하고 여백을 픽셀 단위로 지정합니다( xmargin 및 ymargin). 지정된 사각형에 도달할 수 없는 경우 가장 가까운 유효한 위치로 내용을 스크롤합니다. 두 여백의 기본값은 50픽셀입니다.

centerOn()도 참조하세요 .

void QGraphicsView::ensureVisible(const QGraphicsItem *item, int xmargin = 50, int ymargin = 50)

이 함수는 오버로드된 함수입니다.

항목 item 의 중앙이 보이도록 뷰포트의 콘텐츠를 스크롤하며 여백은 픽셀 단위로 지정된 xmargin 및 ymargin 로 지정합니다. 지정된 지점에 도달할 수 없는 경우 콘텐츠가 가장 가까운 유효한 위치로 스크롤됩니다. 두 여백의 기본값은 50픽셀입니다.

centerOn()도 참조하세요 .

void QGraphicsView::ensureVisible(qreal x, qreal y, qreal w, qreal h, int xmargin = 50, int ymargin = 50)

이 기능은 과부하가 걸린 기능입니다.

이 함수는 편의를 위해 제공됩니다. 이는 ensureVisible(QRectF(x, y, w, h), xmargin, ymargin)을 호출하는 것과 동일합니다.

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

다시 구현합니다: QAbstractScrollArea::event(QEvent * 이벤트).

void QGraphicsView::fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio)

뷰 행렬의 크기를 조정하고 스크롤 막대를 스크롤하여 장면 사각형 rect 이 뷰포트 안에 맞도록 합니다. rect 은 장면 사각형 안에 있어야 하며, 그렇지 않으면 fitInView()는 전체 사각형이 표시되도록 보장할 수 없습니다.

이 함수는 뷰의 회전, 이동 또는 전단을 유지합니다. 뷰의 배율은 aspectRatioMode 에 따라 조정됩니다. rect 이 뷰에 꼭 맞지 않으면 뷰의 중앙에 배치됩니다.

일반적으로 resizeEvent()의 재구현 내부에서 fitInView()를 호출하여 뷰의 크기가 조정될 때 전체 장면 또는 장면의 일부가 뷰포트의 새 크기에 맞게 자동으로 조정되도록 하는 것이 일반적입니다. 하지만 새 변환이 스크롤바의 자동 상태를 전환하는 경우 resizeEvent() 내부에서 fitInView()를 호출하면 원치 않는 크기 조정 재귀가 발생할 수 있습니다. 이를 방지하기 위해 스크롤바 정책을 항상 켜짐 또는 항상 꺼짐으로 전환할 수 있습니다( horizontalScrollBarPolicy() 및 verticalScrollBarPolicy() 참조).

rect 이 비어 있거나 뷰포트가 너무 작으면 이 함수는 아무 작업도 수행하지 않습니다.

setTransform(), ensureVisible() 및 centerOn()도 참조하세요 .

void QGraphicsView::fitInView(const QGraphicsItem *item, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio)

이 함수는 과부하된 함수입니다.

aspectRatioMode 에 따라 뷰의 크기를 조정하여 item 이 뷰 내부에 꼭 맞도록 합니다.

ensureVisible() 및 centerOn()도 참조하십시오 .

void QGraphicsView::fitInView(qreal x, qreal y, qreal w, qreal h, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio)

이 함수는 오버로드된 함수입니다.

이 편의 함수는 fitInView(QRectF(x, y, w, h), aspectRatioMode)를 호출하는 것과 동일합니다.

ensureVisible() 및 centerOn()도 참조하세요 .

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

다시 구현합니다: QWidget::focusInEvent(QFocusEvent * 이벤트).

[override virtual protected] bool QGraphicsView::focusNextPrevChild(bool next)

다시 구현합니다: QWidget::focusNextPrevChild(다음 부울).

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

다시 구현합니다: QWidget::focusOutEvent(QFocusEvent * 이벤트).

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

다시 구현합니다: QWidget::inputMethodEvent(Q입력메소드이벤트 *이벤트).

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

재구현합니다: QWidget::inputMethodQuery(Qt::InputMethodQuery 쿼리) const.

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

rect 안에 있는 layers 을 무효화하고 다시 그리기를 예약합니다. rect 은 씬 좌표에 있습니다. rect 안에 있는 layers 의 캐시된 콘텐츠는 무조건 무효화되고 다시 그려집니다.

이 함수를 호출하여 씬의 배경 또는 전경에 대한 변경 사항을 QGraphicsView 에 알릴 수 있습니다. 일반적으로 타일 기반 배경이 있는 씬에서 QGraphicsView 백그라운드 캐싱이 활성화된 경우 변경 사항을 알리기 위해 사용됩니다.

QGraphicsView 은 현재 백그라운드 캐싱만 지원합니다( QGraphicsView::CacheBackground 참조 ). 이 함수는 QGraphicsScene::BackgroundLayer 이외의 레이어가 전달되면 update()를 호출하는 것과 동일합니다.

QGraphicsScene::invalidate() 및 update()도 참조하세요 .

bool QGraphicsView::isTransformed() const

뷰가 변형된 경우(즉, 비아이덴티티 변환이 할당되었거나 스크롤 막대가 조정된 경우) true 을 반환합니다.

setTransform(), horizontalScrollBar() 및 verticalScrollBar()도 참조하십시오 .

QGraphicsItem *QGraphicsView::itemAt(const QPoint &pos) const

뷰포트 좌표의 pos 위치에 있는 항목을 반환합니다. 이 위치에 여러 항목이 있는 경우 이 함수는 맨 위에 있는 항목을 반환합니다.

예시:

void CustomView::mousePressEvent(QMouseEvent *event) { if (QGraphicsItem *item = itemAt(event->pos())) {        qDebug() << "You clicked on item" << item;
    } else {        qDebug("You didn't click on an item.");
    } }

items() 및 Sorting도 참조하세요 .

QGraphicsItem *QGraphicsView::itemAt(int x, int y) const

이 기능은 과부하가 걸린 기능입니다.

이 함수는 편의를 위해 제공됩니다. itemAt(QPoint(x, y))을 호출하는 것과 동일합니다.

QList<QGraphicsItem *> QGraphicsView::items() const

연결된 장면의 모든 항목 목록을 내림차순으로 반환합니다(즉, 반환된 목록의 첫 번째 항목이 맨 위에 있는 항목).

QGraphicsScene::items() 및 Sorting 을참조하세요 .

QList<QGraphicsItem *> QGraphicsView::items(const QPoint &pos) const

뷰에서 pos 위치에 있는 모든 항목의 목록을 반환합니다. 항목은 내림차순으로 나열됩니다(즉, 목록의 첫 번째 항목이 가장 위쪽 항목이고 마지막 항목이 가장 아래쪽 항목입니다). pos 은 뷰포트 좌표입니다.

이 함수는 QGraphicsView 의 서브클래스에 있는 마우스 이벤트 핸들러 내에서 가장 일반적으로 호출됩니다. pos 은 QMouseEvent::pos()와 마찬가지로 변환되지 않은 뷰포트 좌표로 되어 있습니다.

void CustomView::mousePressEvent(QMouseEvent *event){
    qDebug() << "There are" << items(event->pos()).size()
            << "items at position"<< mapToScene(event->pos()); }

QGraphicsScene::items() 및 Sorting 을참조하세요 .

QList<QGraphicsItem *> QGraphicsView::items(int x, int y) const

이 함수는 편의를 위해 제공됩니다. item(QPoint(x, y))을 호출하는 것과 같습니다.

QList<QGraphicsItem *> QGraphicsView::items(int x, int y, int w, int h, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

이 편의 함수는 item(QRectF(x, y, w, h), mode)을 호출하는 것과 동일합니다.

QList<QGraphicsItem *> QGraphicsView::items(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

이 함수는 오버로드된 함수입니다.

mode 에 따라 path 에 포함되거나 과 교차하는 모든 항목의 목록을 반환합니다. path 은 뷰포트 좌표입니다.

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

itemAt(), items(), mapToScene() 및 Sorting도 참조하십시오 .

QList<QGraphicsItem *> QGraphicsView::items(const QPolygon &polygon, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

이 함수는 오버로드된 함수입니다.

mode 에 따라 polygon 에 포함되거나 과 교차하는 모든 항목의 목록을 반환합니다. polygon 은 뷰포트 좌표입니다.

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

항목은 내림차순으로 정렬됩니다(즉, 반환된 목록의 첫 번째 항목이 가장 위쪽 항목이 됩니다).

itemAt(), items(), mapToScene() 및 Sorting 를참조하세요 .

QList<QGraphicsItem *> QGraphicsView::items(const QRect &rect, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

이 함수는 오버로드된 함수입니다.

mode 에 따라 rect 에 포함되거나 과 교차하는 모든 항목의 목록을 반환합니다. rect 은 뷰포트 좌표입니다.

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

항목은 내림차순으로 정렬됩니다(즉, 반환된 목록의 첫 번째 항목이 가장 위쪽 항목이 됩니다).

itemAt(), items(), mapToScene() 및 Sorting 를참조하세요 .

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

다시 구현합니다: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

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

다시 구현합니다: QWidget::keyReleaseEvent(QKeyEvent * 이벤트).

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

장면 좌표 페인터 경로 path 를 뷰포트 좌표 페인터 경로로 반환합니다.

mapToScene()도 참조하십시오 .

QPoint QGraphicsView::mapFromScene(const QPointF &point) const

장면 좌표 point 를 뷰포트 좌표로 반환합니다.

mapToScene()도 참조하세요 .

QPolygon QGraphicsView::mapFromScene(const QPolygonF &polygon) const

씬 좌표 다각형 polygon 을 뷰포트 좌표 다각형으로 반환합니다.

mapToScene()도 참조하십시오 .

QPolygon QGraphicsView::mapFromScene(const QRectF &rect) const

씬 사각형 rect 을 뷰포트 좌표 다각형으로 반환합니다.

mapToScene()도 참조하십시오 .

QPoint QGraphicsView::mapFromScene(qreal x, qreal y) const

이 함수는 편의를 위해 제공됩니다. mapFromScene(QPointF(x, y))을 호출하는 것과 동일합니다.

QPolygon QGraphicsView::mapFromScene(qreal x, qreal y, qreal w, qreal h) const

이 함수는 편의를 위해 제공됩니다. mapFromScene(QRectF(x, y, w, h))을 호출하는 것과 동일합니다.

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

장면 좌표 페인터 경로에 매핑된 뷰포트 페인터 경로 path 를 반환합니다.

mapFromScene()도 참조하십시오 .

QPointF QGraphicsView::mapToScene(const QPoint &point) const

장면 좌표에 매핑된 뷰포트 좌표 point 를 반환합니다.

참고: 포인트 자체 대신 point 에서 해당 픽셀이 포함된 전체 직사각형을 매핑하는 것이 유용할 수 있습니다. 이렇게 하려면 mapToScene(QRect(point, QSize(2, 2)))을 호출하면 됩니다.

mapFromScene()도 참조하세요 .

QPolygonF QGraphicsView::mapToScene(const QPolygon &polygon) const

장면 좌표 다각형에 매핑된 뷰포트 다각형 polygon 을 반환합니다.

mapFromScene()도 참조하십시오 .

QPolygonF QGraphicsView::mapToScene(const QRect &rect) const

장면 좌표 다각형에 매핑된 뷰포트 사각형 rect 을 반환합니다.

mapFromScene()도 참조하십시오 .

QPointF QGraphicsView::mapToScene(int x, int y) const

이 함수는 편의를 위해 제공됩니다. mapToScene(QPoint(x, y))을 호출하는 것과 동일합니다.

QPolygonF QGraphicsView::mapToScene(int x, int y, int w, int h) const

이 함수는 편의를 위해 제공됩니다. mapToScene(QRect(x, y, w, h))을 호출하는 것과 동일합니다.

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

다시 구현합니다: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

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

다시 구현합니다: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

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

다시 구현합니다: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

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

다시 구현합니다: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

[override virtual protected] void QGraphicsView::paintEvent(QPaintEvent *event)

다시 구현합니다: QAbstractScrollArea::paintEvent(QPaintEvent * 이벤트).

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

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

QGraphicsScene scene;
scene.addItem(...
...

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

QPrinter printer(QPrinter::HighResolution);
printer.setPageSize(QPrinter::A4);
QPainter painter(&printer);

// print, fitting the viewport contents into a full page
view.render(&painter);

// print the upper half of the viewport into the lower.
// half of the page.
QRect viewport = view.viewport()->rect();
view.render(&painter,
            QRectF(0, printer.height() / 2,
                   printer.width(), printer.height() / 2),
            viewport.adjusted(0, 0, 0, -viewport.height() / 2));

source 이 널 직사각형인 경우 이 함수는 viewport()->rect()를 사용하여 그릴 내용을 결정합니다. target 가 널 직사각형인 경우 painter 의 페인트 장치의 전체 크기(예: QPrinter의 경우 페이지 크기)가 사용됩니다.

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

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

void QGraphicsView::resetCachedContent()

캐시된 콘텐츠를 초기화합니다. 이 함수를 호출하면 QGraphicsView 의 캐시가 지워집니다. 현재 캐시 모드가 CacheNone 인 경우 이 함수는 아무 작업도 수행하지 않습니다.

이 함수는 backgroundBrush 또는 QGraphicsScene::backgroundBrush 속성이 변경되면 자동으로 호출되며, 사용자 정의 배경을 그리기 위해 QGraphicsScene::drawBackground() 또는 QGraphicsView::drawBackground()을 다시 구현하고 전체 다시 그리기를 트리거해야 하는 경우에만 이 함수를 호출하면 됩니다.

cacheMode()도 참조하세요 .

void QGraphicsView::resetTransform()

뷰 변환을 ID 행렬로 재설정합니다.

transform() 및 setTransform()도 참조하세요 .

[override virtual protected] void QGraphicsView::resizeEvent(QResizeEvent *event)

다시 구현합니다: QAbstractScrollArea::resizeEvent(QResizeEvent * 이벤트).

void QGraphicsView::rotate(qreal angle)

현재 보기 변환 angle 을 시계 방향으로 회전합니다.

setTransform(), transform(), scale(), shear() 및 translate()도 참조하세요 .

[signal] void QGraphicsView::rubberBandChanged(QRect rubberBandRect, QPointF fromScenePoint, QPointF toScenePoint)

이 신호는 고무줄 직사각형이 변경될 때 방출됩니다. 뷰포트 직사각형은 rubberBandRect 로 지정됩니다. 드래그 시작 위치와 드래그 끝 위치는 fromScenePoint 및 toScenePoint 로 장면 포인트에 제공됩니다.

고무줄 선택이 끝나면 이 신호는 null 값으로 방출됩니다.

rubberBandRect()도 참조하십시오 .

QRect QGraphicsView::rubberBandRect() const

이 함수는 사용자가 현재 고무줄로 항목 선택을 하고 있는 경우 현재 고무줄 영역(뷰포트 좌표)을 반환합니다. 사용자가 고무줄을 사용하지 않는 경우 이 함수는 (널) QRectF()를 반환합니다.

이 QRect 의 일부는 시각적 뷰포트 외부에 있을 수 있습니다. 예를 들어 음수 값을 포함할 수 있습니다.

rubberBandSelectionMode 및 rubberBandChanged()도 참조하세요 .

void QGraphicsView::scale(qreal sx, qreal sy)

현재 뷰 변환의 배율을 (sx, sy)로 조정합니다.

setTransform(), transform(), rotate(), shear() 및 translate()도 참조하십시오 .

QGraphicsScene *QGraphicsView::scene() const

현재 뷰에 시각화된 장면에 대한 포인터를 반환합니다. 현재 시각화된 장면이 없는 경우 nullptr 이 반환됩니다.

setScene()도 참조하십시오 .

[override virtual protected] void QGraphicsView::scrollContentsBy(int dx, int dy)

재구현합니다: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

void QGraphicsView::setOptimizationFlag(QGraphicsView::OptimizationFlag flag, bool enabled = true)

enabled 이 참이면 flag 을 활성화하고, 그렇지 않으면 flag 을 비활성화합니다.

optimizationFlags도 참조하세요 .

void QGraphicsView::setRenderHint(QPainter::RenderHint hint, bool enabled = true)

enabled 이 참이면 렌더링 힌트 hint 가 활성화되고, 그렇지 않으면 비활성화됩니다.

renderHints 를참조하세요 .

void QGraphicsView::setScene(QGraphicsScene *scene)

현재 장면을 scene 으로 설정합니다. scene 을 이미 보고 있는 경우 이 함수는 아무 작업도 수행하지 않습니다.

뷰에 장면이 설정되면 QGraphicsScene::changed() 신호가 이 뷰의 updateScene() 슬롯에 자동으로 연결되고 뷰의 스크롤 막대가 장면의 크기에 맞게 조정됩니다.

뷰는 scene 의 소유권을 갖지 않습니다.

scene()도 참조하십시오 .

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

뷰의 현재 변환 행렬을 matrix 로 설정합니다.

combine 이 참이면 matrix 이 현재 행렬과 결합되고, 그렇지 않으면 matrix 이 현재 행렬을 대체합니다. combine 은 기본적으로 거짓입니다.

변환 행렬은 장면을 뷰 좌표로 변환합니다. 동일성 행렬에서 제공하는 기본 변환을 사용하면 뷰의 픽셀 하나가 장면의 한 단위를 나타냅니다(예: 뷰에서 10x10 직사각형 항목은 10x10 픽셀을 사용하여 그려집니다). 2x2 배율 행렬을 적용하면 장면이 1:2로 그려집니다(예: 10x10 직사각형 항목은 뷰에서 20x20 픽셀을 사용하여 그려집니다).

예제:

QGraphicsScene scene;
scene.addText("GraphicsView rotated clockwise");

QGraphicsView view(&scene);
view.rotate(90); // the text is rendered with a 90 degree clockwise rotation
view.show();

변형된 뷰를 사용하여 항목과의 상호 작용을 단순화하기 위해 QGraphicsView 에서는 장면과 뷰 좌표 간에 변환할 수 있는 mapTo... 및 mapFrom... 함수를 제공합니다. 예를 들어 mapToScene()를 호출하여 뷰 좌표를 부동 소수점 장면 좌표로 매핑하거나 mapFromScene()를 호출하여 부동 소수점 장면 좌표에서 뷰 좌표로 매핑할 수 있습니다.

transform(), resetTransform(), rotate(), scale(), shear() 및 translate()도 참조하십시오 .

[override virtual protected slot] void QGraphicsView::setupViewport(QWidget *widget)

다시 구현합니다: QAbstractScrollArea::setupViewport(QWidget *뷰포트).

이 슬롯은 setViewport()이 호출된 후 QAbstractScrollArea 에 의해 호출됩니다. 이 함수를 QGraphicsView 의 서브클래스에서 다시 구현하여 새 뷰포트 widget 를 사용하기 전에 초기화하세요.

setViewport()도 참조하세요 .

void QGraphicsView::shear(qreal sh, qreal sv)

현재 뷰 변환을 (sh, sv).

setTransform(), transform(), rotate(), scale() 및 translate()도 참조하십시오 .

[override virtual protected] void QGraphicsView::showEvent(QShowEvent *event)

다시 구현합니다: QWidget::showEvent(QShowEvent * 이벤트).

[override virtual] QSize QGraphicsView::sizeHint() const

재구현합니다: QAbstractScrollArea::sizeHint() const.

QTransform QGraphicsView::transform() const

뷰의 현재 변환 행렬을 반환합니다. 현재 변환이 설정되어 있지 않으면 ID 행렬이 반환됩니다.

setTransform(), rotate(), scale(), shear() 및 translate()도 참조하십시오 .

void QGraphicsView::translate(qreal dx, qreal dy)

현재 뷰 변환을 (dx, dy)로 변환합니다.

setTransform(), transform(), rotate() 및 shear()도 참조하세요 .

[slot] void QGraphicsView::updateScene(const QList<QRectF> &rects)

씬 사각형의 업데이트를 예약합니다 rects.

QGraphicsScene::changed()도 참조하세요 .

[slot] void QGraphicsView::updateSceneRect(const QRectF &rect)

QGraphicsView 에 씬의 씬 렉트가 변경되었음을 알립니다. rect 은 새 씬 렉트입니다. 뷰에 이미 명시적으로 설정된 장면 rect가 있는 경우 이 함수는 아무 작업도 수행하지 않습니다.

sceneRect 및 QGraphicsScene::sceneRectChanged()도 참조하십시오 .

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

다시 구현합니다: QAbstractScrollArea::viewportEvent(QEvent * 이벤트).

QTransform QGraphicsView::viewportTransform() const

장면 좌표를 뷰포트 좌표에 매핑하는 행렬을 반환합니다.

mapToScene() 및 mapFromScene()도 참조하십시오 .

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

다시 구현합니다: QAbstractScrollArea::wheelEvent(QWheelEvent *e).