初心者向け No.28

画像ビューアー

画像ファイルを開いてウィンドウに表示するビューアー。PIL/Pillowの基本的な使い方を学びます。

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

1. アプリ概要

画像ファイルを開いてウィンドウに表示するビューアー。PIL/Pillowの基本的な使い方を学びます。

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

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+

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

pip install pillow

4. 完全なソースコード

💡
コードのコピー方法

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

app28.py
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
from PIL import Image, ImageTk


class App28:
    """画像ビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("画像ビューアー")
        self.root.geometry("640x520")
        self.root.configure(bg="#222")
        self.image = None
        self.photo = None
        self.zoom = 1.0
        self._build_ui()

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#333", pady=6)
        toolbar.pack(fill=tk.X)
        ttk.Button(toolbar, text="📂 開く", command=self.open_image).pack(side=tk.LEFT, padx=6)
        ttk.Button(toolbar, text="🔍+", command=lambda: self.change_zoom(1.2)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="🔍-", command=lambda: self.change_zoom(0.8)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="原寸", command=lambda: self.set_zoom(1.0)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="フィット", command=self.fit_to_window).pack(side=tk.LEFT, padx=2)
        self.info_label = tk.Label(toolbar, text="画像を開いてください",
                                   bg="#333", fg="#aaa", font=("Noto Sans JP", 10))
        self.info_label.pack(side=tk.LEFT, padx=12)

        # スクロール付きキャンバス
        canvas_frame = tk.Frame(self.root, bg="#222")
        canvas_frame.pack(fill=tk.BOTH, expand=True)

        self.canvas = tk.Canvas(canvas_frame, bg="#222", cursor="crosshair")
        self.canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL, command=self.canvas.yview)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb = ttk.Scrollbar(self.root, orient=tk.HORIZONTAL, command=self.canvas.xview)
        h_sb.pack(fill=tk.X)
        self.canvas.configure(xscrollcommand=h_sb.set, yscrollcommand=v_sb.set)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)

    def open_image(self):
        path = filedialog.askopenfilename(
            filetypes=[("画像ファイル", "*.png *.jpg *.jpeg *.gif *.bmp *.webp"),
                       ("全てのファイル", "*.*")])
        if not path:
            return
        self.image = Image.open(path)
        self.zoom = 1.0
        self._show_image()
        w, h = self.image.size
        self.info_label.config(
            text=f"{w} × {h} px  |  {self.image.mode}  |  {path.split('/')[-1]}")

    def _show_image(self):
        if not self.image:
            return
        w, h = self.image.size
        new_w, new_h = int(w * self.zoom), int(h * self.zoom)
        resized = self.image.resize((new_w, new_h), Image.LANCZOS)
        self.photo = ImageTk.PhotoImage(resized)
        self.canvas.delete("all")
        self.canvas.create_image(0, 0, anchor=tk.NW, image=self.photo)
        self.canvas.configure(scrollregion=(0, 0, new_w, new_h))

    def change_zoom(self, factor):
        self.zoom = max(0.05, min(self.zoom * factor, 10.0))
        self._show_image()

    def set_zoom(self, zoom):
        self.zoom = zoom
        self._show_image()

    def fit_to_window(self):
        if not self.image:
            return
        cw = self.canvas.winfo_width()
        ch = self.canvas.winfo_height()
        iw, ih = self.image.size
        self.zoom = min(cw / iw, ch / ih)
        self._show_image()

    def _on_mousewheel(self, event):
        factor = 1.1 if event.delta > 0 else 0.9
        self.change_zoom(factor)


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

5. コード解説

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

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

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
from PIL import Image, ImageTk


class App28:
    """画像ビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("画像ビューアー")
        self.root.geometry("640x520")
        self.root.configure(bg="#222")
        self.image = None
        self.photo = None
        self.zoom = 1.0
        self._build_ui()

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#333", pady=6)
        toolbar.pack(fill=tk.X)
        ttk.Button(toolbar, text="📂 開く", command=self.open_image).pack(side=tk.LEFT, padx=6)
        ttk.Button(toolbar, text="🔍+", command=lambda: self.change_zoom(1.2)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="🔍-", command=lambda: self.change_zoom(0.8)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="原寸", command=lambda: self.set_zoom(1.0)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="フィット", command=self.fit_to_window).pack(side=tk.LEFT, padx=2)
        self.info_label = tk.Label(toolbar, text="画像を開いてください",
                                   bg="#333", fg="#aaa", font=("Noto Sans JP", 10))
        self.info_label.pack(side=tk.LEFT, padx=12)

        # スクロール付きキャンバス
        canvas_frame = tk.Frame(self.root, bg="#222")
        canvas_frame.pack(fill=tk.BOTH, expand=True)

        self.canvas = tk.Canvas(canvas_frame, bg="#222", cursor="crosshair")
        self.canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL, command=self.canvas.yview)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb = ttk.Scrollbar(self.root, orient=tk.HORIZONTAL, command=self.canvas.xview)
        h_sb.pack(fill=tk.X)
        self.canvas.configure(xscrollcommand=h_sb.set, yscrollcommand=v_sb.set)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)

    def open_image(self):
        path = filedialog.askopenfilename(
            filetypes=[("画像ファイル", "*.png *.jpg *.jpeg *.gif *.bmp *.webp"),
                       ("全てのファイル", "*.*")])
        if not path:
            return
        self.image = Image.open(path)
        self.zoom = 1.0
        self._show_image()
        w, h = self.image.size
        self.info_label.config(
            text=f"{w} × {h} px  |  {self.image.mode}  |  {path.split('/')[-1]}")

    def _show_image(self):
        if not self.image:
            return
        w, h = self.image.size
        new_w, new_h = int(w * self.zoom), int(h * self.zoom)
        resized = self.image.resize((new_w, new_h), Image.LANCZOS)
        self.photo = ImageTk.PhotoImage(resized)
        self.canvas.delete("all")
        self.canvas.create_image(0, 0, anchor=tk.NW, image=self.photo)
        self.canvas.configure(scrollregion=(0, 0, new_w, new_h))

    def change_zoom(self, factor):
        self.zoom = max(0.05, min(self.zoom * factor, 10.0))
        self._show_image()

    def set_zoom(self, zoom):
        self.zoom = zoom
        self._show_image()

    def fit_to_window(self):
        if not self.image:
            return
        cw = self.canvas.winfo_width()
        ch = self.canvas.winfo_height()
        iw, ih = self.image.size
        self.zoom = min(cw / iw, ch / ih)
        self._show_image()

    def _on_mousewheel(self, event):
        factor = 1.1 if event.delta > 0 else 0.9
        self.change_zoom(factor)


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

LabelFrameによるセクション分け

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
from PIL import Image, ImageTk


class App28:
    """画像ビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("画像ビューアー")
        self.root.geometry("640x520")
        self.root.configure(bg="#222")
        self.image = None
        self.photo = None
        self.zoom = 1.0
        self._build_ui()

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#333", pady=6)
        toolbar.pack(fill=tk.X)
        ttk.Button(toolbar, text="📂 開く", command=self.open_image).pack(side=tk.LEFT, padx=6)
        ttk.Button(toolbar, text="🔍+", command=lambda: self.change_zoom(1.2)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="🔍-", command=lambda: self.change_zoom(0.8)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="原寸", command=lambda: self.set_zoom(1.0)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="フィット", command=self.fit_to_window).pack(side=tk.LEFT, padx=2)
        self.info_label = tk.Label(toolbar, text="画像を開いてください",
                                   bg="#333", fg="#aaa", font=("Noto Sans JP", 10))
        self.info_label.pack(side=tk.LEFT, padx=12)

        # スクロール付きキャンバス
        canvas_frame = tk.Frame(self.root, bg="#222")
        canvas_frame.pack(fill=tk.BOTH, expand=True)

        self.canvas = tk.Canvas(canvas_frame, bg="#222", cursor="crosshair")
        self.canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL, command=self.canvas.yview)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb = ttk.Scrollbar(self.root, orient=tk.HORIZONTAL, command=self.canvas.xview)
        h_sb.pack(fill=tk.X)
        self.canvas.configure(xscrollcommand=h_sb.set, yscrollcommand=v_sb.set)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)

    def open_image(self):
        path = filedialog.askopenfilename(
            filetypes=[("画像ファイル", "*.png *.jpg *.jpeg *.gif *.bmp *.webp"),
                       ("全てのファイル", "*.*")])
        if not path:
            return
        self.image = Image.open(path)
        self.zoom = 1.0
        self._show_image()
        w, h = self.image.size
        self.info_label.config(
            text=f"{w} × {h} px  |  {self.image.mode}  |  {path.split('/')[-1]}")

    def _show_image(self):
        if not self.image:
            return
        w, h = self.image.size
        new_w, new_h = int(w * self.zoom), int(h * self.zoom)
        resized = self.image.resize((new_w, new_h), Image.LANCZOS)
        self.photo = ImageTk.PhotoImage(resized)
        self.canvas.delete("all")
        self.canvas.create_image(0, 0, anchor=tk.NW, image=self.photo)
        self.canvas.configure(scrollregion=(0, 0, new_w, new_h))

    def change_zoom(self, factor):
        self.zoom = max(0.05, min(self.zoom * factor, 10.0))
        self._show_image()

    def set_zoom(self, zoom):
        self.zoom = zoom
        self._show_image()

    def fit_to_window(self):
        if not self.image:
            return
        cw = self.canvas.winfo_width()
        ch = self.canvas.winfo_height()
        iw, ih = self.image.size
        self.zoom = min(cw / iw, ch / ih)
        self._show_image()

    def _on_mousewheel(self, event):
        factor = 1.1 if event.delta > 0 else 0.9
        self.change_zoom(factor)


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

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

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
from PIL import Image, ImageTk


class App28:
    """画像ビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("画像ビューアー")
        self.root.geometry("640x520")
        self.root.configure(bg="#222")
        self.image = None
        self.photo = None
        self.zoom = 1.0
        self._build_ui()

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#333", pady=6)
        toolbar.pack(fill=tk.X)
        ttk.Button(toolbar, text="📂 開く", command=self.open_image).pack(side=tk.LEFT, padx=6)
        ttk.Button(toolbar, text="🔍+", command=lambda: self.change_zoom(1.2)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="🔍-", command=lambda: self.change_zoom(0.8)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="原寸", command=lambda: self.set_zoom(1.0)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="フィット", command=self.fit_to_window).pack(side=tk.LEFT, padx=2)
        self.info_label = tk.Label(toolbar, text="画像を開いてください",
                                   bg="#333", fg="#aaa", font=("Noto Sans JP", 10))
        self.info_label.pack(side=tk.LEFT, padx=12)

        # スクロール付きキャンバス
        canvas_frame = tk.Frame(self.root, bg="#222")
        canvas_frame.pack(fill=tk.BOTH, expand=True)

        self.canvas = tk.Canvas(canvas_frame, bg="#222", cursor="crosshair")
        self.canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL, command=self.canvas.yview)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb = ttk.Scrollbar(self.root, orient=tk.HORIZONTAL, command=self.canvas.xview)
        h_sb.pack(fill=tk.X)
        self.canvas.configure(xscrollcommand=h_sb.set, yscrollcommand=v_sb.set)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)

    def open_image(self):
        path = filedialog.askopenfilename(
            filetypes=[("画像ファイル", "*.png *.jpg *.jpeg *.gif *.bmp *.webp"),
                       ("全てのファイル", "*.*")])
        if not path:
            return
        self.image = Image.open(path)
        self.zoom = 1.0
        self._show_image()
        w, h = self.image.size
        self.info_label.config(
            text=f"{w} × {h} px  |  {self.image.mode}  |  {path.split('/')[-1]}")

    def _show_image(self):
        if not self.image:
            return
        w, h = self.image.size
        new_w, new_h = int(w * self.zoom), int(h * self.zoom)
        resized = self.image.resize((new_w, new_h), Image.LANCZOS)
        self.photo = ImageTk.PhotoImage(resized)
        self.canvas.delete("all")
        self.canvas.create_image(0, 0, anchor=tk.NW, image=self.photo)
        self.canvas.configure(scrollregion=(0, 0, new_w, new_h))

    def change_zoom(self, factor):
        self.zoom = max(0.05, min(self.zoom * factor, 10.0))
        self._show_image()

    def set_zoom(self, zoom):
        self.zoom = zoom
        self._show_image()

    def fit_to_window(self):
        if not self.image:
            return
        cw = self.canvas.winfo_width()
        ch = self.canvas.winfo_height()
        iw, ih = self.image.size
        self.zoom = min(cw / iw, ch / ih)
        self._show_image()

    def _on_mousewheel(self, event):
        factor = 1.1 if event.delta > 0 else 0.9
        self.change_zoom(factor)


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

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

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
from PIL import Image, ImageTk


class App28:
    """画像ビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("画像ビューアー")
        self.root.geometry("640x520")
        self.root.configure(bg="#222")
        self.image = None
        self.photo = None
        self.zoom = 1.0
        self._build_ui()

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#333", pady=6)
        toolbar.pack(fill=tk.X)
        ttk.Button(toolbar, text="📂 開く", command=self.open_image).pack(side=tk.LEFT, padx=6)
        ttk.Button(toolbar, text="🔍+", command=lambda: self.change_zoom(1.2)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="🔍-", command=lambda: self.change_zoom(0.8)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="原寸", command=lambda: self.set_zoom(1.0)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="フィット", command=self.fit_to_window).pack(side=tk.LEFT, padx=2)
        self.info_label = tk.Label(toolbar, text="画像を開いてください",
                                   bg="#333", fg="#aaa", font=("Noto Sans JP", 10))
        self.info_label.pack(side=tk.LEFT, padx=12)

        # スクロール付きキャンバス
        canvas_frame = tk.Frame(self.root, bg="#222")
        canvas_frame.pack(fill=tk.BOTH, expand=True)

        self.canvas = tk.Canvas(canvas_frame, bg="#222", cursor="crosshair")
        self.canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL, command=self.canvas.yview)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb = ttk.Scrollbar(self.root, orient=tk.HORIZONTAL, command=self.canvas.xview)
        h_sb.pack(fill=tk.X)
        self.canvas.configure(xscrollcommand=h_sb.set, yscrollcommand=v_sb.set)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)

    def open_image(self):
        path = filedialog.askopenfilename(
            filetypes=[("画像ファイル", "*.png *.jpg *.jpeg *.gif *.bmp *.webp"),
                       ("全てのファイル", "*.*")])
        if not path:
            return
        self.image = Image.open(path)
        self.zoom = 1.0
        self._show_image()
        w, h = self.image.size
        self.info_label.config(
            text=f"{w} × {h} px  |  {self.image.mode}  |  {path.split('/')[-1]}")

    def _show_image(self):
        if not self.image:
            return
        w, h = self.image.size
        new_w, new_h = int(w * self.zoom), int(h * self.zoom)
        resized = self.image.resize((new_w, new_h), Image.LANCZOS)
        self.photo = ImageTk.PhotoImage(resized)
        self.canvas.delete("all")
        self.canvas.create_image(0, 0, anchor=tk.NW, image=self.photo)
        self.canvas.configure(scrollregion=(0, 0, new_w, new_h))

    def change_zoom(self, factor):
        self.zoom = max(0.05, min(self.zoom * factor, 10.0))
        self._show_image()

    def set_zoom(self, zoom):
        self.zoom = zoom
        self._show_image()

    def fit_to_window(self):
        if not self.image:
            return
        cw = self.canvas.winfo_width()
        ch = self.canvas.winfo_height()
        iw, ih = self.image.size
        self.zoom = min(cw / iw, ch / ih)
        self._show_image()

    def _on_mousewheel(self, event):
        factor = 1.1 if event.delta > 0 else 0.9
        self.change_zoom(factor)


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

例外処理とmessagebox

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

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
from PIL import Image, ImageTk


class App28:
    """画像ビューアー"""

    def __init__(self, root):
        self.root = root
        self.root.title("画像ビューアー")
        self.root.geometry("640x520")
        self.root.configure(bg="#222")
        self.image = None
        self.photo = None
        self.zoom = 1.0
        self._build_ui()

    def _build_ui(self):
        # ツールバー
        toolbar = tk.Frame(self.root, bg="#333", pady=6)
        toolbar.pack(fill=tk.X)
        ttk.Button(toolbar, text="📂 開く", command=self.open_image).pack(side=tk.LEFT, padx=6)
        ttk.Button(toolbar, text="🔍+", command=lambda: self.change_zoom(1.2)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="🔍-", command=lambda: self.change_zoom(0.8)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="原寸", command=lambda: self.set_zoom(1.0)).pack(side=tk.LEFT, padx=2)
        ttk.Button(toolbar, text="フィット", command=self.fit_to_window).pack(side=tk.LEFT, padx=2)
        self.info_label = tk.Label(toolbar, text="画像を開いてください",
                                   bg="#333", fg="#aaa", font=("Noto Sans JP", 10))
        self.info_label.pack(side=tk.LEFT, padx=12)

        # スクロール付きキャンバス
        canvas_frame = tk.Frame(self.root, bg="#222")
        canvas_frame.pack(fill=tk.BOTH, expand=True)

        self.canvas = tk.Canvas(canvas_frame, bg="#222", cursor="crosshair")
        self.canvas.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        v_sb = ttk.Scrollbar(canvas_frame, orient=tk.VERTICAL, command=self.canvas.yview)
        v_sb.pack(side=tk.RIGHT, fill=tk.Y)
        h_sb = ttk.Scrollbar(self.root, orient=tk.HORIZONTAL, command=self.canvas.xview)
        h_sb.pack(fill=tk.X)
        self.canvas.configure(xscrollcommand=h_sb.set, yscrollcommand=v_sb.set)
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)

    def open_image(self):
        path = filedialog.askopenfilename(
            filetypes=[("画像ファイル", "*.png *.jpg *.jpeg *.gif *.bmp *.webp"),
                       ("全てのファイル", "*.*")])
        if not path:
            return
        self.image = Image.open(path)
        self.zoom = 1.0
        self._show_image()
        w, h = self.image.size
        self.info_label.config(
            text=f"{w} × {h} px  |  {self.image.mode}  |  {path.split('/')[-1]}")

    def _show_image(self):
        if not self.image:
            return
        w, h = self.image.size
        new_w, new_h = int(w * self.zoom), int(h * self.zoom)
        resized = self.image.resize((new_w, new_h), Image.LANCZOS)
        self.photo = ImageTk.PhotoImage(resized)
        self.canvas.delete("all")
        self.canvas.create_image(0, 0, anchor=tk.NW, image=self.photo)
        self.canvas.configure(scrollregion=(0, 0, new_w, new_h))

    def change_zoom(self, factor):
        self.zoom = max(0.05, min(self.zoom * factor, 10.0))
        self._show_image()

    def set_zoom(self, zoom):
        self.zoom = zoom
        self._show_image()

    def fit_to_window(self):
        if not self.image:
            return
        cw = self.canvas.winfo_width()
        ch = self.canvas.winfo_height()
        iw, ih = self.image.size
        self.zoom = min(cw / iw, ch / ih)
        self._show_image()

    def _on_mousewheel(self, event):
        factor = 1.1 if event.delta > 0 else 0.9
        self.change_zoom(factor)


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

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

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

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

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

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

    App28クラスを定義し、__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:機能拡張

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

  2. 課題2:UIの改善

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

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

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

🚀
次に挑戦するアプリ

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