中級者向け No.086

HEXビューア

バイナリファイルの内容を16進数ダンプ形式で表示するHexビューア。オフセット・HEX・ASCII列を色分けして表示し、バイナリ解析を学ぶ。

🎯 難易度: ★★★ 難しい 📦 ライブラリ: tkinter(標準ライブラリ)のみ ⏱️ 制作時間: 30〜90分

1. アプリ概要

バイナリファイルの内容を16進数ダンプ形式で表示するHexビューア。オフセット・HEX・ASCII列を色分けして表示し、バイナリ解析を学ぶ。

このアプリはfileカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter、難易度は ★★★ 難しい です。

Pythonの豊富なライブラリを活用することで、実用的なアプリを短いコードで実装できます。ソースコードをコピーして実行し、仕組みを理解したうえでカスタマイズに挑戦してみてください。

GUIアプリ開発はプログラミングの楽しさを実感できる最も効果的な学習方法のひとつです。変数・関数・クラス・イベント処理などの重要な概念が自然と身につきます。

2. 機能一覧

  • HEXビューアのメイン機能
  • 直感的なGUIインターフェース
  • 入力値のバリデーション
  • エラーハンドリング
  • 結果の見やすい表示
  • クリア機能付き

3. 事前準備・環境

ℹ️
動作確認環境

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

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

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

4. 完全なソースコード

💡
コードのコピー方法

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

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


class App086:
    """HEXビューア"""

    BYTES_PER_ROW = 16
    PAGE_SIZE     = 512   # 表示バイト数 (1ページ)

    def __init__(self, root):
        self.root = root
        self.root.title("HEXビューア")
        self.root.geometry("920x620")
        self.root.configure(bg="#0d1117")
        self._data   = b""
        self._offset = 0    # 表示開始オフセット
        self._search_results = []
        self._build_ui()
        self.root.bind("<Prior>",  lambda e: self._page(-1))
        self.root.bind("<Next>",   lambda e: self._page(1))
        self.root.bind("<Home>",   lambda e: self._goto(0))
        self.root.bind("<End>",    lambda e: self._goto(max(0, len(self._data) - self.PAGE_SIZE)))

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#161b22", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔢 HEXビューア",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#161b22", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # ツールバー
        tb = tk.Frame(self.root, bg="#161b22", pady=4)
        tb.pack(fill=tk.X)
        ttk.Button(tb, text="📂 ファイルを開く",
                   command=self._open).pack(side=tk.LEFT, padx=4)

        tk.Label(tb, text="ページ:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.page_var = tk.IntVar(value=1)
        ttk.Spinbox(tb, from_=1, to=9999, textvariable=self.page_var,
                    width=6,
                    command=self._on_page_spin).pack(side=tk.LEFT)
        tk.Label(tb, text="/", bg="#161b22", fg="#8b949e").pack(side=tk.LEFT)
        self.total_pages_lbl = tk.Label(tb, text="1", bg="#161b22",
                                          fg="#8b949e", font=("Arial", 9))
        self.total_pages_lbl.pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="◀",
                   command=lambda: self._page(-1)).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="▶",
                   command=lambda: self._page(1)).pack(side=tk.LEFT, padx=2)

        # 検索
        tk.Label(tb, text="検索:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.search_var = tk.StringVar()
        ttk.Entry(tb, textvariable=self.search_var, width=14).pack(side=tk.LEFT)
        self.search_mode_var = tk.StringVar(value="HEX")
        ttk.Combobox(tb, textvariable=self.search_mode_var,
                     values=["HEX", "ASCII"], state="readonly",
                     width=6).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="🔍 検索",
                   command=self._search).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="次へ",
                   command=self._search_next).pack(side=tk.LEFT, padx=2)
        self._search_idx = 0

        # メインエリア: HEXダンプ
        text_f = tk.Frame(self.root, bg="#0d1117")
        text_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 行番号キャンバスは Text の行番号表示で代用
        self.hex_text = tk.Text(
            text_f, bg="#0d1117", fg="#c9d1d9",
            font=("Courier New", 10), relief=tk.FLAT,
            state=tk.DISABLED, wrap=tk.NONE,
            width=78, insertbackground="white")
        xsb = ttk.Scrollbar(text_f, orient=tk.HORIZONTAL,
                             command=self.hex_text.xview)
        ysb = ttk.Scrollbar(text_f, command=self.hex_text.yview)
        self.hex_text.configure(xscrollcommand=xsb.set,
                                 yscrollcommand=ysb.set)
        ysb.pack(side=tk.RIGHT, fill=tk.Y)
        self.hex_text.pack(fill=tk.BOTH, expand=True)
        xsb.pack(fill=tk.X)

        # カラータグ
        self.hex_text.tag_configure("addr",    foreground="#79b8ff")
        self.hex_text.tag_configure("zero",    foreground="#3c4043")
        self.hex_text.tag_configure("printable", foreground="#b5e853")
        self.hex_text.tag_configure("search",  background="#f57c00",
                                     foreground="#000")

        # 下部: ファイル情報
        self.info_var = tk.StringVar(value="ファイルを開いてください")
        tk.Label(self.root, textvariable=self.info_var,
                 bg="#161b22", fg="#8b949e", font=("Courier New", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open(self):
        path = filedialog.askopenfilename(filetypes=[("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, "rb") as f:
                self._data = f.read()
            self._offset = 0
            total = max(1, (len(self._data) + self.PAGE_SIZE - 1) // self.PAGE_SIZE)
            self.total_pages_lbl.config(text=str(total))
            self.page_var.set(1)
            self._render()
            size = len(self._data)
            self.info_var.set(
                f"{os.path.basename(path)}  |  {size:,} bytes  |  "
                f"PageUp/Down でページ移動  |  PgUp/PgDn / ◀▶ ボタン")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _render(self):
        bpr = self.BYTES_PER_ROW
        start = self._offset
        end   = min(start + self.PAGE_SIZE, len(self._data))
        chunk = self._data[start:end]

        self.hex_text.configure(state=tk.NORMAL)
        self.hex_text.delete("1.0", tk.END)

        lines = []
        for row_start in range(0, len(chunk), bpr):
            row = chunk[row_start:row_start + bpr]
            addr = start + row_start
            hex_part  = " ".join(f"{b:02X}" for b in row)
            hex_part  = hex_part.ljust(bpr * 3 - 1)
            ascii_part = "".join(chr(b) if 32 <= b < 127 else "." for b in row)
            line = f"{addr:08X}  {hex_part}  |{ascii_part}|\n"
            lines.append((addr, row, line))

        for addr, row, line in lines:
            bpr = self.BYTES_PER_ROW
            # アドレス部分
            self.hex_text.insert(tk.END, f"{addr:08X}", "addr")
            self.hex_text.insert(tk.END, "  ")
            # HEX部分
            for i, b in enumerate(row):
                tag = "zero" if b == 0 else ""
                self.hex_text.insert(tk.END, f"{b:02X}", tag)
                self.hex_text.insert(tk.END, " ")
            # 端揃え
            if len(row) < bpr:
                self.hex_text.insert(tk.END, "   " * (bpr - len(row)))
            self.hex_text.insert(tk.END, " |")
            # ASCII部分
            for b in row:
                ch = chr(b) if 32 <= b < 127 else "."
                tag = "printable" if 32 <= b < 127 else ""
                self.hex_text.insert(tk.END, ch, tag)
            self.hex_text.insert(tk.END, "|\n")

        self.hex_text.configure(state=tk.DISABLED)
        page = self._offset // self.PAGE_SIZE + 1
        self.page_var.set(page)

    def _page(self, delta):
        new_offset = self._offset + delta * self.PAGE_SIZE
        self._goto(new_offset)

    def _goto(self, offset):
        offset = max(0, min(offset, len(self._data) - 1 if self._data else 0))
        # アライン
        offset = (offset // self.PAGE_SIZE) * self.PAGE_SIZE
        if offset != self._offset:
            self._offset = offset
            self._render()

    def _on_page_spin(self):
        try:
            page = int(self.page_var.get())
            self._goto((page - 1) * self.PAGE_SIZE)
        except Exception:
            pass

    def _search(self):
        query = self.search_var.get().strip()
        if not query or not self._data:
            return
        mode = self.search_mode_var.get()
        try:
            if mode == "HEX":
                needle = bytes.fromhex(query.replace(" ", ""))
            else:
                needle = query.encode("ascii", errors="replace")
        except Exception as e:
            messagebox.showerror("エラー", f"検索パターンが不正: {e}")
            return

        results = []
        start = 0
        while True:
            pos = self._data.find(needle, start)
            if pos == -1:
                break
            results.append(pos)
            start = pos + 1

        self._search_results = results
        self._search_idx     = 0
        if results:
            self._highlight_search(results[0], len(needle))
            self.info_var.set(f"検索: {len(results)} 件見つかりました")
        else:
            self.info_var.set("見つかりませんでした")

    def _search_next(self):
        if not self._search_results:
            return
        self._search_idx = (self._search_idx + 1) % len(self._search_results)
        pos = self._search_results[self._search_idx]
        query = self.search_var.get().strip()
        mode  = self.search_mode_var.get()
        try:
            length = len(bytes.fromhex(query.replace(" ", ""))) if mode == "HEX" \
                     else len(query.encode("ascii", errors="replace"))
        except Exception:
            length = 1
        self._highlight_search(pos, length)

    def _highlight_search(self, pos, length):
        # 該当ページへ移動
        page_offset = (pos // self.PAGE_SIZE) * self.PAGE_SIZE
        if page_offset != self._offset:
            self._offset = page_offset
            self._render()
        # ハイライト (簡易: 行内のHEX部分)
        self.hex_text.tag_remove("search", "1.0", tk.END)
        local = pos - self._offset
        if 0 <= local < self.PAGE_SIZE:
            row = local // self.BYTES_PER_ROW
            col = local % self.BYTES_PER_ROW
            # テキスト行: row+1, HEX列: 10 (addr) + col*3
            line_no  = row + 1
            hex_col  = 10 + col * 3
            end_col  = hex_col + length * 3 - 1
            self.hex_text.tag_add(
                "search",
                f"{line_no}.{hex_col}", f"{line_no}.{end_col}")
            self.hex_text.see(f"{line_no}.0")
        self.info_var.set(
            f"オフセット: 0x{pos:08X} ({pos})  "
            f"({self._search_idx + 1}/{len(self._search_results)} 件目)")


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

5. コード解説

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

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

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

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


class App086:
    """HEXビューア"""

    BYTES_PER_ROW = 16
    PAGE_SIZE     = 512   # 表示バイト数 (1ページ)

    def __init__(self, root):
        self.root = root
        self.root.title("HEXビューア")
        self.root.geometry("920x620")
        self.root.configure(bg="#0d1117")
        self._data   = b""
        self._offset = 0    # 表示開始オフセット
        self._search_results = []
        self._build_ui()
        self.root.bind("<Prior>",  lambda e: self._page(-1))
        self.root.bind("<Next>",   lambda e: self._page(1))
        self.root.bind("<Home>",   lambda e: self._goto(0))
        self.root.bind("<End>",    lambda e: self._goto(max(0, len(self._data) - self.PAGE_SIZE)))

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#161b22", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔢 HEXビューア",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#161b22", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # ツールバー
        tb = tk.Frame(self.root, bg="#161b22", pady=4)
        tb.pack(fill=tk.X)
        ttk.Button(tb, text="📂 ファイルを開く",
                   command=self._open).pack(side=tk.LEFT, padx=4)

        tk.Label(tb, text="ページ:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.page_var = tk.IntVar(value=1)
        ttk.Spinbox(tb, from_=1, to=9999, textvariable=self.page_var,
                    width=6,
                    command=self._on_page_spin).pack(side=tk.LEFT)
        tk.Label(tb, text="/", bg="#161b22", fg="#8b949e").pack(side=tk.LEFT)
        self.total_pages_lbl = tk.Label(tb, text="1", bg="#161b22",
                                          fg="#8b949e", font=("Arial", 9))
        self.total_pages_lbl.pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="◀",
                   command=lambda: self._page(-1)).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="▶",
                   command=lambda: self._page(1)).pack(side=tk.LEFT, padx=2)

        # 検索
        tk.Label(tb, text="検索:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.search_var = tk.StringVar()
        ttk.Entry(tb, textvariable=self.search_var, width=14).pack(side=tk.LEFT)
        self.search_mode_var = tk.StringVar(value="HEX")
        ttk.Combobox(tb, textvariable=self.search_mode_var,
                     values=["HEX", "ASCII"], state="readonly",
                     width=6).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="🔍 検索",
                   command=self._search).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="次へ",
                   command=self._search_next).pack(side=tk.LEFT, padx=2)
        self._search_idx = 0

        # メインエリア: HEXダンプ
        text_f = tk.Frame(self.root, bg="#0d1117")
        text_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 行番号キャンバスは Text の行番号表示で代用
        self.hex_text = tk.Text(
            text_f, bg="#0d1117", fg="#c9d1d9",
            font=("Courier New", 10), relief=tk.FLAT,
            state=tk.DISABLED, wrap=tk.NONE,
            width=78, insertbackground="white")
        xsb = ttk.Scrollbar(text_f, orient=tk.HORIZONTAL,
                             command=self.hex_text.xview)
        ysb = ttk.Scrollbar(text_f, command=self.hex_text.yview)
        self.hex_text.configure(xscrollcommand=xsb.set,
                                 yscrollcommand=ysb.set)
        ysb.pack(side=tk.RIGHT, fill=tk.Y)
        self.hex_text.pack(fill=tk.BOTH, expand=True)
        xsb.pack(fill=tk.X)

        # カラータグ
        self.hex_text.tag_configure("addr",    foreground="#79b8ff")
        self.hex_text.tag_configure("zero",    foreground="#3c4043")
        self.hex_text.tag_configure("printable", foreground="#b5e853")
        self.hex_text.tag_configure("search",  background="#f57c00",
                                     foreground="#000")

        # 下部: ファイル情報
        self.info_var = tk.StringVar(value="ファイルを開いてください")
        tk.Label(self.root, textvariable=self.info_var,
                 bg="#161b22", fg="#8b949e", font=("Courier New", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open(self):
        path = filedialog.askopenfilename(filetypes=[("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, "rb") as f:
                self._data = f.read()
            self._offset = 0
            total = max(1, (len(self._data) + self.PAGE_SIZE - 1) // self.PAGE_SIZE)
            self.total_pages_lbl.config(text=str(total))
            self.page_var.set(1)
            self._render()
            size = len(self._data)
            self.info_var.set(
                f"{os.path.basename(path)}  |  {size:,} bytes  |  "
                f"PageUp/Down でページ移動  |  PgUp/PgDn / ◀▶ ボタン")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _render(self):
        bpr = self.BYTES_PER_ROW
        start = self._offset
        end   = min(start + self.PAGE_SIZE, len(self._data))
        chunk = self._data[start:end]

        self.hex_text.configure(state=tk.NORMAL)
        self.hex_text.delete("1.0", tk.END)

        lines = []
        for row_start in range(0, len(chunk), bpr):
            row = chunk[row_start:row_start + bpr]
            addr = start + row_start
            hex_part  = " ".join(f"{b:02X}" for b in row)
            hex_part  = hex_part.ljust(bpr * 3 - 1)
            ascii_part = "".join(chr(b) if 32 <= b < 127 else "." for b in row)
            line = f"{addr:08X}  {hex_part}  |{ascii_part}|\n"
            lines.append((addr, row, line))

        for addr, row, line in lines:
            bpr = self.BYTES_PER_ROW
            # アドレス部分
            self.hex_text.insert(tk.END, f"{addr:08X}", "addr")
            self.hex_text.insert(tk.END, "  ")
            # HEX部分
            for i, b in enumerate(row):
                tag = "zero" if b == 0 else ""
                self.hex_text.insert(tk.END, f"{b:02X}", tag)
                self.hex_text.insert(tk.END, " ")
            # 端揃え
            if len(row) < bpr:
                self.hex_text.insert(tk.END, "   " * (bpr - len(row)))
            self.hex_text.insert(tk.END, " |")
            # ASCII部分
            for b in row:
                ch = chr(b) if 32 <= b < 127 else "."
                tag = "printable" if 32 <= b < 127 else ""
                self.hex_text.insert(tk.END, ch, tag)
            self.hex_text.insert(tk.END, "|\n")

        self.hex_text.configure(state=tk.DISABLED)
        page = self._offset // self.PAGE_SIZE + 1
        self.page_var.set(page)

    def _page(self, delta):
        new_offset = self._offset + delta * self.PAGE_SIZE
        self._goto(new_offset)

    def _goto(self, offset):
        offset = max(0, min(offset, len(self._data) - 1 if self._data else 0))
        # アライン
        offset = (offset // self.PAGE_SIZE) * self.PAGE_SIZE
        if offset != self._offset:
            self._offset = offset
            self._render()

    def _on_page_spin(self):
        try:
            page = int(self.page_var.get())
            self._goto((page - 1) * self.PAGE_SIZE)
        except Exception:
            pass

    def _search(self):
        query = self.search_var.get().strip()
        if not query or not self._data:
            return
        mode = self.search_mode_var.get()
        try:
            if mode == "HEX":
                needle = bytes.fromhex(query.replace(" ", ""))
            else:
                needle = query.encode("ascii", errors="replace")
        except Exception as e:
            messagebox.showerror("エラー", f"検索パターンが不正: {e}")
            return

        results = []
        start = 0
        while True:
            pos = self._data.find(needle, start)
            if pos == -1:
                break
            results.append(pos)
            start = pos + 1

        self._search_results = results
        self._search_idx     = 0
        if results:
            self._highlight_search(results[0], len(needle))
            self.info_var.set(f"検索: {len(results)} 件見つかりました")
        else:
            self.info_var.set("見つかりませんでした")

    def _search_next(self):
        if not self._search_results:
            return
        self._search_idx = (self._search_idx + 1) % len(self._search_results)
        pos = self._search_results[self._search_idx]
        query = self.search_var.get().strip()
        mode  = self.search_mode_var.get()
        try:
            length = len(bytes.fromhex(query.replace(" ", ""))) if mode == "HEX" \
                     else len(query.encode("ascii", errors="replace"))
        except Exception:
            length = 1
        self._highlight_search(pos, length)

    def _highlight_search(self, pos, length):
        # 該当ページへ移動
        page_offset = (pos // self.PAGE_SIZE) * self.PAGE_SIZE
        if page_offset != self._offset:
            self._offset = page_offset
            self._render()
        # ハイライト (簡易: 行内のHEX部分)
        self.hex_text.tag_remove("search", "1.0", tk.END)
        local = pos - self._offset
        if 0 <= local < self.PAGE_SIZE:
            row = local // self.BYTES_PER_ROW
            col = local % self.BYTES_PER_ROW
            # テキスト行: row+1, HEX列: 10 (addr) + col*3
            line_no  = row + 1
            hex_col  = 10 + col * 3
            end_col  = hex_col + length * 3 - 1
            self.hex_text.tag_add(
                "search",
                f"{line_no}.{hex_col}", f"{line_no}.{end_col}")
            self.hex_text.see(f"{line_no}.0")
        self.info_var.set(
            f"オフセット: 0x{pos:08X} ({pos})  "
            f"({self._search_idx + 1}/{len(self._search_results)} 件目)")


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

UIレイアウトの構築

LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。

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


class App086:
    """HEXビューア"""

    BYTES_PER_ROW = 16
    PAGE_SIZE     = 512   # 表示バイト数 (1ページ)

    def __init__(self, root):
        self.root = root
        self.root.title("HEXビューア")
        self.root.geometry("920x620")
        self.root.configure(bg="#0d1117")
        self._data   = b""
        self._offset = 0    # 表示開始オフセット
        self._search_results = []
        self._build_ui()
        self.root.bind("<Prior>",  lambda e: self._page(-1))
        self.root.bind("<Next>",   lambda e: self._page(1))
        self.root.bind("<Home>",   lambda e: self._goto(0))
        self.root.bind("<End>",    lambda e: self._goto(max(0, len(self._data) - self.PAGE_SIZE)))

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#161b22", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔢 HEXビューア",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#161b22", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # ツールバー
        tb = tk.Frame(self.root, bg="#161b22", pady=4)
        tb.pack(fill=tk.X)
        ttk.Button(tb, text="📂 ファイルを開く",
                   command=self._open).pack(side=tk.LEFT, padx=4)

        tk.Label(tb, text="ページ:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.page_var = tk.IntVar(value=1)
        ttk.Spinbox(tb, from_=1, to=9999, textvariable=self.page_var,
                    width=6,
                    command=self._on_page_spin).pack(side=tk.LEFT)
        tk.Label(tb, text="/", bg="#161b22", fg="#8b949e").pack(side=tk.LEFT)
        self.total_pages_lbl = tk.Label(tb, text="1", bg="#161b22",
                                          fg="#8b949e", font=("Arial", 9))
        self.total_pages_lbl.pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="◀",
                   command=lambda: self._page(-1)).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="▶",
                   command=lambda: self._page(1)).pack(side=tk.LEFT, padx=2)

        # 検索
        tk.Label(tb, text="検索:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.search_var = tk.StringVar()
        ttk.Entry(tb, textvariable=self.search_var, width=14).pack(side=tk.LEFT)
        self.search_mode_var = tk.StringVar(value="HEX")
        ttk.Combobox(tb, textvariable=self.search_mode_var,
                     values=["HEX", "ASCII"], state="readonly",
                     width=6).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="🔍 検索",
                   command=self._search).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="次へ",
                   command=self._search_next).pack(side=tk.LEFT, padx=2)
        self._search_idx = 0

        # メインエリア: HEXダンプ
        text_f = tk.Frame(self.root, bg="#0d1117")
        text_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 行番号キャンバスは Text の行番号表示で代用
        self.hex_text = tk.Text(
            text_f, bg="#0d1117", fg="#c9d1d9",
            font=("Courier New", 10), relief=tk.FLAT,
            state=tk.DISABLED, wrap=tk.NONE,
            width=78, insertbackground="white")
        xsb = ttk.Scrollbar(text_f, orient=tk.HORIZONTAL,
                             command=self.hex_text.xview)
        ysb = ttk.Scrollbar(text_f, command=self.hex_text.yview)
        self.hex_text.configure(xscrollcommand=xsb.set,
                                 yscrollcommand=ysb.set)
        ysb.pack(side=tk.RIGHT, fill=tk.Y)
        self.hex_text.pack(fill=tk.BOTH, expand=True)
        xsb.pack(fill=tk.X)

        # カラータグ
        self.hex_text.tag_configure("addr",    foreground="#79b8ff")
        self.hex_text.tag_configure("zero",    foreground="#3c4043")
        self.hex_text.tag_configure("printable", foreground="#b5e853")
        self.hex_text.tag_configure("search",  background="#f57c00",
                                     foreground="#000")

        # 下部: ファイル情報
        self.info_var = tk.StringVar(value="ファイルを開いてください")
        tk.Label(self.root, textvariable=self.info_var,
                 bg="#161b22", fg="#8b949e", font=("Courier New", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open(self):
        path = filedialog.askopenfilename(filetypes=[("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, "rb") as f:
                self._data = f.read()
            self._offset = 0
            total = max(1, (len(self._data) + self.PAGE_SIZE - 1) // self.PAGE_SIZE)
            self.total_pages_lbl.config(text=str(total))
            self.page_var.set(1)
            self._render()
            size = len(self._data)
            self.info_var.set(
                f"{os.path.basename(path)}  |  {size:,} bytes  |  "
                f"PageUp/Down でページ移動  |  PgUp/PgDn / ◀▶ ボタン")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _render(self):
        bpr = self.BYTES_PER_ROW
        start = self._offset
        end   = min(start + self.PAGE_SIZE, len(self._data))
        chunk = self._data[start:end]

        self.hex_text.configure(state=tk.NORMAL)
        self.hex_text.delete("1.0", tk.END)

        lines = []
        for row_start in range(0, len(chunk), bpr):
            row = chunk[row_start:row_start + bpr]
            addr = start + row_start
            hex_part  = " ".join(f"{b:02X}" for b in row)
            hex_part  = hex_part.ljust(bpr * 3 - 1)
            ascii_part = "".join(chr(b) if 32 <= b < 127 else "." for b in row)
            line = f"{addr:08X}  {hex_part}  |{ascii_part}|\n"
            lines.append((addr, row, line))

        for addr, row, line in lines:
            bpr = self.BYTES_PER_ROW
            # アドレス部分
            self.hex_text.insert(tk.END, f"{addr:08X}", "addr")
            self.hex_text.insert(tk.END, "  ")
            # HEX部分
            for i, b in enumerate(row):
                tag = "zero" if b == 0 else ""
                self.hex_text.insert(tk.END, f"{b:02X}", tag)
                self.hex_text.insert(tk.END, " ")
            # 端揃え
            if len(row) < bpr:
                self.hex_text.insert(tk.END, "   " * (bpr - len(row)))
            self.hex_text.insert(tk.END, " |")
            # ASCII部分
            for b in row:
                ch = chr(b) if 32 <= b < 127 else "."
                tag = "printable" if 32 <= b < 127 else ""
                self.hex_text.insert(tk.END, ch, tag)
            self.hex_text.insert(tk.END, "|\n")

        self.hex_text.configure(state=tk.DISABLED)
        page = self._offset // self.PAGE_SIZE + 1
        self.page_var.set(page)

    def _page(self, delta):
        new_offset = self._offset + delta * self.PAGE_SIZE
        self._goto(new_offset)

    def _goto(self, offset):
        offset = max(0, min(offset, len(self._data) - 1 if self._data else 0))
        # アライン
        offset = (offset // self.PAGE_SIZE) * self.PAGE_SIZE
        if offset != self._offset:
            self._offset = offset
            self._render()

    def _on_page_spin(self):
        try:
            page = int(self.page_var.get())
            self._goto((page - 1) * self.PAGE_SIZE)
        except Exception:
            pass

    def _search(self):
        query = self.search_var.get().strip()
        if not query or not self._data:
            return
        mode = self.search_mode_var.get()
        try:
            if mode == "HEX":
                needle = bytes.fromhex(query.replace(" ", ""))
            else:
                needle = query.encode("ascii", errors="replace")
        except Exception as e:
            messagebox.showerror("エラー", f"検索パターンが不正: {e}")
            return

        results = []
        start = 0
        while True:
            pos = self._data.find(needle, start)
            if pos == -1:
                break
            results.append(pos)
            start = pos + 1

        self._search_results = results
        self._search_idx     = 0
        if results:
            self._highlight_search(results[0], len(needle))
            self.info_var.set(f"検索: {len(results)} 件見つかりました")
        else:
            self.info_var.set("見つかりませんでした")

    def _search_next(self):
        if not self._search_results:
            return
        self._search_idx = (self._search_idx + 1) % len(self._search_results)
        pos = self._search_results[self._search_idx]
        query = self.search_var.get().strip()
        mode  = self.search_mode_var.get()
        try:
            length = len(bytes.fromhex(query.replace(" ", ""))) if mode == "HEX" \
                     else len(query.encode("ascii", errors="replace"))
        except Exception:
            length = 1
        self._highlight_search(pos, length)

    def _highlight_search(self, pos, length):
        # 該当ページへ移動
        page_offset = (pos // self.PAGE_SIZE) * self.PAGE_SIZE
        if page_offset != self._offset:
            self._offset = page_offset
            self._render()
        # ハイライト (簡易: 行内のHEX部分)
        self.hex_text.tag_remove("search", "1.0", tk.END)
        local = pos - self._offset
        if 0 <= local < self.PAGE_SIZE:
            row = local // self.BYTES_PER_ROW
            col = local % self.BYTES_PER_ROW
            # テキスト行: row+1, HEX列: 10 (addr) + col*3
            line_no  = row + 1
            hex_col  = 10 + col * 3
            end_col  = hex_col + length * 3 - 1
            self.hex_text.tag_add(
                "search",
                f"{line_no}.{hex_col}", f"{line_no}.{end_col}")
            self.hex_text.see(f"{line_no}.0")
        self.info_var.set(
            f"オフセット: 0x{pos:08X} ({pos})  "
            f"({self._search_idx + 1}/{len(self._search_results)} 件目)")


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

イベント処理

ボタンのcommand引数でクリックイベントを、bind('')でEnterキーイベントを処理します。どちらの操作でも同じprocess()が呼ばれ、コードの重複を避けられます。

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


class App086:
    """HEXビューア"""

    BYTES_PER_ROW = 16
    PAGE_SIZE     = 512   # 表示バイト数 (1ページ)

    def __init__(self, root):
        self.root = root
        self.root.title("HEXビューア")
        self.root.geometry("920x620")
        self.root.configure(bg="#0d1117")
        self._data   = b""
        self._offset = 0    # 表示開始オフセット
        self._search_results = []
        self._build_ui()
        self.root.bind("<Prior>",  lambda e: self._page(-1))
        self.root.bind("<Next>",   lambda e: self._page(1))
        self.root.bind("<Home>",   lambda e: self._goto(0))
        self.root.bind("<End>",    lambda e: self._goto(max(0, len(self._data) - self.PAGE_SIZE)))

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#161b22", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔢 HEXビューア",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#161b22", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # ツールバー
        tb = tk.Frame(self.root, bg="#161b22", pady=4)
        tb.pack(fill=tk.X)
        ttk.Button(tb, text="📂 ファイルを開く",
                   command=self._open).pack(side=tk.LEFT, padx=4)

        tk.Label(tb, text="ページ:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.page_var = tk.IntVar(value=1)
        ttk.Spinbox(tb, from_=1, to=9999, textvariable=self.page_var,
                    width=6,
                    command=self._on_page_spin).pack(side=tk.LEFT)
        tk.Label(tb, text="/", bg="#161b22", fg="#8b949e").pack(side=tk.LEFT)
        self.total_pages_lbl = tk.Label(tb, text="1", bg="#161b22",
                                          fg="#8b949e", font=("Arial", 9))
        self.total_pages_lbl.pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="◀",
                   command=lambda: self._page(-1)).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="▶",
                   command=lambda: self._page(1)).pack(side=tk.LEFT, padx=2)

        # 検索
        tk.Label(tb, text="検索:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.search_var = tk.StringVar()
        ttk.Entry(tb, textvariable=self.search_var, width=14).pack(side=tk.LEFT)
        self.search_mode_var = tk.StringVar(value="HEX")
        ttk.Combobox(tb, textvariable=self.search_mode_var,
                     values=["HEX", "ASCII"], state="readonly",
                     width=6).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="🔍 検索",
                   command=self._search).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="次へ",
                   command=self._search_next).pack(side=tk.LEFT, padx=2)
        self._search_idx = 0

        # メインエリア: HEXダンプ
        text_f = tk.Frame(self.root, bg="#0d1117")
        text_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 行番号キャンバスは Text の行番号表示で代用
        self.hex_text = tk.Text(
            text_f, bg="#0d1117", fg="#c9d1d9",
            font=("Courier New", 10), relief=tk.FLAT,
            state=tk.DISABLED, wrap=tk.NONE,
            width=78, insertbackground="white")
        xsb = ttk.Scrollbar(text_f, orient=tk.HORIZONTAL,
                             command=self.hex_text.xview)
        ysb = ttk.Scrollbar(text_f, command=self.hex_text.yview)
        self.hex_text.configure(xscrollcommand=xsb.set,
                                 yscrollcommand=ysb.set)
        ysb.pack(side=tk.RIGHT, fill=tk.Y)
        self.hex_text.pack(fill=tk.BOTH, expand=True)
        xsb.pack(fill=tk.X)

        # カラータグ
        self.hex_text.tag_configure("addr",    foreground="#79b8ff")
        self.hex_text.tag_configure("zero",    foreground="#3c4043")
        self.hex_text.tag_configure("printable", foreground="#b5e853")
        self.hex_text.tag_configure("search",  background="#f57c00",
                                     foreground="#000")

        # 下部: ファイル情報
        self.info_var = tk.StringVar(value="ファイルを開いてください")
        tk.Label(self.root, textvariable=self.info_var,
                 bg="#161b22", fg="#8b949e", font=("Courier New", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open(self):
        path = filedialog.askopenfilename(filetypes=[("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, "rb") as f:
                self._data = f.read()
            self._offset = 0
            total = max(1, (len(self._data) + self.PAGE_SIZE - 1) // self.PAGE_SIZE)
            self.total_pages_lbl.config(text=str(total))
            self.page_var.set(1)
            self._render()
            size = len(self._data)
            self.info_var.set(
                f"{os.path.basename(path)}  |  {size:,} bytes  |  "
                f"PageUp/Down でページ移動  |  PgUp/PgDn / ◀▶ ボタン")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _render(self):
        bpr = self.BYTES_PER_ROW
        start = self._offset
        end   = min(start + self.PAGE_SIZE, len(self._data))
        chunk = self._data[start:end]

        self.hex_text.configure(state=tk.NORMAL)
        self.hex_text.delete("1.0", tk.END)

        lines = []
        for row_start in range(0, len(chunk), bpr):
            row = chunk[row_start:row_start + bpr]
            addr = start + row_start
            hex_part  = " ".join(f"{b:02X}" for b in row)
            hex_part  = hex_part.ljust(bpr * 3 - 1)
            ascii_part = "".join(chr(b) if 32 <= b < 127 else "." for b in row)
            line = f"{addr:08X}  {hex_part}  |{ascii_part}|\n"
            lines.append((addr, row, line))

        for addr, row, line in lines:
            bpr = self.BYTES_PER_ROW
            # アドレス部分
            self.hex_text.insert(tk.END, f"{addr:08X}", "addr")
            self.hex_text.insert(tk.END, "  ")
            # HEX部分
            for i, b in enumerate(row):
                tag = "zero" if b == 0 else ""
                self.hex_text.insert(tk.END, f"{b:02X}", tag)
                self.hex_text.insert(tk.END, " ")
            # 端揃え
            if len(row) < bpr:
                self.hex_text.insert(tk.END, "   " * (bpr - len(row)))
            self.hex_text.insert(tk.END, " |")
            # ASCII部分
            for b in row:
                ch = chr(b) if 32 <= b < 127 else "."
                tag = "printable" if 32 <= b < 127 else ""
                self.hex_text.insert(tk.END, ch, tag)
            self.hex_text.insert(tk.END, "|\n")

        self.hex_text.configure(state=tk.DISABLED)
        page = self._offset // self.PAGE_SIZE + 1
        self.page_var.set(page)

    def _page(self, delta):
        new_offset = self._offset + delta * self.PAGE_SIZE
        self._goto(new_offset)

    def _goto(self, offset):
        offset = max(0, min(offset, len(self._data) - 1 if self._data else 0))
        # アライン
        offset = (offset // self.PAGE_SIZE) * self.PAGE_SIZE
        if offset != self._offset:
            self._offset = offset
            self._render()

    def _on_page_spin(self):
        try:
            page = int(self.page_var.get())
            self._goto((page - 1) * self.PAGE_SIZE)
        except Exception:
            pass

    def _search(self):
        query = self.search_var.get().strip()
        if not query or not self._data:
            return
        mode = self.search_mode_var.get()
        try:
            if mode == "HEX":
                needle = bytes.fromhex(query.replace(" ", ""))
            else:
                needle = query.encode("ascii", errors="replace")
        except Exception as e:
            messagebox.showerror("エラー", f"検索パターンが不正: {e}")
            return

        results = []
        start = 0
        while True:
            pos = self._data.find(needle, start)
            if pos == -1:
                break
            results.append(pos)
            start = pos + 1

        self._search_results = results
        self._search_idx     = 0
        if results:
            self._highlight_search(results[0], len(needle))
            self.info_var.set(f"検索: {len(results)} 件見つかりました")
        else:
            self.info_var.set("見つかりませんでした")

    def _search_next(self):
        if not self._search_results:
            return
        self._search_idx = (self._search_idx + 1) % len(self._search_results)
        pos = self._search_results[self._search_idx]
        query = self.search_var.get().strip()
        mode  = self.search_mode_var.get()
        try:
            length = len(bytes.fromhex(query.replace(" ", ""))) if mode == "HEX" \
                     else len(query.encode("ascii", errors="replace"))
        except Exception:
            length = 1
        self._highlight_search(pos, length)

    def _highlight_search(self, pos, length):
        # 該当ページへ移動
        page_offset = (pos // self.PAGE_SIZE) * self.PAGE_SIZE
        if page_offset != self._offset:
            self._offset = page_offset
            self._render()
        # ハイライト (簡易: 行内のHEX部分)
        self.hex_text.tag_remove("search", "1.0", tk.END)
        local = pos - self._offset
        if 0 <= local < self.PAGE_SIZE:
            row = local // self.BYTES_PER_ROW
            col = local % self.BYTES_PER_ROW
            # テキスト行: row+1, HEX列: 10 (addr) + col*3
            line_no  = row + 1
            hex_col  = 10 + col * 3
            end_col  = hex_col + length * 3 - 1
            self.hex_text.tag_add(
                "search",
                f"{line_no}.{hex_col}", f"{line_no}.{end_col}")
            self.hex_text.see(f"{line_no}.0")
        self.info_var.set(
            f"オフセット: 0x{pos:08X} ({pos})  "
            f"({self._search_idx + 1}/{len(self._search_results)} 件目)")


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

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

tk.Textウィジェットをstate=DISABLED(読み取り専用)で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。

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


class App086:
    """HEXビューア"""

    BYTES_PER_ROW = 16
    PAGE_SIZE     = 512   # 表示バイト数 (1ページ)

    def __init__(self, root):
        self.root = root
        self.root.title("HEXビューア")
        self.root.geometry("920x620")
        self.root.configure(bg="#0d1117")
        self._data   = b""
        self._offset = 0    # 表示開始オフセット
        self._search_results = []
        self._build_ui()
        self.root.bind("<Prior>",  lambda e: self._page(-1))
        self.root.bind("<Next>",   lambda e: self._page(1))
        self.root.bind("<Home>",   lambda e: self._goto(0))
        self.root.bind("<End>",    lambda e: self._goto(max(0, len(self._data) - self.PAGE_SIZE)))

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#161b22", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔢 HEXビューア",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#161b22", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # ツールバー
        tb = tk.Frame(self.root, bg="#161b22", pady=4)
        tb.pack(fill=tk.X)
        ttk.Button(tb, text="📂 ファイルを開く",
                   command=self._open).pack(side=tk.LEFT, padx=4)

        tk.Label(tb, text="ページ:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.page_var = tk.IntVar(value=1)
        ttk.Spinbox(tb, from_=1, to=9999, textvariable=self.page_var,
                    width=6,
                    command=self._on_page_spin).pack(side=tk.LEFT)
        tk.Label(tb, text="/", bg="#161b22", fg="#8b949e").pack(side=tk.LEFT)
        self.total_pages_lbl = tk.Label(tb, text="1", bg="#161b22",
                                          fg="#8b949e", font=("Arial", 9))
        self.total_pages_lbl.pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="◀",
                   command=lambda: self._page(-1)).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="▶",
                   command=lambda: self._page(1)).pack(side=tk.LEFT, padx=2)

        # 検索
        tk.Label(tb, text="検索:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.search_var = tk.StringVar()
        ttk.Entry(tb, textvariable=self.search_var, width=14).pack(side=tk.LEFT)
        self.search_mode_var = tk.StringVar(value="HEX")
        ttk.Combobox(tb, textvariable=self.search_mode_var,
                     values=["HEX", "ASCII"], state="readonly",
                     width=6).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="🔍 検索",
                   command=self._search).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="次へ",
                   command=self._search_next).pack(side=tk.LEFT, padx=2)
        self._search_idx = 0

        # メインエリア: HEXダンプ
        text_f = tk.Frame(self.root, bg="#0d1117")
        text_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 行番号キャンバスは Text の行番号表示で代用
        self.hex_text = tk.Text(
            text_f, bg="#0d1117", fg="#c9d1d9",
            font=("Courier New", 10), relief=tk.FLAT,
            state=tk.DISABLED, wrap=tk.NONE,
            width=78, insertbackground="white")
        xsb = ttk.Scrollbar(text_f, orient=tk.HORIZONTAL,
                             command=self.hex_text.xview)
        ysb = ttk.Scrollbar(text_f, command=self.hex_text.yview)
        self.hex_text.configure(xscrollcommand=xsb.set,
                                 yscrollcommand=ysb.set)
        ysb.pack(side=tk.RIGHT, fill=tk.Y)
        self.hex_text.pack(fill=tk.BOTH, expand=True)
        xsb.pack(fill=tk.X)

        # カラータグ
        self.hex_text.tag_configure("addr",    foreground="#79b8ff")
        self.hex_text.tag_configure("zero",    foreground="#3c4043")
        self.hex_text.tag_configure("printable", foreground="#b5e853")
        self.hex_text.tag_configure("search",  background="#f57c00",
                                     foreground="#000")

        # 下部: ファイル情報
        self.info_var = tk.StringVar(value="ファイルを開いてください")
        tk.Label(self.root, textvariable=self.info_var,
                 bg="#161b22", fg="#8b949e", font=("Courier New", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open(self):
        path = filedialog.askopenfilename(filetypes=[("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, "rb") as f:
                self._data = f.read()
            self._offset = 0
            total = max(1, (len(self._data) + self.PAGE_SIZE - 1) // self.PAGE_SIZE)
            self.total_pages_lbl.config(text=str(total))
            self.page_var.set(1)
            self._render()
            size = len(self._data)
            self.info_var.set(
                f"{os.path.basename(path)}  |  {size:,} bytes  |  "
                f"PageUp/Down でページ移動  |  PgUp/PgDn / ◀▶ ボタン")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _render(self):
        bpr = self.BYTES_PER_ROW
        start = self._offset
        end   = min(start + self.PAGE_SIZE, len(self._data))
        chunk = self._data[start:end]

        self.hex_text.configure(state=tk.NORMAL)
        self.hex_text.delete("1.0", tk.END)

        lines = []
        for row_start in range(0, len(chunk), bpr):
            row = chunk[row_start:row_start + bpr]
            addr = start + row_start
            hex_part  = " ".join(f"{b:02X}" for b in row)
            hex_part  = hex_part.ljust(bpr * 3 - 1)
            ascii_part = "".join(chr(b) if 32 <= b < 127 else "." for b in row)
            line = f"{addr:08X}  {hex_part}  |{ascii_part}|\n"
            lines.append((addr, row, line))

        for addr, row, line in lines:
            bpr = self.BYTES_PER_ROW
            # アドレス部分
            self.hex_text.insert(tk.END, f"{addr:08X}", "addr")
            self.hex_text.insert(tk.END, "  ")
            # HEX部分
            for i, b in enumerate(row):
                tag = "zero" if b == 0 else ""
                self.hex_text.insert(tk.END, f"{b:02X}", tag)
                self.hex_text.insert(tk.END, " ")
            # 端揃え
            if len(row) < bpr:
                self.hex_text.insert(tk.END, "   " * (bpr - len(row)))
            self.hex_text.insert(tk.END, " |")
            # ASCII部分
            for b in row:
                ch = chr(b) if 32 <= b < 127 else "."
                tag = "printable" if 32 <= b < 127 else ""
                self.hex_text.insert(tk.END, ch, tag)
            self.hex_text.insert(tk.END, "|\n")

        self.hex_text.configure(state=tk.DISABLED)
        page = self._offset // self.PAGE_SIZE + 1
        self.page_var.set(page)

    def _page(self, delta):
        new_offset = self._offset + delta * self.PAGE_SIZE
        self._goto(new_offset)

    def _goto(self, offset):
        offset = max(0, min(offset, len(self._data) - 1 if self._data else 0))
        # アライン
        offset = (offset // self.PAGE_SIZE) * self.PAGE_SIZE
        if offset != self._offset:
            self._offset = offset
            self._render()

    def _on_page_spin(self):
        try:
            page = int(self.page_var.get())
            self._goto((page - 1) * self.PAGE_SIZE)
        except Exception:
            pass

    def _search(self):
        query = self.search_var.get().strip()
        if not query or not self._data:
            return
        mode = self.search_mode_var.get()
        try:
            if mode == "HEX":
                needle = bytes.fromhex(query.replace(" ", ""))
            else:
                needle = query.encode("ascii", errors="replace")
        except Exception as e:
            messagebox.showerror("エラー", f"検索パターンが不正: {e}")
            return

        results = []
        start = 0
        while True:
            pos = self._data.find(needle, start)
            if pos == -1:
                break
            results.append(pos)
            start = pos + 1

        self._search_results = results
        self._search_idx     = 0
        if results:
            self._highlight_search(results[0], len(needle))
            self.info_var.set(f"検索: {len(results)} 件見つかりました")
        else:
            self.info_var.set("見つかりませんでした")

    def _search_next(self):
        if not self._search_results:
            return
        self._search_idx = (self._search_idx + 1) % len(self._search_results)
        pos = self._search_results[self._search_idx]
        query = self.search_var.get().strip()
        mode  = self.search_mode_var.get()
        try:
            length = len(bytes.fromhex(query.replace(" ", ""))) if mode == "HEX" \
                     else len(query.encode("ascii", errors="replace"))
        except Exception:
            length = 1
        self._highlight_search(pos, length)

    def _highlight_search(self, pos, length):
        # 該当ページへ移動
        page_offset = (pos // self.PAGE_SIZE) * self.PAGE_SIZE
        if page_offset != self._offset:
            self._offset = page_offset
            self._render()
        # ハイライト (簡易: 行内のHEX部分)
        self.hex_text.tag_remove("search", "1.0", tk.END)
        local = pos - self._offset
        if 0 <= local < self.PAGE_SIZE:
            row = local // self.BYTES_PER_ROW
            col = local % self.BYTES_PER_ROW
            # テキスト行: row+1, HEX列: 10 (addr) + col*3
            line_no  = row + 1
            hex_col  = 10 + col * 3
            end_col  = hex_col + length * 3 - 1
            self.hex_text.tag_add(
                "search",
                f"{line_no}.{hex_col}", f"{line_no}.{end_col}")
            self.hex_text.see(f"{line_no}.0")
        self.info_var.set(
            f"オフセット: 0x{pos:08X} ({pos})  "
            f"({self._search_idx + 1}/{len(self._search_results)} 件目)")


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

例外処理とエラーハンドリング

try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。

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


class App086:
    """HEXビューア"""

    BYTES_PER_ROW = 16
    PAGE_SIZE     = 512   # 表示バイト数 (1ページ)

    def __init__(self, root):
        self.root = root
        self.root.title("HEXビューア")
        self.root.geometry("920x620")
        self.root.configure(bg="#0d1117")
        self._data   = b""
        self._offset = 0    # 表示開始オフセット
        self._search_results = []
        self._build_ui()
        self.root.bind("<Prior>",  lambda e: self._page(-1))
        self.root.bind("<Next>",   lambda e: self._page(1))
        self.root.bind("<Home>",   lambda e: self._goto(0))
        self.root.bind("<End>",    lambda e: self._goto(max(0, len(self._data) - self.PAGE_SIZE)))

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#161b22", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🔢 HEXビューア",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#161b22", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        # ツールバー
        tb = tk.Frame(self.root, bg="#161b22", pady=4)
        tb.pack(fill=tk.X)
        ttk.Button(tb, text="📂 ファイルを開く",
                   command=self._open).pack(side=tk.LEFT, padx=4)

        tk.Label(tb, text="ページ:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.page_var = tk.IntVar(value=1)
        ttk.Spinbox(tb, from_=1, to=9999, textvariable=self.page_var,
                    width=6,
                    command=self._on_page_spin).pack(side=tk.LEFT)
        tk.Label(tb, text="/", bg="#161b22", fg="#8b949e").pack(side=tk.LEFT)
        self.total_pages_lbl = tk.Label(tb, text="1", bg="#161b22",
                                          fg="#8b949e", font=("Arial", 9))
        self.total_pages_lbl.pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="◀",
                   command=lambda: self._page(-1)).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="▶",
                   command=lambda: self._page(1)).pack(side=tk.LEFT, padx=2)

        # 検索
        tk.Label(tb, text="検索:", bg="#161b22", fg="#8b949e",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 2))
        self.search_var = tk.StringVar()
        ttk.Entry(tb, textvariable=self.search_var, width=14).pack(side=tk.LEFT)
        self.search_mode_var = tk.StringVar(value="HEX")
        ttk.Combobox(tb, textvariable=self.search_mode_var,
                     values=["HEX", "ASCII"], state="readonly",
                     width=6).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="🔍 検索",
                   command=self._search).pack(side=tk.LEFT, padx=2)
        ttk.Button(tb, text="次へ",
                   command=self._search_next).pack(side=tk.LEFT, padx=2)
        self._search_idx = 0

        # メインエリア: HEXダンプ
        text_f = tk.Frame(self.root, bg="#0d1117")
        text_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 行番号キャンバスは Text の行番号表示で代用
        self.hex_text = tk.Text(
            text_f, bg="#0d1117", fg="#c9d1d9",
            font=("Courier New", 10), relief=tk.FLAT,
            state=tk.DISABLED, wrap=tk.NONE,
            width=78, insertbackground="white")
        xsb = ttk.Scrollbar(text_f, orient=tk.HORIZONTAL,
                             command=self.hex_text.xview)
        ysb = ttk.Scrollbar(text_f, command=self.hex_text.yview)
        self.hex_text.configure(xscrollcommand=xsb.set,
                                 yscrollcommand=ysb.set)
        ysb.pack(side=tk.RIGHT, fill=tk.Y)
        self.hex_text.pack(fill=tk.BOTH, expand=True)
        xsb.pack(fill=tk.X)

        # カラータグ
        self.hex_text.tag_configure("addr",    foreground="#79b8ff")
        self.hex_text.tag_configure("zero",    foreground="#3c4043")
        self.hex_text.tag_configure("printable", foreground="#b5e853")
        self.hex_text.tag_configure("search",  background="#f57c00",
                                     foreground="#000")

        # 下部: ファイル情報
        self.info_var = tk.StringVar(value="ファイルを開いてください")
        tk.Label(self.root, textvariable=self.info_var,
                 bg="#161b22", fg="#8b949e", font=("Courier New", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _open(self):
        path = filedialog.askopenfilename(filetypes=[("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, "rb") as f:
                self._data = f.read()
            self._offset = 0
            total = max(1, (len(self._data) + self.PAGE_SIZE - 1) // self.PAGE_SIZE)
            self.total_pages_lbl.config(text=str(total))
            self.page_var.set(1)
            self._render()
            size = len(self._data)
            self.info_var.set(
                f"{os.path.basename(path)}  |  {size:,} bytes  |  "
                f"PageUp/Down でページ移動  |  PgUp/PgDn / ◀▶ ボタン")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _render(self):
        bpr = self.BYTES_PER_ROW
        start = self._offset
        end   = min(start + self.PAGE_SIZE, len(self._data))
        chunk = self._data[start:end]

        self.hex_text.configure(state=tk.NORMAL)
        self.hex_text.delete("1.0", tk.END)

        lines = []
        for row_start in range(0, len(chunk), bpr):
            row = chunk[row_start:row_start + bpr]
            addr = start + row_start
            hex_part  = " ".join(f"{b:02X}" for b in row)
            hex_part  = hex_part.ljust(bpr * 3 - 1)
            ascii_part = "".join(chr(b) if 32 <= b < 127 else "." for b in row)
            line = f"{addr:08X}  {hex_part}  |{ascii_part}|\n"
            lines.append((addr, row, line))

        for addr, row, line in lines:
            bpr = self.BYTES_PER_ROW
            # アドレス部分
            self.hex_text.insert(tk.END, f"{addr:08X}", "addr")
            self.hex_text.insert(tk.END, "  ")
            # HEX部分
            for i, b in enumerate(row):
                tag = "zero" if b == 0 else ""
                self.hex_text.insert(tk.END, f"{b:02X}", tag)
                self.hex_text.insert(tk.END, " ")
            # 端揃え
            if len(row) < bpr:
                self.hex_text.insert(tk.END, "   " * (bpr - len(row)))
            self.hex_text.insert(tk.END, " |")
            # ASCII部分
            for b in row:
                ch = chr(b) if 32 <= b < 127 else "."
                tag = "printable" if 32 <= b < 127 else ""
                self.hex_text.insert(tk.END, ch, tag)
            self.hex_text.insert(tk.END, "|\n")

        self.hex_text.configure(state=tk.DISABLED)
        page = self._offset // self.PAGE_SIZE + 1
        self.page_var.set(page)

    def _page(self, delta):
        new_offset = self._offset + delta * self.PAGE_SIZE
        self._goto(new_offset)

    def _goto(self, offset):
        offset = max(0, min(offset, len(self._data) - 1 if self._data else 0))
        # アライン
        offset = (offset // self.PAGE_SIZE) * self.PAGE_SIZE
        if offset != self._offset:
            self._offset = offset
            self._render()

    def _on_page_spin(self):
        try:
            page = int(self.page_var.get())
            self._goto((page - 1) * self.PAGE_SIZE)
        except Exception:
            pass

    def _search(self):
        query = self.search_var.get().strip()
        if not query or not self._data:
            return
        mode = self.search_mode_var.get()
        try:
            if mode == "HEX":
                needle = bytes.fromhex(query.replace(" ", ""))
            else:
                needle = query.encode("ascii", errors="replace")
        except Exception as e:
            messagebox.showerror("エラー", f"検索パターンが不正: {e}")
            return

        results = []
        start = 0
        while True:
            pos = self._data.find(needle, start)
            if pos == -1:
                break
            results.append(pos)
            start = pos + 1

        self._search_results = results
        self._search_idx     = 0
        if results:
            self._highlight_search(results[0], len(needle))
            self.info_var.set(f"検索: {len(results)} 件見つかりました")
        else:
            self.info_var.set("見つかりませんでした")

    def _search_next(self):
        if not self._search_results:
            return
        self._search_idx = (self._search_idx + 1) % len(self._search_results)
        pos = self._search_results[self._search_idx]
        query = self.search_var.get().strip()
        mode  = self.search_mode_var.get()
        try:
            length = len(bytes.fromhex(query.replace(" ", ""))) if mode == "HEX" \
                     else len(query.encode("ascii", errors="replace"))
        except Exception:
            length = 1
        self._highlight_search(pos, length)

    def _highlight_search(self, pos, length):
        # 該当ページへ移動
        page_offset = (pos // self.PAGE_SIZE) * self.PAGE_SIZE
        if page_offset != self._offset:
            self._offset = page_offset
            self._render()
        # ハイライト (簡易: 行内のHEX部分)
        self.hex_text.tag_remove("search", "1.0", tk.END)
        local = pos - self._offset
        if 0 <= local < self.PAGE_SIZE:
            row = local // self.BYTES_PER_ROW
            col = local % self.BYTES_PER_ROW
            # テキスト行: row+1, HEX列: 10 (addr) + col*3
            line_no  = row + 1
            hex_col  = 10 + col * 3
            end_col  = hex_col + length * 3 - 1
            self.hex_text.tag_add(
                "search",
                f"{line_no}.{hex_col}", f"{line_no}.{end_col}")
            self.hex_text.see(f"{line_no}.0")
        self.info_var.set(
            f"オフセット: 0x{pos:08X} ({pos})  "
            f"({self._search_idx + 1}/{len(self._search_results)} 件目)")


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

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

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

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

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

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

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

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

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

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

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

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

    _execute()メソッドにメインロジックを実装します。

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

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

  7. 7
    エラー処理を追加する

    try-exceptとmessageboxでエラーハンドリングを追加します。

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

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。

💡 ダークモードを追加する

bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。

💡 データの保存機能

処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。

💡 設定ダイアログ

フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。

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

❌ 日本語フォントが表示されない

原因:システムに日本語フォントが見つからない場合があります。

解決法:font引数を省略するかシステムに合ったフォントを指定してください。

❌ ライブラリのインポートエラー

原因:必要なライブラリがインストールされていません。

解決法:pip install コマンドで必要なライブラリをインストールしてください。

❌ ウィンドウサイズが合わない

原因:画面解像度や表示スケールによって異なる場合があります。

解決法:root.geometry()で適切なサイズに調整してください。

9. 練習問題

アプリの理解を深めるための練習問題です。

  1. 課題1:機能拡張

    HEXビューアに新しい機能を1つ追加してみましょう。

  2. 課題2:UIの改善

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

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

    処理結果をファイルに保存する機能を追加しましょう。

🚀
次に挑戦するアプリ

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