PDFビューアー

1. アプリ概要

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

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

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

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

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

2. 機能一覧

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

3. 事前準備・環境

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

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

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

pip install pillow

4. 完全なソースコード

import tkinter as tk
from tkinter import ttk, messagebox


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

    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self.root.geometry("500x400")
        self.root.configure(bg="#f8f9fc")
        self._build_ui()

    def _build_ui(self):
        """UIを構築する"""
        # タイトルフレーム
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=12)
        title_frame.pack(fill=tk.X)

        tk.Label(
            title_frame,
            text="PDFビューアー",
            font=("Noto Sans JP", 16, "bold"),
            bg="#3776ab", fg="white"
        ).pack()

        # メインフレーム
        main_frame = tk.Frame(self.root, bg="#f8f9fc", padx=20, pady=20)
        main_frame.pack(fill=tk.BOTH, expand=True)

        # 入力エリア
        input_frame = ttk.LabelFrame(main_frame, text="入力", padding=10)
        input_frame.pack(fill=tk.X, pady=(0, 10))

        tk.Label(input_frame, text="値を入力:").grid(row=0, column=0, sticky="w")
        self.entry = ttk.Entry(input_frame, width=30, font=("Arial", 12))
        self.entry.grid(row=0, column=1, padx=8, sticky="ew")
        self.entry.bind("", lambda e: self.process())
        input_frame.columnconfigure(1, weight=1)

        # 実行ボタン
        ttk.Button(
            main_frame,
            text="実行する",
            command=self.process
        ).pack(pady=8)

        # 結果エリア
        result_frame = ttk.LabelFrame(main_frame, text="結果", padding=10)
        result_frame.pack(fill=tk.BOTH, expand=True)

        self.result_text = tk.Text(
            result_frame,
            font=("Noto Sans JP", 11),
            bg="white", relief=tk.FLAT,
            state=tk.DISABLED
        )
        self.result_text.pack(fill=tk.BOTH, expand=True)

        # スクロールバー
        scrollbar = ttk.Scrollbar(result_frame, command=self.result_text.yview)
        self.result_text.configure(yscrollcommand=scrollbar.set)
        scrollbar.pack(side=tk.RIGHT, fill=tk.Y)

    def process(self):
        """メイン処理"""
        value = self.entry.get().strip()
        if not value:
            messagebox.showwarning("警告", "値を入力してください")
            return

        try:
            result = self._calculate(value)
            self._show_result(result)
        except ValueError as e:
            messagebox.showerror("エラー", f"入力値が不正です: {e}")
        except Exception as e:
            messagebox.showerror("エラー", f"予期しないエラー: {e}")

    def _calculate(self, value):
        """計算処理（各アプリで実装）"""
        # TODO: ここにPDFビューアーの計算ロジックを実装する
        return f"入力値: {value}\n結果をここに表示します"

    def _show_result(self, text):
        """結果テキストエリアに表示"""
        self.result_text.config(state=tk.NORMAL)
        self.result_text.delete("1.0", tk.END)
        self.result_text.insert("1.0", text)
        self.result_text.config(state=tk.DISABLED)


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

5. コード解説

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

class App07:
    def __init__(self, root):
        self.root = root
        self.root.title("PDFビューアー")
        self._build_ui()

input_frame = ttk.LabelFrame(main_frame, text="入力", padding=10)
input_frame.pack(fill=tk.X, pady=(0, 10))

self.entry = ttk.Entry(frame, width=30)
self.entry.bind('', lambda e: self.process())

self.result_text.config(state=tk.NORMAL)
self.result_text.delete('1.0', tk.END)
self.result_text.insert('1.0', text)
self.result_text.config(state=tk.DISABLED)

try:
    result = self._calculate(value)
except ValueError as e:
    messagebox.showerror("エラー", f"入力値が不正: {e}")

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のスキルが飛躍的に向上します。

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

9. 練習問題

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

1. 課題1：機能拡張

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

2. 課題2：UIの改善

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

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

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