中級者向け No.07

PDFビューアー

PDFファイルをページ単位で表示・ナビゲーションできるビューアー。PyMuPDF(fitz)ライブラリの活用を学びます。

🎯 難易度: ★★☆ 📦 ライブラリ: tkinter(標準ライブラリ), PyMuPDF, Pillow ⏱️ 制作時間: 30〜90分

1. アプリ概要

PDFファイルをページ単位で表示・ナビゲーションできるビューアー。PyMuPDF(fitz)ライブラリの活用を学びます。

このアプリは中級カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter(標準ライブラリ)・PyMuPDF・Pillow で、難易度は ★★☆ です。

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

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

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

2. 機能一覧

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

3. 事前準備・環境

ℹ️
動作確認環境

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

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

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

インストールが必要なライブラリ

pip install pillow

4. 完全なソースコード

💡
コードのコピー方法

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

app07.py
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os

try:
    import fitz  # PyMuPDF
    FITZ_AVAILABLE = True
except ImportError:
    FITZ_AVAILABLE = False

try:
    from PIL import Image, ImageTk
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False


class App07:
    """PDFビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self.root.geometry("860x700")
        self.root.configure(bg="#404040")
        self.doc = None
        self.current_page = 0
        self.total_pages = 0
        self.zoom = 1.5
        self.tk_images = []
        self._build_ui()

        if not FITZ_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "PyMuPDF が必要です。\n"
                "pip install pymupdf でインストールしてください。")
        elif not PIL_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "Pillow が必要です。\n"
                "pip install Pillow でインストールしてください。")

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#3c3f41", pady=6)
        toolbar.pack(fill=tk.X)
        tk.Label(toolbar, text="📄 PDFビューアー",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#3c3f41", fg="#a9b7c6").pack(side=tk.LEFT, padx=12)
        ttk.Button(toolbar, text="📂 開く",
                   command=self._open_pdf).pack(side=tk.LEFT, padx=4)

        # ページナビ
        nav_frame = tk.Frame(toolbar, bg="#3c3f41")
        nav_frame.pack(side=tk.LEFT, padx=16)
        ttk.Button(nav_frame, text="◀◀ 最初",
                   command=self._first_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="◀ 前",
                   command=self._prev_page).pack(side=tk.LEFT, padx=2)
        self.page_var = tk.StringVar(value="0")
        page_entry = ttk.Entry(nav_frame, textvariable=self.page_var,
                               width=5, font=("Arial", 11))
        page_entry.pack(side=tk.LEFT, padx=4)
        page_entry.bind("<Return>", self._jump_to_page)
        self.total_label = tk.Label(nav_frame, text="/ 0",
                                    bg="#3c3f41", fg="#a9b7c6",
                                    font=("Arial", 11))
        self.total_label.pack(side=tk.LEFT)
        ttk.Button(nav_frame, text="次 ▶",
                   command=self._next_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="最後 ▶▶",
                   command=self._last_page).pack(side=tk.LEFT, padx=2)

        # ズーム
        zoom_frame = tk.Frame(toolbar, bg="#3c3f41")
        zoom_frame.pack(side=tk.LEFT, padx=16)
        tk.Label(zoom_frame, text="ズーム:", bg="#3c3f41",
                 fg="#a9b7c6").pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="+",
                   command=self._zoom_in).pack(side=tk.LEFT, padx=2)
        self.zoom_label = tk.Label(zoom_frame, text="150%",
                                   bg="#3c3f41", fg="#a9b7c6",
                                   font=("Arial", 11), width=5)
        self.zoom_label.pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="-",
                   command=self._zoom_out).pack(side=tk.LEFT, padx=2)
        ttk.Button(zoom_frame, text="全幅",
                   command=self._fit_width).pack(side=tk.LEFT, padx=2)

        # キーバインド
        self.root.bind("<Left>", lambda e: self._prev_page())
        self.root.bind("<Right>", lambda e: self._next_page())
        self.root.bind("<Prior>", lambda e: self._prev_page())
        self.root.bind("<Next>", lambda e: self._next_page())

        # メインエリア: サムネイル + ページ表示
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True)

        # 左: サムネイルパネル
        thumb_frame = tk.Frame(paned, bg="#2b2b2b", width=120)
        thumb_label = tk.Label(thumb_frame, text="ページ一覧",
                               bg="#3c3f41", fg="#a9b7c6",
                               font=("Arial", 9))
        thumb_label.pack(fill=tk.X)
        self.thumb_canvas = tk.Canvas(thumb_frame, bg="#2b2b2b",
                                       width=120, highlightthickness=0)
        thumb_sb = ttk.Scrollbar(thumb_frame, command=self.thumb_canvas.yview)
        self.thumb_canvas.configure(yscrollcommand=thumb_sb.set)
        thumb_sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.thumb_canvas.pack(fill=tk.BOTH, expand=True)
        self.thumb_inner = tk.Frame(self.thumb_canvas, bg="#2b2b2b")
        self.thumb_canvas.create_window((0, 0), window=self.thumb_inner, anchor="nw")
        self.thumb_inner.bind("<Configure>",
                              lambda e: self.thumb_canvas.configure(
                                  scrollregion=self.thumb_canvas.bbox("all")))
        paned.add(thumb_frame, weight=0)

        # 右: ページキャンバス
        canvas_frame = tk.Frame(paned, bg="#525252")
        self.canvas = tk.Canvas(canvas_frame, bg="#525252",
                                highlightthickness=0)
        h_sb = ttk.Scrollbar(canvas_frame, orient=tk.HORIZONTAL,
                             command=self.canvas.xview)
        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL,
                             command=self.canvas.yview)
        self.canvas.configure(xscrollcommand=h_sb.set,
                              yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.canvas.pack(fill=tk.BOTH, expand=True)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
        paned.add(canvas_frame, weight=1)

        self.status_var = tk.StringVar(value="PDFファイルを開いてください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#3c3f41", fg="#888", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open_pdf(self):
        if not FITZ_AVAILABLE or not PIL_AVAILABLE:
            messagebox.showwarning("警告", "必要なライブラリをインストールしてください")
            return
        path = filedialog.askopenfilename(
            filetypes=[("PDFファイル", "*.pdf"), ("すべて", "*.*")])
        if path:
            try:
                self.doc = fitz.open(path)
                self.total_pages = len(self.doc)
                self.current_page = 0
                self.total_label.config(text=f"/ {self.total_pages}")
                self.root.title(f"PDFビューアー — {os.path.basename(path)}")
                self._build_thumbnails()
                self._render_page()
                self.status_var.set(
                    f"{os.path.basename(path)}  |  {self.total_pages} ページ")
            except Exception as e:
                messagebox.showerror("エラー", str(e))

    def _render_page(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        mat = fitz.Matrix(self.zoom, self.zoom)
        pix = page.get_pixmap(matrix=mat)
        img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
        tk_img = ImageTk.PhotoImage(img)
        self.tk_images = [tk_img]  # 参照保持
        self.canvas.delete("all")
        pad = 20
        self.canvas.create_rectangle(
            pad, pad, pix.width + pad + 4, pix.height + pad + 4,
            fill="#888", outline="")
        self.canvas.create_image(pad, pad, anchor="nw", image=tk_img)
        self.canvas.configure(
            scrollregion=(0, 0, pix.width + pad*2, pix.height + pad*2))
        self.page_var.set(str(self.current_page + 1))
        self.status_var.set(
            f"ページ {self.current_page+1} / {self.total_pages}  "
            f"ズーム {int(self.zoom*100)}%")

    def _build_thumbnails(self):
        for w in self.thumb_inner.winfo_children():
            w.destroy()
        self.thumb_tk_images = []
        for i in range(self.total_pages):
            page = self.doc[i]
            pix = page.get_pixmap(matrix=fitz.Matrix(0.15, 0.15))
            img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
            tk_img = ImageTk.PhotoImage(img)
            self.thumb_tk_images.append(tk_img)
            btn = tk.Button(self.thumb_inner, image=tk_img,
                            text=str(i+1), compound=tk.BOTTOM,
                            bg="#2b2b2b", fg="#ccc", relief=tk.FLAT,
                            command=lambda p=i: self._go_to(p))
            btn.pack(pady=2)

    def _go_to(self, page):
        if 0 <= page < self.total_pages:
            self.current_page = page
            self._render_page()

    def _first_page(self):
        self._go_to(0)

    def _last_page(self):
        self._go_to(self.total_pages - 1)

    def _prev_page(self):
        self._go_to(self.current_page - 1)

    def _next_page(self):
        self._go_to(self.current_page + 1)

    def _jump_to_page(self, event=None):
        try:
            p = int(self.page_var.get()) - 1
            self._go_to(p)
        except ValueError:
            pass

    def _zoom_in(self):
        self.zoom = min(4.0, self.zoom + 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _zoom_out(self):
        self.zoom = max(0.5, self.zoom - 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _fit_width(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        cw = self.canvas.winfo_width() or 600
        pw = page.rect.width
        self.zoom = (cw - 60) / pw
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _on_mousewheel(self, event):
        if event.state & 0x4:  # Ctrl
            if event.delta > 0:
                self._zoom_in()
            else:
                self._zoom_out()
        else:
            self.canvas.yview_scroll(-1 * (event.delta // 120), "units")


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

5. コード解説

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

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

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

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

try:
    import fitz  # PyMuPDF
    FITZ_AVAILABLE = True
except ImportError:
    FITZ_AVAILABLE = False

try:
    from PIL import Image, ImageTk
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False


class App07:
    """PDFビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self.root.geometry("860x700")
        self.root.configure(bg="#404040")
        self.doc = None
        self.current_page = 0
        self.total_pages = 0
        self.zoom = 1.5
        self.tk_images = []
        self._build_ui()

        if not FITZ_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "PyMuPDF が必要です。\n"
                "pip install pymupdf でインストールしてください。")
        elif not PIL_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "Pillow が必要です。\n"
                "pip install Pillow でインストールしてください。")

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#3c3f41", pady=6)
        toolbar.pack(fill=tk.X)
        tk.Label(toolbar, text="📄 PDFビューアー",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#3c3f41", fg="#a9b7c6").pack(side=tk.LEFT, padx=12)
        ttk.Button(toolbar, text="📂 開く",
                   command=self._open_pdf).pack(side=tk.LEFT, padx=4)

        # ページナビ
        nav_frame = tk.Frame(toolbar, bg="#3c3f41")
        nav_frame.pack(side=tk.LEFT, padx=16)
        ttk.Button(nav_frame, text="◀◀ 最初",
                   command=self._first_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="◀ 前",
                   command=self._prev_page).pack(side=tk.LEFT, padx=2)
        self.page_var = tk.StringVar(value="0")
        page_entry = ttk.Entry(nav_frame, textvariable=self.page_var,
                               width=5, font=("Arial", 11))
        page_entry.pack(side=tk.LEFT, padx=4)
        page_entry.bind("<Return>", self._jump_to_page)
        self.total_label = tk.Label(nav_frame, text="/ 0",
                                    bg="#3c3f41", fg="#a9b7c6",
                                    font=("Arial", 11))
        self.total_label.pack(side=tk.LEFT)
        ttk.Button(nav_frame, text="次 ▶",
                   command=self._next_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="最後 ▶▶",
                   command=self._last_page).pack(side=tk.LEFT, padx=2)

        # ズーム
        zoom_frame = tk.Frame(toolbar, bg="#3c3f41")
        zoom_frame.pack(side=tk.LEFT, padx=16)
        tk.Label(zoom_frame, text="ズーム:", bg="#3c3f41",
                 fg="#a9b7c6").pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="+",
                   command=self._zoom_in).pack(side=tk.LEFT, padx=2)
        self.zoom_label = tk.Label(zoom_frame, text="150%",
                                   bg="#3c3f41", fg="#a9b7c6",
                                   font=("Arial", 11), width=5)
        self.zoom_label.pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="-",
                   command=self._zoom_out).pack(side=tk.LEFT, padx=2)
        ttk.Button(zoom_frame, text="全幅",
                   command=self._fit_width).pack(side=tk.LEFT, padx=2)

        # キーバインド
        self.root.bind("<Left>", lambda e: self._prev_page())
        self.root.bind("<Right>", lambda e: self._next_page())
        self.root.bind("<Prior>", lambda e: self._prev_page())
        self.root.bind("<Next>", lambda e: self._next_page())

        # メインエリア: サムネイル + ページ表示
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True)

        # 左: サムネイルパネル
        thumb_frame = tk.Frame(paned, bg="#2b2b2b", width=120)
        thumb_label = tk.Label(thumb_frame, text="ページ一覧",
                               bg="#3c3f41", fg="#a9b7c6",
                               font=("Arial", 9))
        thumb_label.pack(fill=tk.X)
        self.thumb_canvas = tk.Canvas(thumb_frame, bg="#2b2b2b",
                                       width=120, highlightthickness=0)
        thumb_sb = ttk.Scrollbar(thumb_frame, command=self.thumb_canvas.yview)
        self.thumb_canvas.configure(yscrollcommand=thumb_sb.set)
        thumb_sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.thumb_canvas.pack(fill=tk.BOTH, expand=True)
        self.thumb_inner = tk.Frame(self.thumb_canvas, bg="#2b2b2b")
        self.thumb_canvas.create_window((0, 0), window=self.thumb_inner, anchor="nw")
        self.thumb_inner.bind("<Configure>",
                              lambda e: self.thumb_canvas.configure(
                                  scrollregion=self.thumb_canvas.bbox("all")))
        paned.add(thumb_frame, weight=0)

        # 右: ページキャンバス
        canvas_frame = tk.Frame(paned, bg="#525252")
        self.canvas = tk.Canvas(canvas_frame, bg="#525252",
                                highlightthickness=0)
        h_sb = ttk.Scrollbar(canvas_frame, orient=tk.HORIZONTAL,
                             command=self.canvas.xview)
        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL,
                             command=self.canvas.yview)
        self.canvas.configure(xscrollcommand=h_sb.set,
                              yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.canvas.pack(fill=tk.BOTH, expand=True)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
        paned.add(canvas_frame, weight=1)

        self.status_var = tk.StringVar(value="PDFファイルを開いてください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#3c3f41", fg="#888", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open_pdf(self):
        if not FITZ_AVAILABLE or not PIL_AVAILABLE:
            messagebox.showwarning("警告", "必要なライブラリをインストールしてください")
            return
        path = filedialog.askopenfilename(
            filetypes=[("PDFファイル", "*.pdf"), ("すべて", "*.*")])
        if path:
            try:
                self.doc = fitz.open(path)
                self.total_pages = len(self.doc)
                self.current_page = 0
                self.total_label.config(text=f"/ {self.total_pages}")
                self.root.title(f"PDFビューアー — {os.path.basename(path)}")
                self._build_thumbnails()
                self._render_page()
                self.status_var.set(
                    f"{os.path.basename(path)}  |  {self.total_pages} ページ")
            except Exception as e:
                messagebox.showerror("エラー", str(e))

    def _render_page(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        mat = fitz.Matrix(self.zoom, self.zoom)
        pix = page.get_pixmap(matrix=mat)
        img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
        tk_img = ImageTk.PhotoImage(img)
        self.tk_images = [tk_img]  # 参照保持
        self.canvas.delete("all")
        pad = 20
        self.canvas.create_rectangle(
            pad, pad, pix.width + pad + 4, pix.height + pad + 4,
            fill="#888", outline="")
        self.canvas.create_image(pad, pad, anchor="nw", image=tk_img)
        self.canvas.configure(
            scrollregion=(0, 0, pix.width + pad*2, pix.height + pad*2))
        self.page_var.set(str(self.current_page + 1))
        self.status_var.set(
            f"ページ {self.current_page+1} / {self.total_pages}  "
            f"ズーム {int(self.zoom*100)}%")

    def _build_thumbnails(self):
        for w in self.thumb_inner.winfo_children():
            w.destroy()
        self.thumb_tk_images = []
        for i in range(self.total_pages):
            page = self.doc[i]
            pix = page.get_pixmap(matrix=fitz.Matrix(0.15, 0.15))
            img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
            tk_img = ImageTk.PhotoImage(img)
            self.thumb_tk_images.append(tk_img)
            btn = tk.Button(self.thumb_inner, image=tk_img,
                            text=str(i+1), compound=tk.BOTTOM,
                            bg="#2b2b2b", fg="#ccc", relief=tk.FLAT,
                            command=lambda p=i: self._go_to(p))
            btn.pack(pady=2)

    def _go_to(self, page):
        if 0 <= page < self.total_pages:
            self.current_page = page
            self._render_page()

    def _first_page(self):
        self._go_to(0)

    def _last_page(self):
        self._go_to(self.total_pages - 1)

    def _prev_page(self):
        self._go_to(self.current_page - 1)

    def _next_page(self):
        self._go_to(self.current_page + 1)

    def _jump_to_page(self, event=None):
        try:
            p = int(self.page_var.get()) - 1
            self._go_to(p)
        except ValueError:
            pass

    def _zoom_in(self):
        self.zoom = min(4.0, self.zoom + 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _zoom_out(self):
        self.zoom = max(0.5, self.zoom - 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _fit_width(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        cw = self.canvas.winfo_width() or 600
        pw = page.rect.width
        self.zoom = (cw - 60) / pw
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _on_mousewheel(self, event):
        if event.state & 0x4:  # Ctrl
            if event.delta > 0:
                self._zoom_in()
            else:
                self._zoom_out()
        else:
            self.canvas.yview_scroll(-1 * (event.delta // 120), "units")


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

LabelFrameによるセクション分け

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

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

try:
    import fitz  # PyMuPDF
    FITZ_AVAILABLE = True
except ImportError:
    FITZ_AVAILABLE = False

try:
    from PIL import Image, ImageTk
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False


class App07:
    """PDFビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self.root.geometry("860x700")
        self.root.configure(bg="#404040")
        self.doc = None
        self.current_page = 0
        self.total_pages = 0
        self.zoom = 1.5
        self.tk_images = []
        self._build_ui()

        if not FITZ_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "PyMuPDF が必要です。\n"
                "pip install pymupdf でインストールしてください。")
        elif not PIL_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "Pillow が必要です。\n"
                "pip install Pillow でインストールしてください。")

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#3c3f41", pady=6)
        toolbar.pack(fill=tk.X)
        tk.Label(toolbar, text="📄 PDFビューアー",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#3c3f41", fg="#a9b7c6").pack(side=tk.LEFT, padx=12)
        ttk.Button(toolbar, text="📂 開く",
                   command=self._open_pdf).pack(side=tk.LEFT, padx=4)

        # ページナビ
        nav_frame = tk.Frame(toolbar, bg="#3c3f41")
        nav_frame.pack(side=tk.LEFT, padx=16)
        ttk.Button(nav_frame, text="◀◀ 最初",
                   command=self._first_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="◀ 前",
                   command=self._prev_page).pack(side=tk.LEFT, padx=2)
        self.page_var = tk.StringVar(value="0")
        page_entry = ttk.Entry(nav_frame, textvariable=self.page_var,
                               width=5, font=("Arial", 11))
        page_entry.pack(side=tk.LEFT, padx=4)
        page_entry.bind("<Return>", self._jump_to_page)
        self.total_label = tk.Label(nav_frame, text="/ 0",
                                    bg="#3c3f41", fg="#a9b7c6",
                                    font=("Arial", 11))
        self.total_label.pack(side=tk.LEFT)
        ttk.Button(nav_frame, text="次 ▶",
                   command=self._next_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="最後 ▶▶",
                   command=self._last_page).pack(side=tk.LEFT, padx=2)

        # ズーム
        zoom_frame = tk.Frame(toolbar, bg="#3c3f41")
        zoom_frame.pack(side=tk.LEFT, padx=16)
        tk.Label(zoom_frame, text="ズーム:", bg="#3c3f41",
                 fg="#a9b7c6").pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="+",
                   command=self._zoom_in).pack(side=tk.LEFT, padx=2)
        self.zoom_label = tk.Label(zoom_frame, text="150%",
                                   bg="#3c3f41", fg="#a9b7c6",
                                   font=("Arial", 11), width=5)
        self.zoom_label.pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="-",
                   command=self._zoom_out).pack(side=tk.LEFT, padx=2)
        ttk.Button(zoom_frame, text="全幅",
                   command=self._fit_width).pack(side=tk.LEFT, padx=2)

        # キーバインド
        self.root.bind("<Left>", lambda e: self._prev_page())
        self.root.bind("<Right>", lambda e: self._next_page())
        self.root.bind("<Prior>", lambda e: self._prev_page())
        self.root.bind("<Next>", lambda e: self._next_page())

        # メインエリア: サムネイル + ページ表示
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True)

        # 左: サムネイルパネル
        thumb_frame = tk.Frame(paned, bg="#2b2b2b", width=120)
        thumb_label = tk.Label(thumb_frame, text="ページ一覧",
                               bg="#3c3f41", fg="#a9b7c6",
                               font=("Arial", 9))
        thumb_label.pack(fill=tk.X)
        self.thumb_canvas = tk.Canvas(thumb_frame, bg="#2b2b2b",
                                       width=120, highlightthickness=0)
        thumb_sb = ttk.Scrollbar(thumb_frame, command=self.thumb_canvas.yview)
        self.thumb_canvas.configure(yscrollcommand=thumb_sb.set)
        thumb_sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.thumb_canvas.pack(fill=tk.BOTH, expand=True)
        self.thumb_inner = tk.Frame(self.thumb_canvas, bg="#2b2b2b")
        self.thumb_canvas.create_window((0, 0), window=self.thumb_inner, anchor="nw")
        self.thumb_inner.bind("<Configure>",
                              lambda e: self.thumb_canvas.configure(
                                  scrollregion=self.thumb_canvas.bbox("all")))
        paned.add(thumb_frame, weight=0)

        # 右: ページキャンバス
        canvas_frame = tk.Frame(paned, bg="#525252")
        self.canvas = tk.Canvas(canvas_frame, bg="#525252",
                                highlightthickness=0)
        h_sb = ttk.Scrollbar(canvas_frame, orient=tk.HORIZONTAL,
                             command=self.canvas.xview)
        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL,
                             command=self.canvas.yview)
        self.canvas.configure(xscrollcommand=h_sb.set,
                              yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.canvas.pack(fill=tk.BOTH, expand=True)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
        paned.add(canvas_frame, weight=1)

        self.status_var = tk.StringVar(value="PDFファイルを開いてください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#3c3f41", fg="#888", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open_pdf(self):
        if not FITZ_AVAILABLE or not PIL_AVAILABLE:
            messagebox.showwarning("警告", "必要なライブラリをインストールしてください")
            return
        path = filedialog.askopenfilename(
            filetypes=[("PDFファイル", "*.pdf"), ("すべて", "*.*")])
        if path:
            try:
                self.doc = fitz.open(path)
                self.total_pages = len(self.doc)
                self.current_page = 0
                self.total_label.config(text=f"/ {self.total_pages}")
                self.root.title(f"PDFビューアー — {os.path.basename(path)}")
                self._build_thumbnails()
                self._render_page()
                self.status_var.set(
                    f"{os.path.basename(path)}  |  {self.total_pages} ページ")
            except Exception as e:
                messagebox.showerror("エラー", str(e))

    def _render_page(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        mat = fitz.Matrix(self.zoom, self.zoom)
        pix = page.get_pixmap(matrix=mat)
        img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
        tk_img = ImageTk.PhotoImage(img)
        self.tk_images = [tk_img]  # 参照保持
        self.canvas.delete("all")
        pad = 20
        self.canvas.create_rectangle(
            pad, pad, pix.width + pad + 4, pix.height + pad + 4,
            fill="#888", outline="")
        self.canvas.create_image(pad, pad, anchor="nw", image=tk_img)
        self.canvas.configure(
            scrollregion=(0, 0, pix.width + pad*2, pix.height + pad*2))
        self.page_var.set(str(self.current_page + 1))
        self.status_var.set(
            f"ページ {self.current_page+1} / {self.total_pages}  "
            f"ズーム {int(self.zoom*100)}%")

    def _build_thumbnails(self):
        for w in self.thumb_inner.winfo_children():
            w.destroy()
        self.thumb_tk_images = []
        for i in range(self.total_pages):
            page = self.doc[i]
            pix = page.get_pixmap(matrix=fitz.Matrix(0.15, 0.15))
            img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
            tk_img = ImageTk.PhotoImage(img)
            self.thumb_tk_images.append(tk_img)
            btn = tk.Button(self.thumb_inner, image=tk_img,
                            text=str(i+1), compound=tk.BOTTOM,
                            bg="#2b2b2b", fg="#ccc", relief=tk.FLAT,
                            command=lambda p=i: self._go_to(p))
            btn.pack(pady=2)

    def _go_to(self, page):
        if 0 <= page < self.total_pages:
            self.current_page = page
            self._render_page()

    def _first_page(self):
        self._go_to(0)

    def _last_page(self):
        self._go_to(self.total_pages - 1)

    def _prev_page(self):
        self._go_to(self.current_page - 1)

    def _next_page(self):
        self._go_to(self.current_page + 1)

    def _jump_to_page(self, event=None):
        try:
            p = int(self.page_var.get()) - 1
            self._go_to(p)
        except ValueError:
            pass

    def _zoom_in(self):
        self.zoom = min(4.0, self.zoom + 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _zoom_out(self):
        self.zoom = max(0.5, self.zoom - 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _fit_width(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        cw = self.canvas.winfo_width() or 600
        pw = page.rect.width
        self.zoom = (cw - 60) / pw
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _on_mousewheel(self, event):
        if event.state & 0x4:  # Ctrl
            if event.delta > 0:
                self._zoom_in()
            else:
                self._zoom_out()
        else:
            self.canvas.yview_scroll(-1 * (event.delta // 120), "units")


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

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

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

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

try:
    import fitz  # PyMuPDF
    FITZ_AVAILABLE = True
except ImportError:
    FITZ_AVAILABLE = False

try:
    from PIL import Image, ImageTk
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False


class App07:
    """PDFビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self.root.geometry("860x700")
        self.root.configure(bg="#404040")
        self.doc = None
        self.current_page = 0
        self.total_pages = 0
        self.zoom = 1.5
        self.tk_images = []
        self._build_ui()

        if not FITZ_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "PyMuPDF が必要です。\n"
                "pip install pymupdf でインストールしてください。")
        elif not PIL_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "Pillow が必要です。\n"
                "pip install Pillow でインストールしてください。")

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#3c3f41", pady=6)
        toolbar.pack(fill=tk.X)
        tk.Label(toolbar, text="📄 PDFビューアー",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#3c3f41", fg="#a9b7c6").pack(side=tk.LEFT, padx=12)
        ttk.Button(toolbar, text="📂 開く",
                   command=self._open_pdf).pack(side=tk.LEFT, padx=4)

        # ページナビ
        nav_frame = tk.Frame(toolbar, bg="#3c3f41")
        nav_frame.pack(side=tk.LEFT, padx=16)
        ttk.Button(nav_frame, text="◀◀ 最初",
                   command=self._first_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="◀ 前",
                   command=self._prev_page).pack(side=tk.LEFT, padx=2)
        self.page_var = tk.StringVar(value="0")
        page_entry = ttk.Entry(nav_frame, textvariable=self.page_var,
                               width=5, font=("Arial", 11))
        page_entry.pack(side=tk.LEFT, padx=4)
        page_entry.bind("<Return>", self._jump_to_page)
        self.total_label = tk.Label(nav_frame, text="/ 0",
                                    bg="#3c3f41", fg="#a9b7c6",
                                    font=("Arial", 11))
        self.total_label.pack(side=tk.LEFT)
        ttk.Button(nav_frame, text="次 ▶",
                   command=self._next_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="最後 ▶▶",
                   command=self._last_page).pack(side=tk.LEFT, padx=2)

        # ズーム
        zoom_frame = tk.Frame(toolbar, bg="#3c3f41")
        zoom_frame.pack(side=tk.LEFT, padx=16)
        tk.Label(zoom_frame, text="ズーム:", bg="#3c3f41",
                 fg="#a9b7c6").pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="+",
                   command=self._zoom_in).pack(side=tk.LEFT, padx=2)
        self.zoom_label = tk.Label(zoom_frame, text="150%",
                                   bg="#3c3f41", fg="#a9b7c6",
                                   font=("Arial", 11), width=5)
        self.zoom_label.pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="-",
                   command=self._zoom_out).pack(side=tk.LEFT, padx=2)
        ttk.Button(zoom_frame, text="全幅",
                   command=self._fit_width).pack(side=tk.LEFT, padx=2)

        # キーバインド
        self.root.bind("<Left>", lambda e: self._prev_page())
        self.root.bind("<Right>", lambda e: self._next_page())
        self.root.bind("<Prior>", lambda e: self._prev_page())
        self.root.bind("<Next>", lambda e: self._next_page())

        # メインエリア: サムネイル + ページ表示
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True)

        # 左: サムネイルパネル
        thumb_frame = tk.Frame(paned, bg="#2b2b2b", width=120)
        thumb_label = tk.Label(thumb_frame, text="ページ一覧",
                               bg="#3c3f41", fg="#a9b7c6",
                               font=("Arial", 9))
        thumb_label.pack(fill=tk.X)
        self.thumb_canvas = tk.Canvas(thumb_frame, bg="#2b2b2b",
                                       width=120, highlightthickness=0)
        thumb_sb = ttk.Scrollbar(thumb_frame, command=self.thumb_canvas.yview)
        self.thumb_canvas.configure(yscrollcommand=thumb_sb.set)
        thumb_sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.thumb_canvas.pack(fill=tk.BOTH, expand=True)
        self.thumb_inner = tk.Frame(self.thumb_canvas, bg="#2b2b2b")
        self.thumb_canvas.create_window((0, 0), window=self.thumb_inner, anchor="nw")
        self.thumb_inner.bind("<Configure>",
                              lambda e: self.thumb_canvas.configure(
                                  scrollregion=self.thumb_canvas.bbox("all")))
        paned.add(thumb_frame, weight=0)

        # 右: ページキャンバス
        canvas_frame = tk.Frame(paned, bg="#525252")
        self.canvas = tk.Canvas(canvas_frame, bg="#525252",
                                highlightthickness=0)
        h_sb = ttk.Scrollbar(canvas_frame, orient=tk.HORIZONTAL,
                             command=self.canvas.xview)
        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL,
                             command=self.canvas.yview)
        self.canvas.configure(xscrollcommand=h_sb.set,
                              yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.canvas.pack(fill=tk.BOTH, expand=True)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
        paned.add(canvas_frame, weight=1)

        self.status_var = tk.StringVar(value="PDFファイルを開いてください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#3c3f41", fg="#888", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open_pdf(self):
        if not FITZ_AVAILABLE or not PIL_AVAILABLE:
            messagebox.showwarning("警告", "必要なライブラリをインストールしてください")
            return
        path = filedialog.askopenfilename(
            filetypes=[("PDFファイル", "*.pdf"), ("すべて", "*.*")])
        if path:
            try:
                self.doc = fitz.open(path)
                self.total_pages = len(self.doc)
                self.current_page = 0
                self.total_label.config(text=f"/ {self.total_pages}")
                self.root.title(f"PDFビューアー — {os.path.basename(path)}")
                self._build_thumbnails()
                self._render_page()
                self.status_var.set(
                    f"{os.path.basename(path)}  |  {self.total_pages} ページ")
            except Exception as e:
                messagebox.showerror("エラー", str(e))

    def _render_page(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        mat = fitz.Matrix(self.zoom, self.zoom)
        pix = page.get_pixmap(matrix=mat)
        img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
        tk_img = ImageTk.PhotoImage(img)
        self.tk_images = [tk_img]  # 参照保持
        self.canvas.delete("all")
        pad = 20
        self.canvas.create_rectangle(
            pad, pad, pix.width + pad + 4, pix.height + pad + 4,
            fill="#888", outline="")
        self.canvas.create_image(pad, pad, anchor="nw", image=tk_img)
        self.canvas.configure(
            scrollregion=(0, 0, pix.width + pad*2, pix.height + pad*2))
        self.page_var.set(str(self.current_page + 1))
        self.status_var.set(
            f"ページ {self.current_page+1} / {self.total_pages}  "
            f"ズーム {int(self.zoom*100)}%")

    def _build_thumbnails(self):
        for w in self.thumb_inner.winfo_children():
            w.destroy()
        self.thumb_tk_images = []
        for i in range(self.total_pages):
            page = self.doc[i]
            pix = page.get_pixmap(matrix=fitz.Matrix(0.15, 0.15))
            img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
            tk_img = ImageTk.PhotoImage(img)
            self.thumb_tk_images.append(tk_img)
            btn = tk.Button(self.thumb_inner, image=tk_img,
                            text=str(i+1), compound=tk.BOTTOM,
                            bg="#2b2b2b", fg="#ccc", relief=tk.FLAT,
                            command=lambda p=i: self._go_to(p))
            btn.pack(pady=2)

    def _go_to(self, page):
        if 0 <= page < self.total_pages:
            self.current_page = page
            self._render_page()

    def _first_page(self):
        self._go_to(0)

    def _last_page(self):
        self._go_to(self.total_pages - 1)

    def _prev_page(self):
        self._go_to(self.current_page - 1)

    def _next_page(self):
        self._go_to(self.current_page + 1)

    def _jump_to_page(self, event=None):
        try:
            p = int(self.page_var.get()) - 1
            self._go_to(p)
        except ValueError:
            pass

    def _zoom_in(self):
        self.zoom = min(4.0, self.zoom + 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _zoom_out(self):
        self.zoom = max(0.5, self.zoom - 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _fit_width(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        cw = self.canvas.winfo_width() or 600
        pw = page.rect.width
        self.zoom = (cw - 60) / pw
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _on_mousewheel(self, event):
        if event.state & 0x4:  # Ctrl
            if event.delta > 0:
                self._zoom_in()
            else:
                self._zoom_out()
        else:
            self.canvas.yview_scroll(-1 * (event.delta // 120), "units")


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

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

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

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

try:
    import fitz  # PyMuPDF
    FITZ_AVAILABLE = True
except ImportError:
    FITZ_AVAILABLE = False

try:
    from PIL import Image, ImageTk
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False


class App07:
    """PDFビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self.root.geometry("860x700")
        self.root.configure(bg="#404040")
        self.doc = None
        self.current_page = 0
        self.total_pages = 0
        self.zoom = 1.5
        self.tk_images = []
        self._build_ui()

        if not FITZ_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "PyMuPDF が必要です。\n"
                "pip install pymupdf でインストールしてください。")
        elif not PIL_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "Pillow が必要です。\n"
                "pip install Pillow でインストールしてください。")

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#3c3f41", pady=6)
        toolbar.pack(fill=tk.X)
        tk.Label(toolbar, text="📄 PDFビューアー",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#3c3f41", fg="#a9b7c6").pack(side=tk.LEFT, padx=12)
        ttk.Button(toolbar, text="📂 開く",
                   command=self._open_pdf).pack(side=tk.LEFT, padx=4)

        # ページナビ
        nav_frame = tk.Frame(toolbar, bg="#3c3f41")
        nav_frame.pack(side=tk.LEFT, padx=16)
        ttk.Button(nav_frame, text="◀◀ 最初",
                   command=self._first_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="◀ 前",
                   command=self._prev_page).pack(side=tk.LEFT, padx=2)
        self.page_var = tk.StringVar(value="0")
        page_entry = ttk.Entry(nav_frame, textvariable=self.page_var,
                               width=5, font=("Arial", 11))
        page_entry.pack(side=tk.LEFT, padx=4)
        page_entry.bind("<Return>", self._jump_to_page)
        self.total_label = tk.Label(nav_frame, text="/ 0",
                                    bg="#3c3f41", fg="#a9b7c6",
                                    font=("Arial", 11))
        self.total_label.pack(side=tk.LEFT)
        ttk.Button(nav_frame, text="次 ▶",
                   command=self._next_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="最後 ▶▶",
                   command=self._last_page).pack(side=tk.LEFT, padx=2)

        # ズーム
        zoom_frame = tk.Frame(toolbar, bg="#3c3f41")
        zoom_frame.pack(side=tk.LEFT, padx=16)
        tk.Label(zoom_frame, text="ズーム:", bg="#3c3f41",
                 fg="#a9b7c6").pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="+",
                   command=self._zoom_in).pack(side=tk.LEFT, padx=2)
        self.zoom_label = tk.Label(zoom_frame, text="150%",
                                   bg="#3c3f41", fg="#a9b7c6",
                                   font=("Arial", 11), width=5)
        self.zoom_label.pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="-",
                   command=self._zoom_out).pack(side=tk.LEFT, padx=2)
        ttk.Button(zoom_frame, text="全幅",
                   command=self._fit_width).pack(side=tk.LEFT, padx=2)

        # キーバインド
        self.root.bind("<Left>", lambda e: self._prev_page())
        self.root.bind("<Right>", lambda e: self._next_page())
        self.root.bind("<Prior>", lambda e: self._prev_page())
        self.root.bind("<Next>", lambda e: self._next_page())

        # メインエリア: サムネイル + ページ表示
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True)

        # 左: サムネイルパネル
        thumb_frame = tk.Frame(paned, bg="#2b2b2b", width=120)
        thumb_label = tk.Label(thumb_frame, text="ページ一覧",
                               bg="#3c3f41", fg="#a9b7c6",
                               font=("Arial", 9))
        thumb_label.pack(fill=tk.X)
        self.thumb_canvas = tk.Canvas(thumb_frame, bg="#2b2b2b",
                                       width=120, highlightthickness=0)
        thumb_sb = ttk.Scrollbar(thumb_frame, command=self.thumb_canvas.yview)
        self.thumb_canvas.configure(yscrollcommand=thumb_sb.set)
        thumb_sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.thumb_canvas.pack(fill=tk.BOTH, expand=True)
        self.thumb_inner = tk.Frame(self.thumb_canvas, bg="#2b2b2b")
        self.thumb_canvas.create_window((0, 0), window=self.thumb_inner, anchor="nw")
        self.thumb_inner.bind("<Configure>",
                              lambda e: self.thumb_canvas.configure(
                                  scrollregion=self.thumb_canvas.bbox("all")))
        paned.add(thumb_frame, weight=0)

        # 右: ページキャンバス
        canvas_frame = tk.Frame(paned, bg="#525252")
        self.canvas = tk.Canvas(canvas_frame, bg="#525252",
                                highlightthickness=0)
        h_sb = ttk.Scrollbar(canvas_frame, orient=tk.HORIZONTAL,
                             command=self.canvas.xview)
        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL,
                             command=self.canvas.yview)
        self.canvas.configure(xscrollcommand=h_sb.set,
                              yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.canvas.pack(fill=tk.BOTH, expand=True)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
        paned.add(canvas_frame, weight=1)

        self.status_var = tk.StringVar(value="PDFファイルを開いてください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#3c3f41", fg="#888", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open_pdf(self):
        if not FITZ_AVAILABLE or not PIL_AVAILABLE:
            messagebox.showwarning("警告", "必要なライブラリをインストールしてください")
            return
        path = filedialog.askopenfilename(
            filetypes=[("PDFファイル", "*.pdf"), ("すべて", "*.*")])
        if path:
            try:
                self.doc = fitz.open(path)
                self.total_pages = len(self.doc)
                self.current_page = 0
                self.total_label.config(text=f"/ {self.total_pages}")
                self.root.title(f"PDFビューアー — {os.path.basename(path)}")
                self._build_thumbnails()
                self._render_page()
                self.status_var.set(
                    f"{os.path.basename(path)}  |  {self.total_pages} ページ")
            except Exception as e:
                messagebox.showerror("エラー", str(e))

    def _render_page(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        mat = fitz.Matrix(self.zoom, self.zoom)
        pix = page.get_pixmap(matrix=mat)
        img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
        tk_img = ImageTk.PhotoImage(img)
        self.tk_images = [tk_img]  # 参照保持
        self.canvas.delete("all")
        pad = 20
        self.canvas.create_rectangle(
            pad, pad, pix.width + pad + 4, pix.height + pad + 4,
            fill="#888", outline="")
        self.canvas.create_image(pad, pad, anchor="nw", image=tk_img)
        self.canvas.configure(
            scrollregion=(0, 0, pix.width + pad*2, pix.height + pad*2))
        self.page_var.set(str(self.current_page + 1))
        self.status_var.set(
            f"ページ {self.current_page+1} / {self.total_pages}  "
            f"ズーム {int(self.zoom*100)}%")

    def _build_thumbnails(self):
        for w in self.thumb_inner.winfo_children():
            w.destroy()
        self.thumb_tk_images = []
        for i in range(self.total_pages):
            page = self.doc[i]
            pix = page.get_pixmap(matrix=fitz.Matrix(0.15, 0.15))
            img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
            tk_img = ImageTk.PhotoImage(img)
            self.thumb_tk_images.append(tk_img)
            btn = tk.Button(self.thumb_inner, image=tk_img,
                            text=str(i+1), compound=tk.BOTTOM,
                            bg="#2b2b2b", fg="#ccc", relief=tk.FLAT,
                            command=lambda p=i: self._go_to(p))
            btn.pack(pady=2)

    def _go_to(self, page):
        if 0 <= page < self.total_pages:
            self.current_page = page
            self._render_page()

    def _first_page(self):
        self._go_to(0)

    def _last_page(self):
        self._go_to(self.total_pages - 1)

    def _prev_page(self):
        self._go_to(self.current_page - 1)

    def _next_page(self):
        self._go_to(self.current_page + 1)

    def _jump_to_page(self, event=None):
        try:
            p = int(self.page_var.get()) - 1
            self._go_to(p)
        except ValueError:
            pass

    def _zoom_in(self):
        self.zoom = min(4.0, self.zoom + 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _zoom_out(self):
        self.zoom = max(0.5, self.zoom - 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _fit_width(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        cw = self.canvas.winfo_width() or 600
        pw = page.rect.width
        self.zoom = (cw - 60) / pw
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _on_mousewheel(self, event):
        if event.state & 0x4:  # Ctrl
            if event.delta > 0:
                self._zoom_in()
            else:
                self._zoom_out()
        else:
            self.canvas.yview_scroll(-1 * (event.delta // 120), "units")


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

例外処理とmessagebox

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

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

try:
    import fitz  # PyMuPDF
    FITZ_AVAILABLE = True
except ImportError:
    FITZ_AVAILABLE = False

try:
    from PIL import Image, ImageTk
    PIL_AVAILABLE = True
except ImportError:
    PIL_AVAILABLE = False


class App07:
    """PDFビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self.root.geometry("860x700")
        self.root.configure(bg="#404040")
        self.doc = None
        self.current_page = 0
        self.total_pages = 0
        self.zoom = 1.5
        self.tk_images = []
        self._build_ui()

        if not FITZ_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "PyMuPDF が必要です。\n"
                "pip install pymupdf でインストールしてください。")
        elif not PIL_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "Pillow が必要です。\n"
                "pip install Pillow でインストールしてください。")

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#3c3f41", pady=6)
        toolbar.pack(fill=tk.X)
        tk.Label(toolbar, text="📄 PDFビューアー",
                 font=("Noto Sans JP", 13, "bold"),
                 bg="#3c3f41", fg="#a9b7c6").pack(side=tk.LEFT, padx=12)
        ttk.Button(toolbar, text="📂 開く",
                   command=self._open_pdf).pack(side=tk.LEFT, padx=4)

        # ページナビ
        nav_frame = tk.Frame(toolbar, bg="#3c3f41")
        nav_frame.pack(side=tk.LEFT, padx=16)
        ttk.Button(nav_frame, text="◀◀ 最初",
                   command=self._first_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="◀ 前",
                   command=self._prev_page).pack(side=tk.LEFT, padx=2)
        self.page_var = tk.StringVar(value="0")
        page_entry = ttk.Entry(nav_frame, textvariable=self.page_var,
                               width=5, font=("Arial", 11))
        page_entry.pack(side=tk.LEFT, padx=4)
        page_entry.bind("<Return>", self._jump_to_page)
        self.total_label = tk.Label(nav_frame, text="/ 0",
                                    bg="#3c3f41", fg="#a9b7c6",
                                    font=("Arial", 11))
        self.total_label.pack(side=tk.LEFT)
        ttk.Button(nav_frame, text="次 ▶",
                   command=self._next_page).pack(side=tk.LEFT, padx=2)
        ttk.Button(nav_frame, text="最後 ▶▶",
                   command=self._last_page).pack(side=tk.LEFT, padx=2)

        # ズーム
        zoom_frame = tk.Frame(toolbar, bg="#3c3f41")
        zoom_frame.pack(side=tk.LEFT, padx=16)
        tk.Label(zoom_frame, text="ズーム:", bg="#3c3f41",
                 fg="#a9b7c6").pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="+",
                   command=self._zoom_in).pack(side=tk.LEFT, padx=2)
        self.zoom_label = tk.Label(zoom_frame, text="150%",
                                   bg="#3c3f41", fg="#a9b7c6",
                                   font=("Arial", 11), width=5)
        self.zoom_label.pack(side=tk.LEFT)
        ttk.Button(zoom_frame, text="-",
                   command=self._zoom_out).pack(side=tk.LEFT, padx=2)
        ttk.Button(zoom_frame, text="全幅",
                   command=self._fit_width).pack(side=tk.LEFT, padx=2)

        # キーバインド
        self.root.bind("<Left>", lambda e: self._prev_page())
        self.root.bind("<Right>", lambda e: self._next_page())
        self.root.bind("<Prior>", lambda e: self._prev_page())
        self.root.bind("<Next>", lambda e: self._next_page())

        # メインエリア: サムネイル + ページ表示
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True)

        # 左: サムネイルパネル
        thumb_frame = tk.Frame(paned, bg="#2b2b2b", width=120)
        thumb_label = tk.Label(thumb_frame, text="ページ一覧",
                               bg="#3c3f41", fg="#a9b7c6",
                               font=("Arial", 9))
        thumb_label.pack(fill=tk.X)
        self.thumb_canvas = tk.Canvas(thumb_frame, bg="#2b2b2b",
                                       width=120, highlightthickness=0)
        thumb_sb = ttk.Scrollbar(thumb_frame, command=self.thumb_canvas.yview)
        self.thumb_canvas.configure(yscrollcommand=thumb_sb.set)
        thumb_sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.thumb_canvas.pack(fill=tk.BOTH, expand=True)
        self.thumb_inner = tk.Frame(self.thumb_canvas, bg="#2b2b2b")
        self.thumb_canvas.create_window((0, 0), window=self.thumb_inner, anchor="nw")
        self.thumb_inner.bind("<Configure>",
                              lambda e: self.thumb_canvas.configure(
                                  scrollregion=self.thumb_canvas.bbox("all")))
        paned.add(thumb_frame, weight=0)

        # 右: ページキャンバス
        canvas_frame = tk.Frame(paned, bg="#525252")
        self.canvas = tk.Canvas(canvas_frame, bg="#525252",
                                highlightthickness=0)
        h_sb = ttk.Scrollbar(canvas_frame, orient=tk.HORIZONTAL,
                             command=self.canvas.xview)
        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL,
                             command=self.canvas.yview)
        self.canvas.configure(xscrollcommand=h_sb.set,
                              yscrollcommand=v_sb.set)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb.pack(side=tk.BOTTOM, fill=tk.X)
        self.canvas.pack(fill=tk.BOTH, expand=True)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
        paned.add(canvas_frame, weight=1)

        self.status_var = tk.StringVar(value="PDFファイルを開いてください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#3c3f41", fg="#888", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open_pdf(self):
        if not FITZ_AVAILABLE or not PIL_AVAILABLE:
            messagebox.showwarning("警告", "必要なライブラリをインストールしてください")
            return
        path = filedialog.askopenfilename(
            filetypes=[("PDFファイル", "*.pdf"), ("すべて", "*.*")])
        if path:
            try:
                self.doc = fitz.open(path)
                self.total_pages = len(self.doc)
                self.current_page = 0
                self.total_label.config(text=f"/ {self.total_pages}")
                self.root.title(f"PDFビューアー — {os.path.basename(path)}")
                self._build_thumbnails()
                self._render_page()
                self.status_var.set(
                    f"{os.path.basename(path)}  |  {self.total_pages} ページ")
            except Exception as e:
                messagebox.showerror("エラー", str(e))

    def _render_page(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        mat = fitz.Matrix(self.zoom, self.zoom)
        pix = page.get_pixmap(matrix=mat)
        img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
        tk_img = ImageTk.PhotoImage(img)
        self.tk_images = [tk_img]  # 参照保持
        self.canvas.delete("all")
        pad = 20
        self.canvas.create_rectangle(
            pad, pad, pix.width + pad + 4, pix.height + pad + 4,
            fill="#888", outline="")
        self.canvas.create_image(pad, pad, anchor="nw", image=tk_img)
        self.canvas.configure(
            scrollregion=(0, 0, pix.width + pad*2, pix.height + pad*2))
        self.page_var.set(str(self.current_page + 1))
        self.status_var.set(
            f"ページ {self.current_page+1} / {self.total_pages}  "
            f"ズーム {int(self.zoom*100)}%")

    def _build_thumbnails(self):
        for w in self.thumb_inner.winfo_children():
            w.destroy()
        self.thumb_tk_images = []
        for i in range(self.total_pages):
            page = self.doc[i]
            pix = page.get_pixmap(matrix=fitz.Matrix(0.15, 0.15))
            img = Image.frombytes("RGB", [pix.width, pix.height], pix.samples)
            tk_img = ImageTk.PhotoImage(img)
            self.thumb_tk_images.append(tk_img)
            btn = tk.Button(self.thumb_inner, image=tk_img,
                            text=str(i+1), compound=tk.BOTTOM,
                            bg="#2b2b2b", fg="#ccc", relief=tk.FLAT,
                            command=lambda p=i: self._go_to(p))
            btn.pack(pady=2)

    def _go_to(self, page):
        if 0 <= page < self.total_pages:
            self.current_page = page
            self._render_page()

    def _first_page(self):
        self._go_to(0)

    def _last_page(self):
        self._go_to(self.total_pages - 1)

    def _prev_page(self):
        self._go_to(self.current_page - 1)

    def _next_page(self):
        self._go_to(self.current_page + 1)

    def _jump_to_page(self, event=None):
        try:
            p = int(self.page_var.get()) - 1
            self._go_to(p)
        except ValueError:
            pass

    def _zoom_in(self):
        self.zoom = min(4.0, self.zoom + 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _zoom_out(self):
        self.zoom = max(0.5, self.zoom - 0.25)
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _fit_width(self):
        if not self.doc:
            return
        page = self.doc[self.current_page]
        cw = self.canvas.winfo_width() or 600
        pw = page.rect.width
        self.zoom = (cw - 60) / pw
        self.zoom_label.config(text=f"{int(self.zoom*100)}%")
        self._render_page()

    def _on_mousewheel(self, event):
        if event.state & 0x4:  # Ctrl
            if event.delta > 0:
                self._zoom_in()
            else:
                self._zoom_out()
        else:
            self.canvas.yview_scroll(-1 * (event.delta // 120), "units")


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

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

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

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

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

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

    App07クラスを定義し、__init__とmainloop()の最小構成を作ります。

  3. 3
    タイトルバーを作る

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

  4. 4
    入力フォームを実装する

    LabelFrameとEntryウィジェットで入力エリアを作ります。

  5. 5
    処理ロジックを実装する

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

  6. 6
    結果表示を実装する

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

  7. 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:機能拡張

    PDFビューアーに新しい機能を1つ追加してみましょう。どんな機能があると便利か考えてから実装してください。

  2. 課題2:UIの改善

    色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしてみましょう。

  3. 課題3:保存機能の追加

    入力値や計算結果をファイルに保存する機能を追加しましょう。jsonやcsvモジュールを使います。

🚀
次に挑戦するアプリ

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