QRadioButton Class
QRadioButton 위젯은 텍스트 레이블이 포함된 라디오 버튼을 제공합니다. 더 보기...
| 헤더: | #include <QRadioButton> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QAbstractButton |
공개 함수
| QRadioButton(QWidget *parent = nullptr) | |
| QRadioButton(const QString &text, QWidget *parent = nullptr) | |
| virtual | ~QRadioButton() |
재구현된 공용 함수
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
보호된 함수
| virtual void | initStyleOption(QStyleOptionButton *option) const |
재구현된 보호 함수
| virtual bool | event(QEvent *e) override |
| virtual bool | hitButton(const QPoint &pos) const override |
| virtual void | mouseMoveEvent(QMouseEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
상세 설명
QRadioButton은 켜기(선택) 또는 끄기(선택 해제)가 가능한 옵션 버튼입니다. 라디오 버튼은 일반적으로 사용자에게 "여러 개 중 하나"를 선택하도록 제시합니다. 라디오 버튼 그룹에서는 한 번에 하나의 라디오 버튼만 선택할 수 있으며, 사용자가 다른 버튼을 선택하면 이전에 선택된 버튼은 선택 해제됩니다.
라디오 버튼은 기본적으로 autoExclusive 속성이 설정되어 있습니다. auto-exclusive가 활성화되면, 동일한 부모 위젯에 속한 라디오 버튼들은 마치 하나의 배타적 버튼 그룹에 속한 것처럼 동작합니다. 동일한 부모 위젯에 속한 라디오 버튼에 대해 여러 개의 배타적 버튼 그룹이 필요한 경우, 이를 QButtonGroup 에 배치하십시오.
버튼이 켜지거나 꺼질 때마다 toggled() 신호가 발생합니다. 버튼의 상태가 변경될 때마다 특정 동작을 트리거하려면 이 신호에 연결하십시오. 특정 버튼이 선택되었는지 확인하려면 isChecked()를 사용하십시오.
QPushButton 과 마찬가지로, 라디오 버튼은 텍스트를 표시하며, 선택에 따라 작은 아이콘도 표시할 수 있습니다. 아이콘은 setIcon()를 사용하여 설정합니다. 텍스트는 생성자에서 또는 setText()를 사용하여 설정할 수 있습니다. 텍스트에서 원하는 문자의 앞에 앰퍼샌드(&)를 붙이면 단축키를 지정할 수 있습니다. 예를 들어:
QRadioButton *button = new QRadioButton("Search from the &cursor", this);이 예제에서 단축키는 Alt+c입니다. 자세한 내용은 QShortcut 문서를 참조하십시오. 실제 앰퍼샌드를 표시하려면 '&&'를 사용하십시오.
중요한 상속 멤버: text(), setText(), text(), setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(), toggle(), pressed(), released(), clicked(), toggled().
QPushButton, QToolButton 및 QCheckBox도 참조하십시오 .
멤버 함수 문서
[explicit] QRadioButton::QRadioButton(QWidget *parent = nullptr)
지정된 ` parent`를 사용하여 라디오 버튼을 생성하지만, 텍스트나 픽스맵은 포함하지 않습니다.
parent 인수는 QAbstractButton 생성자에 전달됩니다.
[explicit] QRadioButton::QRadioButton(const QString &text, QWidget *parent = nullptr)
지정된 ` parent ` 및 ` text ` 문자열을 사용하여 라디오 버튼을 생성합니다.
parent 인수는 QAbstractButton 생성자로 전달됩니다.
[virtual noexcept] QRadioButton::~QRadioButton()
소멸자.
[override virtual protected] bool QRadioButton::event(QEvent *e)
QAbstractButton::event(QEvent *e)를 재구현합니다.
[override virtual protected] bool QRadioButton::hitButton(const QPoint &pos) const
QAbstractButton::hitButton(const QPoint &pos) const를 재구현합니다.
[virtual protected] void QRadioButton::initStyleOption(QStyleOptionButton *option) const
option 를 QRadioButton 에 있는 값들로 초기화합니다. 이 메서드는 하위 클래스에서 QStyleOptionButton 가 필요하지만, 모든 정보를 직접 입력하고 싶지 않을 때 유용합니다.
QStyleOption::initFrom()도 참조하십시오 .
[override virtual] QSize QRadioButton::minimumSizeHint() const
QWidget::minimumSizeHint 속성에 대한 액세스 함수를 재구현합니다.
[override virtual protected] void QRadioButton::mouseMoveEvent(QMouseEvent *e)
QAbstractButton::mouseMoveEvent(QMouseEvent *e)를 재구현합니다.
[override virtual protected] void QRadioButton::paintEvent(QPaintEvent *)
QAbstractButton::paintEvent(QPaintEvent *e)를 재구현합니다.
[override virtual] QSize QRadioButton::sizeHint() const
QWidget::sizeHint 속성에 대한 액세스 함수를 재구현합니다.
© 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.
