Cách sử dụng lớp PyQt QSlider để tạo một widget thanh trượt (slider).

Trong bài viết này, bạn sẽ học cách sử dụng lớp PyQt QSlider để tạo một widget thanh trượt (slider). Thanh trượt là một công cụ phổ biến trong các giao diện người dùng, cho phép người dùng điều chỉnh một giá trị trong một phạm vi xác định thông qua việc di chuyển tay cầm dọc theo một thanh ngang hoặc dọc. Qua bài viết này, bạn sẽ hiểu cách tạo và tùy chỉnh thanh trượt, cũng như kết nối các tín hiệu để xử lý các thay đổi giá trị khi người dùng tương tác với widget này.

Giới thiệu về PyQt QSlider

QSlider là một widget cho phép bạn điều khiển giá trị trong một phạm vi xác định. Thanh trượt cho phép bạn di chuyển một "tay cầm" (handle) dọc theo một rãnh ngang hoặc dọc. Vị trí của tay cầm sẽ được chuyển đổi thành một số nguyên trong khoảng giá trị hợp lệ.

Để tạo thanh trượt, bạn sử dụng lớp PyQt QSlider:

QSlider(orientation[, parent=None])

Các tham số của QSlider:

• Orientation: Định hướng của thanh trượt, có thể là Qt.Orientation.Vertical (dọc) hoặc Qt.Orientation.Horizontal (ngang).
• Parent: Widget cha của thanh trượt.

Ví dụ, để tạo một thanh trượt ngang:

Bài viết này được đăng tại [free tuts .net]

slider = QSlider(Qt.Orientation.Horizontal, self)

Kết quả:

Hoặc một thanh trượt dọc:

slider = QSlider(Qt.Orientation.Vertical, self)

Kết quả:

Phạm vi (Range)

Để thiết lập phạm vi giá trị cho thanh trượt, bạn sử dụng phương thức setRange():

slider.setRange(min, max)

Bạn cũng có thể sử dụng setMinimum(min) và setMaximum(max) để thiết lập giá trị nhỏ nhất và lớn nhất.

Bước đơn (Single Step)

Khi bạn nhấn các phím mũi tên lên/xuống hoặc trái/phải, thanh trượt sẽ tăng/giảm một đơn vị bước đơn. Để thiết lập bước đơn, sử dụng setSingleStep():

slider.setSingleStep(step)

Bước trang (Page Step)

Khi nhấn phím Page Up/Page Down, thanh trượt sẽ tăng/giảm một bước trang. Bạn có thể sử dụng setPageStep() để thiết lập bước trang:

slider.setPageStep(pageStep)

Thiết lập giá trị hiện tại:

Để thiết lập giá trị cho thanh trượt, bạn sử dụng phương thức setValue():

slider.setValue(value)

Để lấy giá trị hiện tại của thanh trượt, sử dụng value():

current_value = slider.value()

Hiển thị dấu đánh dấu (Tick Marks)

Mặc định, thanh trượt không có dấu đánh dấu. Để hiển thị dấu đánh dấu, sử dụng setTickPosition(). Các tùy chọn cho dấu đánh dấu là:

• QSlider.TicksAbove: Hiển thị dấu đánh dấu ở phía trên thanh trượt.

• QSlider.TicksBelow: Hiển thị dấu đánh dấu ở phía dưới thanh trượt.

​

• QSlider.TicksLeft: Hiển thị dấu đánh dấu ở phía bên trái (dành cho thanh trượt dọc).

• QSlider.TicksRight: Hiển thị dấu đánh dấu ở phía bên phải (dành cho thanh trượt dọc).

• QSlider.TicksBothSides: Hiển thị dấu đánh dấu ở cả hai bên của thanh trượt.

Thiết lập khoảng dấu (Tick Interval)

Để thiết lập khoảng cách giữa các dấu đánh dấu, bạn sử dụng setTickInterval(). Mặc định, khoảng cách là 0, thanh trượt sẽ chọn giữa singleStep và pageStep.

Tín hiệu (Signals)

Tín hiệu quan trọng nhất của QSlider là valueChanged. Nó sẽ được kích hoạt khi giá trị của thanh trượt thay đổi.

Ví dụ về PyQt QSlider

Đoạn mã dưới đây sử dụng lớp QSlider để tạo một thanh trượt, kèm theo một nhãn để hiển thị giá trị hiện tại của thanh trượt:

import sys
from PyQt6.QtWidgets import QApplication, QWidget, QSlider, QLabel, QFormLayout
from PyQt6.QtCore import Qt

class MainWindow(QWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

        self.setWindowTitle('PyQt QSlider')
        self.setMinimumWidth(200)

        layout = QFormLayout()
        self.setLayout(layout)

        slider = QSlider(Qt.Orientation.Horizontal, self)
        slider.setRange(0, 100)
        slider.setValue(50)
        slider.setSingleStep(5)
        slider.setPageStep(10)
        slider.setTickPosition(QSlider.TickPosition.TicksAbove)

        slider.valueChanged.connect(self.update)

        self.result_label = QLabel('', self)

        layout.addRow(slider)
        layout.addRow(self.result_label)

        self.show()

    def update(self, value):
        self.result_label.setText(f'Giá trị hiện tại: {value}')

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MainWindow()
    sys.exit(app.exec())

Kết quả:

Giải thích cách hoạt động:

Tạo một đối tượng QSlider với định hướng ngang:

slider = QSlider(Qt.Orientation.Horizontal, self)

Thiết lập phạm vi, giá trị mặc định, bước đơn, bước trang, và vị trí dấu đánh dấu:

slider.setRange(0, 100)
slider.setValue(50)
slider.setSingleStep(10)
slider.setPageStep(20)
slider.setTickPosition(QSlider.TickPosition.TicksAbove)

Kết nối tín hiệu valueChanged() với phương thức update():

slider.valueChanged.connect(self.update)

Tạo một nhãn QLabel để hiển thị giá trị của thanh trượt:

self.result_label = QLabel('', self)

Định nghĩa phương thức update() để cập nhật nhãn khi giá trị thanh trượt thay đổi:

def update(self, value):
    self.result_label.setText(f'Giá trị hiện tại: {value}')

Kết bài

Sử dụng QSlider trong PyQt giúp bạn dễ dàng tạo ra một thanh trượt để người dùng có thể tương tác và thay đổi giá trị trong phạm vi bạn định sẵn. Bằng cách kết nối tín hiệu valueChanged, bạn có thể theo dõi và cập nhật giá trị thanh trượt mỗi khi người dùng thực hiện thao tác. Với những kiến thức này, bạn có thể linh hoạt tích hợp thanh trượt vào ứng dụng của mình, mang lại trải nghiệm người dùng trực quan và hiệu quả.