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 (일반적으로 생성자에서 설정됨)와 제목의 정렬을 설정할 수 있습니다. 그룹 상자는 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 입니다.
기능에 접근합니다:
Qt::Alignment | alignment() const |
void | setAlignment(int alignment) |
Qt::Alignment 를참조하세요 .
checkable : bool
이 속성은 그룹 상자의 제목에 확인란이 있는지 여부를 나타냅니다.
이 속성이 true
인 경우 그룹 상자는 일반 레이블 대신 확인란을 사용하여 제목을 표시합니다. 확인란이 선택되어 있으면 그룹 상자의 하위 항목이 활성화되고, 그렇지 않으면 비활성화되어 액세스할 수 없습니다.
기본적으로 그룹 상자는 선택할 수 없습니다.
그룹 상자에 대해 이 속성을 활성화하면 처음에 해당 그룹 상자의 콘텐츠도 활성화됩니다.
액세스 기능:
bool | isCheckable() const |
void | setCheckable(bool checkable) |
checked 을참조하세요 .
checked : bool
이 속성은 그룹 상자의 선택 여부를 보유합니다.
그룹 상자를 선택할 수 있는 경우 확인란과 함께 표시됩니다. 확인란이 선택되어 있으면 그룹 상자의 하위 항목이 활성화되고, 그렇지 않으면 하위 항목이 비활성화되어 사용자가 액세스할 수 없습니다.
기본적으로 선택 가능한 그룹 상자도 선택되어 있습니다.
액세스 기능:
bool | isChecked() const |
void | setChecked(bool checked) |
알림 신호:
void | toggled(bool on) |
checkable참조 .
flat : bool
이 속성은 그룹 상자가 평면으로 칠해져 있는지 또는 프레임이 있는지를 나타냅니다.
그룹 상자는 일반적으로 상단에 제목이 있는 주변 프레임으로 구성됩니다. 이 속성을 활성화하면 대부분의 스타일에서 프레임의 상단 부분만 그려지고, 그렇지 않으면 전체 프레임이 그려집니다.
기본적으로 이 속성은 비활성화되어 있으므로 명시적으로 지정하지 않는 한 그룹 상자는 평면이 아닙니다.
참고: 일부 스타일에서는 평면 그룹 상자와 평면이 아닌 그룹 상자의 표현이 비슷하여 다른 스타일에서처럼 구분하기 어려울 수 있습니다.
기능에 접근합니다:
bool | isFlat() const |
void | setFlat(bool flat) |
title 를참조하세요 .
title : QString
이 속성은 그룹 상자 제목 텍스트를 저장합니다.
그룹 상자 제목 텍스트에 앰퍼샌드('&') 뒤에 문자가 포함된 경우 키보드 단축키가 있습니다.
g->setTitle("&User information");
위의 예에서 Alt+U 은 키보드 포커스를 그룹 상자로 이동합니다. 자세한 내용은 QShortcut 문서를 참조하세요(실제 앰퍼샌드를 표시하려면 '&&'를 사용하세요).
기본 제목 텍스트는 없습니다.
기능에 액세스합니다:
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 * 이벤트).
[override virtual protected]
void QGroupBox::childEvent(QChildEvent *c)
다시 구현합니다: QObject::childEvent(QChildEvent * 이벤트).
[signal]
void QGroupBox::clicked(bool checked = false)
이 신호는 확인란이 활성화되거나(즉, 마우스 커서가 버튼 안에 있는 상태에서 눌렀다가 놓을 때) 바로 가기 키를 입력할 때 발생합니다. 특히 setChecked()를 호출하는 경우에는 이 신호가 발생하지 않습니다.
확인란을 선택하면 checked 은 참이고, 확인란을 선택하지 않으면 거짓입니다.
checkable, toggled() 및 checked 를참조하세요 .
[override virtual protected]
bool QGroupBox::event(QEvent *e)
다시 구현합니다: QWidget::event(QEvent * 이벤트).
[override virtual protected]
void QGroupBox::focusInEvent(QFocusEvent *fe)
다시 구현합니다: QWidget::focusInEvent(QFocusEvent * 이벤트).
[virtual protected]
void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const
QGroupBox 의 값으로 option 을 초기화합니다. 이 메서드는 하위 클래스에 QStyleOptionGroupBox 이 필요하지만 모든 정보를 직접 채우고 싶지 않을 때 유용합니다.
QStyleOption::initFrom()도 참조하세요 .
[override virtual]
QSize QGroupBox::minimumSizeHint() const
속성에 대한 액세스 함수를 다시 구현합니다: QWidget::minimumSizeHint.
[override virtual protected]
void QGroupBox::mouseMoveEvent(QMouseEvent *event)
다시 구현합니다: QWidget::mouseMoveEvent(QMouseEvent * 이벤트).
[override virtual protected]
void QGroupBox::mousePressEvent(QMouseEvent *event)
다시 구현합니다: QWidget::mousePressEvent(QMouseEvent * 이벤트).
[override virtual protected]
void QGroupBox::mouseReleaseEvent(QMouseEvent *event)
다시 구현합니다: QWidget::mouseReleaseEvent(QMouseEvent * 이벤트).
[override virtual protected]
void QGroupBox::paintEvent(QPaintEvent *event)
다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).
[override virtual protected]
void QGroupBox::resizeEvent(QResizeEvent *e)
다시 구현합니다: QWidget::resizeEvent(QResizeEvent * 이벤트).
[signal]
void QGroupBox::toggled(bool on)
그룹 확인란이 선택 가능한 경우 확인란이 토글될 때 이 신호가 전송됩니다. on 확인란이 선택되어 있으면 참이고, 그렇지 않으면 거짓입니다.
참고: 속성에 대한 알림 신호 checked.
checkable도 참조하세요 .
© 2025 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.