QGroupBox Class
QGroupBox 위젯은 제목이 있는 그룹 박스 프레임을 제공합니다. 더 보기...
| 헤더: | #include <QGroupBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QWidget |
속성
공개 함수
| QGroupBox(QWidget *parent = nullptr) | |
| QGroupBox(const QString &title, QWidget *parent = nullptr) | |
| virtual | ~QGroupBox() |
| Qt::Alignment | alignment() const |
| bool | isCheckable() const |
| bool | isChecked() const |
| bool | isFlat() const |
| void | setAlignment(int alignment) |
| void | setCheckable(bool checkable) |
| void | setFlat(bool flat) |
| void | setTitle(const QString &title) |
| QString | title() const |
재구현된 공용 함수
| virtual QSize | minimumSizeHint() const override |
공개 슬롯
| void | setChecked(bool checked) |
신호
보호된 함수
| virtual void | initStyleOption(QStyleOptionGroupBox *option) const |
재구현된 보호 함수
| virtual void | changeEvent(QEvent *ev) override |
| virtual void | childEvent(QChildEvent *c) override |
| virtual bool | event(QEvent *e) override |
| virtual void | focusInEvent(QFocusEvent *fe) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual void | resizeEvent(QResizeEvent *e) override |
상세 설명

그룹 박스는 프레임, 상단의 제목, 키보드 단축키를 제공하며, 그 내부에 다양한 위젯을 표시합니다. 키보드 단축키는 키보드 포커스를 그룹 박스의 자식 위젯 중 하나로 이동시킵니다.
QGroupBox를 사용하면 그룹 박스 레이아웃( title, 일반적으로 생성자에서 설정됨)과 제목의 수직 정렬( alignment)을 설정할 수도 있습니다. 그룹 박스는 수직으로 정렬( checkable)될 수 있습니다. 체크 가능한 그룹 박스 내의 자식 위젯은 그룹 박스가 활성화( checked) 상태인지 여부에 따라 활성화되거나 비활성화됩니다.
flat 속성을 활성화하면 그룹 박스가 차지하는 공간을 최소화할 수 있습니다. 대부분의 styles 에서 이 속성을 활성화하면 프레임의 왼쪽, 오른쪽 및 하단 가장자리가 제거됩니다.
QGroupBox는 자식 위젯(대개 QCheckBox나 QRadioButton이지만 어떤 위젯이든 될 수 있음)의 레이아웃을 자동으로 구성하지 않습니다. 다음 예제는 레이아웃이 적용된 QGroupBox를 설정하는 방법을 보여줍니다:
QGroupBox *groupBox = new QGroupBox(tr("Group Box with Layout"));
QRadioButton *radio1 = new QRadioButton(tr("&Radio button 1"));
QRadioButton *radio2 = new QRadioButton(tr("R&adio button 2"));
QRadioButton *radio3 = new QRadioButton(tr("Ra&dio button 3"));
radio1->setChecked(true);
QVBoxLayout *vbox = new QVBoxLayout;
vbox->addWidget(radio1);
vbox->addWidget(radio2);
vbox->addWidget(radio3);
vbox->addStretch(1);
groupBox->setLayout(vbox);QButtonGroup도 참조하십시오 .
속성 문서
alignment : Qt::Alignment
이 속성은 그룹 박스 제목의 정렬 방식을 지정합니다.
대부분의 스타일은 제목을 프레임 상단에 배치합니다. 제목의 수평 정렬은 다음 목록에 있는 단일 값을 사용하여 지정할 수 있습니다.
- Qt::AlignLeft 제목 텍스트를 그룹 박스의 왼쪽 가장자리에 정렬합니다.
- Qt::AlignRight 제목 텍스트를 그룹 상자의 오른쪽 가장자리에 정렬합니다.
- Qt::AlignHCenter 제목 텍스트를 그룹 박스의 수평 중앙에 정렬합니다.
기본 정렬 방식은 ' Qt::AlignLeft'입니다.
Access 함수:
| Qt::Alignment | alignment() const |
| void | setAlignment(int alignment) |
참조: Qt::Alignment.
checkable : bool
이 속성은 그룹 박스의 제목에 체크박스가 포함되어 있는지 여부를 나타냅니다.
이 속성이 ` true`인 경우, 그룹 박스는 일반 레이블 대신 체크박스를 사용하여 제목을 표시합니다. 체크박스가 선택되어 있으면 그룹 박스의 자식 요소들이 활성화되고, 그렇지 않으면 비활성화되어 접근할 수 없게 됩니다.
기본적으로 그룹 박스는 체크할 수 없습니다.
그룹 상자에 대해 이 속성이 활성화되면, 그 내용이 활성화되도록 하기 위해 체크박스가 처음에 선택된 상태로 설정됩니다.
Access 함수:
| bool | isCheckable() const |
| void | setCheckable(bool checkable) |
참조: checked.
checked : bool
이 속성은 그룹 박스가 선택되어 있는지 여부를 나타냅니다.
그룹 박스에 선택 가능 속성이 설정되어 있으면, 체크 박스와 함께 표시됩니다. 체크 박스가 선택되어 있으면 그룹 박스의 자식 요소들이 활성화되며, 그렇지 않으면 자식 요소들이 비활성화되어 사용자가 접근할 수 없게 됩니다.
기본적으로 선택 가능한 그룹 박스는 선택된 상태로 표시됩니다.
참고: 그룹박스의 선택 상태가 해제되어도그룹 박스 자체는 비활성화되지 않으며, 선택 상태가 해제된 그룹 박스 내의 개별 자식 요소를 명시적으로 활성화할 수 있습니다. 그러나 이는 최종 사용자에게 예상치 못한 경험을 야기할 수 있으므로 권장되지 않습니다.
액세스 함수:
| bool | isChecked() const |
| void | setChecked(bool checked) |
알림 신호:
| void | toggled(bool on) |
checkable도 참조하십시오 .
flat : bool
이 속성은 그룹 박스가 테두리 없이 채워져 있든, 테두리가 있든 상관없이 적용됩니다.
그룹 박스는 일반적으로 상단에 제목이 있는 테두리로 구성됩니다. 이 속성이 활성화되어 있으면 대부분의 스타일에서 테두리의 상단 부분만 그려지며, 그렇지 않은 경우 테두리 전체가 그려집니다.
기본적으로 이 속성은 비활성화되어 있으며, 즉 명시적으로 지정하지 않는 한 그룹 박스는 평면 형태로 표시되지 않습니다.
참고: 일부 스타일에서는 평면형과 비평면형 그룹 박스의 모양이 비슷하여 다른 스타일에서처럼 명확하게 구별되지 않을 수 있습니다.
Access 함수:
| bool | isFlat() const |
| void | setFlat(bool flat) |
title도 참조하십시오 .
title : QString
이 속성은 그룹 상자 제목 텍스트를 저장합니다.
그룹 박스 제목에 앰퍼샌드('&') 뒤에 알파벳이 오는 경우, 해당 그룹 박스 제목 텍스트에는 키보드 단축키가 지정됩니다.
g->setTitle("&User information");위의 예시에서, ` Alt+U `는 키보드 포커스를 그룹 박스로 이동시킵니다. 자세한 내용은 QShortcut 문서를 참조하십시오(실제 앰퍼샌드를 표시하려면 '&&'를 사용하십시오).
기본 제목 텍스트는 없습니다.
Access 함수:
| QString | title() const |
| void | setTitle(const QString &title) |
'정렬' 항목도 참조하십시오 .
멤버 함수 문서
[explicit] QGroupBox::QGroupBox(QWidget *parent = nullptr)
지정된 그룹 박스 레이아웃( parent )을 사용하되, 제목이 없는 그룹 박스 위젯을 생성합니다.
[explicit] QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)
지정된 ` title ` 및 ` parent`을 사용하여 그룹 박스를 생성합니다.
[virtual noexcept] QGroupBox::~QGroupBox()
그룹 상자를 삭제합니다.
[override virtual protected] void QGroupBox::changeEvent(QEvent *ev)
QWidget::changeEvent(QEvent *event)를 재구현합니다.
[override virtual protected] void QGroupBox::childEvent(QChildEvent *c)
QObject::childEvent(QChildEvent *event)를 재구현합니다.
[signal] void QGroupBox::clicked(bool checked = false)
이 신호는 체크박스가 활성화될 때(즉, 마우스 커서가 버튼 안에 있는 상태에서 체크박스를 눌렀다가 놓았을 때) 또는 단축키를 입력했을 때 발생합니다. 특히, ` setChecked()`를 호출할 경우에는 이 신호가 발생하지 않습니다.
체크박스가 선택된 경우 ` checked `는 `true`이며, 선택되지 않은 경우 `false`입니다.
checkable, toggled(), checked도 참조하십시오 .
[override virtual protected] bool QGroupBox::event(QEvent *e)
QWidget::event(QEvent *event)를 재구현합니다.
[override virtual protected] void QGroupBox::focusInEvent(QFocusEvent *fe)
QWidget::focusInEvent(QFocusEvent *event)를 재구현합니다.
[virtual protected] void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const
option 를 QGroupBox 에 있는 값들로 초기화합니다. 이 메서드는 하위 클래스에서 QStyleOptionGroupBox 가 필요하지만, 모든 정보를 직접 입력하고 싶지 않을 때 유용합니다.
QStyleOption::initFrom()도 참조하십시오 .
[override virtual] QSize QGroupBox::minimumSizeHint() const
QWidget::minimumSizeHint 속성에 대한 액세스 함수를 재구현합니다.
[override virtual protected] void QGroupBox::mouseMoveEvent(QMouseEvent *event)
QWidget::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.
[override virtual protected] void QGroupBox::mousePressEvent(QMouseEvent *event)
QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.
[override virtual protected] void QGroupBox::mouseReleaseEvent(QMouseEvent *event)
QWidget::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.
[override virtual protected] void QGroupBox::paintEvent(QPaintEvent *event)
QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.
[override virtual protected] void QGroupBox::resizeEvent(QResizeEvent *e)
QWidget::resizeEvent(QResizeEvent *event)를 재구현합니다.
[signal] void QGroupBox::toggled(bool on)
그룹 박스에 체크 상자가 포함된 경우, 이 신호는 체크 상자의 선택 상태가 전환될 때 발생합니다. 체크 상자가 선택되어 있으면 ` on `가 `true`이고, 그렇지 않으면 `false`입니다.
참고: 속성 ` checked`에 대한알림 신호입니다.
참조: checkable.
© 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.