QFocusFrame Class
QFocusFrame 위젯은 위젯의 일반적인 페인트 가능 영역 바깥쪽에 위치할 수 있는 포커스 프레임을 제공합니다. 더 보기...
| 헤더: | #include <QFocusFrame> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QWidget |
공개 함수
| QFocusFrame(QWidget *parent = nullptr) | |
| virtual | ~QFocusFrame() |
| void | setWidget(QWidget *widget) |
| QWidget * | widget() const |
보호된 함수
| virtual void | initStyleOption(QStyleOption *option) const |
재구현된 보호 함수
| virtual bool | event(QEvent *e) override |
| virtual bool | eventFilter(QObject *o, QEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
상세 설명
일반적으로 애플리케이션은 자체 QFocusFrame을 생성할 필요가 없는데, 이는 ` QStyle `가 이 세부 사항을 대신 처리해 주기 때문입니다. 스타일 작성자는 선택적으로 QFocusFrame을 사용하여 위젯의 페인트 가능한 기하 구조 외부에 포커스 영역을 둘 수 있습니다. 이렇게 하면 위젯이 포커스를 갖기 위해 공간을 예약할 필요가 없으며, QFocusFrame::setWidget 를 사용하여 QWidget 에 포커스 영역을 설정하기만 하면 됩니다. 그러나 사용자 정의 위젯에서 자체 QFocusFrame을 생성하고 QWidget::setGeometry 를 통해 지오메트리를 수동으로 설정하는 것도 허용되지만, 포커스가 있는 위젯의 크기나 위치가 변경될 때 자동 배치 기능은 작동하지 않습니다.
멤버 함수 문서
QFocusFrame::QFocusFrame(QWidget *parent = nullptr)
QFocusFrame을 생성합니다.
이 포커스 프레임은 ` parent `의 업데이트를 감시하지 않으며, 수동으로 배치하거나 ` QFocusFrame::setWidget`을 사용하여 배치할 수 있습니다. QFocusFrame은 ` Qt::WA_NoChildEventsForParent ` 속성을 설정하므로, 결과적으로 부모 위젯은 ` QEvent::ChildAdded ` 이벤트를 수신하지 않게 됩니다. 이를 통해 ` QSplitter `이나 기타 자식 이벤트 감시 위젯 내부에서 QFocusFrame의 기하학적 크기를 수동으로 설정할 수 있습니다.
QFocusFrame::setWidget()도 참조하십시오 .
[virtual noexcept] QFocusFrame::~QFocusFrame()
소멸자.
[override virtual protected] bool QFocusFrame::event(QEvent *e)
QWidget::event(QEvent *event)를 재구현합니다.
[override virtual protected] bool QFocusFrame::eventFilter(QObject *o, QEvent *e)
QObject::eventFilter(QObject *watched, QEvent *event)를 재구현합니다.
[virtual protected] void QFocusFrame::initStyleOption(QStyleOption *option) const
option 를 QFocusFrame 에 있는 값들로 초기화합니다. 이 메서드는 하위 클래스에서 QStyleOption 가 필요하지만, 모든 정보를 직접 입력하고 싶지 않을 때 유용합니다.
QStyleOption::initFrom()도 참조하십시오 .
[override virtual protected] void QFocusFrame::paintEvent(QPaintEvent *)
QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.
void QFocusFrame::setWidget(QWidget *widget)
QFocusFrame widget 의 변경 사항을 추적하여 크기를 자동으로 조정합니다. 모니터링 대상 위젯의 부모가 변경되면, 는 해당 위젯을 따라가며 자동으로 위젯 주위에 배치됩니다. 모니터링 대상 위젯이 삭제되면, 는 해당 값을 0으로 설정합니다. QFocusFrame QFocusFrame
QFocusFrame::widget()도 참조하십시오 .
QWidget *QFocusFrame::widget() const
자동 크기 조정 및 업데이트를 위해 현재 모니터링 중인 위젯을 반환합니다.
QFocusFrame::setWidget()도 참조하십시오 .
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
