初心者向け No.05

ToDoリストアプリ

タスクの追加・完了・削除ができるToDoリスト。Listboxウィジェットの使い方とデータ管理を学びます。

🎯 難易度: ★☆☆ 📦 ライブラリ: tkinter（標準ライブラリ） ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

タスクの追加・完了・削除ができるToDoリスト。Listboxウィジェットの使い方とデータ管理を学びます。

このアプリは管理カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★☆☆ です。

Pythonでは tkinter を使うことで、クロスプラットフォームなGUIアプリを簡単に作成できます。このアプリを通じて、ウィジェットの配置・イベント処理・データ管理など、GUI開発の実践的なスキルを習得できます。

ソースコードは完全な動作状態で提供しており、コピーしてそのまま実行できます。まずは実行して動作を確認し、その後コードを読んで仕組みを理解していきましょう。カスタマイズセクションでは機能拡張のアイデアも紹介しています。

GUIアプリ開発は、プログラミングの楽しさを実感できる最も効果的な学習方法のひとつです。アプリを作ることで、変数・関数・クラス・イベント処理など、プログラミングの重要な概念が自然と身についていきます。このアプリをきっかけに、オリジナルアプリの開発にも挑戦してみてください。

2. 機能一覧

ToDoリストアプリのメイン機能
直感的なGUIインターフェース
入力値のバリデーション
エラーハンドリング
結果の見やすい表示
キーボードショートカット対応

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows・Mac・Linux すべて対応

以下の環境で動作確認しています。

Python 3.10 以上
OS: Windows 10/11・macOS 12+・Ubuntu 20.04+

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

app05.py

import tkinter as tk
from tkinter import ttk, messagebox


class App05:
    """ToDoリストアプリ"""

    def __init__(self, root):
        self.root = root
        self.root.title("ToDoリストアプリ")
        self.root.geometry("500x520")
        self.root.configure(bg="#f8f9fc")
        self.tasks = []
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="ToDoリストアプリ",
                 font=("Noto Sans JP", 16, "bold"),
                 bg="#3776ab", fg="white").pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="タスクを追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))
        self.entry = ttk.Entry(input_frame, font=("Noto Sans JP", 12))
        self.entry.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=(0, 8))
        self.entry.bind("<Return>", lambda e: self.add_task())
        ttk.Button(input_frame, text="追加", command=self.add_task).pack(side=tk.LEFT)

        # リストエリア
        list_frame = ttk.LabelFrame(main_frame, text="タスク一覧", padding=10)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 10))
        self.listbox = tk.Listbox(list_frame, font=("Noto Sans JP", 11),
                                  selectmode=tk.SINGLE, activestyle="none",
                                  bg="white", relief=tk.FLAT, height=12)
        self.listbox.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        scrollbar = ttk.Scrollbar(list_frame, command=self.listbox.yview)
        self.listbox.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ボタンエリア
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(fill=tk.X)
        ttk.Button(btn_frame, text="完了/未完了", command=self.toggle_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="削除", command=self.delete_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="全て削除", command=self.clear_all).pack(side=tk.LEFT)

        self.status_label = tk.Label(main_frame, text="タスク: 0件",
                                     bg="#f8f9fc", fg="#666", font=("Noto Sans JP", 10))
        self.status_label.pack(anchor="e", pady=(8, 0))

    def add_task(self):
        text = self.entry.get().strip()
        if not text:
            return
        self.tasks.append({"text": text, "done": False})
        self.entry.delete(0, tk.END)
        self._refresh()

    def toggle_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        idx = sel[0]
        self.tasks[idx]["done"] = not self.tasks[idx]["done"]
        self._refresh()
        self.listbox.selection_set(idx)

    def delete_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        self.tasks.pop(sel[0])
        self._refresh()

    def clear_all(self):
        if messagebox.askyesno("確認", "全てのタスクを削除しますか？"):
            self.tasks.clear()
            self._refresh()

    def _refresh(self):
        self.listbox.delete(0, tk.END)
        for task in self.tasks:
            prefix = "✅ " if task["done"] else "⬜ "
            self.listbox.insert(tk.END, prefix + task["text"])
            if task["done"]:
                self.listbox.itemconfig(tk.END, fg="#aaa")
        done = sum(1 for t in self.tasks if t["done"])
        self.status_label.config(text=f"タスク: {len(self.tasks)}件（完了: {done}件）")


if __name__ == "__main__":
    root = tk.Tk()
    app = App05(root)
    root.mainloop()

5. コード解説

ToDoリストアプリのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

クラス設計とコンストラクタ

App05クラスにアプリの全機能をまとめています。__init__メソッドでウィンドウの基本設定を行い、_build_ui()でUI構築、process()でメイン処理を担当します。この分離により、各メソッドの責任が明確になりコードが読みやすくなります。

import tkinter as tk
from tkinter import ttk, messagebox


class App05:
    """ToDoリストアプリ"""

    def __init__(self, root):
        self.root = root
        self.root.title("ToDoリストアプリ")
        self.root.geometry("500x520")
        self.root.configure(bg="#f8f9fc")
        self.tasks = []
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="ToDoリストアプリ",
                 font=("Noto Sans JP", 16, "bold"),
                 bg="#3776ab", fg="white").pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="タスクを追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))
        self.entry = ttk.Entry(input_frame, font=("Noto Sans JP", 12))
        self.entry.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=(0, 8))
        self.entry.bind("<Return>", lambda e: self.add_task())
        ttk.Button(input_frame, text="追加", command=self.add_task).pack(side=tk.LEFT)

        # リストエリア
        list_frame = ttk.LabelFrame(main_frame, text="タスク一覧", padding=10)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 10))
        self.listbox = tk.Listbox(list_frame, font=("Noto Sans JP", 11),
                                  selectmode=tk.SINGLE, activestyle="none",
                                  bg="white", relief=tk.FLAT, height=12)
        self.listbox.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        scrollbar = ttk.Scrollbar(list_frame, command=self.listbox.yview)
        self.listbox.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ボタンエリア
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(fill=tk.X)
        ttk.Button(btn_frame, text="完了/未完了", command=self.toggle_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="削除", command=self.delete_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="全て削除", command=self.clear_all).pack(side=tk.LEFT)

        self.status_label = tk.Label(main_frame, text="タスク: 0件",
                                     bg="#f8f9fc", fg="#666", font=("Noto Sans JP", 10))
        self.status_label.pack(anchor="e", pady=(8, 0))

    def add_task(self):
        text = self.entry.get().strip()
        if not text:
            return
        self.tasks.append({"text": text, "done": False})
        self.entry.delete(0, tk.END)
        self._refresh()

    def toggle_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        idx = sel[0]
        self.tasks[idx]["done"] = not self.tasks[idx]["done"]
        self._refresh()
        self.listbox.selection_set(idx)

    def delete_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        self.tasks.pop(sel[0])
        self._refresh()

    def clear_all(self):
        if messagebox.askyesno("確認", "全てのタスクを削除しますか？"):
            self.tasks.clear()
            self._refresh()

    def _refresh(self):
        self.listbox.delete(0, tk.END)
        for task in self.tasks:
            prefix = "✅ " if task["done"] else "⬜ "
            self.listbox.insert(tk.END, prefix + task["text"])
            if task["done"]:
                self.listbox.itemconfig(tk.END, fg="#aaa")
        done = sum(1 for t in self.tasks if t["done"])
        self.status_label.config(text=f"タスク: {len(self.tasks)}件（完了: {done}件）")


if __name__ == "__main__":
    root = tk.Tk()
    app = App05(root)
    root.mainloop()

LabelFrameによるセクション分け

ttk.LabelFrame を使うことで、入力エリアと結果エリアを視覚的に分けられます。padding引数でフレーム内の余白を設定し、見やすいレイアウトを実現しています。

import tkinter as tk
from tkinter import ttk, messagebox


class App05:
    """ToDoリストアプリ"""

    def __init__(self, root):
        self.root = root
        self.root.title("ToDoリストアプリ")
        self.root.geometry("500x520")
        self.root.configure(bg="#f8f9fc")
        self.tasks = []
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="ToDoリストアプリ",
                 font=("Noto Sans JP", 16, "bold"),
                 bg="#3776ab", fg="white").pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="タスクを追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))
        self.entry = ttk.Entry(input_frame, font=("Noto Sans JP", 12))
        self.entry.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=(0, 8))
        self.entry.bind("<Return>", lambda e: self.add_task())
        ttk.Button(input_frame, text="追加", command=self.add_task).pack(side=tk.LEFT)

        # リストエリア
        list_frame = ttk.LabelFrame(main_frame, text="タスク一覧", padding=10)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 10))
        self.listbox = tk.Listbox(list_frame, font=("Noto Sans JP", 11),
                                  selectmode=tk.SINGLE, activestyle="none",
                                  bg="white", relief=tk.FLAT, height=12)
        self.listbox.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        scrollbar = ttk.Scrollbar(list_frame, command=self.listbox.yview)
        self.listbox.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ボタンエリア
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(fill=tk.X)
        ttk.Button(btn_frame, text="完了/未完了", command=self.toggle_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="削除", command=self.delete_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="全て削除", command=self.clear_all).pack(side=tk.LEFT)

        self.status_label = tk.Label(main_frame, text="タスク: 0件",
                                     bg="#f8f9fc", fg="#666", font=("Noto Sans JP", 10))
        self.status_label.pack(anchor="e", pady=(8, 0))

    def add_task(self):
        text = self.entry.get().strip()
        if not text:
            return
        self.tasks.append({"text": text, "done": False})
        self.entry.delete(0, tk.END)
        self._refresh()

    def toggle_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        idx = sel[0]
        self.tasks[idx]["done"] = not self.tasks[idx]["done"]
        self._refresh()
        self.listbox.selection_set(idx)

    def delete_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        self.tasks.pop(sel[0])
        self._refresh()

    def clear_all(self):
        if messagebox.askyesno("確認", "全てのタスクを削除しますか？"):
            self.tasks.clear()
            self._refresh()

    def _refresh(self):
        self.listbox.delete(0, tk.END)
        for task in self.tasks:
            prefix = "✅ " if task["done"] else "⬜ "
            self.listbox.insert(tk.END, prefix + task["text"])
            if task["done"]:
                self.listbox.itemconfig(tk.END, fg="#aaa")
        done = sum(1 for t in self.tasks if t["done"])
        self.status_label.config(text=f"タスク: {len(self.tasks)}件（完了: {done}件）")


if __name__ == "__main__":
    root = tk.Tk()
    app = App05(root)
    root.mainloop()

Entryウィジェットとイベントバインド

ttk.Entryで入力フィールドを作成します。bind('', ...)でEnterキー押下時に処理を実行できます。これにより、マウスを使わずキーボードだけで操作できるUXが実現できます。

import tkinter as tk
from tkinter import ttk, messagebox


class App05:
    """ToDoリストアプリ"""

    def __init__(self, root):
        self.root = root
        self.root.title("ToDoリストアプリ")
        self.root.geometry("500x520")
        self.root.configure(bg="#f8f9fc")
        self.tasks = []
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="ToDoリストアプリ",
                 font=("Noto Sans JP", 16, "bold"),
                 bg="#3776ab", fg="white").pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="タスクを追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))
        self.entry = ttk.Entry(input_frame, font=("Noto Sans JP", 12))
        self.entry.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=(0, 8))
        self.entry.bind("<Return>", lambda e: self.add_task())
        ttk.Button(input_frame, text="追加", command=self.add_task).pack(side=tk.LEFT)

        # リストエリア
        list_frame = ttk.LabelFrame(main_frame, text="タスク一覧", padding=10)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 10))
        self.listbox = tk.Listbox(list_frame, font=("Noto Sans JP", 11),
                                  selectmode=tk.SINGLE, activestyle="none",
                                  bg="white", relief=tk.FLAT, height=12)
        self.listbox.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        scrollbar = ttk.Scrollbar(list_frame, command=self.listbox.yview)
        self.listbox.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ボタンエリア
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(fill=tk.X)
        ttk.Button(btn_frame, text="完了/未完了", command=self.toggle_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="削除", command=self.delete_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="全て削除", command=self.clear_all).pack(side=tk.LEFT)

        self.status_label = tk.Label(main_frame, text="タスク: 0件",
                                     bg="#f8f9fc", fg="#666", font=("Noto Sans JP", 10))
        self.status_label.pack(anchor="e", pady=(8, 0))

    def add_task(self):
        text = self.entry.get().strip()
        if not text:
            return
        self.tasks.append({"text": text, "done": False})
        self.entry.delete(0, tk.END)
        self._refresh()

    def toggle_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        idx = sel[0]
        self.tasks[idx]["done"] = not self.tasks[idx]["done"]
        self._refresh()
        self.listbox.selection_set(idx)

    def delete_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        self.tasks.pop(sel[0])
        self._refresh()

    def clear_all(self):
        if messagebox.askyesno("確認", "全てのタスクを削除しますか？"):
            self.tasks.clear()
            self._refresh()

    def _refresh(self):
        self.listbox.delete(0, tk.END)
        for task in self.tasks:
            prefix = "✅ " if task["done"] else "⬜ "
            self.listbox.insert(tk.END, prefix + task["text"])
            if task["done"]:
                self.listbox.itemconfig(tk.END, fg="#aaa")
        done = sum(1 for t in self.tasks if t["done"])
        self.status_label.config(text=f"タスク: {len(self.tasks)}件（完了: {done}件）")


if __name__ == "__main__":
    root = tk.Tk()
    app = App05(root)
    root.mainloop()

Textウィジェットでの結果表示

結果表示にはtk.Textウィジェットを使います。state=tk.DISABLEDでユーザーが直接編集できないようにし、表示前にNORMALに切り替えてからinsert()で内容を更新します。

import tkinter as tk
from tkinter import ttk, messagebox


class App05:
    """ToDoリストアプリ"""

    def __init__(self, root):
        self.root = root
        self.root.title("ToDoリストアプリ")
        self.root.geometry("500x520")
        self.root.configure(bg="#f8f9fc")
        self.tasks = []
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="ToDoリストアプリ",
                 font=("Noto Sans JP", 16, "bold"),
                 bg="#3776ab", fg="white").pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="タスクを追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))
        self.entry = ttk.Entry(input_frame, font=("Noto Sans JP", 12))
        self.entry.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=(0, 8))
        self.entry.bind("<Return>", lambda e: self.add_task())
        ttk.Button(input_frame, text="追加", command=self.add_task).pack(side=tk.LEFT)

        # リストエリア
        list_frame = ttk.LabelFrame(main_frame, text="タスク一覧", padding=10)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 10))
        self.listbox = tk.Listbox(list_frame, font=("Noto Sans JP", 11),
                                  selectmode=tk.SINGLE, activestyle="none",
                                  bg="white", relief=tk.FLAT, height=12)
        self.listbox.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        scrollbar = ttk.Scrollbar(list_frame, command=self.listbox.yview)
        self.listbox.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ボタンエリア
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(fill=tk.X)
        ttk.Button(btn_frame, text="完了/未完了", command=self.toggle_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="削除", command=self.delete_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="全て削除", command=self.clear_all).pack(side=tk.LEFT)

        self.status_label = tk.Label(main_frame, text="タスク: 0件",
                                     bg="#f8f9fc", fg="#666", font=("Noto Sans JP", 10))
        self.status_label.pack(anchor="e", pady=(8, 0))

    def add_task(self):
        text = self.entry.get().strip()
        if not text:
            return
        self.tasks.append({"text": text, "done": False})
        self.entry.delete(0, tk.END)
        self._refresh()

    def toggle_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        idx = sel[0]
        self.tasks[idx]["done"] = not self.tasks[idx]["done"]
        self._refresh()
        self.listbox.selection_set(idx)

    def delete_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        self.tasks.pop(sel[0])
        self._refresh()

    def clear_all(self):
        if messagebox.askyesno("確認", "全てのタスクを削除しますか？"):
            self.tasks.clear()
            self._refresh()

    def _refresh(self):
        self.listbox.delete(0, tk.END)
        for task in self.tasks:
            prefix = "✅ " if task["done"] else "⬜ "
            self.listbox.insert(tk.END, prefix + task["text"])
            if task["done"]:
                self.listbox.itemconfig(tk.END, fg="#aaa")
        done = sum(1 for t in self.tasks if t["done"])
        self.status_label.config(text=f"タスク: {len(self.tasks)}件（完了: {done}件）")


if __name__ == "__main__":
    root = tk.Tk()
    app = App05(root)
    root.mainloop()

例外処理とmessagebox

try-except で ValueError と Exception を捕捉し、messagebox.showerror() でユーザーにわかりやすいエラーメッセージを表示します。入力バリデーションは必ず実装しましょう。

import tkinter as tk
from tkinter import ttk, messagebox


class App05:
    """ToDoリストアプリ"""

    def __init__(self, root):
        self.root = root
        self.root.title("ToDoリストアプリ")
        self.root.geometry("500x520")
        self.root.configure(bg="#f8f9fc")
        self.tasks = []
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="ToDoリストアプリ",
                 font=("Noto Sans JP", 16, "bold"),
                 bg="#3776ab", fg="white").pack()

        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=16)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="タスクを追加", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))
        self.entry = ttk.Entry(input_frame, font=("Noto Sans JP", 12))
        self.entry.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=(0, 8))
        self.entry.bind("<Return>", lambda e: self.add_task())
        ttk.Button(input_frame, text="追加", command=self.add_task).pack(side=tk.LEFT)

        # リストエリア
        list_frame = ttk.LabelFrame(main_frame, text="タスク一覧", padding=10)
        list_frame.pack(fill=tk.BOTH, expand=True, pady=(0, 10))
        self.listbox = tk.Listbox(list_frame, font=("Noto Sans JP", 11),
                                  selectmode=tk.SINGLE, activestyle="none",
                                  bg="white", relief=tk.FLAT, height=12)
        self.listbox.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        scrollbar = ttk.Scrollbar(list_frame, command=self.listbox.yview)
        self.listbox.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ボタンエリア
        btn_frame = tk.Frame(main_frame, bg="#f8f9fc")
        btn_frame.pack(fill=tk.X)
        ttk.Button(btn_frame, text="完了/未完了", command=self.toggle_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="削除", command=self.delete_task).pack(side=tk.LEFT, padx=(0, 8))
        ttk.Button(btn_frame, text="全て削除", command=self.clear_all).pack(side=tk.LEFT)

        self.status_label = tk.Label(main_frame, text="タスク: 0件",
                                     bg="#f8f9fc", fg="#666", font=("Noto Sans JP", 10))
        self.status_label.pack(anchor="e", pady=(8, 0))

    def add_task(self):
        text = self.entry.get().strip()
        if not text:
            return
        self.tasks.append({"text": text, "done": False})
        self.entry.delete(0, tk.END)
        self._refresh()

    def toggle_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        idx = sel[0]
        self.tasks[idx]["done"] = not self.tasks[idx]["done"]
        self._refresh()
        self.listbox.selection_set(idx)

    def delete_task(self):
        sel = self.listbox.curselection()
        if not sel:
            messagebox.showinfo("情報", "タスクを選択してください")
            return
        self.tasks.pop(sel[0])
        self._refresh()

    def clear_all(self):
        if messagebox.askyesno("確認", "全てのタスクを削除しますか？"):
            self.tasks.clear()
            self._refresh()

    def _refresh(self):
        self.listbox.delete(0, tk.END)
        for task in self.tasks:
            prefix = "✅ " if task["done"] else "⬜ "
            self.listbox.insert(tk.END, prefix + task["text"])
            if task["done"]:
                self.listbox.itemconfig(tk.END, fg="#aaa")
        done = sum(1 for t in self.tasks if t["done"])
        self.status_label.config(text=f"タスク: {len(self.tasks)}件（完了: {done}件）")


if __name__ == "__main__":
    root = tk.Tk()
    app = App05(root)
    root.mainloop()

6. ステップバイステップガイド

このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。

1

ファイルを作成する
新しいファイルを作成して app05.py と保存します。
2

クラスの骨格を作る
App05クラスを定義し、__init__とmainloop()の最小構成を作ります。
3

タイトルバーを作る
Frameを使ってカラーバー付きのタイトルエリアを作ります。
4

入力フォームを実装する
LabelFrameとEntryウィジェットで入力エリアを作ります。
5

処理ロジックを実装する
_calculate()メソッドに計算・処理ロジックを実装します。
6

結果表示を実装する
TextウィジェットかLabelに結果を表示する_show_result()を実装します。
7

エラー処理を追加する
try-exceptとmessageboxでエラーハンドリングを追加します。

7. カスタマイズアイデア

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。少しずつ機能を追加することで、Pythonのスキルが飛躍的に向上します。

💡 ダークモードを追加する

bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。

💡 データのエクスポート機能

計算結果をCSV・TXTファイルに保存するエクスポート機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。

💡 入力履歴機能

以前の入力値を覚えておいてComboboxのドロップダウンで再選択できる履歴機能を追加しましょう。

8. よくある問題と解決法

❌ 日本語フォントが表示されない

原因：システムに日本語フォントが見つからない場合があります。

解決法：font引数を省略するかシステムに合ったフォントを指定してください。

❌ ウィンドウのサイズが変更できない

原因：resizable(False, False)が設定されています。

解決法：resizable(True, True)に変更してください。

9. 練習問題

アプリの理解を深めるための練習問題です。難易度順に挑戦してみてください。

課題1：機能拡張
ToDoリストアプリに新しい機能を1つ追加してみましょう。どんな機能があると便利か考えてから実装してください。
課題2：UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしてみましょう。
課題3：保存機能の追加
入力値や計算結果をファイルに保存する機能を追加しましょう。jsonやcsvモジュールを使います。

🚀

次に挑戦するアプリ

このアプリをマスターしたら、次のNo.06に挑戦しましょう。

No.04 →No.06 → 初心者用GUIアプリ一覧に戻る