QGraphicsWidget Class

멤버 함수 설명서

QGraphicsWidget::QGraphicsWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())

QGraphicsWidget 인스턴스를 생성합니다. 선택적 매개변수인 ` parent `는 ` QGraphicsItem`의 생성자에 전달됩니다. 선택적 매개변수인 ` wFlags `는 위젯의 창 플래그(예: 위젯을 창, 도구, 팝업 등으로 설정할지 여부)를 지정합니다.

[virtual noexcept] QGraphicsWidget::~QGraphicsWidget()

QGraphicsWidget 인스턴스를 삭제합니다.

QList<QAction *> QGraphicsWidget::actions() const

이 위젯의 액션 목록(비어 있을 수도 있음)을 반환합니다.

insertAction(), removeAction(), QWidget::actions(), QAction::associatedWidgets() 및 QAction::associatedGraphicsWidgets()도 참조하십시오 .

void QGraphicsWidget::addAction(QAction *action)

이 위젯의 액션 목록에 ‘ action ’ 액션을 추가합니다.

모든 QGraphicsWidget은 QAction목록을 가지고 있지만, 이를 그래픽적으로 표현하는 방식은 매우 다양합니다. QAction 목록( actions()이 반환하는 값)의 기본 용도는 컨텍스트 QMenu 를 생성하는 것입니다.

QGraphicsWidget 에는 각 액션이 하나씩만 포함되어야 하며, 이미 존재하는 액션을 추가하더라도 위젯에 동일한 액션이 두 번 포함되지는 않습니다.

removeAction(), insertAction(), actions(), QWidget::addAction()도 참조하십시오 .

void QGraphicsWidget::addActions(const QList<QAction *> &actions)

actions 액션을 이 위젯의 액션 목록에 추가합니다.

removeAction(), QMenu, addAction() 및 QWidget::addActions()도 참조하십시오 .

void QGraphicsWidget::adjustSize()

위젯의 크기를 실제 선호 크기 힌트에 맞게 조정합니다.

이 함수는 항목이 처음 표시될 때 암시적으로 호출됩니다.

effectiveSizeHint() 및 Qt::MinimumSize도 참조하십시오 .

[override virtual] QRectF QGraphicsWidget::boundingRect() const

QGraphicsItem::boundingRect() const를 재구현합니다.

[virtual protected] void QGraphicsWidget::changeEvent(QEvent *event)

이 이벤트 핸들러는 상태 변경을 처리하도록 재구현할 수 있습니다.

이 이벤트에서 변경되는 상태는 event 를 통해 가져올 수 있습니다.

변경 이벤트에는 QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::ParentChange, QEvent::LayoutDirectionChange 및 QEvent::ContentsRectChange 가 포함됩니다.

[slot] bool QGraphicsWidget::close()

위젯을 닫으려면 이 함수를 호출하십시오.

위젯이 닫힌 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다. 이 슬롯은 먼저 위젯에 ` QCloseEvent `을 전송하며, 위젯은 이 이벤트를 수락할 수도 있고 수락하지 않을 수도 있습니다. 이벤트가 무시된 경우 아무런 동작도 발생하지 않습니다. 이벤트가 수락된 경우, 위젯에 ` hide()`을 호출합니다.

위젯에 Qt::WA_DeleteOnClose 속성이 설정되어 있으면 위젯이 삭제됩니다.

[virtual protected] void QGraphicsWidget::closeEvent(QCloseEvent *event)

event 에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 위젯 닫기 이벤트를 수신할 수 있습니다. 기본 구현은 해당 이벤트를 수락합니다.

close() 및 QCloseEvent도 참조하십시오 .

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

QGraphicsObject::event(QEvent *ev)를 재구현합니다.

event 를 처리합니다. ` QGraphicsWidget `는 다음 이벤트를 처리합니다:

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

QGraphicsItem::focusInEvent(QFocusEvent *event)를 재구현합니다.

[virtual protected] bool QGraphicsWidget::focusNextPrevChild(bool next)

Tab 및 Shift+Tab에 적합하도록 키보드 포커스를 전달할 새로운 위젯을 찾으며, 새로운 위젯을 찾을 수 있으면 ` true `를 반환하고, 그렇지 않으면 ` false `를 반환합니다. ` next `가 참이면 이 함수는 앞으로 검색하고, ` next `가 거짓이면 뒤로 검색합니다.

때로는 위젯과 그 하위 위젯에 대한 특수한 포커스 처리를 제공하기 위해 이 함수를 재구현하고 싶을 수 있습니다. 예를 들어, 웹 브라우저는 현재 활성화된 링크를 앞뒤로 이동하도록 이 함수를 재구현하고, 페이지의 마지막 또는 첫 번째 링크에 도달했을 때만 기본 구현을 호출할 수 있습니다.

자식 위젯은 부모 위젯에 대해 focusNextPrevChild()를 호출하지만, 포커스를 어디로 이동시킬지는 자식 위젯을 포함하는 창만이 결정합니다. 객체에 대해 이 함수를 재구현하면 모든 자식 위젯의 포커스 이동 경로를 제어할 수 있습니다.

focusPolicy()도 참조하십시오 .

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

QGraphicsItem::focusOutEvent(QFocusEvent *event)를 재구현합니다.

QGraphicsWidget *QGraphicsWidget::focusWidget() const

이 위젯이나 이 위젯의 자식 또는 하위 위젯 중 현재 입력 포커스를 가지고 있는 것이 있다면, 이 함수는 해당 위젯에 대한 포인터를 반환합니다. 입력 포커스를 가진 하위 위젯이 없는 경우, ` nullptr `가 반환됩니다.

QGraphicsItem::focusItem() 및 QWidget::focusWidget()도 참조하십시오 .

[signal] void QGraphicsWidget::geometryChanged()

setGeometry()에서 지오메트리가 변경될 때마다 이 신호가 발생합니다.

[override virtual] void QGraphicsWidget::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const를 재구현합니다.

위젯의 내용 여백을 가져옵니다. 여백은 left, top, right 및 bottom 에 qreal 포인터로 저장됩니다. nullptr 를 전달하면 각 인수를 생략할 수 있습니다.

setContentsMargins()도 참조하십시오 .

void QGraphicsWidget::getWindowFrameMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

위젯의 창 테두리 여백을 가져옵니다. 여백 값은 left, top, right 및 bottom 에 qreal 형 포인터로 저장됩니다. nullptr 를 전달하면 각 인수를 생략할 수 있습니다.

setWindowFrameMargins() 및 windowFrameRect()도 참조하십시오 .

[virtual protected] void QGraphicsWidget::grabKeyboardEvent(QEvent *event)

event 에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 QEvent::GrabKeyboard 이벤트에 대한 알림을 수신할 수 있습니다.

grabKeyboard() 및 grabMouse()도 참조하십시오 .

[virtual protected] void QGraphicsWidget::grabMouseEvent(QEvent *event)

event 에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 QEvent::GrabMouse 이벤트에 대한 알림을 수신할 수 있습니다.

grabMouse() 및 grabKeyboard()도 참조하십시오 .

int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context = Qt::WindowShortcut)

지정된 키 sequence 가 지정된 영역 context 에서 입력되는지 감시하는 단축키를 Qt의 단축키 시스템에 추가합니다. context 가 Qt::ApplicationShortcut 인 경우, 이 단축키는 애플리케이션 전체에 적용됩니다. 그렇지 않은 경우, 이 위젯 Qt::WidgetShortcut 에만 국한되거나 창 자체 Qt::WindowShortcut 에만 국한됩니다. 창에 속하지 않는 위젯(즉, 최상위 위젯과 그 자식 위젯)의 경우 Qt::WindowShortcut, 단축키는 씬에 적용됩니다.

동일한 키 sequence 가 여러 위젯에 의해 잡혀 있는 경우, 해당 키 sequence 가 발생하면 QEvent::Shortcut 이벤트가 적용되는 모든 위젯으로 비결정적인 순서대로 전송되지만, ``ambiguous'' 플래그는 true로 설정됩니다.

releaseShortcut(), setShortcutEnabled() 및 QWidget::grabShortcut()도 참조하십시오 .

[virtual protected] void QGraphicsWidget::hideEvent(QHideEvent *event)

Hide 이벤트에 대한 이 이벤트 핸들러는 위젯이 숨겨진 후, 예를 들어 위젯이 이전에 표시되어 있던 상태에서 해당 위젯이나 그 상위 요소 중 하나에 대해 setVisible(false)가 호출된 후에 전달됩니다.

이 이벤트 핸들러를 재구현하여 위젯이 숨겨지는 시점을 감지할 수 있습니다. event 에서 QEvent::accept() 또는 QEvent::ignore()를 호출해도 아무런 효과가 없습니다.

showEvent(), QWidget::hideEvent() 및 ItemVisibleChange도 참조하십시오 .

[override virtual protected] void QGraphicsWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)

QGraphicsItem::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)를 재구현합니다.

[override virtual protected] void QGraphicsWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event)

QGraphicsItem::hoverMoveEvent(QGraphicsSceneHoverEvent *event)를 재구현합니다.

[virtual protected] void QGraphicsWidget::initStyleOption(QStyleOption *option) const

이 위젯의 현재 상태를 기반으로 스타일 옵션 객체를 채우고, 그 결과를 ` option`에 저장합니다. 기본 구현에서는 ` option `에 다음 속성들을 채웁니다.

QGraphicsWidget 의 서브클래스는 기본 구현을 호출한 다음, qstyleoption_cast<>()를 사용하여 option 의 유형을 테스트하거나, 위젯별 옵션을 저장하기 전에 QStyleOption::Type 를 테스트해야 합니다.

예를 들어:

void MyGroupBoxWidget::initStyleOption(QStyleOption *option) const
{
    QGraphicsWidget::initStyleOption(option);
    if (QStyleOptionGroupBox *box = qstyleoption_cast<QStyleOptionGroupBox *>(option)) {
        // Add group box specific state.
        box->text = tr("My Group Box");
        //...
    }
}

QStyleOption::initFrom()도 참조하십시오 .

void QGraphicsWidget::insertAction(QAction *before, QAction *action)

이 위젯의 액션 목록에 ‘ action ’ 액션을 ‘ before ’ 액션 바로 앞에 삽입합니다. ‘ before ’이 ‘ nullptr ’인 경우, 또는 ‘ before ’가 이 위젯에 대해 유효한 액션이 아닌 경우, 해당 액션을 목록 끝에 추가합니다.

QGraphicsWidget 에는 각 액션이 하나씩만 포함되어야 합니다.

removeAction(), addAction(), QMenu, actions(), QWidget::insertActions()도 참조하십시오 .

void QGraphicsWidget::insertActions(QAction *before, const QList<QAction *> &actions)

이 위젯의 동작 목록에 ‘ actions ’ 동작을 ‘ before ’ 동작 앞에 삽입합니다. ‘ before ’이 ‘ nullptr ’인 경우, 또는 ‘ before ’이 이 위젯에 대해 유효한 동작이 아닌 경우, 해당 동작을 목록 끝에 추가합니다.

QGraphicsWidget 에는 각 액션이 최대 하나씩만 포함될 수 있습니다.

removeAction(), QMenu, insertAction(), QWidget::insertActions()도 참조하십시오 .

bool QGraphicsWidget::isActiveWindow() const

이 위젯의 창이 활성 창에 있거나, 위젯에 창이 없지만 활성 씬(즉, 현재 포커스가 있는 씬)에 있는 경우 ` true `를 반환합니다.

활성 창이란 현재 입력 포커스를 가지고 있는 자식 위젯을 포함하고 있거나, 그 자체로 입력 포커스를 가지고 있는 창을 말합니다.

QGraphicsScene::activeWindow(), QGraphicsScene::setActiveWindow(), isActive()도 참조하십시오 .

[override virtual protected] QVariant QGraphicsWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)

QGraphicsItem::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)를 재구현합니다.

QGraphicsWidget 이 함수의 기본 구현을 사용하여 항목의 상태 변경과 관련된 이벤트를 포착하고 전달합니다. 이 때문에 하위 클래스에서는 반드시 기본 구현을 호출해야 합니다.

change 는 변경 유형을 지정하며, value 는 새로운 값입니다.

예를 들어, QGraphicsWidget 는 ItemVisibleChange를 사용하여 Show 및 Hide 이벤트를 전달하고, ItemPositionHasChanged를 사용하여 Move 이벤트를 전달하며, ItemParentChange를 사용하여 ParentChange 이벤트를 전달하고 포커스 체인을 관리합니다.

QGraphicsWidget 위치 변경 사항을 추적하기 위해 기본적으로 ItemSendsGeometryChanges 플래그를 활성화합니다.

QGraphicsItem::itemChange()도 참조하십시오 .

QGraphicsLayout *QGraphicsWidget::layout() const

이 위젯의 레이아웃을 반환하거나, 현재 이 위젯을 관리하는 레이아웃이 없는 경우 ` nullptr `를 반환합니다.

참조 : `setLayout()`도 참조하십시오 .

[virtual protected] void QGraphicsWidget::moveEvent(QGraphicsSceneMoveEvent *event)

GraphicsSceneMove 이벤트에 대한 이 이벤트 핸들러는 위젯이 이동한 후(예: 로컬 위치가 변경된 후) 전달됩니다.

이 이벤트는 항목이 로컬로 이동한 경우에만 전달됩니다. ` setTransform()`를 호출하거나 항목의 상위 요소 중 하나를 이동하는 것은 항목의 로컬 위치에 영향을 미치지 않습니다.

위젯이 이동한 시점을 감지하려면 이 이벤트 핸들러를 재구현할 수 있습니다. event 에서 QEvent::accept() 또는 QEvent::ignore()를 호출해도 아무런 효과가 없습니다.

ItemPositionChange 및 ItemPositionHasChanged도 참조하십시오 .

[override virtual] void QGraphicsWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)를 재구현합니다.

[virtual] void QGraphicsWidget::paintWindowFrame(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

이 가상 함수는 ` QGraphicsScene `에 의해 호출되어, ` painter`, ` option` 및 ` widget`을 사용하여 로컬 좌표계에서 창의 테두리를 그립니다. 기본 구현은 현재 스타일을 사용하여 테두리와 제목 표시줄을 렌더링합니다.

QGraphicsWidget 의 서브클래스에서 이 함수를 재구현하여 위젯의 창 테두리를 사용자 정의 방식으로 렌더링할 수 있습니다.

QGraphicsItem::paint()도 참조하십시오 .

[virtual protected] void QGraphicsWidget::polishEvent()

이 이벤트는 아이템이 생성된 후, 하지만 장면을 통해 표시되거나 다른 방식으로 접근되기 전의 어느 시점에 장면에 의해 아이템에 전달됩니다. 이 이벤트 핸들러를 사용하면 아이템이 완전히 생성되어야 하는 위젯의 마지막 순간 초기화 작업을 수행할 수 있습니다.

기본 구현은 아무 작업도 수행하지 않습니다.

QRectF QGraphicsWidget::rect() const

항목의 로컬 직사각형을 ` QRectF` 형식으로 반환합니다. 이 함수는 ` QRectF` (`QPointF()`), ` size()`와 동일합니다.

setGeometry() 및 resize()도 참조하십시오 .

void QGraphicsWidget::releaseShortcut(int id)

지정된 키 조합( id )을 가진 단축키를 Qt의 단축키 시스템에서 제거합니다. 이 위젯은 더 이상 해당 단축키의 키 조합에 대한 키 입력 이벤트( QEvent::Shortcut )를 수신하지 않게 됩니다(동일한 키 조합을 가진 다른 단축키가 있는 경우는 제외).

grabShortcut(), setShortcutEnabled(), QWidget::releaseShortcut()도 참조하십시오 .

void QGraphicsWidget::removeAction(QAction *action)

이 위젯의 작업 목록에서 “ action ” 작업을 제거합니다.

insertAction(), actions(), QWidget::removeAction()도 참조하십시오 .

void QGraphicsWidget::resize(qreal w, qreal h)

지정된 width (w) 및 height (h)을 사용하여 resize 객체를 생성합니다. 이 편의 함수는 resize(QSizeF(w, h))를 호출하는 것과 동일합니다.

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

[virtual protected] void QGraphicsWidget::resizeEvent(QGraphicsSceneResizeEvent *event)

GraphicsSceneResize 이벤트에 대한 이 이벤트 핸들러는 위젯의 크기가 조정된 후(즉, 위젯의 로컬 크기가 변경된 후) 호출됩니다. ` event `에는 이전 크기와 새로운 크기가 모두 포함됩니다.

이 이벤트는 위젯의 로컬 크기가 변경되었을 때만 전달됩니다. 위젯이나 그 상위 요소, 또는 뷰에서 ` setTransform()`를 호출하더라도 위젯의 로컬 크기에 영향을 미치지 않습니다.

위젯의 크기가 조정되었을 때 이를 감지하기 위해 이 이벤트 핸들러를 재구현할 수 있습니다. event 에서 QEvent::accept() 또는 QEvent::ignore()를 호출해도 아무런 효과가 없습니다.

geometry() 및 setGeometry()도 참조하십시오 .

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

QGraphicsItem::sceneEvent(QEvent *event)를 재구현합니다.

QGraphicsWidget의 sceneEvent() 구현은 단순히 event 를 QGraphicsWidget::event()로 전달합니다. event() 또는 편의 함수 중 하나에서 위젯에 대한 모든 이벤트를 처리할 수 있으며, QGraphicsWidget 의 하위 클래스에서 이 함수를 재구현할 필요는 없습니다.

event 가 인식되고 처리된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

QGraphicsItem::sceneEvent()도 참조하십시오 .

void QGraphicsWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)

on 가 true인 경우, 이 함수는 attribute 를 활성화하며, 그렇지 않은 경우 attribute 는 비활성화됩니다.

지원되는 속성의 전체 목록과 각 속성의 용도에 대해서는 QGraphicsWidget 클래스 문서를 참조하십시오.

testAttribute() 및 QWidget::setAttribute()도 참조하십시오 .

void QGraphicsWidget::setContentsMargins(QMarginsF margins)

위젯의 콘텐츠 여백을 ` margins`로 설정합니다.

콘텐츠 여백은 할당된 레이아웃이 하위 위젯과 레이아웃의 위치를 정의하는 데 사용됩니다. 여백은 하위 위젯을 자체 기하 구조의 특정 영역으로만 제한하는 위젯에 특히 유용합니다. 예를 들어, 레이아웃이 적용된 그룹 박스는 하위 위젯을 프레임 내부에 배치하되 제목 바로 아래에 배치합니다.

위젯의 내용 여백을 변경하면 항상 ` update()`가 호출되며, 할당된 레이아웃은 자동으로 활성화됩니다. 그러면 위젯은 ` ContentsRectChange ` 이벤트를 수신합니다.

getContentsMargins() 및 setGeometry()도 참조하십시오 .

void QGraphicsWidget::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

위젯의 내용 여백을 left, top, right 및 bottom 로 설정합니다.

void QGraphicsWidget::setGeometry(qreal x, qreal y, qreal w, qreal h)

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

geometry() 및 resize()도 참조하십시오 .

void QGraphicsWidget::setLayout(QGraphicsLayout *layout)

이 위젯의 레이아웃을 ` layout`로 설정합니다. 새 레이아웃이 할당되기 전에 기존 레이아웃 관리자는 모두 삭제됩니다. ` layout `가 ` nullptr`인 경우, 위젯은 레이아웃이 없는 상태로 남게 됩니다. 기존 하위 위젯의 기하학적 속성은 영향을 받지 않습니다.

현재 layout 또는 그 모든 하위 레이아웃에 의해 관리되고 있는 모든 위젯은 자동으로 이 항목으로 부모가 변경됩니다. 그런 다음 레이아웃이 무효화되고, 자식 위젯의 지오메트리는 이 항목의 geometry() 및 contentsMargins()에 따라 조정됩니다. layout 에 의해 명시적으로 관리되지 않는 자식 위젯은 이 위젯에 레이아웃이 할당된 후에도 영향을 받지 않습니다.

QGraphicsWidget layout 의 소유권을 인수합니다.

layout(), QGraphicsLinearLayout::addItem(), QGraphicsLayout::invalidate()도 참조하십시오 .

void QGraphicsWidget::setShortcutAutoRepeat(int id, bool enabled = true)

enabled 가 true인 경우, 지정된 id 를 사용하는 단축키의 자동 반복이 활성화되며, 그렇지 않은 경우 비활성화됩니다.

grabShortcut(), releaseShortcut(), QWidget::setShortcutAutoRepeat()도 참조하십시오 .

void QGraphicsWidget::setShortcutEnabled(int id, bool enabled = true)

enabled 가 true인 경우, 지정된 id 를 가진 단축키가 활성화되며, 그렇지 않은 경우 단축키는 비활성화됩니다.

grabShortcut(), releaseShortcut(), QWidget::setShortcutEnabled()도 참조하십시오 .

void QGraphicsWidget::setStyle(QStyle *style)

위젯의 스타일을 style 로 설정합니다. QGraphicsWidget 는 style 의 소유권을 가져가지 않습니다.

스타일이 지정되지 않았거나 style 가 nullptr 인 경우, 위젯은 QGraphicsScene::style()을 사용합니다(이 값이 설정된 경우). 그렇지 않은 경우 위젯은 QApplication::style()을 사용합니다.

이 함수는 style 가 nullptr 가 아닐 경우 Qt::WA_SetStyle 속성을 설정하고, 그렇지 않은 경우 해당 속성을 지웁니다.

style()도 참조하십시오 .

[static] void QGraphicsWidget::setTabOrder(QGraphicsWidget *first, QGraphicsWidget *second)

second 위젯을 포커스 위젯 고리 내에서 이동시켜, Tab 키를 누르면 키보드 포커스가 first 위젯에서 second 위젯으로 이동하도록 합니다.

second 위젯의 탭 순서가 변경되므로, 체인을 다음과 같이 구성해야 합니다:

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

다음과 같이 구성해서는안 됩니다:

// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to d

first 가 nullptr 인 경우, 이는 장면이 Tab 포커스를 획득했을 때(즉, 사용자가 Tab 키를 눌러 포커스가 장면으로 넘어왔을 때) second 가 입력 포커스를 가장 먼저 받아야 함을 의미합니다. second 가 nullptr 인 경우, 이는 장면이 BackTab 포커스를 획득했을 때 first 가 가장 먼저 포커스를 받아야 함을 의미합니다.

기본적으로 탭 순서는 위젯 생성 순서를 사용하여 암시적으로 정의됩니다.

‘ focusPolicy ’ 및 ‘위젯의 키보드 포커스’항목도 참조하십시오 .

void QGraphicsWidget::setWindowFrameMargins(QMarginsF margins)

위젯의 창 테두리 여백을 ` margins`로 설정합니다. 기본 테두리 여백은 스타일에 의해 제공되며, 현재 창 플래그에 따라 달라집니다.

사용자 정의 창 장식을 그리려면, 기본 여백을 재정의하기 위해 사용자 정의 프레임 여백을 설정할 수 있습니다.

unsetWindowFrameMargins(), getWindowFrameMargins(), windowFrameRect()도 참조하십시오 .

void QGraphicsWidget::setWindowFrameMargins(qreal left, qreal top, qreal right, qreal bottom)

위젯의 창 테두리 여백을 left, top, right 및 bottom 로 설정합니다.

[override virtual] QPainterPath QGraphicsWidget::shape() const

QGraphicsItem::shape() const를 재구현합니다.

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

Show 이벤트에 대한 이 이벤트 핸들러는 위젯이 표시되기 전에 호출됩니다. 예를 들어, 위젯이 이전에 숨겨져 있던 상태에서 해당 위젯이나 그 상위 요소 중 하나에 대해 setVisible(true)가 호출된 경우입니다.

이 이벤트 핸들러를 재구현하여 위젯이 표시되는 시점을 감지할 수 있습니다. event 에서 QEvent::accept() 또는 QEvent::ignore()를 호출해도 아무런 효과가 없습니다.

hideEvent(), QWidget::showEvent() 및 ItemVisibleChange도 참조하십시오 .

[override virtual protected] QSizeF QGraphicsWidget::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

QGraphicsLayoutItem::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const를 재구현합니다.

QStyle *QGraphicsWidget::style() const

위젯의 스타일에 대한 포인터를 반환합니다. 이 위젯에 명시적으로 할당된 스타일이 없는 경우, 대신 씬의 스타일이 반환됩니다. 마찬가지로, 씬에 할당된 스타일이 없는 경우, 이 함수는 ` QApplication::style()`를 반환합니다.

setStyle()도 참조하십시오 .

bool QGraphicsWidget::testAttribute(Qt::WidgetAttribute attribute) const

이 위젯에 대해 ` attribute `가 활성화되어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

setAttribute()도 참조하십시오 .

[override virtual] int QGraphicsWidget::type() const

QGraphicsItem::type() const를 재구현합니다.

[virtual protected] void QGraphicsWidget::ungrabKeyboardEvent(QEvent *event)

event 에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 QEvent::UngrabKeyboard 이벤트에 대한 알림을 수신할 수 있습니다.

ungrabKeyboard() 및 ungrabMouse()도 참조하십시오 .

[virtual protected] void QGraphicsWidget::ungrabMouseEvent(QEvent *event)

event 에 대한 이 이벤트 핸들러는 하위 클래스에서 재구현하여 QEvent::UngrabMouse 이벤트에 대한 알림을 수신할 수 있습니다.

ungrabMouse() 및 ungrabKeyboard()도 참조하십시오 .

void QGraphicsWidget::unsetWindowFrameMargins()

창 프레임 여백을 스타일에서 제공하는 기본값으로 재설정합니다.

setWindowFrameMargins(), getWindowFrameMargins() 및 windowFrameRect()도 참조하십시오 .

[override virtual protected] void QGraphicsWidget::updateGeometry()

QGraphicsLayoutItem::updateGeometry()를 재구현합니다.

이 위젯이 현재 레이아웃에 의해 관리되고 있는 경우, 이 함수는 레이아웃에 위젯의 크기 힌트가 변경되었음을 알리며, 레이아웃은 이에 따라 위젯의 크기를 조정하고 위치를 재설정해야 할 수 있습니다.

위젯의 sizeHint()가 변경된 경우 이 함수를 호출하십시오.

QGraphicsLayout::invalidate()도 참조하십시오 .

[virtual protected] bool QGraphicsWidget::windowFrameEvent(QEvent *event)

event 에 대한 이 이벤트 핸들러는, 해당 위젯이 창인 경우 창 프레임에 대한 이벤트를 수신합니다. 기본 구현은 이동, 크기 조정 등과 같은 기본 창 프레임 상호작용을 지원합니다.

QGraphicsWidget 의 서브클래스에서 이 핸들러를 재구현하여 사용자 정의 창 프레임 상호작용 기능을 제공할 수 있습니다.

event 가 인식되어 처리된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

event()도 참조하십시오 .

QRectF QGraphicsWidget::windowFrameGeometry() const

위젯의 기하 정보를 창 테두리를 포함하여 부모 좌표계로 반환합니다.

windowFrameRect(), getWindowFrameMargins(), setWindowFrameMargins()도 참조하십시오 .

QRectF QGraphicsWidget::windowFrameRect() const

위젯의 로컬 직사각형 영역(창 테두리 포함)을 반환합니다.

windowFrameGeometry(), getWindowFrameMargins() 및 setWindowFrameMargins()도 참조하십시오 .

[virtual protected] Qt::WindowFrameSection QGraphicsWidget::windowFrameSectionAt(const QPointF &pos) const

pos 위치에 있는 창 테두리 부분을 반환하며, 해당 위치에 창 테두리 부분이 없는 경우 Qt::NoSection 를 반환합니다.

이 함수는 QGraphicsWidget 의 기본 구현에서 창 프레임 상호 작용에 사용됩니다.

창을 상호작용 방식으로 이동하거나 크기를 조정하는 방식을 사용자 정의하려면 이 함수를 재구현할 수 있습니다. 예를 들어, 창 크기를 오른쪽 하단 모서리를 통해서만 조정할 수 있도록 하려면, Qt::BottomRightSection 을 제외한 모든 섹션에 대해 Qt::NoSection 을 반환하도록 이 함수를 재구현할 수 있습니다.

windowFrameEvent(), paintWindowFrame() 및 windowFrameGeometry()도 참조하십시오 .

Qt::WindowType QGraphicsWidget::windowType() const

위젯의 창 유형을 반환합니다.

windowFlags(), isWindow(), isPanel()도 참조하십시오 .