PySide6 :: QThread

QThread

Qt에서 스레드를 관리하는 기본 클래스

• QThread 를 사용하여 새로운 스레드를 생성, 실행 가능

기본 개념

• QThread 는 독립적인 실행 흐름을 갖는 별도의 스레드를 생성
• 스레드가 시작되면 내부적으로 run() 메소드 호출
  • 사용자는 run() 메소드를 직접 호출하지 않고, start() 메소드를 호출하여 스레드 시작
• QThread는 자체 이벤트 루프 exec() 를 보유, Signal-Slot 통신, 타이머 등 이벤트 처리 가능
• 스레드가 작업을 수행하는 동안 메인 스레드 (GUI)는 응답 상태를 유지 → 프로그램이 멈추는 현상 방지

주요 메서드

구현

​1. run() 메서드 오버라이드

import sys
 
from PySide6.QtCore import QThread, Signal, Slot
from PySide6.QtWidgets import (
	QApplication, QMainWindow, QWidget,
	QVBoxLayout, 
	QPushButton, QLabel
)
 
 
class WorkerThread(QThread):
	result_ready = Signal(str)    ## 작업이 완료되었음을 나타내는 시그널
	
	def run(self) -> None:
		for i in range(5):
			self.sleep(1)
			self.result_ready.emit(f"Count: {i + 1}")
 
 
class MainWindow(QMainWindow):
	def __init__(self) -> None :
		super().__init__()
		
		self.thread = WorkerThread()
		
		self._setup_ui()
		self._setup_connections()
	
	def _setup_ui(self) -> None :
		## 창 설정
		self.setWindowTitle("QThread Example")
		
		container = QWidget()
		self.setCentralWidget(container)
		
		layout = QVBoxLayout(self)
		container.setLayout(layout)
		
		## UI 설정
		self.label = QLabel("")
		self.start_button = QPushButton("Start", self)
		
		layout.addWidget(self.label)
		layout.addWidget(self.start_button)
	
	def _setup_connections(self) -> None :
		self.thread.result_ready.connect(self.update_text)
		self.start_button.clicked.connect(self.start_thread)
	
	@Slot(str)
	def update_text(self, text) -> None :
		self.label.setText(text)
	
	def start_thread(self) -> None :
		self.thread.start()
 
 
if __name__ == '__main__' :
	app = QApplication(sys.argv)
	
	window = MainWindow()
	window.show()
	
	app.exec()
 

• QThread 를 상속받는 WorkerThread 클래스를 생성, 백그라운드 작업을 수행
• 스레드에서 작업이 완료될 때 마다 result_ready 시그널을 방출
• 메인 윈도우는 이 시그널을 수신, 텍스트 업데이트

전체 코드

import sys
 
from PySide6.QtCore import QThread, Signal, Slot
from PySide6.QtWidgets import (
	QApplication, QMainWindow, QWidget,
	QVBoxLayout, 
	QPushButton, QLabel
)
 
 
class WorkerThread(QThread):
	result_ready = Signal(str)    ## 작업이 완료되었음을 나타내는 시그널
	
	def run(self) -> None:
		for i in range(5):
			self.sleep(1)
			self.result_ready.emit(f"Count: {i + 1}")
 
 
class MainWindow(QMainWindow):
	def __init__(self) -> None :
		super().__init__()
		
		self.thread = WorkerThread()
		
		self._setup_ui()
		self._setup_connections()
	
	def _setup_ui(self) -> None :
		## 창 설정
		self.setWindowTitle("QThread Example")
		
		container = QWidget()
		self.setCentralWidget(container)
		
		layout = QVBoxLayout(self)
		container.setLayout(layout)
		
		## UI 설정
		self.label = QLabel("")
		self.start_button = QPushButton("Start", self)
		
		layout.addWidget(self.label)
		layout.addWidget(self.start_button)
	
	def _setup_connections(self) -> None :
		self.thread.result_ready.connect(self.update_text)
		self.start_button.clicked.connect(self.start_thread)
	
	@Slot(str)
	def update_text(self, text) -> None :
		self.label.setText(text)
	
	def start_thread(self) -> None :
		self.thread.start()
 
 
if __name__ == '__main__' :
	app = QApplication(sys.argv)
	
	window = MainWindow()
	window.show()
	
	app.exec()

2. moveToThread() 사용

---

Reference

PySide6 Threading 관련 글

• PySide6 :: Multi-Threading
• PySide6 :: QThread