TUTORIAL
PyQt5 튜토리얼-라디오 버튼
이 튜토리얼에서는 라디오 버튼을 만들고, toggled 신호에 슬롯을 연결하고, 옵션을 미리 선택하며, 그룹을 독립적으로 유지하는 예제를 통해 PyQt5 QRadioButton 위젯을 소개합니다.
이 페이지의 내용
QRadioButton은 사용자가 여러 옵션 중에서 정확히 하나만 선택하도록 하는 위젯으로, 여러 선택지가 상호 배타적일 때 적합합니다. 독립적인 켜기/끄기 선택에는 QCheckBox를 대신 사용하세요. 각 체크박스는 자신의 상태를 개별적으로 유지하기 때문입니다. 각 QRadioButton은 둥근 선택 표시와 텍스트 레이블을 결합하며, 같은 부모 위젯을 공유하는 라디오 버튼은 자동으로 하나의 배타적 그룹을 이룹니다. 하나를 선택하면 나머지는 해제됩니다.
QRadioButton 위젯 만들기
보이는 옵션 텍스트를 QRadioButton 생성자에 전달하고 다른 위젯과 마찬가지로 버튼을 레이아웃에 추가합니다. 다음 스크립트는 사용자가 어느 도시에 사는지 묻는 창을 만들고, New York과 Houston을 선택지로 제공하며, 답변을 표시할 두 번째 QLabel을 준비합니다. 이 예제에는 PyQt5와 그래픽 디스플레이가 필요합니다. importlib.util.find_spec 검사 덕분에 PyQt5가 설치되지 않은 환경에서도 파일이 오류 없이 종료되고, 데스크톱에서는 아래와 같은 창이 열립니다. 예제 코드와 창에 표시되는 레이블은 원문과 동일하게 영어로 유지됩니다.
import importlib.util
import sys
if importlib.util.find_spec("PyQt5") is None:
sys.exit(0) # PyQt5 is required for the GUI below
from PyQt5.QtWidgets import (
QApplication,
QLabel,
QRadioButton,
QVBoxLayout,
QWidget,
)
class basicRadiobuttonExample(QWidget):
def __init__(self):
super().__init__()
self.init_ui()
def init_ui(self):
self.label = QLabel("Which city do you live in?")
self.rbtn1 = QRadioButton("New York")
self.rbtn2 = QRadioButton("Houston")
self.label2 = QLabel("")
self.rbtn1.toggled.connect(self.onClicked)
self.rbtn2.toggled.connect(self.onClicked)
layout = QVBoxLayout()
layout.addWidget(self.label)
layout.addWidget(self.rbtn1)
layout.addWidget(self.rbtn2)
layout.addWidget(self.label2)
self.setGeometry(200, 200, 300, 150)
self.setLayout(layout)
self.setWindowTitle("PyQt5 Radio Button Example")
self.show()
def onClicked(self):
radioBtn = self.sender()
if radioBtn.isChecked():
self.label2.setText("You live in " + radioBtn.text())
if __name__ == "__main__":
app = QApplication(sys.argv)
ex = basicRadiobuttonExample()
sys.exit(app.exec_())
생성자 문자열("New York", "Houston")은 각 둥근 선택 표시 옆에 표시되는 텍스트가 됩니다. self.label은 질문을 표시하고, self.label2는 처음에는 빈 레이블로 시작해 나중에 선택 결과를 보고하며, QVBoxLayout은 위젯을 추가된 순서대로 수직으로 쌓습니다. setGeometry(200, 200, 300, 150)은 창의 위치와 크기를 정하고, setWindowTitle()은 창 제목을 설정합니다. 코드가 원문과 동일하게 유지되므로 창에 나타나는 질문, 버튼 레이블, 결과 문자열은 영어로 표시됩니다.
toggled 신호에 응답하기
QRadioButton은 체크 상태가 어느 방향으로든 바뀔 때마다 toggled 신호를 발생시킵니다. 선택될 때는 체크된 상태로 한 번, 선택을 잃는 버튼은 체크되지 않은 상태로 한 번 발생합니다. 두 버튼을 하나의 슬롯인 self.rbtn1.toggled.connect(self.onClicked)와 self.rbtn2.toggled.connect(self.onClicked)에 연결하는 것만으로 전체 그룹을 추적할 수 있습니다.
toggled는 선택이 해제된 버튼에서도 발생하므로, 슬롯은 isChecked()로 필터링하여 새로 선택된 버튼만 결과를 업데이트하도록 합니다. onClicked 안에서 self.sender()는 신호를 발생시킨 위젯을 반환하고, text()는 보이는 옵션 레이블을 읽으며, self.label2.setText("You live in " + radioBtn.text())가 답변을 작성합니다. 결과 레이블에 표시되는 문자열도 코드와 동일하게 영어입니다.
toggled 신호는 새 체크 상태를 불리언 값으로도 전달하므로, def onClicked(self, checked)처럼 선언된 슬롯은 isChecked()를 호출하는 대신 그 값을 사용할 수 있습니다. 여기서는 신호를 보낸 버튼에 대해 isChecked()를 확인하는 쪽이 더 간단한 패턴입니다. 어떤 버튼이 텍스트를 만들어 냈는지 명확해지기 때문입니다.
setChecked()로 기본 선택 설정하기
새 QRadioButton 인스턴스는 체크되지 않은 상태로 시작하므로 창이 열릴 때는 아무 옵션도 선택되어 있지 않습니다. 애플리케이션이 시작될 때 하나를 미리 선택하려면 해당 버튼에 대해 setChecked()를 호출하세요: self.rbtn1.setChecked(True).
체크 상태를 변경하면 사용자 클릭과 마찬가지로 toggled가 발생합니다. 미리 선택한 항목이 결과 레이블 같은 종속 위젯도 함께 업데이트하게 하려면 신호를 연결한 후에 setChecked(True)를 호출하고, 시작 시 선택이 슬롯을 실행하지 않고 유지되어야 한다면 연결하기 전에 호출하세요.
QButtonGroup으로 독립적인 그룹 만들기
같은 부모를 가진 모든 QRadioButton 위젯은 하나의 암시적 그룹에 속하므로, toggled 신호가 서로 다른 슬롯에 연결되어 있어도 한 번에 하나만 체크될 수 있습니다. 창에서 서로 독립적인 질문을 여러 개 해야 할 때는 각 옵션 세트를 QtWidgets의 QButtonGroup으로 묶고 addButton()으로 버튼을 등록하세요. 그러면 각 그룹이 다른 그룹과 무관하게 하나의 체크된 버튼을 허용합니다. 다음 예제는 도시와 주를 모두 묻는 예제로, 첫 번째 스크립트와 동일한 PyQt5 데스크톱 환경이 필요합니다. 코드와 창에 표시되는 레이블은 원문과 동일하게 영어로 유지됩니다:
import importlib.util
import sys
if importlib.util.find_spec("PyQt5") is None:
sys.exit(0) # PyQt5 is required for the GUI below
from PyQt5.QtWidgets import (
QApplication,
QButtonGroup,
QLabel,
QRadioButton,
QVBoxLayout,
QWidget,
)
class basicRadiobuttonExample(QWidget):
def __init__(self):
super().__init__()
self.init_ui()
def init_ui(self):
self.label = QLabel("Which city do you live in?")
self.rbtn1 = QRadioButton("New York")
self.rbtn2 = QRadioButton("Houston")
self.label2 = QLabel("")
self.label3 = QLabel("Which state do you live in?")
self.rbtn3 = QRadioButton("New York")
self.rbtn4 = QRadioButton("Texas")
self.label4 = QLabel("")
self.btngroup1 = QButtonGroup()
self.btngroup2 = QButtonGroup()
self.btngroup1.addButton(self.rbtn1)
self.btngroup1.addButton(self.rbtn2)
self.btngroup2.addButton(self.rbtn3)
self.btngroup2.addButton(self.rbtn4)
self.rbtn1.toggled.connect(self.onClickedCity)
self.rbtn2.toggled.connect(self.onClickedCity)
self.rbtn3.toggled.connect(self.onClickedState)
self.rbtn4.toggled.connect(self.onClickedState)
layout = QVBoxLayout()
layout.addWidget(self.label)
layout.addWidget(self.rbtn1)
layout.addWidget(self.rbtn2)
layout.addWidget(self.label2)
layout.addWidget(self.label3)
layout.addWidget(self.rbtn3)
layout.addWidget(self.rbtn4)
layout.addWidget(self.label4)
self.setGeometry(200, 200, 300, 300)
self.setLayout(layout)
self.setWindowTitle("PyQt5 Radio Button Example")
self.show()
def onClickedCity(self):
radioBtn = self.sender()
if radioBtn.isChecked():
self.label2.setText("You live in " + radioBtn.text())
def onClickedState(self):
radioBtn = self.sender()
if radioBtn.isChecked():
self.label4.setText("You live in " + radioBtn.text())
if __name__ == "__main__":
app = QApplication(sys.argv)
ex = basicRadiobuttonExample()
sys.exit(app.exec_())
프로그램은 도시 버튼용 self.btngroup1과 주 버튼용 self.btngroup2라는 두 개의 QButtonGroup 인스턴스를 만듭니다. addButton()은 각 라디오 버튼을 해당 그룹에 등록합니다. 도시 쌍은 self.btngroup1.addButton(self.rbtn1)과 self.btngroup1.addButton(self.rbtn2), 주 쌍은 self.btngroup2.addButton(self.rbtn3)과 self.btngroup2.addButton(self.rbtn4)로 등록합니다. 그룹이 없으면 네 버튼이 모두 같은 부모를 공유하기 때문에 Texas를 선택하면 도시 선택이 해제됩니다. 그룹을 두면 각 질문이 자신의 체크된 버튼을 유지하고 각 결과 레이블이 독립적으로 업데이트됩니다.
창만으로는 이 규칙을 텍스트로 보여 줄 수 없으므로, 다음 순수 Python 모델이 동일한 배타성을 재현합니다. 그룹당 하나의 선택만 허용되고 두 번째 그룹은 첫 번째 그룹의 영향을 받지 않습니다. 이 예제를 실행해 보세요. 모델 코드와 출력 문자열은 원문과 동일하게 영어로 유지됩니다:
class RadioGroup:
def __init__(self):
self.buttons = []
self.checked = None
def add(self, label):
self.buttons.append(label)
def select(self, label):
self.checked = label
return "Selected: " + label
city = RadioGroup()
city.add("New York")
city.add("Houston")
state = RadioGroup()
state.add("New York")
state.add("Texas")
print(city.select("New York"))
print(state.select("Texas"))
print(city.select("Houston"))
print("State group still holds:", state.checked)
Selected: New York
Selected: Texas
Selected: Houston
State group still holds: Texas
QButtonGroup은 모델의 RadioGroup 역할을 합니다. 새 선택은 같은 그룹 안에서 이전 선택을 대체하고, 다른 그룹은 자신의 답을 그대로 유지합니다.