QSlider 값 전달

QSlider

QSlider는 슬라이더를 움직여 숫자 값을 조절하는 위젯

볼륨 조절, 밝기 조절, 진행률 조절처럼 사용자가 숫자 값을 직접 조절해야 하는 화면에서 자주 사용된다.

자주 사용하는 방향 설정

Qt.Horizontal → 슬라이더를 가로 방향으로 표시
Qt.Vertical → 슬라이더를 세로 방향으로 표시

---

슬라이더 값 설정

자주 사용하는 메서드

setMinimum() → 슬라이더의 최소값 설정
setMaximum() → 슬라이더의 최대값 설정
setValue() → 슬라이더의 초기값 설정

slider.setMinimum(1)
slider.setMaximum(100)
slider.setValue(25)

위 설정은 최소값 1, 최대값 100 범위에서 시작 값을 25로 지정한 상태이다.

---

valueChanged(int) Signal

슬라이더 값이 변경될 때마다 valueChanged(int) Signal이 발생

단순히 값이 변경되었다는 사실만 알려주는 것이 아니라 현재 슬라이더 값을 int 형태로 함께 전달한다.

valueChanged(int)

슬라이더 값이 변경될 때 현재 숫자 값을 함께 전달하는 Signal

---

Slot에서 값 받기

Signal이 전달한 숫자 값을 Slot 함수의 매개변수로 받을 수 있다.

def respond_to_slider(data):
    print("슬라이더 값 변경 :", data)

사용자가 슬라이더를 움직일 때마다 최신 숫자 값이 data로 자동 전달된다.

---

QSlider 예제

import sys
from PySide6.QtCore import (
    Qt
)
from PySide6.QtWidgets import (
    QApplication,
    QSlider
)

# valueChanged(int) Signal이 전달한 값을 받을 Slot 함수
def respond_to_slider(data):
    print("슬라이더 값 변경 :", data)

# QApplication 객체 생성
app = QApplication(sys.argv)

# 가로 방향 슬라이더 생성
slider = QSlider(Qt.Horizontal)

# 슬라이더 최소값 / 최대값 / 초기값 설정
slider.setMinimum(1)
slider.setMaximum(100)
slider.setValue(25)

# Signal(valueChanged)과 Slot(respond_to_slider) 연결
slider.valueChanged.connect(respond_to_slider)

# 슬라이더 화면 출력
slider.show()

# 이벤트 루프 실행
sys.exit(app.exec())

동작 과정

1. 사용자가 슬라이더 이동
2. valueChanged(int) Signal 발생
3. 현재 슬라이더 값 전달
4. respond_to_slider(data) 함수 실행

슬라이더를 움직일 때마다 현재 숫자 값이 콘솔에 출력된다.