QGraphicsView Class

멤버 함수 문서

QGraphicsView::QGraphicsView(QWidget *parent = nullptr)

QGraphicsView를 생성합니다. ` parent `는 ` QWidget`의 생성자에 전달됩니다.

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

QGraphicsView를 생성하고, 시각화될 장면을 ` 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)

이 함수는 편의상 제공되는 것입니다. 이는 centerOn(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 *event)를 재구현합니다.

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

QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)를 재구현합니다.

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

QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)을 재구현합니다.

[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 *event)를 재구현합니다.

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 *event)를 재구현합니다.

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)

item 가 뷰 내부에 꼭 맞게 배치되도록 보장하며, aspectRatioMode 에 따라 뷰의 크기를 조정합니다.

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 *event)를 재구현합니다.

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

QWidget::focusNextPrevChild(bool next)를 재구현합니다.

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

QWidget::focusOutEvent(QFocusEvent *event)을 재구현합니다.

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

QWidget::inputMethodEvent(QInputMethodEvent *event)를 재구현합니다.

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

QWidget::inputMethodQuery(const Qt::InputMethodQuery query)를 재구현합니다.

[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::position()과 마찬가지로 변환되지 않은 뷰포트 좌표계로 표시됩니다.

void CustomView::mousePressEvent(QMouseEvent*event)
{
    qDebug() << "There are" << items(event->pos()).size()
            << "위치에 있는 아이템" << mapToScene(event->pos());
}

QGraphicsScene::items() 및 Sorting도 참조하십시오 .

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

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

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

이 편의 함수는 items(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 *event)를 재구현합니다.

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(QRectpoint , 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 *event)를 재구현합니다.

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(someItem);
//...

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

QPrinter printer(QPrinter::HighResolution);
printer.setDocName("Example");
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 가 null rect인 경우, 이 함수는 viewport()->rect()를 사용하여 그릴 내용을 결정합니다. target 가 null rect인 경우, painter 의 페인트 장치 전체 크기(예: QPrinter의 경우 페이지 크기)가 사용됩니다.

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

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

void QGraphicsView::resetCachedContent()

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

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

cacheMode()도 참조하십시오 .

void QGraphicsView::resetTransform()

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

transform() 및 setTransform()도 참조하십시오 .

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

QAbstractScrollArea::resizeEvent(QResizeEvent *event)을 재구현합니다.

void QGraphicsView::rotate(qreal angle)

현재 뷰 변환을 시계 방향으로 angle 도 회전시킵니다.

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

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

이 신호는 고무줄 사각형(rect)이 변경될 때 발생합니다. 뷰포트 사각형은 ` rubberBandRect`로 지정됩니다. 드래그 시작 위치와 드래그 종료 위치는 ` fromScenePoint ` 및 ` toScenePoint`를 통해 씬 좌표로 제공됩니다.

고무줄 선택이 종료되면 이 신호는 null 값과 함께 발송됩니다.

rubberBandRect()도 참조하십시오 .

QRect QGraphicsView::rubberBandRect() const

이 함수는 사용자가 현재 러버 밴드를 사용하여 항목을 선택 중인 경우, 현재 러버 밴드 영역(뷰포트 좌표 기준)을 반환합니다. 사용자가 러버 밴드를 사용하지 않을 때는 이 함수가 (null인) 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 가 true인 경우 flag 를 활성화하고, 그렇지 않은 경우 flag 를 비활성화합니다.

optimizationFlags도 참조하십시오 .

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

enabled 가 true인 경우, 렌더링 힌트 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 가 true인 경우, matrix 가 현재 행렬과 결합되며, 그렇지 않은 경우 matrix 가 현재 행렬을 대체합니다. combine 는 기본적으로 false입니다.

변환 행렬은 씬을 뷰 좌표계로 변환합니다. 단위 행렬이 제공하는 기본 변환을 사용하면, 뷰의 1픽셀은 씬의 1단위를 나타냅니다(예: 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 *viewport)를 재구현합니다.

이 슬롯은 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 *event)를 재구현합니다.

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

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

QTransform QGraphicsView::transform() const

뷰에 대한 현재 변환 행렬을 반환합니다. 현재 변환이 설정되어 있지 않으면 단위 행렬이 반환됩니다.

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 는 새로운 장면 사각형입니다. 뷰에 이미 명시적으로 설정된 장면 사각형이 있는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

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

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

QAbstractScrollArea::viewportEvent(QEvent *event)를 재구현합니다.

QTransform QGraphicsView::viewportTransform() const

씬 좌표를 뷰포트 좌표로 매핑하는 행렬을 반환합니다.

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

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

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