Thông báo: Download 4 khóa học Python từ cơ bản đến nâng cao tại đây.
Cách sử dụng lớp QCheckBox trong PyQt
Trong bài viết này, bạn sẽ tìm hiểu cách sử dụng lớp PyQt QCheckBox để tạo một widget checkbox trong ứng dụng giao diện người dùng. Checkbox là một thành phần giao diện phổ biến, cho phép người dùng chọn hoặc bỏ chọn các tùy chọn khác nhau. Việc hiểu và sử dụng thành thạo QCheckBox sẽ giúp bạn xây dựng các ứng dụng có giao diện người dùng linh hoạt và tương tác tốt hơn. Mình sẽ đi qua từng bước cụ thể, từ việc tạo checkbox đơn giản đến cách xử lý sự kiện và tạo checkbox ba trạng thái.

Giới thiệu về widget PyQt QCheckBox
Lớp QCheckBox cho phép bạn tạo một widget checkbox, có thể bật hoặc tắt. Để tạo một checkbox bằng cách sử dụng lớp QCheckBox, bạn thực hiện các bước sau:
Bước 1: Nhập lớp QCheckBox:
from PyQt6.QtWidgets import QCheckBox
Bước 2: Tạo một đối tượng mới của lớp QCheckBox:
Bài viết này được đăng tại [free tuts .net]
checkbox = QCheckBox(text)
Chương trình dưới đây sẽ tạo ra một cửa sổ có chứa một checkbox:
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QCheckBox, QGridLayout
from PyQt6.QtCore import Qt
class MainWindow(QWidget):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.setWindowTitle('PyQt QCheckBox')
self.setGeometry(100, 100, 320, 210)
# tạo layout dạng grid
layout = QGridLayout()
self.setLayout(layout)
# tạo checkbox
checkbox = QCheckBox('I agree', self)
layout.addWidget(checkbox, 0, 0, Qt.AlignmentFlag.AlignCenter)
# hiển thị cửa sổ
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
window = MainWindow()
sys.exit(app.exec())
Lưu ý rằng chương trình sử dụng QGridLayout để đặt checkbox trên cửa sổ.
Kết quả:

Tín hiệu stateChanged
Checkbox sẽ phát ra tín hiệu stateChanged bất cứ khi nào bạn chọn hoặc bỏ chọn nó.
Nếu bạn muốn thực hiện một hành động khi checkbox được chọn hoặc bỏ chọn, bạn có thể kết nối một hàm xử lý (slot) với tín hiệu stateChanged. Ví dụ:
checkbox = QCheckBox('I agree', self)
checkbox.stateChanged.connect(self.on_checkbox_changed)
Tín hiệu stateChanged sẽ gửi một giá trị chỉ ra liệu checkbox đang được chọn hay không. Để kiểm tra trạng thái của một QCheckBox, bạn tạo một đối tượng Qt.CheckState:
state = Qt.CheckState(value)
Và so sánh nó với một trong ba giá trị sau:
| Trạng thái | Ý nghĩa |
|---|---|
Qt.CheckState.Checked |
Đã chọn |
Qt.CheckState.Unchecked |
Chưa chọn |
Qt.CheckState.PartiallyChecked |
Chọn một phần (tristate) |
Lưu ý rằng Qt.CheckState.PartiallyChecked được sử dụng cho checkbox ba trạng thái (tristate) mà chúng ta sẽ thảo luận ở phần sau.
Ví dụ:
def on_checkbox_changed(self, value):
state = Qt.CheckState(value)
if state == Qt.CheckState.Checked:
print('Checked')
elif state == Qt.CheckState.Unchecked:
print('Unchecked')
Ngoài ra, bạn cũng có thể sử dụng phương thức isChecked() để kiểm tra liệu checkbox có được chọn hay không.
Chương trình hoàn chỉnh dưới đây sẽ hiển thị một thông báo trong console khi checkbox được chọn hoặc bỏ chọn:
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QCheckBox, QGridLayout
from PyQt6.QtCore import Qt
class MainWindow(QWidget):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.setWindowTitle('PyQt QCheckBox')
self.setGeometry(100, 100, 320, 210)
# tạo layout dạng grid
layout = QGridLayout()
self.setLayout(layout)
# tạo checkbox
checkbox = QCheckBox('I agree', self)
checkbox.stateChanged.connect(self.on_checkbox_changed)
layout.addWidget(checkbox, 0, 0, Qt.AlignmentFlag.AlignCenter)
# hiển thị cửa sổ
self.show()
def on_checkbox_changed(self, value):
state = Qt.CheckState(value)
if state == Qt.CheckState.Checked:
print('Checked')
elif state == Qt.CheckState.Unchecked:
print('Unchecked')
if __name__ == '__main__':
app = QApplication(sys.argv)
window = MainWindow()
sys.exit(app.exec())
Thiết lập trạng thái checked hoặc unchecked cho PyQt QCheckBox bằng mã
Lớp QCheckBox có phương thức setChecked() cho phép bạn kiểm tra hoặc bỏ chọn checkbox bằng mã.
Nếu bạn truyền vào giá trị True cho phương thức setChecked(), checkbox sẽ được chọn. Ngược lại, nếu bạn truyền vào giá trị False, checkbox sẽ bị bỏ chọn.
Bạn cũng có thể sử dụng phương thức setCheckState() của lớp QCheckBox để đặt trạng thái của checkbox. Phương thức setCheckState() nhận một trong ba giá trị trạng thái của Qt.CheckState.
Chương trình dưới đây minh họa cách sử dụng phương thức setChecked() để chọn và bỏ chọn một checkbox:
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QCheckBox, QPushButton, QGridLayout
from PyQt6.QtCore import Qt
class MainWindow(QWidget):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.setWindowTitle('PyQt QCheckBox')
self.setGeometry(100, 100, 320, 210)
# tạo layout dạng grid
layout = QGridLayout()
self.setLayout(layout)
# tạo checkbox
self.checkbox = QCheckBox('I agree', self)
check_button = QPushButton('Check', self)
check_button.clicked.connect(self.check)
uncheck_button = QPushButton('Uncheck', self)
uncheck_button.clicked.connect(self.uncheck)
layout.addWidget(self.checkbox, 0, 0, 0, 2,
Qt.AlignmentFlag.AlignCenter)
layout.addWidget(check_button, 1, 0)
layout.addWidget(uncheck_button, 1, 1)
# hiển thị cửa sổ
self.show()
def check(self):
self.checkbox.setChecked(True)
def uncheck(self):
self.checkbox.setChecked(False)
if __name__ == '__main__':
app = QApplication(sys.argv)
window = MainWindow()
sys.exit(app.exec())
Kết quả:

Tạo checkbox ba trạng thái (tristate) trong PyQt
Ngoài trạng thái chọn và bỏ chọn, QCheckBox còn hỗ trợ trạng thái thứ ba, chỉ ra "không thay đổi". Trong trường hợp này, checkbox sẽ có ba trạng thái:
- Đã chọn (Checked)
- Chưa chọn (Unchecked)
- Chọn một phần (Partially checked)
Trong thực tế, bạn sử dụng checkbox ba trạng thái để cung cấp cho người dùng tùy chọn không chọn hoặc bỏ chọn checkbox.
Để tạo checkbox ba trạng thái, bạn sử dụng phương thức setTristate(True):
checkbox.setTristate(True)
Chương trình dưới đây sẽ hiển thị checkbox ba trạng thái:
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QCheckBox, QGridLayout
from PyQt6.QtCore import Qt
class MainWindow(QWidget):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.setWindowTitle('PyQt QCheckBox')
self.setGeometry(100, 100, 320, 210)
# tạo layout dạng grid
layout = QGridLayout()
self.setLayout(layout)
# tạo checkbox ba trạng thái
self.checkbox = QCheckBox('A Tristate Checkbox', self)
self.checkbox.setTristate(True)
layout.addWidget(self.checkbox, 0, 0, Qt.AlignmentFlag.AlignCenter)
# hiển thị cửa sổ
self.show()
if __name__ == '__main__':
app = QApplication(sys.argv)
window = MainWindow()
sys.exit(app.exec())
Kết quả:

Kết bài
Qua bài hướng dẫn này, bạn đã nắm được cách sử dụng lớp QCheckBox để tạo các widget checkbox trong ứng dụng PyQt. Bạn đã biết cách làm việc với tín hiệu stateChanged để theo dõi trạng thái của checkbox, sử dụng phương thức setChecked() hoặc setState() để điều khiển trạng thái của checkbox bằng mã, và tạo checkbox ba trạng thái bằng phương thức setTristate(). Với những kiến thức này, bạn có thể tạo ra các checkbox linh hoạt, phục vụ cho nhiều mục đích khác nhau trong ứng dụng giao diện người dùng của mình.

Các kiểu dữ liệu trong C ( int - float - double - char ...)
Thuật toán tìm ước chung lớn nhất trong C/C++
Cấu trúc lệnh switch case trong C++ (có bài tập thực hành)
ComboBox - ListBox trong lập trình C# winforms
Random trong Python: Tạo số random ngẫu nhiên
Lệnh cin và cout trong C++
Cách khai báo biến trong PHP, các loại biến thường gặp
Download và cài đặt Vertrigo Server
Thẻ li trong HTML
Thẻ article trong HTML5
Cấu trúc HTML5: Cách tạo template HTML5 đầu tiên
Cách dùng thẻ img trong HTML và các thuộc tính của img
Thẻ a trong HTML và các thuộc tính của thẻ a thường dùng