シンプルテキストエディタ

1. アプリ概要

ファイルの開く・保存・新規作成ができるテキストエディタ。メニューバーとファイルダイアログの実装を学びます。

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

このアプリは「ツール」カテゴリです。日々の作業を自動化する実用ツールは Python が最も得意とする領域です。短いコードで実用性のある成果物が作れる点が魅力です。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。

カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。

2. 機能一覧

• ループで生成するボタン群（それぞれ new_file()・open_file()・save_file() を実行）
• キー <KeyRelease> から _update_status() を実行
• マウス操作 <ButtonRelease> から _update_status() を実行
• キー <Control-n> から new_file() を実行
• キー <Control-o> から open_file() を実行
• キー <Control-s> から save_file() を実行
• filedialog.askopenfilename() によるファイル選択ダイアログ
• filedialog.asksaveasfilename() によるファイル選択ダイアログ
• messagebox.askyesno() によるダイアログ通知
• ウィンドウはタイトル「テキストエディタ - 無題」・サイズ 843x512 で起動

3. 事前準備・環境

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

• Python 3.10 以上
• OS: Windows 11（実機で起動・基本操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

4. 完全なソースコード

import tkinter as tk
from tkinter import ttk, messagebox, filedialog


class App08:
    """シンプルテキストエディタ"""

    def __init__(self, root):
        self.root = root
        self.root.title("テキストエディタ - 無題")
        self.root.geometry("843x512")
        self.root.minsize(843, 512)
        self.root.configure(bg="#f8f9fc")
        self.current_file = None
        self._build_ui()

    def _build_ui(self):
        # メニューバー
        menubar = tk.Menu(self.root)
        self.root.config(menu=menubar)

        file_menu = tk.Menu(menubar, tearoff=0)
        menubar.add_cascade(label="ファイル", menu=file_menu)
        file_menu.add_command(label="新規作成", accelerator="Ctrl+N", command=self.new_file)
        file_menu.add_command(label="開く...", accelerator="Ctrl+O", command=self.open_file)
        file_menu.add_command(label="上書き保存", accelerator="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.root.quit)

        edit_menu = tk.Menu(menubar, tearoff=0)
        menubar.add_cascade(label="編集", menu=edit_menu)
        edit_menu.add_command(label="元に戻す", accelerator="Ctrl+Z",
                              command=lambda: self.text.event_generate("<<Undo>>"))
        edit_menu.add_command(label="やり直し", accelerator="Ctrl+Y",
                              command=lambda: self.text.event_generate("<<Redo>>"))
        edit_menu.add_separator()
        edit_menu.add_command(label="全て選択", accelerator="Ctrl+A",
                              command=lambda: self.text.tag_add(tk.SEL, "1.0", tk.END))

        # ツールバー
        toolbar = tk.Frame(self.root, bg="#e8eaf0", pady=4)
        toolbar.pack(fill=tk.X)
        for label, cmd in [("新規", self.new_file), ("開く", self.open_file),
                           ("保存", self.save_file)]:
            ttk.Button(toolbar, text=label, command=cmd, width=6).pack(side=tk.LEFT, padx=2)

        # テキストエリア
        text_frame = tk.Frame(self.root)
        text_frame.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        self.text = tk.Text(text_frame, font=("Courier New", 12), wrap=tk.WORD,
                            undo=True, bg="white", fg="#111",
                            insertbackground="#3776ab", padx=8, pady=8)
        self.text.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        scrollbar = ttk.Scrollbar(text_frame, command=self.text.yview)
        self.text.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

        # ステータスバー
        self.status_var = tk.StringVar(value="行: 1  列: 1  文字数: 0")
        tk.Label(self.root, textvariable=self.status_var, anchor="w",
                 bg="#e8eaf0", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

        self.text.bind("<KeyRelease>", self._update_status)
        self.text.bind("<ButtonRelease>", self._update_status)

        # キーボードショートカット
        self.root.bind("<Control-n>", lambda e: self.new_file())
        self.root.bind("<Control-o>", lambda e: self.open_file())
        self.root.bind("<Control-s>", lambda e: self.save_file())

    def _update_status(self, event=None):
        pos = self.text.index(tk.INSERT)
        line, col = pos.split(".")
        chars = len(self.text.get("1.0", tk.END)) - 1
        self.status_var.set(f"行: {line}  列: {int(col)+1}  文字数: {chars}")

    def new_file(self):
        if self.text.get("1.0", tk.END).strip():
            if not messagebox.askyesno("確認", "変更を破棄して新規作成しますか？"):
                return
        self.text.delete("1.0", tk.END)
        self.current_file = None
        self.root.title("テキストエディタ - 無題")

    def open_file(self):
        path = filedialog.askopenfilename(
            filetypes=[("テキストファイル", "*.txt"), ("全てのファイル", "*.*")])
        if not path:
            return
        with open(path, encoding="utf-8") as f:
            content = f.read()
        self.text.delete("1.0", tk.END)
        self.text.insert("1.0", content)
        self.current_file = path
        self.root.title(f"テキストエディタ - {path}")

    def save_file(self):
        if self.current_file:
            with open(self.current_file, "w", encoding="utf-8") as f:
                f.write(self.text.get("1.0", tk.END))
        else:
            self.save_as()

    def save_as(self):
        path = filedialog.asksaveasfilename(
            defaultextension=".txt",
            filetypes=[("テキストファイル", "*.txt"), ("全てのファイル", "*.*")])
        if not path:
            return
        with open(path, "w", encoding="utf-8") as f:
            f.write(self.text.get("1.0", tk.END))
        self.current_file = path
        self.root.title(f"テキストエディタ - {path}")


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

5. コード解説

シンプルテキストエディタのコードを、実際に書かれている実装に沿って解説します。

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

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

1. 1
   ファイルを作成する

   新しいファイルを作成して app08.py と保存します。使うのは tkinter だけなので、追加インストールは不要です。

2. 2
   クラスの骨格を作る

   App08 クラスを定義し、__init__ と、末尾の root = tk.Tk() ～ mainloop() の最小構成を書いて、まず空のウィンドウが出ることを確認します。

3. 3
   ウィンドウを設定する

   title("テキストエディタ - 無題")・geometry("843x512")・configure(bg="#f8f9fc")・minsize(843, 512) をコンストラクタで設定します。

4. 4
   画面部品を並べる

   _build_ui() の中で、tk.Menu×3・tk.Frame×2・ttk.Button（ループで生成）・tk.Text・ttk.Scrollbar・tk.Label を作って配置します（掲載コードと同じ並び順で書くとレイアウトが一致します）。まず表示だけ確認しましょう。

5. 5
   イベントを接続する

   ループ生成のボタンは、ラベルと処理（new_file()・open_file()・save_file()）をペアで並べたデータをループで回し、command= に渡して接続します。bind("<KeyRelease>", ...)・bind("<ButtonRelease>", ...)・bind("<Control-n>", ...)・bind("<Control-o>", ...)・bind("<Control-s>", ...) の登録も忘れずに。

6. 6
   中心になるメソッドを実装する

   アプリの本体である open_file()（11行）・new_file()（7行）・save_file()（6行）・_update_status()（5行） を実装します。

7. 7
   動作確認する

   python app08.py で起動し、各ボタンが反応すること・キー操作（<KeyRelease>・<Control-n>・<Control-o>・<Control-s>）が効くこと・マウス操作（クリック・ホイールなど）が効くことを確認します。

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

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

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

9. 練習問題

アプリの理解を深めるための練習問題です。気になるものから挑戦してみてください（課題3は定型の発展課題です）。

1. 課題1：ステータスバーに総行数を足す

   ステータスバーの「行 / 列 / 文字数」に「総行数」を追加します。文字を打つたびに数値が変わるようにしてください。

   期待結果：「abc」「def」「ghi」と3行入力すると、ステータスバーが 行: 3 列: 4 文字数: 11 総行数: 3 になる。全部消すと 総行数: 1 に戻る。

   合格条件

   • キーを離すたびに総行数が変わる（ボタンを押さなくても更新される）
   • 改行を1つ消すと総行数が1つ減る
   • 何も入力していない状態で「総行数: 1」（0 ではない）

   ヒント①（どこを触るか）: 表示文字列を組み立てているのは _update_status() の self.status_var.set(f"…") です。あわせて _build_ui() の初期値 tk.StringVar(value="行: 1 列: 1 文字数: 0") も直してください（__init__() は _update_status() を呼ばないので、最初のキー入力まではこの初期値が表示されます）。
   ヒント②（使うもの）: 最終行の行番号は self.text.index("end-1c") が返す「行.列」の左側。split(".") で取り出して int() にします。
   つまずきやすい点: self.text.get("1.0", tk.END) の末尾には必ず改行が1つ余分に付きます（文字数の計算が - 1 している理由）。split("\n") の要素数で行を数えると常に1行多くなります。

2. 課題2：未保存の変更をタイトルバーに「*」で示す

   本文を編集したらウィンドウタイトルの末尾に「*」を付け、保存・新規作成・ファイルを開いた直後は消えるようにします。

   期待結果：起動直後は「テキストエディタ - 無題」。1文字打つと「テキストエディタ - 無題 *」に変わり、Ctrl+S で保存すると「*」が消える。

   合格条件

   • 保存したあとにもう一度編集すると「*」がまた付く
   • 「開く」で読み込んだ直後は「*」が付かない
   • タイトルのファイル名部分（self.current_file の表示）は今までどおり

   ヒント①（どこを触るか）: 編集の検知は _build_ui() で bind をまとめている箇所に1行足します。タイトルを戻すのは new_file() / open_file() / save_file() / save_as() の4つです。
   ヒント②（使うもの）: Text ウィジェットは変更フラグを持っていて、self.text.edit_modified() で状態を読み、self.text.edit_modified(False) で戻せます。イベント名は仮想イベントの <<Modified>> です。
   つまずきやすい点: edit_modified(False) を呼ぶと <<Modified>> がもう一度発火します（Python 3.12 / Tk 8.6 で確認したところ、1文字の入力でハンドラが2回呼ばれました）。2回目で何もしない書き方にしておかないと処理が往復します。

3. 課題3：新しいボタンを追加する

   既存のボタンと同じ書き方で新しいボタンを1つ足し、押されたときに動くメソッドを自作してみましょう。ボタンの作成と command= の接続がセットで身に付きます。