簡易メモ帳
テキストの作成・保存・読み込みができるメモ帳。ファイルダイアログとTextウィジェットの使い方を学べる。
1. アプリ概要
テキストの作成・保存・読み込みができるメモ帳。ファイルダイアログとTextウィジェットの使い方を学べる。
このアプリはorganizersカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★☆ です。
このアプリは「整理ツール」カテゴリです。整理・分類系のツールはデータ構造とユーザー操作を結びつける書き方を学ぶ好機です。設計次第で書きやすさが大きく変わります。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。
コピー＆実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。
アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。
2. 機能一覧
- 簡易メモ帳のメイン機能
- 直感的なGUIインターフェース
- 入力値のバリデーション
- エラーハンドリング
- 結果の見やすい表示
- クリア機能付き
3. 事前準備・環境
Python 3.10 以上 / Windows・Mac・Linux すべて対応
以下の環境で動作確認しています。
- Python 3.10 以上
- OS: Windows 10/11・macOS 12+・Ubuntu 20.04+
4. 完全なソースコード
右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。
import tkinter as tk
from tkinter import ttk, filedialog, messagebox
import os
class App055:
"""簡易メモ帳"""
def __init__(self, root):
self.root = root
self.root.title("簡易メモ帳 - 無題")
self.root.geometry("720x520")
self.current_path = None
self.dirty = False
self._build_ui()
self.root.protocol("WM_DELETE_WINDOW", self.on_close)
def _build_ui(self):
"""UIを構築する"""
# メニューバー
menubar = tk.Menu(self.root)
file_menu = tk.Menu(menubar, tearoff=0)
file_menu.add_command(label="新規 (Ctrl+N)", command=self.new_file)
file_menu.add_command(label="開く (Ctrl+O)", command=self.open_file)
file_menu.add_command(label="保存 (Ctrl+S)", command=self.save_file)
file_menu.add_command(label="名前を付けて保存", command=self.save_as)
file_menu.add_separator()
file_menu.add_command(label="終了", command=self.on_close)
menubar.add_cascade(label="ファイル", menu=file_menu)
edit_menu = tk.Menu(menubar, tearoff=0)
edit_menu.add_command(label="切り取り", command=lambda: self.text.event_generate("<<Cut>>"))
edit_menu.add_command(label="コピー", command=lambda: self.text.event_generate("<<Copy>>"))
edit_menu.add_command(label="貼り付け", command=lambda: self.text.event_generate("<<Paste>>"))
menubar.add_cascade(label="編集", menu=edit_menu)
self.root.config(menu=menubar)
# ツールバー
bar = tk.Frame(self.root)
bar.pack(fill=tk.X)
ttk.Button(bar, text="新規", command=self.new_file).pack(side=tk.LEFT, padx=2, pady=2)
ttk.Button(bar, text="開く", command=self.open_file).pack(side=tk.LEFT, padx=2)
ttk.Button(bar, text="保存", command=self.save_file).pack(side=tk.LEFT, padx=2)
ttk.Button(bar, text="名前を付けて保存", command=self.save_as).pack(side=tk.LEFT, padx=2)
# テキストエリア
text_frame = tk.Frame(self.root)
text_frame.pack(fill=tk.BOTH, expand=True)
self.text = tk.Text(text_frame, font=("Noto Sans JP", 12), undo=True, wrap="word")
self.text.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
sb = ttk.Scrollbar(text_frame, command=self.text.yview)
self.text.configure(yscrollcommand=sb.set)
sb.pack(side=tk.RIGHT, fill=tk.Y)
self.text.bind("<<Modified>>", self._on_modified)
# ステータスバー
self.status = tk.Label(self.root, text="行: 1 / 列: 1 / 文字数: 0", anchor="w", bd=1, relief=tk.SUNKEN)
self.status.pack(fill=tk.X, side=tk.BOTTOM)
self.text.bind("<KeyRelease>", self._update_status)
self.text.bind("<ButtonRelease>", self._update_status)
# ショートカット
self.root.bind_all("<Control-n>", lambda e: self.new_file())
self.root.bind_all("<Control-o>", lambda e: self.open_file())
self.root.bind_all("<Control-s>", lambda e: self.save_file())
def _on_modified(self, event=None):
"""変更フラグを更新"""
if self.text.edit_modified():
self.dirty = True
self._update_title()
self.text.edit_modified(False)
def _update_status(self, event=None):
"""ステータスバーを更新"""
idx = self.text.index(tk.INSERT)
line, col = idx.split(".")
chars = len(self.text.get("1.0", "end-1c"))
self.status.config(text=f"行: {line} / 列: {int(col)+1} / 文字数: {chars}")
def _update_title(self):
"""タイトル表示を更新"""
name = os.path.basename(self.current_path) if self.current_path else "無題"
mark = "*" if self.dirty else ""
self.root.title(f"簡易メモ帳 - {name}{mark}")
def _confirm_save(self):
"""未保存変更を確認"""
if not self.dirty:
return True
ans = messagebox.askyesnocancel("確認", "変更を保存しますか?")
if ans is None:
return False
if ans:
return self.save_file()
return True
def new_file(self):
"""新規作成"""
if not self._confirm_save():
return
self.text.delete("1.0", tk.END)
self.current_path = None
self.dirty = False
self._update_title()
self._update_status()
def open_file(self):
"""ファイルを開く"""
if not self._confirm_save():
return
path = filedialog.askopenfilename(filetypes=[("テキスト", "*.txt"), ("すべて", "*.*")])
if not path:
return
try:
with open(path, "r", encoding="utf-8") as f:
content = f.read()
except UnicodeDecodeError:
try:
with open(path, "r", encoding="cp932") as f:
content = f.read()
except Exception as e:
messagebox.showerror("エラー", f"読み込み失敗: {e}")
return
except Exception as e:
messagebox.showerror("エラー", f"読み込み失敗: {e}")
return
self.text.delete("1.0", tk.END)
self.text.insert("1.0", content)
self.current_path = path
self.dirty = False
self._update_title()
self._update_status()
def save_file(self):
"""上書き保存"""
if not self.current_path:
return self.save_as()
return self._save_to(self.current_path)
def save_as(self):
"""名前を付けて保存"""
path = filedialog.asksaveasfilename(defaultextension=".txt", filetypes=[("テキスト", "*.txt"), ("すべて", "*.*")])
if not path:
return False
return self._save_to(path)
def _save_to(self, path):
"""指定パスへ書き出し"""
try:
with open(path, "w", encoding="utf-8") as f:
f.write(self.text.get("1.0", "end-1c"))
self.current_path = path
self.dirty = False
self._update_title()
return True
except Exception as e:
messagebox.showerror("エラー", f"保存失敗: {e}")
return False
def on_close(self):
"""終了処理"""
if self._confirm_save():
self.root.destroy()
if __name__ == "__main__":
root = tk.Tk()
app = App055(root)
root.mainloop()
5. コード解説
簡易メモ帳のコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。
クラス設計とコンストラクタ
App055クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
UIレイアウトの構築
LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
イベント処理
ボタンのcommand引数でクリックイベントを、bind('
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
Textウィジェットでの結果表示
tk.Textウィジェットをstate=DISABLED（読み取り専用）で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
例外処理とエラーハンドリング
try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。
※ 該当部分のコード本体は 「4. 完全なソースコード」 をご参照ください（重複表示を避けるため再掲を省略しています）。
6. ステップバイステップガイド
このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。
-
1ファイルを作成する
新しいファイルを作成して app055.py と保存します。
-
2クラスの骨格を作る
App055クラスを定義し、__init__とmainloop()の最小構成を作ります。
-
3タイトルバーを作る
Frameを使ってカラーバー付きのタイトルエリアを作ります。
-
4入力フォームを実装する
LabelFrameとEntryウィジェットで入力エリアを作ります。
-
5処理ロジックを実装する
_execute()メソッドにメインロジックを実装します。
-
6結果表示を実装する
TextウィジェットかLabelに結果を表示する_show_result()を実装します。
-
7エラー処理を追加する
try-exceptとmessageboxでエラーハンドリングを追加します。
7. カスタマイズアイデア
基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。
💡 ダークモードを追加する
bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。
💡 データの保存機能
処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。
💡 設定ダイアログ
フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。
8. よくある問題と解決法
❌ 日本語フォントが表示されない
原因：システムに日本語フォントが見つからない場合があります。
解決法：font引数を省略するかシステムに合ったフォントを指定してください。
❌ ライブラリのインポートエラー
原因：必要なライブラリがインストールされていません。
解決法：pip install コマンドで必要なライブラリをインストールしてください。
❌ ウィンドウサイズが合わない
原因：画面解像度や表示スケールによって異なる場合があります。
解決法：root.geometry()で適切なサイズに調整してください。
9. 練習問題
アプリの理解を深めるための練習問題です。
-
課題1：機能拡張
簡易メモ帳に新しい機能を1つ追加してみましょう。
-
課題2：UIの改善
色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。
-
課題3：保存機能の追加
処理結果をファイルに保存する機能を追加しましょう。