PySide6入門 — Pythonで作るはじめてのデスクトップGUI（初心者向け完全ガイド）

from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QLabel
import sys

app = QApplication(sys.argv)
w = QWidget()
lay = QVBoxLayout(w)

label = QLabel("まだ押されていません")
btn = QPushButton("押してね")

def on_click():
    label.setText("ボタンが押されました！")

btn.clicked.connect(on_click)

lay.addWidget(label)
lay.addWidget(btn)
w.show()
sys.exit(app.exec())

from PySide6.QtWidgets import QMainWindow, QAction

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        file_menu = self.menuBar().addMenu("&File")
        exit_action = QAction("Exit", self)
        exit_action.triggered.connect(self.close)
        file_menu.addAction(exit_action)

手軽に書けるが、QThread オブジェクト自身は元のスレッド（作成したスレッド）に所属する性質などに注意が必要。単純なケース向け。

# A) QThread を継承する簡単な例（学習用）
# qthread_example_a.py
import sys, time
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QLabel
from PySide6.QtCore import QThread, Signal

class WorkerThread(QThread):
    # メインスレッドに送るためのシグナル
    progress = Signal(int)
    finished = Signal()

    def run(self):
        # run() は別スレッドで実行される
        for i in range(1, 6):
            time.sleep(1)            # 重い処理の代わり
            self.progress.emit(i)   # シグナルで進捗を通知
        self.finished.emit()

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QThread 継承の例")
        self.label = QLabel("未開始")
        self.btn = QPushButton("開始")

        layout = QVBoxLayout(self)
        layout.addWidget(self.label)
        layout.addWidget(self.btn)

        self.btn.clicked.connect(self.start_thread)

    def start_thread(self):
        self.btn.setEnabled(False)
        self.thread = WorkerThread()           # 参照を保持すること（GC防止）
        self.thread.progress.connect(self.on_progress)
        self.thread.finished.connect(self.on_finished)
        self.thread.start()                    # <- run() を別スレッドで呼ぶ

    def on_progress(self, i):
        # シグナルはメインスレッド側のスロットで安全に UI 更新ができる
        self.label.setText(f"進捗: {i}")

    def on_finished(self):
        self.label.setText("完了")
        self.btn.setEnabled(True)
        self.thread = None

if __name__ == "__main__":
    app = QApplication(sys.argv)
    w = MainWindow()
    w.show()
    sys.exit(app.exec())

start() を使う。run() を直接呼んではいけません（直接呼ぶと別スレッドになりません）。

処理ロジックを QObject に切り出してシグナルでやり取りするため、設計が明瞭で安全性が高い。多くのプロや公式ドキュメントで推奨される。

# B) 推奨パターン：Worker(QObject) + moveToThread（実務向け）
# qthread_example_b.py
import sys, time
from PySide6.QtCore import QObject, Signal, Slot, QThread
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QLabel

class Worker(QObject):
    progress = Signal(int)
    finished = Signal()
    def __init__(self):
        super().__init__()
        self._running = True

    @Slot()
    def do_work(self):
        # このメソッドは Worker が移動したスレッド上で動く
        for i in range(1, 6):
            if not self._running:
                break
            time.sleep(1)
            self.progress.emit(i)
        self.finished.emit()

    @Slot()
    def stop(self):
        self._running = False

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("moveToThread の例（推奨）")
        self.label = QLabel("未開始")
        self.btn_start = QPushButton("開始")
        self.btn_stop = QPushButton("停止")
        self.btn_stop.setEnabled(False)

        layout = QVBoxLayout(self)
        layout.addWidget(self.label)
        layout.addWidget(self.btn_start)
        layout.addWidget(self.btn_stop)

        self.btn_start.clicked.connect(self.start)
        self.btn_stop.clicked.connect(self.stop)

    def start(self):
        self.btn_start.setEnabled(False)
        self.btn_stop.setEnabled(True)

        self.thread = QThread()
        self.worker = Worker()
        self.worker.moveToThread(self.thread)

        # 接続
        self.thread.started.connect(self.worker.do_work)
        self.worker.progress.connect(self.on_progress)
        self.worker.finished.connect(self.on_finished)
        self.worker.finished.connect(self.thread.quit)   # 終了したらスレッドのイベントループを抜ける
        self.thread.finished.connect(self.thread.deleteLater)
        self.worker.finished.connect(self.worker.deleteLater)

        self.thread.start()

    def stop(self):
        self.btn_stop.setEnabled(False)
        # Worker の stop() を呼んで安全に停止を指示
        self.worker.stop()

    def on_progress(self, i):
        self.label.setText(f"進捗: {i}")

    def on_finished(self):
        self.label.setText("完了")
        self.btn_start.setEnabled(True)
        self.btn_stop.setEnabled(False)
        # thread.quit() は worker.finished で呼ばれるので追加で呼ぶ必要はない

if __name__ == "__main__":
    app = QApplication(sys.argv)
    w = MainWindow()
    w.show()
    sys.exit(app.exec())

# exercise1.py
import sys
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QLabel
from PySide6.QtCore import QTimer

app = QApplication(sys.argv)
w = QWidget()
w.setWindowTitle("演習1 - 最小GUI")

layout = QVBoxLayout(w)
label = QLabel("未実行")
button = QPushButton("開始")
layout.addWidget(label)
layout.addWidget(button)

def on_start():
    label.setText("実行中...")
    # 2000ms = 2秒後に完了テキストに変更
    QTimer.singleShot(2000, lambda: label.setText("完了"))

button.clicked.connect(on_start)

w.show()
sys.exit(app.exec())

# exercise2.py
import sys, json
from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QListWidget,
                               QLineEdit, QPushButton, QHBoxLayout, QVBoxLayout,
                               QAction, QFileDialog, QMessageBox)
from PySide6.QtCore import Qt

class TodoMainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("TODO演習")
        central = QWidget()
        self.setCentralWidget(central)

        self.list_widget = QListWidget()
        self.input = QLineEdit()
        add_btn = QPushButton("追加")
        del_btn = QPushButton("削除")

        h = QHBoxLayout()
        h.addWidget(self.input)
        h.addWidget(add_btn)

        v = QVBoxLayout(central)
        v.addLayout(h)
        v.addWidget(self.list_widget)
        v.addWidget(del_btn)

        add_btn.clicked.connect(self.add_task)
        del_btn.clicked.connect(self.delete_task)

        menubar = self.menuBar()
        file_menu = menubar.addMenu("ファイル")
        save_action = QAction("保存", self)
        load_action = QAction("読み込み", self)
        file_menu.addAction(save_action)
        file_menu.addAction(load_action)
        save_action.triggered.connect(self.save_tasks)
        load_action.triggered.connect(self.load_tasks)

    def add_task(self):
        text = self.input.text().strip()
        if text:
            self.list_widget.addItem(text)
            self.input.clear()

    def delete_task(self):
        for item in list(self.list_widget.selectedItems()):
            row = self.list_widget.row(item)
            self.list_widget.takeItem(row)

    def save_tasks(self):
        tasks = [self.list_widget.item(i).text() for i in range(self.list_widget.count())]
        path, _ = QFileDialog.getSaveFileName(self, "保存", filter="JSON Files (*.json)")
        if path:
            try:
                with open(path, "w", encoding="utf-8") as f:
                    json.dump(tasks, f, ensure_ascii=False, indent=2)
            except Exception as e:
                QMessageBox.warning(self, "エラー", f"保存に失敗しました: {e}")

    def load_tasks(self):
        path, _ = QFileDialog.getOpenFileName(self, "読み込み", filter="JSON Files (*.json)")
        if path:
            try:
                with open(path, "r", encoding="utf-8") as f:
                    tasks = json.load(f)
                self.list_widget.clear()
                for t in tasks:
                    self.list_widget.addItem(t)
            except Exception as e:
                QMessageBox.warning(self, "エラー", f"読み込みに失敗しました: {e}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    w = TodoMainWindow()
    w.show()
    sys.exit(app.exec())

# exercise3.py
import sys
import time
from PySide6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QLabel
from PySide6.QtCore import QThread, Signal

class Worker(QThread):
    finished_signal = Signal(str)

    def run(self):
        # 長時間処理の代わりに sleep を使う例
        time.sleep(3)
        # 処理完了を通知
        self.finished_signal.emit("バックグラウンド処理が完了しました")

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("演習3 - スレッド")
        layout = QVBoxLayout(self)
        self.label = QLabel("未実行")
        self.btn = QPushButton("処理開始")
        layout.addWidget(self.label)
        layout.addWidget(self.btn)
        self.btn.clicked.connect(self.start_work)

    def start_work(self):
        self.label.setText("処理中...")
        self.btn.setEnabled(False)
        self.worker = Worker()
        self.worker.finished_signal.connect(self.on_finished)
        self.worker.start()

    def on_finished(self, message):
        self.label.setText(message)
        self.btn.setEnabled(True)
        self.worker = None

if __name__ == "__main__":
    app = QApplication(sys.argv)
    w = MainWindow()
    w.show()
    sys.exit(app.exec())