初心者向け No.42
家計簿アプリ
収入・支出を記録して残高を管理するシンプルな家計簿。Treeviewウィジェットの実装を学びます。
📋 目次
1. アプリ概要
収入・支出を記録して残高を管理するシンプルな家計簿。Treeviewウィジェットの実装を学びます。
このアプリは管理カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★★☆ です。
Pythonでは tkinter を使うことで、クロスプラットフォームなGUIアプリを簡単に作成できます。このアプリを通じて、ウィジェットの配置・イベント処理・データ管理など、GUI開発の実践的なスキルを習得できます。
ソースコードは完全な動作状態で提供しており、コピーしてそのまま実行できます。まずは実行して動作を確認し、その後コードを読んで仕組みを理解していきましょう。カスタマイズセクションでは機能拡張のアイデアも紹介しています。
GUIアプリ開発は、プログラミングの楽しさを実感できる最も効果的な学習方法のひとつです。アプリを作ることで、変数・関数・クラス・イベント処理など、プログラミングの重要な概念が自然と身についていきます。このアプリをきっかけに、オリジナルアプリの開発にも挑戦してみてください。
2. 機能一覧
- 家計簿アプリのメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- キーボードショートカット対応
3. 事前準備・環境
動作確認環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
コードのコピー方法
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
app42.py
import tkinter as tk
from tkinter import ttk, messagebox
from datetime import date
class App42:
"""家計簿アプリ"""
def __init__(self, root):
self.root = root
self.root.title("家計簿アプリ")
self.root.geometry("580x500")
self.root.configure(bg="#f8f9fc")
self.records = []
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="家計簿アプリ",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
main_frame.pack(fill=tk.BOTH, expand=True)
# 入力
add_frame = ttk.LabelFrame(main_frame, text="記録を追加", padding=10)
add_frame.pack(fill=tk.X, pady=(0, 10))
for row, (label, attr, default) in enumerate([
("日付:", "date_entry", str(date.today())),
("内容:", "desc_entry", ""),
("金額 (円):", "amount_entry", ""),
]):
tk.Label(add_frame, text=label, width=10, anchor="w").grid(
row=row, column=0, sticky="w", pady=3)
entry = ttk.Entry(add_frame, font=("Noto Sans JP", 11), width=18)
entry.insert(0, default)
entry.grid(row=row, column=1, padx=6, sticky="ew")
setattr(self, attr, entry)
tk.Label(add_frame, text="種別:").grid(row=0, column=2, sticky="w", padx=(12, 0))
self.type_var = tk.StringVar(value="支出")
ttk.Combobox(add_frame, textvariable=self.type_var,
values=["収入", "支出"], state="readonly", width=8).grid(
row=0, column=3, padx=6)
ttk.Button(add_frame, text="追加", command=self.add_record).grid(
row=1, column=2, columnspan=2, padx=6, pady=3, sticky="ew")
add_frame.columnconfigure(1, weight=1)
# 残高表示
balance_frame = tk.Frame(main_frame, bg="#f8f9fc")
balance_frame.pack(fill=tk.X, pady=(0, 8))
for col, (label, attr, color) in enumerate([
("収入合計", "income_lbl", "#27ae60"),
("支出合計", "expense_lbl", "#e74c3c"),
("残高", "balance_lbl", "#3776ab"),
]):
box = tk.Frame(balance_frame, bg="white", relief=tk.SOLID, bd=1, padx=12, pady=8)
box.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=4)
tk.Label(box, text=label, bg="white", fg="#888", font=("Noto Sans JP", 9)).pack()
lbl = tk.Label(box, text="¥0", bg="white", fg=color,
font=("Noto Sans JP", 14, "bold"))
lbl.pack()
setattr(self, attr, lbl)
# 一覧
list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=8)
list_frame.pack(fill=tk.BOTH, expand=True)
cols = ("日付", "内容", "種別", "金額")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=8)
for col, w in zip(cols, [90, 180, 60, 100]):
self.tree.heading(col, text=col)
self.tree.column(col, width=w, anchor="w" if col != "金額" else "e")
self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
ttk.Button(main_frame, text="選択削除", command=self.delete_record).pack(
anchor="e", pady=(4, 0))
def add_record(self):
date_str = self.date_entry.get().strip()
desc = self.desc_entry.get().strip()
amount_str = self.amount_entry.get().strip()
kind = self.type_var.get()
if not desc or not amount_str:
messagebox.showwarning("警告", "内容と金額を入力してください")
return
try:
amount = int(amount_str.replace(",", ""))
except ValueError:
messagebox.showerror("エラー", "金額は整数で入力してください")
return
record = {"date": date_str, "desc": desc, "kind": kind, "amount": amount}
self.records.append(record)
self.amount_entry.delete(0, tk.END)
self.desc_entry.delete(0, tk.END)
self._refresh()
def _refresh(self):
for item in self.tree.get_children():
self.tree.delete(item)
income = expense = 0
for r in self.records:
sign = "+" if r["kind"] == "収入" else "-"
tag = "income" if r["kind"] == "収入" else "expense"
self.tree.insert("", tk.END,
values=(r["date"], r["desc"], r["kind"],
f"{sign}¥{r['amount']:,}"),
tags=(tag,))
if r["kind"] == "収入":
income += r["amount"]
else:
expense += r["amount"]
self.tree.tag_configure("income", foreground="#27ae60")
self.tree.tag_configure("expense", foreground="#e74c3c")
balance = income - expense
self.income_lbl.config(text=f"¥{income:,}")
self.expense_lbl.config(text=f"¥{expense:,}")
self.balance_lbl.config(text=f"¥{balance:,}",
fg="#3776ab" if balance >= 0 else "#e74c3c")
def delete_record(self):
sel = self.tree.selection()
if not sel:
return
idx = self.tree.index(sel[0])
self.records.pop(idx)
self._refresh()
if __name__ == "__main__":
root = tk.Tk()
app = App42(root)
root.mainloop()
5. コード解説
家計簿アプリのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App42クラスにアプリの全機能をまとめています。__init__メソッドでウィンドウの基本設定を行い、_build_ui()でUI構築、process()でメイン処理を担当します。この分離により、各メソッドの責任が明確になりコードが読みやすくなります。
import tkinter as tk
from tkinter import ttk, messagebox
from datetime import date
class App42:
"""家計簿アプリ"""
def __init__(self, root):
self.root = root
self.root.title("家計簿アプリ")
self.root.geometry("580x500")
self.root.configure(bg="#f8f9fc")
self.records = []
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="家計簿アプリ",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
main_frame.pack(fill=tk.BOTH, expand=True)
# 入力
add_frame = ttk.LabelFrame(main_frame, text="記録を追加", padding=10)
add_frame.pack(fill=tk.X, pady=(0, 10))
for row, (label, attr, default) in enumerate([
("日付:", "date_entry", str(date.today())),
("内容:", "desc_entry", ""),
("金額 (円):", "amount_entry", ""),
]):
tk.Label(add_frame, text=label, width=10, anchor="w").grid(
row=row, column=0, sticky="w", pady=3)
entry = ttk.Entry(add_frame, font=("Noto Sans JP", 11), width=18)
entry.insert(0, default)
entry.grid(row=row, column=1, padx=6, sticky="ew")
setattr(self, attr, entry)
tk.Label(add_frame, text="種別:").grid(row=0, column=2, sticky="w", padx=(12, 0))
self.type_var = tk.StringVar(value="支出")
ttk.Combobox(add_frame, textvariable=self.type_var,
values=["収入", "支出"], state="readonly", width=8).grid(
row=0, column=3, padx=6)
ttk.Button(add_frame, text="追加", command=self.add_record).grid(
row=1, column=2, columnspan=2, padx=6, pady=3, sticky="ew")
add_frame.columnconfigure(1, weight=1)
# 残高表示
balance_frame = tk.Frame(main_frame, bg="#f8f9fc")
balance_frame.pack(fill=tk.X, pady=(0, 8))
for col, (label, attr, color) in enumerate([
("収入合計", "income_lbl", "#27ae60"),
("支出合計", "expense_lbl", "#e74c3c"),
("残高", "balance_lbl", "#3776ab"),
]):
box = tk.Frame(balance_frame, bg="white", relief=tk.SOLID, bd=1, padx=12, pady=8)
box.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=4)
tk.Label(box, text=label, bg="white", fg="#888", font=("Noto Sans JP", 9)).pack()
lbl = tk.Label(box, text="¥0", bg="white", fg=color,
font=("Noto Sans JP", 14, "bold"))
lbl.pack()
setattr(self, attr, lbl)
# 一覧
list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=8)
list_frame.pack(fill=tk.BOTH, expand=True)
cols = ("日付", "内容", "種別", "金額")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=8)
for col, w in zip(cols, [90, 180, 60, 100]):
self.tree.heading(col, text=col)
self.tree.column(col, width=w, anchor="w" if col != "金額" else "e")
self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
ttk.Button(main_frame, text="選択削除", command=self.delete_record).pack(
anchor="e", pady=(4, 0))
def add_record(self):
date_str = self.date_entry.get().strip()
desc = self.desc_entry.get().strip()
amount_str = self.amount_entry.get().strip()
kind = self.type_var.get()
if not desc or not amount_str:
messagebox.showwarning("警告", "内容と金額を入力してください")
return
try:
amount = int(amount_str.replace(",", ""))
except ValueError:
messagebox.showerror("エラー", "金額は整数で入力してください")
return
record = {"date": date_str, "desc": desc, "kind": kind, "amount": amount}
self.records.append(record)
self.amount_entry.delete(0, tk.END)
self.desc_entry.delete(0, tk.END)
self._refresh()
def _refresh(self):
for item in self.tree.get_children():
self.tree.delete(item)
income = expense = 0
for r in self.records:
sign = "+" if r["kind"] == "収入" else "-"
tag = "income" if r["kind"] == "収入" else "expense"
self.tree.insert("", tk.END,
values=(r["date"], r["desc"], r["kind"],
f"{sign}¥{r['amount']:,}"),
tags=(tag,))
if r["kind"] == "収入":
income += r["amount"]
else:
expense += r["amount"]
self.tree.tag_configure("income", foreground="#27ae60")
self.tree.tag_configure("expense", foreground="#e74c3c")
balance = income - expense
self.income_lbl.config(text=f"¥{income:,}")
self.expense_lbl.config(text=f"¥{expense:,}")
self.balance_lbl.config(text=f"¥{balance:,}",
fg="#3776ab" if balance >= 0 else "#e74c3c")
def delete_record(self):
sel = self.tree.selection()
if not sel:
return
idx = self.tree.index(sel[0])
self.records.pop(idx)
self._refresh()
if __name__ == "__main__":
root = tk.Tk()
app = App42(root)
root.mainloop()
LabelFrameによるセクション分け
ttk.LabelFrame を使うことで、入力エリアと結果エリアを視覚的に分けられます。padding引数でフレーム内の余白を設定し、見やすいレイアウトを実現しています。
import tkinter as tk
from tkinter import ttk, messagebox
from datetime import date
class App42:
"""家計簿アプリ"""
def __init__(self, root):
self.root = root
self.root.title("家計簿アプリ")
self.root.geometry("580x500")
self.root.configure(bg="#f8f9fc")
self.records = []
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="家計簿アプリ",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
main_frame.pack(fill=tk.BOTH, expand=True)
# 入力
add_frame = ttk.LabelFrame(main_frame, text="記録を追加", padding=10)
add_frame.pack(fill=tk.X, pady=(0, 10))
for row, (label, attr, default) in enumerate([
("日付:", "date_entry", str(date.today())),
("内容:", "desc_entry", ""),
("金額 (円):", "amount_entry", ""),
]):
tk.Label(add_frame, text=label, width=10, anchor="w").grid(
row=row, column=0, sticky="w", pady=3)
entry = ttk.Entry(add_frame, font=("Noto Sans JP", 11), width=18)
entry.insert(0, default)
entry.grid(row=row, column=1, padx=6, sticky="ew")
setattr(self, attr, entry)
tk.Label(add_frame, text="種別:").grid(row=0, column=2, sticky="w", padx=(12, 0))
self.type_var = tk.StringVar(value="支出")
ttk.Combobox(add_frame, textvariable=self.type_var,
values=["収入", "支出"], state="readonly", width=8).grid(
row=0, column=3, padx=6)
ttk.Button(add_frame, text="追加", command=self.add_record).grid(
row=1, column=2, columnspan=2, padx=6, pady=3, sticky="ew")
add_frame.columnconfigure(1, weight=1)
# 残高表示
balance_frame = tk.Frame(main_frame, bg="#f8f9fc")
balance_frame.pack(fill=tk.X, pady=(0, 8))
for col, (label, attr, color) in enumerate([
("収入合計", "income_lbl", "#27ae60"),
("支出合計", "expense_lbl", "#e74c3c"),
("残高", "balance_lbl", "#3776ab"),
]):
box = tk.Frame(balance_frame, bg="white", relief=tk.SOLID, bd=1, padx=12, pady=8)
box.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=4)
tk.Label(box, text=label, bg="white", fg="#888", font=("Noto Sans JP", 9)).pack()
lbl = tk.Label(box, text="¥0", bg="white", fg=color,
font=("Noto Sans JP", 14, "bold"))
lbl.pack()
setattr(self, attr, lbl)
# 一覧
list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=8)
list_frame.pack(fill=tk.BOTH, expand=True)
cols = ("日付", "内容", "種別", "金額")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=8)
for col, w in zip(cols, [90, 180, 60, 100]):
self.tree.heading(col, text=col)
self.tree.column(col, width=w, anchor="w" if col != "金額" else "e")
self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
ttk.Button(main_frame, text="選択削除", command=self.delete_record).pack(
anchor="e", pady=(4, 0))
def add_record(self):
date_str = self.date_entry.get().strip()
desc = self.desc_entry.get().strip()
amount_str = self.amount_entry.get().strip()
kind = self.type_var.get()
if not desc or not amount_str:
messagebox.showwarning("警告", "内容と金額を入力してください")
return
try:
amount = int(amount_str.replace(",", ""))
except ValueError:
messagebox.showerror("エラー", "金額は整数で入力してください")
return
record = {"date": date_str, "desc": desc, "kind": kind, "amount": amount}
self.records.append(record)
self.amount_entry.delete(0, tk.END)
self.desc_entry.delete(0, tk.END)
self._refresh()
def _refresh(self):
for item in self.tree.get_children():
self.tree.delete(item)
income = expense = 0
for r in self.records:
sign = "+" if r["kind"] == "収入" else "-"
tag = "income" if r["kind"] == "収入" else "expense"
self.tree.insert("", tk.END,
values=(r["date"], r["desc"], r["kind"],
f"{sign}¥{r['amount']:,}"),
tags=(tag,))
if r["kind"] == "収入":
income += r["amount"]
else:
expense += r["amount"]
self.tree.tag_configure("income", foreground="#27ae60")
self.tree.tag_configure("expense", foreground="#e74c3c")
balance = income - expense
self.income_lbl.config(text=f"¥{income:,}")
self.expense_lbl.config(text=f"¥{expense:,}")
self.balance_lbl.config(text=f"¥{balance:,}",
fg="#3776ab" if balance >= 0 else "#e74c3c")
def delete_record(self):
sel = self.tree.selection()
if not sel:
return
idx = self.tree.index(sel[0])
self.records.pop(idx)
self._refresh()
if __name__ == "__main__":
root = tk.Tk()
app = App42(root)
root.mainloop()
Entryウィジェットとイベントバインド
ttk.Entryで入力フィールドを作成します。bind('
import tkinter as tk
from tkinter import ttk, messagebox
from datetime import date
class App42:
"""家計簿アプリ"""
def __init__(self, root):
self.root = root
self.root.title("家計簿アプリ")
self.root.geometry("580x500")
self.root.configure(bg="#f8f9fc")
self.records = []
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="家計簿アプリ",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
main_frame.pack(fill=tk.BOTH, expand=True)
# 入力
add_frame = ttk.LabelFrame(main_frame, text="記録を追加", padding=10)
add_frame.pack(fill=tk.X, pady=(0, 10))
for row, (label, attr, default) in enumerate([
("日付:", "date_entry", str(date.today())),
("内容:", "desc_entry", ""),
("金額 (円):", "amount_entry", ""),
]):
tk.Label(add_frame, text=label, width=10, anchor="w").grid(
row=row, column=0, sticky="w", pady=3)
entry = ttk.Entry(add_frame, font=("Noto Sans JP", 11), width=18)
entry.insert(0, default)
entry.grid(row=row, column=1, padx=6, sticky="ew")
setattr(self, attr, entry)
tk.Label(add_frame, text="種別:").grid(row=0, column=2, sticky="w", padx=(12, 0))
self.type_var = tk.StringVar(value="支出")
ttk.Combobox(add_frame, textvariable=self.type_var,
values=["収入", "支出"], state="readonly", width=8).grid(
row=0, column=3, padx=6)
ttk.Button(add_frame, text="追加", command=self.add_record).grid(
row=1, column=2, columnspan=2, padx=6, pady=3, sticky="ew")
add_frame.columnconfigure(1, weight=1)
# 残高表示
balance_frame = tk.Frame(main_frame, bg="#f8f9fc")
balance_frame.pack(fill=tk.X, pady=(0, 8))
for col, (label, attr, color) in enumerate([
("収入合計", "income_lbl", "#27ae60"),
("支出合計", "expense_lbl", "#e74c3c"),
("残高", "balance_lbl", "#3776ab"),
]):
box = tk.Frame(balance_frame, bg="white", relief=tk.SOLID, bd=1, padx=12, pady=8)
box.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=4)
tk.Label(box, text=label, bg="white", fg="#888", font=("Noto Sans JP", 9)).pack()
lbl = tk.Label(box, text="¥0", bg="white", fg=color,
font=("Noto Sans JP", 14, "bold"))
lbl.pack()
setattr(self, attr, lbl)
# 一覧
list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=8)
list_frame.pack(fill=tk.BOTH, expand=True)
cols = ("日付", "内容", "種別", "金額")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=8)
for col, w in zip(cols, [90, 180, 60, 100]):
self.tree.heading(col, text=col)
self.tree.column(col, width=w, anchor="w" if col != "金額" else "e")
self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
ttk.Button(main_frame, text="選択削除", command=self.delete_record).pack(
anchor="e", pady=(4, 0))
def add_record(self):
date_str = self.date_entry.get().strip()
desc = self.desc_entry.get().strip()
amount_str = self.amount_entry.get().strip()
kind = self.type_var.get()
if not desc or not amount_str:
messagebox.showwarning("警告", "内容と金額を入力してください")
return
try:
amount = int(amount_str.replace(",", ""))
except ValueError:
messagebox.showerror("エラー", "金額は整数で入力してください")
return
record = {"date": date_str, "desc": desc, "kind": kind, "amount": amount}
self.records.append(record)
self.amount_entry.delete(0, tk.END)
self.desc_entry.delete(0, tk.END)
self._refresh()
def _refresh(self):
for item in self.tree.get_children():
self.tree.delete(item)
income = expense = 0
for r in self.records:
sign = "+" if r["kind"] == "収入" else "-"
tag = "income" if r["kind"] == "収入" else "expense"
self.tree.insert("", tk.END,
values=(r["date"], r["desc"], r["kind"],
f"{sign}¥{r['amount']:,}"),
tags=(tag,))
if r["kind"] == "収入":
income += r["amount"]
else:
expense += r["amount"]
self.tree.tag_configure("income", foreground="#27ae60")
self.tree.tag_configure("expense", foreground="#e74c3c")
balance = income - expense
self.income_lbl.config(text=f"¥{income:,}")
self.expense_lbl.config(text=f"¥{expense:,}")
self.balance_lbl.config(text=f"¥{balance:,}",
fg="#3776ab" if balance >= 0 else "#e74c3c")
def delete_record(self):
sel = self.tree.selection()
if not sel:
return
idx = self.tree.index(sel[0])
self.records.pop(idx)
self._refresh()
if __name__ == "__main__":
root = tk.Tk()
app = App42(root)
root.mainloop()
Textウィジェットでの結果表示
結果表示にはtk.Textウィジェットを使います。state=tk.DISABLEDでユーザーが直接編集できないようにし、表示前にNORMALに切り替えてからinsert()で内容を更新します。
import tkinter as tk
from tkinter import ttk, messagebox
from datetime import date
class App42:
"""家計簿アプリ"""
def __init__(self, root):
self.root = root
self.root.title("家計簿アプリ")
self.root.geometry("580x500")
self.root.configure(bg="#f8f9fc")
self.records = []
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="家計簿アプリ",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
main_frame.pack(fill=tk.BOTH, expand=True)
# 入力
add_frame = ttk.LabelFrame(main_frame, text="記録を追加", padding=10)
add_frame.pack(fill=tk.X, pady=(0, 10))
for row, (label, attr, default) in enumerate([
("日付:", "date_entry", str(date.today())),
("内容:", "desc_entry", ""),
("金額 (円):", "amount_entry", ""),
]):
tk.Label(add_frame, text=label, width=10, anchor="w").grid(
row=row, column=0, sticky="w", pady=3)
entry = ttk.Entry(add_frame, font=("Noto Sans JP", 11), width=18)
entry.insert(0, default)
entry.grid(row=row, column=1, padx=6, sticky="ew")
setattr(self, attr, entry)
tk.Label(add_frame, text="種別:").grid(row=0, column=2, sticky="w", padx=(12, 0))
self.type_var = tk.StringVar(value="支出")
ttk.Combobox(add_frame, textvariable=self.type_var,
values=["収入", "支出"], state="readonly", width=8).grid(
row=0, column=3, padx=6)
ttk.Button(add_frame, text="追加", command=self.add_record).grid(
row=1, column=2, columnspan=2, padx=6, pady=3, sticky="ew")
add_frame.columnconfigure(1, weight=1)
# 残高表示
balance_frame = tk.Frame(main_frame, bg="#f8f9fc")
balance_frame.pack(fill=tk.X, pady=(0, 8))
for col, (label, attr, color) in enumerate([
("収入合計", "income_lbl", "#27ae60"),
("支出合計", "expense_lbl", "#e74c3c"),
("残高", "balance_lbl", "#3776ab"),
]):
box = tk.Frame(balance_frame, bg="white", relief=tk.SOLID, bd=1, padx=12, pady=8)
box.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=4)
tk.Label(box, text=label, bg="white", fg="#888", font=("Noto Sans JP", 9)).pack()
lbl = tk.Label(box, text="¥0", bg="white", fg=color,
font=("Noto Sans JP", 14, "bold"))
lbl.pack()
setattr(self, attr, lbl)
# 一覧
list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=8)
list_frame.pack(fill=tk.BOTH, expand=True)
cols = ("日付", "内容", "種別", "金額")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=8)
for col, w in zip(cols, [90, 180, 60, 100]):
self.tree.heading(col, text=col)
self.tree.column(col, width=w, anchor="w" if col != "金額" else "e")
self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
ttk.Button(main_frame, text="選択削除", command=self.delete_record).pack(
anchor="e", pady=(4, 0))
def add_record(self):
date_str = self.date_entry.get().strip()
desc = self.desc_entry.get().strip()
amount_str = self.amount_entry.get().strip()
kind = self.type_var.get()
if not desc or not amount_str:
messagebox.showwarning("警告", "内容と金額を入力してください")
return
try:
amount = int(amount_str.replace(",", ""))
except ValueError:
messagebox.showerror("エラー", "金額は整数で入力してください")
return
record = {"date": date_str, "desc": desc, "kind": kind, "amount": amount}
self.records.append(record)
self.amount_entry.delete(0, tk.END)
self.desc_entry.delete(0, tk.END)
self._refresh()
def _refresh(self):
for item in self.tree.get_children():
self.tree.delete(item)
income = expense = 0
for r in self.records:
sign = "+" if r["kind"] == "収入" else "-"
tag = "income" if r["kind"] == "収入" else "expense"
self.tree.insert("", tk.END,
values=(r["date"], r["desc"], r["kind"],
f"{sign}¥{r['amount']:,}"),
tags=(tag,))
if r["kind"] == "収入":
income += r["amount"]
else:
expense += r["amount"]
self.tree.tag_configure("income", foreground="#27ae60")
self.tree.tag_configure("expense", foreground="#e74c3c")
balance = income - expense
self.income_lbl.config(text=f"¥{income:,}")
self.expense_lbl.config(text=f"¥{expense:,}")
self.balance_lbl.config(text=f"¥{balance:,}",
fg="#3776ab" if balance >= 0 else "#e74c3c")
def delete_record(self):
sel = self.tree.selection()
if not sel:
return
idx = self.tree.index(sel[0])
self.records.pop(idx)
self._refresh()
if __name__ == "__main__":
root = tk.Tk()
app = App42(root)
root.mainloop()
例外処理とmessagebox
try-except で ValueError と Exception を捕捉し、messagebox.showerror() でユーザーにわかりやすいエラーメッセージを表示します。入力バリデーションは必ず実装しましょう。
import tkinter as tk
from tkinter import ttk, messagebox
from datetime import date
class App42:
"""家計簿アプリ"""
def __init__(self, root):
self.root = root
self.root.title("家計簿アプリ")
self.root.geometry("580x500")
self.root.configure(bg="#f8f9fc")
self.records = []
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="家計簿アプリ",
font=("Noto Sans JP", 16, "bold"),
bg="#3776ab", fg="white").pack()
main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=16, pady=12)
main_frame.pack(fill=tk.BOTH, expand=True)
# 入力
add_frame = ttk.LabelFrame(main_frame, text="記録を追加", padding=10)
add_frame.pack(fill=tk.X, pady=(0, 10))
for row, (label, attr, default) in enumerate([
("日付:", "date_entry", str(date.today())),
("内容:", "desc_entry", ""),
("金額 (円):", "amount_entry", ""),
]):
tk.Label(add_frame, text=label, width=10, anchor="w").grid(
row=row, column=0, sticky="w", pady=3)
entry = ttk.Entry(add_frame, font=("Noto Sans JP", 11), width=18)
entry.insert(0, default)
entry.grid(row=row, column=1, padx=6, sticky="ew")
setattr(self, attr, entry)
tk.Label(add_frame, text="種別:").grid(row=0, column=2, sticky="w", padx=(12, 0))
self.type_var = tk.StringVar(value="支出")
ttk.Combobox(add_frame, textvariable=self.type_var,
values=["収入", "支出"], state="readonly", width=8).grid(
row=0, column=3, padx=6)
ttk.Button(add_frame, text="追加", command=self.add_record).grid(
row=1, column=2, columnspan=2, padx=6, pady=3, sticky="ew")
add_frame.columnconfigure(1, weight=1)
# 残高表示
balance_frame = tk.Frame(main_frame, bg="#f8f9fc")
balance_frame.pack(fill=tk.X, pady=(0, 8))
for col, (label, attr, color) in enumerate([
("収入合計", "income_lbl", "#27ae60"),
("支出合計", "expense_lbl", "#e74c3c"),
("残高", "balance_lbl", "#3776ab"),
]):
box = tk.Frame(balance_frame, bg="white", relief=tk.SOLID, bd=1, padx=12, pady=8)
box.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=4)
tk.Label(box, text=label, bg="white", fg="#888", font=("Noto Sans JP", 9)).pack()
lbl = tk.Label(box, text="¥0", bg="white", fg=color,
font=("Noto Sans JP", 14, "bold"))
lbl.pack()
setattr(self, attr, lbl)
# 一覧
list_frame = ttk.LabelFrame(main_frame, text="記録一覧", padding=8)
list_frame.pack(fill=tk.BOTH, expand=True)
cols = ("日付", "内容", "種別", "金額")
self.tree = ttk.Treeview(list_frame, columns=cols, show="headings", height=8)
for col, w in zip(cols, [90, 180, 60, 100]):
self.tree.heading(col, text=col)
self.tree.column(col, width=w, anchor="w" if col != "金額" else "e")
self.tree.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
self.tree.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
ttk.Button(main_frame, text="選択削除", command=self.delete_record).pack(
anchor="e", pady=(4, 0))
def add_record(self):
date_str = self.date_entry.get().strip()
desc = self.desc_entry.get().strip()
amount_str = self.amount_entry.get().strip()
kind = self.type_var.get()
if not desc or not amount_str:
messagebox.showwarning("警告", "内容と金額を入力してください")
return
try:
amount = int(amount_str.replace(",", ""))
except ValueError:
messagebox.showerror("エラー", "金額は整数で入力してください")
return
record = {"date": date_str, "desc": desc, "kind": kind, "amount": amount}
self.records.append(record)
self.amount_entry.delete(0, tk.END)
self.desc_entry.delete(0, tk.END)
self._refresh()
def _refresh(self):
for item in self.tree.get_children():
self.tree.delete(item)
income = expense = 0
for r in self.records:
sign = "+" if r["kind"] == "収入" else "-"
tag = "income" if r["kind"] == "収入" else "expense"
self.tree.insert("", tk.END,
values=(r["date"], r["desc"], r["kind"],
f"{sign}¥{r['amount']:,}"),
tags=(tag,))
if r["kind"] == "収入":
income += r["amount"]
else:
expense += r["amount"]
self.tree.tag_configure("income", foreground="#27ae60")
self.tree.tag_configure("expense", foreground="#e74c3c")
balance = income - expense
self.income_lbl.config(text=f"¥{income:,}")
self.expense_lbl.config(text=f"¥{expense:,}")
self.balance_lbl.config(text=f"¥{balance:,}",
fg="#3776ab" if balance >= 0 else "#e74c3c")
def delete_record(self):
sel = self.tree.selection()
if not sel:
return
idx = self.tree.index(sel[0])
self.records.pop(idx)
self._refresh()
if __name__ == "__main__":
root = tk.Tk()
app = App42(root)
root.mainloop()
6. ステップバイステップガイド
このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。
-
1ファイルを作成する
新しいファイルを作成して app42.py と保存します。
-
2クラスの骨格を作る
App42クラスを定義し、__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：機能拡張
家計簿アプリに新しい機能を1つ追加してみましょう。どんな機能があると便利か考えてから実装してください。
-
課題2：UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしてみましょう。
-
課題3：保存機能の追加
入力値や計算結果をファイルに保存する機能を追加しましょう。jsonやcsvモジュールを使います。