中級者向け No.41

バーチャルキーボード

画面上に表示してマウスでクリック入力できるバーチャルキーボード。pyautoguiライブラリの活用を学びます。

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

1. アプリ概要

画面上に表示してマウスでクリック入力できるバーチャルキーボード。pyautoguiライブラリの活用を学びます。

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

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+

4. 完全なソースコード

💡
コードのコピー方法

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

app41.py
import tkinter as tk
from tkinter import ttk, messagebox
import string

try:
    import pyautogui
    PYAUTOGUI_AVAILABLE = True
except ImportError:
    PYAUTOGUI_AVAILABLE = False


class App41:
    """バーチャルキーボード"""

    # キーボードレイアウト
    ROWS = [
        ["Esc", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"],
        ["`", "1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-", "=", "BS"],
        ["Tab", "q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "[", "]", "\\"],
        ["Caps", "a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'", "Enter"],
        ["Shift", "z", "x", "c", "v", "b", "n", "m", ",", ".", "/", "Shift"],
        ["Ctrl", "Alt", "Space", "Alt", "Ctrl"],
    ]

    SHIFTED = {
        "`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%",
        "6": "^", "7": "&", "8": "*", "9": "(", "0": ")", "-": "_", "=": "+",
        "[": "{", "]": "}", "\\": "|", ";": ":", "'": '"', ",": "<",
        ".": ">", "/": "?",
    }

    WIDE_KEYS = {"BS": 2.0, "Tab": 1.5, "Caps": 1.8, "Enter": 2.2,
                 "Shift": 2.5, "Space": 5.0, "Ctrl": 1.5, "Alt": 1.2,
                 "Esc": 1.0, "BS": 1.8}

    SPECIAL_KEYS = {"BS", "Tab", "Caps", "Enter", "Shift", "Ctrl", "Alt",
                    "Esc", "Space", "F1", "F2", "F3", "F4", "F5", "F6",
                    "F7", "F8", "F9", "F10", "F11", "F12", "\\"}

    KEY_COLOR = "#3c3c3c"
    SPECIAL_COLOR = "#505050"
    PRESSED_COLOR = "#0078d4"

    def __init__(self, root):
        self.root = root
        self.root.title("バーチャルキーボード")
        self.root.resizable(False, False)
        self.root.configure(bg="#1e1e1e")
        self._shift = False
        self._caps = False
        self._ctrl = False
        self._alt = False
        self._key_buttons = {}
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="⌨️ バーチャルキーボード",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not PYAUTOGUI_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ pyautogui が未インストール (pip install pyautogui)。"
                          "テキストエリアへの入力モードで動作します。",
                     bg="#fff3cd", fg="#856404", font=("Arial", 8),
                     anchor="w", padx=8).pack(fill=tk.X)

        # テキスト出力エリア
        output_f = tk.Frame(self.root, bg="#1e1e1e")
        output_f.pack(fill=tk.X, padx=8, pady=6)
        tk.Label(output_f, text="入力結果:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w")
        self.output_text = tk.Text(output_f, height=4, bg="#0d1117", fg="#c9d1d9",
                                    font=("Courier New", 13), relief=tk.FLAT,
                                    insertbackground="white")
        sb = ttk.Scrollbar(output_f, command=self.output_text.yview)
        self.output_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.output_text.pack(fill=tk.X)

        # 操作ボタン
        ctrl_f = tk.Frame(self.root, bg="#1e1e1e")
        ctrl_f.pack(fill=tk.X, padx=8, pady=2)
        tk.Button(ctrl_f, text="📋 コピー",
                  command=self._copy_text,
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl_f, text="🗑 クリア",
                  command=lambda: self.output_text.delete("1.0", tk.END),
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)

        # 送信先フォーカス設定
        self.target_var = tk.StringVar(value="テキストエリア")
        tk.Label(ctrl_f, text="送信先:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        for val in ["テキストエリア", "フォーカス中ウィンドウ"]:
            ttk.Radiobutton(ctrl_f, text=val, variable=self.target_var,
                            value=val).pack(side=tk.LEFT, padx=4)

        # キーボード本体
        kb_f = tk.Frame(self.root, bg="#1e1e1e", padx=8, pady=8)
        kb_f.pack()

        BASE_W = 42
        BASE_H = 38

        for row_idx, row in enumerate(self.ROWS):
            row_f = tk.Frame(kb_f, bg="#1e1e1e")
            row_f.pack(pady=2, anchor="w")
            for key in row:
                width_mult = self.WIDE_KEYS.get(key, 1.0)
                is_special = key in self.SPECIAL_KEYS
                color = self.SPECIAL_COLOR if is_special else self.KEY_COLOR
                btn_w = max(1, int(width_mult * 3.5))
                btn = tk.Button(row_f, text=key,
                                bg=color, fg="white",
                                relief=tk.FLAT, bd=0,
                                font=("Arial", 9),
                                width=btn_w,
                                height=1,
                                padx=2, pady=4,
                                activebackground=self.PRESSED_COLOR,
                                activeforeground="white",
                                command=lambda k=key: self._on_key(k))
                btn.pack(side=tk.LEFT, padx=1)
                if key not in self._key_buttons:
                    self._key_buttons[key] = []
                self._key_buttons[key].append(btn)

        self.status_var = tk.StringVar(value="キーをクリックして入力")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _on_key(self, key):
        target = self.target_var.get()

        if key == "Shift":
            self._shift = not self._shift
            self._update_shift_display()
            self._highlight_key("Shift", self._shift)
            return
        elif key == "Caps":
            self._caps = not self._caps
            self._update_shift_display()
            self._highlight_key("Caps", self._caps)
            return
        elif key == "Ctrl":
            self._ctrl = not self._ctrl
            self._highlight_key("Ctrl", self._ctrl)
            return
        elif key == "Alt":
            self._alt = not self._alt
            self._highlight_key("Alt", self._alt)
            return

        char = self._resolve_char(key)

        if target == "テキストエリア" or not PYAUTOGUI_AVAILABLE:
            self._insert_to_textarea(key, char)
        else:
            self._send_to_focus(key, char)

        # Shiftの自動解除
        if self._shift:
            self._shift = False
            self._update_shift_display()
            self._highlight_key("Shift", False)

        self.status_var.set(f"押下: {key}  →  '{char}'")

    def _resolve_char(self, key):
        if key == "BS":
            return ""
        if key == "Enter":
            return "\n"
        if key == "Tab":
            return "\t"
        if key == "Space":
            return " "
        if key in self.SPECIAL_KEYS:
            return ""

        effective_shift = self._shift ^ self._caps
        if effective_shift:
            if key in self.SHIFTED:
                return self.SHIFTED[key]
            return key.upper()
        return key.lower()

    def _insert_to_textarea(self, key, char):
        if key == "BS":
            content = self.output_text.get("1.0", tk.END)
            if len(content) > 1:
                self.output_text.delete("end-2c", "end-1c")
        elif char:
            self.output_text.insert(tk.END, char)
            self.output_text.see(tk.END)

    def _send_to_focus(self, key, char):
        if not PYAUTOGUI_AVAILABLE:
            return
        try:
            if key == "BS":
                pyautogui.press("backspace")
            elif key == "Enter":
                pyautogui.press("enter")
            elif key == "Tab":
                pyautogui.press("tab")
            elif key == "Space":
                pyautogui.press("space")
            elif key == "Esc":
                pyautogui.press("escape")
            elif key.startswith("F") and key[1:].isdigit():
                pyautogui.press(key.lower())
            elif char:
                pyautogui.typewrite(char, interval=0)
        except Exception as e:
            self.status_var.set(f"エラー: {e}")

    def _update_shift_display(self):
        effective_shift = self._shift ^ self._caps
        for row in self.ROWS:
            for key in row:
                if key in self.SPECIAL_KEYS or key not in self._key_buttons:
                    continue
                display = key
                if effective_shift:
                    if key in self.SHIFTED:
                        display = self.SHIFTED[key]
                    else:
                        display = key.upper()
                else:
                    display = key.lower()
                for btn in self._key_buttons[key]:
                    btn.config(text=display)

    def _highlight_key(self, key, active):
        if key in self._key_buttons:
            color = self.PRESSED_COLOR if active else self.SPECIAL_COLOR
            for btn in self._key_buttons[key]:
                btn.config(bg=color)

    def _copy_text(self):
        text = self.output_text.get("1.0", tk.END).strip()
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        self.status_var.set("クリップボードにコピーしました")


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

5. コード解説

バーチャルキーボードのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

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

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

try:
    import pyautogui
    PYAUTOGUI_AVAILABLE = True
except ImportError:
    PYAUTOGUI_AVAILABLE = False


class App41:
    """バーチャルキーボード"""

    # キーボードレイアウト
    ROWS = [
        ["Esc", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"],
        ["`", "1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-", "=", "BS"],
        ["Tab", "q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "[", "]", "\\"],
        ["Caps", "a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'", "Enter"],
        ["Shift", "z", "x", "c", "v", "b", "n", "m", ",", ".", "/", "Shift"],
        ["Ctrl", "Alt", "Space", "Alt", "Ctrl"],
    ]

    SHIFTED = {
        "`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%",
        "6": "^", "7": "&", "8": "*", "9": "(", "0": ")", "-": "_", "=": "+",
        "[": "{", "]": "}", "\\": "|", ";": ":", "'": '"', ",": "<",
        ".": ">", "/": "?",
    }

    WIDE_KEYS = {"BS": 2.0, "Tab": 1.5, "Caps": 1.8, "Enter": 2.2,
                 "Shift": 2.5, "Space": 5.0, "Ctrl": 1.5, "Alt": 1.2,
                 "Esc": 1.0, "BS": 1.8}

    SPECIAL_KEYS = {"BS", "Tab", "Caps", "Enter", "Shift", "Ctrl", "Alt",
                    "Esc", "Space", "F1", "F2", "F3", "F4", "F5", "F6",
                    "F7", "F8", "F9", "F10", "F11", "F12", "\\"}

    KEY_COLOR = "#3c3c3c"
    SPECIAL_COLOR = "#505050"
    PRESSED_COLOR = "#0078d4"

    def __init__(self, root):
        self.root = root
        self.root.title("バーチャルキーボード")
        self.root.resizable(False, False)
        self.root.configure(bg="#1e1e1e")
        self._shift = False
        self._caps = False
        self._ctrl = False
        self._alt = False
        self._key_buttons = {}
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="⌨️ バーチャルキーボード",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not PYAUTOGUI_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ pyautogui が未インストール (pip install pyautogui)。"
                          "テキストエリアへの入力モードで動作します。",
                     bg="#fff3cd", fg="#856404", font=("Arial", 8),
                     anchor="w", padx=8).pack(fill=tk.X)

        # テキスト出力エリア
        output_f = tk.Frame(self.root, bg="#1e1e1e")
        output_f.pack(fill=tk.X, padx=8, pady=6)
        tk.Label(output_f, text="入力結果:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w")
        self.output_text = tk.Text(output_f, height=4, bg="#0d1117", fg="#c9d1d9",
                                    font=("Courier New", 13), relief=tk.FLAT,
                                    insertbackground="white")
        sb = ttk.Scrollbar(output_f, command=self.output_text.yview)
        self.output_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.output_text.pack(fill=tk.X)

        # 操作ボタン
        ctrl_f = tk.Frame(self.root, bg="#1e1e1e")
        ctrl_f.pack(fill=tk.X, padx=8, pady=2)
        tk.Button(ctrl_f, text="📋 コピー",
                  command=self._copy_text,
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl_f, text="🗑 クリア",
                  command=lambda: self.output_text.delete("1.0", tk.END),
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)

        # 送信先フォーカス設定
        self.target_var = tk.StringVar(value="テキストエリア")
        tk.Label(ctrl_f, text="送信先:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        for val in ["テキストエリア", "フォーカス中ウィンドウ"]:
            ttk.Radiobutton(ctrl_f, text=val, variable=self.target_var,
                            value=val).pack(side=tk.LEFT, padx=4)

        # キーボード本体
        kb_f = tk.Frame(self.root, bg="#1e1e1e", padx=8, pady=8)
        kb_f.pack()

        BASE_W = 42
        BASE_H = 38

        for row_idx, row in enumerate(self.ROWS):
            row_f = tk.Frame(kb_f, bg="#1e1e1e")
            row_f.pack(pady=2, anchor="w")
            for key in row:
                width_mult = self.WIDE_KEYS.get(key, 1.0)
                is_special = key in self.SPECIAL_KEYS
                color = self.SPECIAL_COLOR if is_special else self.KEY_COLOR
                btn_w = max(1, int(width_mult * 3.5))
                btn = tk.Button(row_f, text=key,
                                bg=color, fg="white",
                                relief=tk.FLAT, bd=0,
                                font=("Arial", 9),
                                width=btn_w,
                                height=1,
                                padx=2, pady=4,
                                activebackground=self.PRESSED_COLOR,
                                activeforeground="white",
                                command=lambda k=key: self._on_key(k))
                btn.pack(side=tk.LEFT, padx=1)
                if key not in self._key_buttons:
                    self._key_buttons[key] = []
                self._key_buttons[key].append(btn)

        self.status_var = tk.StringVar(value="キーをクリックして入力")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _on_key(self, key):
        target = self.target_var.get()

        if key == "Shift":
            self._shift = not self._shift
            self._update_shift_display()
            self._highlight_key("Shift", self._shift)
            return
        elif key == "Caps":
            self._caps = not self._caps
            self._update_shift_display()
            self._highlight_key("Caps", self._caps)
            return
        elif key == "Ctrl":
            self._ctrl = not self._ctrl
            self._highlight_key("Ctrl", self._ctrl)
            return
        elif key == "Alt":
            self._alt = not self._alt
            self._highlight_key("Alt", self._alt)
            return

        char = self._resolve_char(key)

        if target == "テキストエリア" or not PYAUTOGUI_AVAILABLE:
            self._insert_to_textarea(key, char)
        else:
            self._send_to_focus(key, char)

        # Shiftの自動解除
        if self._shift:
            self._shift = False
            self._update_shift_display()
            self._highlight_key("Shift", False)

        self.status_var.set(f"押下: {key}  →  '{char}'")

    def _resolve_char(self, key):
        if key == "BS":
            return ""
        if key == "Enter":
            return "\n"
        if key == "Tab":
            return "\t"
        if key == "Space":
            return " "
        if key in self.SPECIAL_KEYS:
            return ""

        effective_shift = self._shift ^ self._caps
        if effective_shift:
            if key in self.SHIFTED:
                return self.SHIFTED[key]
            return key.upper()
        return key.lower()

    def _insert_to_textarea(self, key, char):
        if key == "BS":
            content = self.output_text.get("1.0", tk.END)
            if len(content) > 1:
                self.output_text.delete("end-2c", "end-1c")
        elif char:
            self.output_text.insert(tk.END, char)
            self.output_text.see(tk.END)

    def _send_to_focus(self, key, char):
        if not PYAUTOGUI_AVAILABLE:
            return
        try:
            if key == "BS":
                pyautogui.press("backspace")
            elif key == "Enter":
                pyautogui.press("enter")
            elif key == "Tab":
                pyautogui.press("tab")
            elif key == "Space":
                pyautogui.press("space")
            elif key == "Esc":
                pyautogui.press("escape")
            elif key.startswith("F") and key[1:].isdigit():
                pyautogui.press(key.lower())
            elif char:
                pyautogui.typewrite(char, interval=0)
        except Exception as e:
            self.status_var.set(f"エラー: {e}")

    def _update_shift_display(self):
        effective_shift = self._shift ^ self._caps
        for row in self.ROWS:
            for key in row:
                if key in self.SPECIAL_KEYS or key not in self._key_buttons:
                    continue
                display = key
                if effective_shift:
                    if key in self.SHIFTED:
                        display = self.SHIFTED[key]
                    else:
                        display = key.upper()
                else:
                    display = key.lower()
                for btn in self._key_buttons[key]:
                    btn.config(text=display)

    def _highlight_key(self, key, active):
        if key in self._key_buttons:
            color = self.PRESSED_COLOR if active else self.SPECIAL_COLOR
            for btn in self._key_buttons[key]:
                btn.config(bg=color)

    def _copy_text(self):
        text = self.output_text.get("1.0", tk.END).strip()
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        self.status_var.set("クリップボードにコピーしました")


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

LabelFrameによるセクション分け

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

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

try:
    import pyautogui
    PYAUTOGUI_AVAILABLE = True
except ImportError:
    PYAUTOGUI_AVAILABLE = False


class App41:
    """バーチャルキーボード"""

    # キーボードレイアウト
    ROWS = [
        ["Esc", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"],
        ["`", "1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-", "=", "BS"],
        ["Tab", "q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "[", "]", "\\"],
        ["Caps", "a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'", "Enter"],
        ["Shift", "z", "x", "c", "v", "b", "n", "m", ",", ".", "/", "Shift"],
        ["Ctrl", "Alt", "Space", "Alt", "Ctrl"],
    ]

    SHIFTED = {
        "`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%",
        "6": "^", "7": "&", "8": "*", "9": "(", "0": ")", "-": "_", "=": "+",
        "[": "{", "]": "}", "\\": "|", ";": ":", "'": '"', ",": "<",
        ".": ">", "/": "?",
    }

    WIDE_KEYS = {"BS": 2.0, "Tab": 1.5, "Caps": 1.8, "Enter": 2.2,
                 "Shift": 2.5, "Space": 5.0, "Ctrl": 1.5, "Alt": 1.2,
                 "Esc": 1.0, "BS": 1.8}

    SPECIAL_KEYS = {"BS", "Tab", "Caps", "Enter", "Shift", "Ctrl", "Alt",
                    "Esc", "Space", "F1", "F2", "F3", "F4", "F5", "F6",
                    "F7", "F8", "F9", "F10", "F11", "F12", "\\"}

    KEY_COLOR = "#3c3c3c"
    SPECIAL_COLOR = "#505050"
    PRESSED_COLOR = "#0078d4"

    def __init__(self, root):
        self.root = root
        self.root.title("バーチャルキーボード")
        self.root.resizable(False, False)
        self.root.configure(bg="#1e1e1e")
        self._shift = False
        self._caps = False
        self._ctrl = False
        self._alt = False
        self._key_buttons = {}
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="⌨️ バーチャルキーボード",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not PYAUTOGUI_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ pyautogui が未インストール (pip install pyautogui)。"
                          "テキストエリアへの入力モードで動作します。",
                     bg="#fff3cd", fg="#856404", font=("Arial", 8),
                     anchor="w", padx=8).pack(fill=tk.X)

        # テキスト出力エリア
        output_f = tk.Frame(self.root, bg="#1e1e1e")
        output_f.pack(fill=tk.X, padx=8, pady=6)
        tk.Label(output_f, text="入力結果:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w")
        self.output_text = tk.Text(output_f, height=4, bg="#0d1117", fg="#c9d1d9",
                                    font=("Courier New", 13), relief=tk.FLAT,
                                    insertbackground="white")
        sb = ttk.Scrollbar(output_f, command=self.output_text.yview)
        self.output_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.output_text.pack(fill=tk.X)

        # 操作ボタン
        ctrl_f = tk.Frame(self.root, bg="#1e1e1e")
        ctrl_f.pack(fill=tk.X, padx=8, pady=2)
        tk.Button(ctrl_f, text="📋 コピー",
                  command=self._copy_text,
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl_f, text="🗑 クリア",
                  command=lambda: self.output_text.delete("1.0", tk.END),
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)

        # 送信先フォーカス設定
        self.target_var = tk.StringVar(value="テキストエリア")
        tk.Label(ctrl_f, text="送信先:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        for val in ["テキストエリア", "フォーカス中ウィンドウ"]:
            ttk.Radiobutton(ctrl_f, text=val, variable=self.target_var,
                            value=val).pack(side=tk.LEFT, padx=4)

        # キーボード本体
        kb_f = tk.Frame(self.root, bg="#1e1e1e", padx=8, pady=8)
        kb_f.pack()

        BASE_W = 42
        BASE_H = 38

        for row_idx, row in enumerate(self.ROWS):
            row_f = tk.Frame(kb_f, bg="#1e1e1e")
            row_f.pack(pady=2, anchor="w")
            for key in row:
                width_mult = self.WIDE_KEYS.get(key, 1.0)
                is_special = key in self.SPECIAL_KEYS
                color = self.SPECIAL_COLOR if is_special else self.KEY_COLOR
                btn_w = max(1, int(width_mult * 3.5))
                btn = tk.Button(row_f, text=key,
                                bg=color, fg="white",
                                relief=tk.FLAT, bd=0,
                                font=("Arial", 9),
                                width=btn_w,
                                height=1,
                                padx=2, pady=4,
                                activebackground=self.PRESSED_COLOR,
                                activeforeground="white",
                                command=lambda k=key: self._on_key(k))
                btn.pack(side=tk.LEFT, padx=1)
                if key not in self._key_buttons:
                    self._key_buttons[key] = []
                self._key_buttons[key].append(btn)

        self.status_var = tk.StringVar(value="キーをクリックして入力")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _on_key(self, key):
        target = self.target_var.get()

        if key == "Shift":
            self._shift = not self._shift
            self._update_shift_display()
            self._highlight_key("Shift", self._shift)
            return
        elif key == "Caps":
            self._caps = not self._caps
            self._update_shift_display()
            self._highlight_key("Caps", self._caps)
            return
        elif key == "Ctrl":
            self._ctrl = not self._ctrl
            self._highlight_key("Ctrl", self._ctrl)
            return
        elif key == "Alt":
            self._alt = not self._alt
            self._highlight_key("Alt", self._alt)
            return

        char = self._resolve_char(key)

        if target == "テキストエリア" or not PYAUTOGUI_AVAILABLE:
            self._insert_to_textarea(key, char)
        else:
            self._send_to_focus(key, char)

        # Shiftの自動解除
        if self._shift:
            self._shift = False
            self._update_shift_display()
            self._highlight_key("Shift", False)

        self.status_var.set(f"押下: {key}  →  '{char}'")

    def _resolve_char(self, key):
        if key == "BS":
            return ""
        if key == "Enter":
            return "\n"
        if key == "Tab":
            return "\t"
        if key == "Space":
            return " "
        if key in self.SPECIAL_KEYS:
            return ""

        effective_shift = self._shift ^ self._caps
        if effective_shift:
            if key in self.SHIFTED:
                return self.SHIFTED[key]
            return key.upper()
        return key.lower()

    def _insert_to_textarea(self, key, char):
        if key == "BS":
            content = self.output_text.get("1.0", tk.END)
            if len(content) > 1:
                self.output_text.delete("end-2c", "end-1c")
        elif char:
            self.output_text.insert(tk.END, char)
            self.output_text.see(tk.END)

    def _send_to_focus(self, key, char):
        if not PYAUTOGUI_AVAILABLE:
            return
        try:
            if key == "BS":
                pyautogui.press("backspace")
            elif key == "Enter":
                pyautogui.press("enter")
            elif key == "Tab":
                pyautogui.press("tab")
            elif key == "Space":
                pyautogui.press("space")
            elif key == "Esc":
                pyautogui.press("escape")
            elif key.startswith("F") and key[1:].isdigit():
                pyautogui.press(key.lower())
            elif char:
                pyautogui.typewrite(char, interval=0)
        except Exception as e:
            self.status_var.set(f"エラー: {e}")

    def _update_shift_display(self):
        effective_shift = self._shift ^ self._caps
        for row in self.ROWS:
            for key in row:
                if key in self.SPECIAL_KEYS or key not in self._key_buttons:
                    continue
                display = key
                if effective_shift:
                    if key in self.SHIFTED:
                        display = self.SHIFTED[key]
                    else:
                        display = key.upper()
                else:
                    display = key.lower()
                for btn in self._key_buttons[key]:
                    btn.config(text=display)

    def _highlight_key(self, key, active):
        if key in self._key_buttons:
            color = self.PRESSED_COLOR if active else self.SPECIAL_COLOR
            for btn in self._key_buttons[key]:
                btn.config(bg=color)

    def _copy_text(self):
        text = self.output_text.get("1.0", tk.END).strip()
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        self.status_var.set("クリップボードにコピーしました")


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

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

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

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

try:
    import pyautogui
    PYAUTOGUI_AVAILABLE = True
except ImportError:
    PYAUTOGUI_AVAILABLE = False


class App41:
    """バーチャルキーボード"""

    # キーボードレイアウト
    ROWS = [
        ["Esc", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"],
        ["`", "1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-", "=", "BS"],
        ["Tab", "q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "[", "]", "\\"],
        ["Caps", "a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'", "Enter"],
        ["Shift", "z", "x", "c", "v", "b", "n", "m", ",", ".", "/", "Shift"],
        ["Ctrl", "Alt", "Space", "Alt", "Ctrl"],
    ]

    SHIFTED = {
        "`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%",
        "6": "^", "7": "&", "8": "*", "9": "(", "0": ")", "-": "_", "=": "+",
        "[": "{", "]": "}", "\\": "|", ";": ":", "'": '"', ",": "<",
        ".": ">", "/": "?",
    }

    WIDE_KEYS = {"BS": 2.0, "Tab": 1.5, "Caps": 1.8, "Enter": 2.2,
                 "Shift": 2.5, "Space": 5.0, "Ctrl": 1.5, "Alt": 1.2,
                 "Esc": 1.0, "BS": 1.8}

    SPECIAL_KEYS = {"BS", "Tab", "Caps", "Enter", "Shift", "Ctrl", "Alt",
                    "Esc", "Space", "F1", "F2", "F3", "F4", "F5", "F6",
                    "F7", "F8", "F9", "F10", "F11", "F12", "\\"}

    KEY_COLOR = "#3c3c3c"
    SPECIAL_COLOR = "#505050"
    PRESSED_COLOR = "#0078d4"

    def __init__(self, root):
        self.root = root
        self.root.title("バーチャルキーボード")
        self.root.resizable(False, False)
        self.root.configure(bg="#1e1e1e")
        self._shift = False
        self._caps = False
        self._ctrl = False
        self._alt = False
        self._key_buttons = {}
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="⌨️ バーチャルキーボード",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not PYAUTOGUI_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ pyautogui が未インストール (pip install pyautogui)。"
                          "テキストエリアへの入力モードで動作します。",
                     bg="#fff3cd", fg="#856404", font=("Arial", 8),
                     anchor="w", padx=8).pack(fill=tk.X)

        # テキスト出力エリア
        output_f = tk.Frame(self.root, bg="#1e1e1e")
        output_f.pack(fill=tk.X, padx=8, pady=6)
        tk.Label(output_f, text="入力結果:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w")
        self.output_text = tk.Text(output_f, height=4, bg="#0d1117", fg="#c9d1d9",
                                    font=("Courier New", 13), relief=tk.FLAT,
                                    insertbackground="white")
        sb = ttk.Scrollbar(output_f, command=self.output_text.yview)
        self.output_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.output_text.pack(fill=tk.X)

        # 操作ボタン
        ctrl_f = tk.Frame(self.root, bg="#1e1e1e")
        ctrl_f.pack(fill=tk.X, padx=8, pady=2)
        tk.Button(ctrl_f, text="📋 コピー",
                  command=self._copy_text,
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl_f, text="🗑 クリア",
                  command=lambda: self.output_text.delete("1.0", tk.END),
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)

        # 送信先フォーカス設定
        self.target_var = tk.StringVar(value="テキストエリア")
        tk.Label(ctrl_f, text="送信先:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        for val in ["テキストエリア", "フォーカス中ウィンドウ"]:
            ttk.Radiobutton(ctrl_f, text=val, variable=self.target_var,
                            value=val).pack(side=tk.LEFT, padx=4)

        # キーボード本体
        kb_f = tk.Frame(self.root, bg="#1e1e1e", padx=8, pady=8)
        kb_f.pack()

        BASE_W = 42
        BASE_H = 38

        for row_idx, row in enumerate(self.ROWS):
            row_f = tk.Frame(kb_f, bg="#1e1e1e")
            row_f.pack(pady=2, anchor="w")
            for key in row:
                width_mult = self.WIDE_KEYS.get(key, 1.0)
                is_special = key in self.SPECIAL_KEYS
                color = self.SPECIAL_COLOR if is_special else self.KEY_COLOR
                btn_w = max(1, int(width_mult * 3.5))
                btn = tk.Button(row_f, text=key,
                                bg=color, fg="white",
                                relief=tk.FLAT, bd=0,
                                font=("Arial", 9),
                                width=btn_w,
                                height=1,
                                padx=2, pady=4,
                                activebackground=self.PRESSED_COLOR,
                                activeforeground="white",
                                command=lambda k=key: self._on_key(k))
                btn.pack(side=tk.LEFT, padx=1)
                if key not in self._key_buttons:
                    self._key_buttons[key] = []
                self._key_buttons[key].append(btn)

        self.status_var = tk.StringVar(value="キーをクリックして入力")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _on_key(self, key):
        target = self.target_var.get()

        if key == "Shift":
            self._shift = not self._shift
            self._update_shift_display()
            self._highlight_key("Shift", self._shift)
            return
        elif key == "Caps":
            self._caps = not self._caps
            self._update_shift_display()
            self._highlight_key("Caps", self._caps)
            return
        elif key == "Ctrl":
            self._ctrl = not self._ctrl
            self._highlight_key("Ctrl", self._ctrl)
            return
        elif key == "Alt":
            self._alt = not self._alt
            self._highlight_key("Alt", self._alt)
            return

        char = self._resolve_char(key)

        if target == "テキストエリア" or not PYAUTOGUI_AVAILABLE:
            self._insert_to_textarea(key, char)
        else:
            self._send_to_focus(key, char)

        # Shiftの自動解除
        if self._shift:
            self._shift = False
            self._update_shift_display()
            self._highlight_key("Shift", False)

        self.status_var.set(f"押下: {key}  →  '{char}'")

    def _resolve_char(self, key):
        if key == "BS":
            return ""
        if key == "Enter":
            return "\n"
        if key == "Tab":
            return "\t"
        if key == "Space":
            return " "
        if key in self.SPECIAL_KEYS:
            return ""

        effective_shift = self._shift ^ self._caps
        if effective_shift:
            if key in self.SHIFTED:
                return self.SHIFTED[key]
            return key.upper()
        return key.lower()

    def _insert_to_textarea(self, key, char):
        if key == "BS":
            content = self.output_text.get("1.0", tk.END)
            if len(content) > 1:
                self.output_text.delete("end-2c", "end-1c")
        elif char:
            self.output_text.insert(tk.END, char)
            self.output_text.see(tk.END)

    def _send_to_focus(self, key, char):
        if not PYAUTOGUI_AVAILABLE:
            return
        try:
            if key == "BS":
                pyautogui.press("backspace")
            elif key == "Enter":
                pyautogui.press("enter")
            elif key == "Tab":
                pyautogui.press("tab")
            elif key == "Space":
                pyautogui.press("space")
            elif key == "Esc":
                pyautogui.press("escape")
            elif key.startswith("F") and key[1:].isdigit():
                pyautogui.press(key.lower())
            elif char:
                pyautogui.typewrite(char, interval=0)
        except Exception as e:
            self.status_var.set(f"エラー: {e}")

    def _update_shift_display(self):
        effective_shift = self._shift ^ self._caps
        for row in self.ROWS:
            for key in row:
                if key in self.SPECIAL_KEYS or key not in self._key_buttons:
                    continue
                display = key
                if effective_shift:
                    if key in self.SHIFTED:
                        display = self.SHIFTED[key]
                    else:
                        display = key.upper()
                else:
                    display = key.lower()
                for btn in self._key_buttons[key]:
                    btn.config(text=display)

    def _highlight_key(self, key, active):
        if key in self._key_buttons:
            color = self.PRESSED_COLOR if active else self.SPECIAL_COLOR
            for btn in self._key_buttons[key]:
                btn.config(bg=color)

    def _copy_text(self):
        text = self.output_text.get("1.0", tk.END).strip()
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        self.status_var.set("クリップボードにコピーしました")


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

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

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

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

try:
    import pyautogui
    PYAUTOGUI_AVAILABLE = True
except ImportError:
    PYAUTOGUI_AVAILABLE = False


class App41:
    """バーチャルキーボード"""

    # キーボードレイアウト
    ROWS = [
        ["Esc", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"],
        ["`", "1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-", "=", "BS"],
        ["Tab", "q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "[", "]", "\\"],
        ["Caps", "a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'", "Enter"],
        ["Shift", "z", "x", "c", "v", "b", "n", "m", ",", ".", "/", "Shift"],
        ["Ctrl", "Alt", "Space", "Alt", "Ctrl"],
    ]

    SHIFTED = {
        "`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%",
        "6": "^", "7": "&", "8": "*", "9": "(", "0": ")", "-": "_", "=": "+",
        "[": "{", "]": "}", "\\": "|", ";": ":", "'": '"', ",": "<",
        ".": ">", "/": "?",
    }

    WIDE_KEYS = {"BS": 2.0, "Tab": 1.5, "Caps": 1.8, "Enter": 2.2,
                 "Shift": 2.5, "Space": 5.0, "Ctrl": 1.5, "Alt": 1.2,
                 "Esc": 1.0, "BS": 1.8}

    SPECIAL_KEYS = {"BS", "Tab", "Caps", "Enter", "Shift", "Ctrl", "Alt",
                    "Esc", "Space", "F1", "F2", "F3", "F4", "F5", "F6",
                    "F7", "F8", "F9", "F10", "F11", "F12", "\\"}

    KEY_COLOR = "#3c3c3c"
    SPECIAL_COLOR = "#505050"
    PRESSED_COLOR = "#0078d4"

    def __init__(self, root):
        self.root = root
        self.root.title("バーチャルキーボード")
        self.root.resizable(False, False)
        self.root.configure(bg="#1e1e1e")
        self._shift = False
        self._caps = False
        self._ctrl = False
        self._alt = False
        self._key_buttons = {}
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="⌨️ バーチャルキーボード",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not PYAUTOGUI_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ pyautogui が未インストール (pip install pyautogui)。"
                          "テキストエリアへの入力モードで動作します。",
                     bg="#fff3cd", fg="#856404", font=("Arial", 8),
                     anchor="w", padx=8).pack(fill=tk.X)

        # テキスト出力エリア
        output_f = tk.Frame(self.root, bg="#1e1e1e")
        output_f.pack(fill=tk.X, padx=8, pady=6)
        tk.Label(output_f, text="入力結果:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w")
        self.output_text = tk.Text(output_f, height=4, bg="#0d1117", fg="#c9d1d9",
                                    font=("Courier New", 13), relief=tk.FLAT,
                                    insertbackground="white")
        sb = ttk.Scrollbar(output_f, command=self.output_text.yview)
        self.output_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.output_text.pack(fill=tk.X)

        # 操作ボタン
        ctrl_f = tk.Frame(self.root, bg="#1e1e1e")
        ctrl_f.pack(fill=tk.X, padx=8, pady=2)
        tk.Button(ctrl_f, text="📋 コピー",
                  command=self._copy_text,
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl_f, text="🗑 クリア",
                  command=lambda: self.output_text.delete("1.0", tk.END),
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)

        # 送信先フォーカス設定
        self.target_var = tk.StringVar(value="テキストエリア")
        tk.Label(ctrl_f, text="送信先:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        for val in ["テキストエリア", "フォーカス中ウィンドウ"]:
            ttk.Radiobutton(ctrl_f, text=val, variable=self.target_var,
                            value=val).pack(side=tk.LEFT, padx=4)

        # キーボード本体
        kb_f = tk.Frame(self.root, bg="#1e1e1e", padx=8, pady=8)
        kb_f.pack()

        BASE_W = 42
        BASE_H = 38

        for row_idx, row in enumerate(self.ROWS):
            row_f = tk.Frame(kb_f, bg="#1e1e1e")
            row_f.pack(pady=2, anchor="w")
            for key in row:
                width_mult = self.WIDE_KEYS.get(key, 1.0)
                is_special = key in self.SPECIAL_KEYS
                color = self.SPECIAL_COLOR if is_special else self.KEY_COLOR
                btn_w = max(1, int(width_mult * 3.5))
                btn = tk.Button(row_f, text=key,
                                bg=color, fg="white",
                                relief=tk.FLAT, bd=0,
                                font=("Arial", 9),
                                width=btn_w,
                                height=1,
                                padx=2, pady=4,
                                activebackground=self.PRESSED_COLOR,
                                activeforeground="white",
                                command=lambda k=key: self._on_key(k))
                btn.pack(side=tk.LEFT, padx=1)
                if key not in self._key_buttons:
                    self._key_buttons[key] = []
                self._key_buttons[key].append(btn)

        self.status_var = tk.StringVar(value="キーをクリックして入力")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _on_key(self, key):
        target = self.target_var.get()

        if key == "Shift":
            self._shift = not self._shift
            self._update_shift_display()
            self._highlight_key("Shift", self._shift)
            return
        elif key == "Caps":
            self._caps = not self._caps
            self._update_shift_display()
            self._highlight_key("Caps", self._caps)
            return
        elif key == "Ctrl":
            self._ctrl = not self._ctrl
            self._highlight_key("Ctrl", self._ctrl)
            return
        elif key == "Alt":
            self._alt = not self._alt
            self._highlight_key("Alt", self._alt)
            return

        char = self._resolve_char(key)

        if target == "テキストエリア" or not PYAUTOGUI_AVAILABLE:
            self._insert_to_textarea(key, char)
        else:
            self._send_to_focus(key, char)

        # Shiftの自動解除
        if self._shift:
            self._shift = False
            self._update_shift_display()
            self._highlight_key("Shift", False)

        self.status_var.set(f"押下: {key}  →  '{char}'")

    def _resolve_char(self, key):
        if key == "BS":
            return ""
        if key == "Enter":
            return "\n"
        if key == "Tab":
            return "\t"
        if key == "Space":
            return " "
        if key in self.SPECIAL_KEYS:
            return ""

        effective_shift = self._shift ^ self._caps
        if effective_shift:
            if key in self.SHIFTED:
                return self.SHIFTED[key]
            return key.upper()
        return key.lower()

    def _insert_to_textarea(self, key, char):
        if key == "BS":
            content = self.output_text.get("1.0", tk.END)
            if len(content) > 1:
                self.output_text.delete("end-2c", "end-1c")
        elif char:
            self.output_text.insert(tk.END, char)
            self.output_text.see(tk.END)

    def _send_to_focus(self, key, char):
        if not PYAUTOGUI_AVAILABLE:
            return
        try:
            if key == "BS":
                pyautogui.press("backspace")
            elif key == "Enter":
                pyautogui.press("enter")
            elif key == "Tab":
                pyautogui.press("tab")
            elif key == "Space":
                pyautogui.press("space")
            elif key == "Esc":
                pyautogui.press("escape")
            elif key.startswith("F") and key[1:].isdigit():
                pyautogui.press(key.lower())
            elif char:
                pyautogui.typewrite(char, interval=0)
        except Exception as e:
            self.status_var.set(f"エラー: {e}")

    def _update_shift_display(self):
        effective_shift = self._shift ^ self._caps
        for row in self.ROWS:
            for key in row:
                if key in self.SPECIAL_KEYS or key not in self._key_buttons:
                    continue
                display = key
                if effective_shift:
                    if key in self.SHIFTED:
                        display = self.SHIFTED[key]
                    else:
                        display = key.upper()
                else:
                    display = key.lower()
                for btn in self._key_buttons[key]:
                    btn.config(text=display)

    def _highlight_key(self, key, active):
        if key in self._key_buttons:
            color = self.PRESSED_COLOR if active else self.SPECIAL_COLOR
            for btn in self._key_buttons[key]:
                btn.config(bg=color)

    def _copy_text(self):
        text = self.output_text.get("1.0", tk.END).strip()
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        self.status_var.set("クリップボードにコピーしました")


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

例外処理とmessagebox

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

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

try:
    import pyautogui
    PYAUTOGUI_AVAILABLE = True
except ImportError:
    PYAUTOGUI_AVAILABLE = False


class App41:
    """バーチャルキーボード"""

    # キーボードレイアウト
    ROWS = [
        ["Esc", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"],
        ["`", "1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-", "=", "BS"],
        ["Tab", "q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "[", "]", "\\"],
        ["Caps", "a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'", "Enter"],
        ["Shift", "z", "x", "c", "v", "b", "n", "m", ",", ".", "/", "Shift"],
        ["Ctrl", "Alt", "Space", "Alt", "Ctrl"],
    ]

    SHIFTED = {
        "`": "~", "1": "!", "2": "@", "3": "#", "4": "$", "5": "%",
        "6": "^", "7": "&", "8": "*", "9": "(", "0": ")", "-": "_", "=": "+",
        "[": "{", "]": "}", "\\": "|", ";": ":", "'": '"', ",": "<",
        ".": ">", "/": "?",
    }

    WIDE_KEYS = {"BS": 2.0, "Tab": 1.5, "Caps": 1.8, "Enter": 2.2,
                 "Shift": 2.5, "Space": 5.0, "Ctrl": 1.5, "Alt": 1.2,
                 "Esc": 1.0, "BS": 1.8}

    SPECIAL_KEYS = {"BS", "Tab", "Caps", "Enter", "Shift", "Ctrl", "Alt",
                    "Esc", "Space", "F1", "F2", "F3", "F4", "F5", "F6",
                    "F7", "F8", "F9", "F10", "F11", "F12", "\\"}

    KEY_COLOR = "#3c3c3c"
    SPECIAL_COLOR = "#505050"
    PRESSED_COLOR = "#0078d4"

    def __init__(self, root):
        self.root = root
        self.root.title("バーチャルキーボード")
        self.root.resizable(False, False)
        self.root.configure(bg="#1e1e1e")
        self._shift = False
        self._caps = False
        self._ctrl = False
        self._alt = False
        self._key_buttons = {}
        self._build_ui()

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="⌨️ バーチャルキーボード",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not PYAUTOGUI_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ pyautogui が未インストール (pip install pyautogui)。"
                          "テキストエリアへの入力モードで動作します。",
                     bg="#fff3cd", fg="#856404", font=("Arial", 8),
                     anchor="w", padx=8).pack(fill=tk.X)

        # テキスト出力エリア
        output_f = tk.Frame(self.root, bg="#1e1e1e")
        output_f.pack(fill=tk.X, padx=8, pady=6)
        tk.Label(output_f, text="入力結果:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w")
        self.output_text = tk.Text(output_f, height=4, bg="#0d1117", fg="#c9d1d9",
                                    font=("Courier New", 13), relief=tk.FLAT,
                                    insertbackground="white")
        sb = ttk.Scrollbar(output_f, command=self.output_text.yview)
        self.output_text.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.output_text.pack(fill=tk.X)

        # 操作ボタン
        ctrl_f = tk.Frame(self.root, bg="#1e1e1e")
        ctrl_f.pack(fill=tk.X, padx=8, pady=2)
        tk.Button(ctrl_f, text="📋 コピー",
                  command=self._copy_text,
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl_f, text="🗑 クリア",
                  command=lambda: self.output_text.delete("1.0", tk.END),
                  bg="#3c3c3c", fg="white", relief=tk.FLAT,
                  font=("Arial", 9), padx=8, pady=3,
                  activebackground="#505050", bd=0).pack(side=tk.LEFT, padx=4)

        # 送信先フォーカス設定
        self.target_var = tk.StringVar(value="テキストエリア")
        tk.Label(ctrl_f, text="送信先:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=(12, 4))
        for val in ["テキストエリア", "フォーカス中ウィンドウ"]:
            ttk.Radiobutton(ctrl_f, text=val, variable=self.target_var,
                            value=val).pack(side=tk.LEFT, padx=4)

        # キーボード本体
        kb_f = tk.Frame(self.root, bg="#1e1e1e", padx=8, pady=8)
        kb_f.pack()

        BASE_W = 42
        BASE_H = 38

        for row_idx, row in enumerate(self.ROWS):
            row_f = tk.Frame(kb_f, bg="#1e1e1e")
            row_f.pack(pady=2, anchor="w")
            for key in row:
                width_mult = self.WIDE_KEYS.get(key, 1.0)
                is_special = key in self.SPECIAL_KEYS
                color = self.SPECIAL_COLOR if is_special else self.KEY_COLOR
                btn_w = max(1, int(width_mult * 3.5))
                btn = tk.Button(row_f, text=key,
                                bg=color, fg="white",
                                relief=tk.FLAT, bd=0,
                                font=("Arial", 9),
                                width=btn_w,
                                height=1,
                                padx=2, pady=4,
                                activebackground=self.PRESSED_COLOR,
                                activeforeground="white",
                                command=lambda k=key: self._on_key(k))
                btn.pack(side=tk.LEFT, padx=1)
                if key not in self._key_buttons:
                    self._key_buttons[key] = []
                self._key_buttons[key].append(btn)

        self.status_var = tk.StringVar(value="キーをクリックして入力")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _on_key(self, key):
        target = self.target_var.get()

        if key == "Shift":
            self._shift = not self._shift
            self._update_shift_display()
            self._highlight_key("Shift", self._shift)
            return
        elif key == "Caps":
            self._caps = not self._caps
            self._update_shift_display()
            self._highlight_key("Caps", self._caps)
            return
        elif key == "Ctrl":
            self._ctrl = not self._ctrl
            self._highlight_key("Ctrl", self._ctrl)
            return
        elif key == "Alt":
            self._alt = not self._alt
            self._highlight_key("Alt", self._alt)
            return

        char = self._resolve_char(key)

        if target == "テキストエリア" or not PYAUTOGUI_AVAILABLE:
            self._insert_to_textarea(key, char)
        else:
            self._send_to_focus(key, char)

        # Shiftの自動解除
        if self._shift:
            self._shift = False
            self._update_shift_display()
            self._highlight_key("Shift", False)

        self.status_var.set(f"押下: {key}  →  '{char}'")

    def _resolve_char(self, key):
        if key == "BS":
            return ""
        if key == "Enter":
            return "\n"
        if key == "Tab":
            return "\t"
        if key == "Space":
            return " "
        if key in self.SPECIAL_KEYS:
            return ""

        effective_shift = self._shift ^ self._caps
        if effective_shift:
            if key in self.SHIFTED:
                return self.SHIFTED[key]
            return key.upper()
        return key.lower()

    def _insert_to_textarea(self, key, char):
        if key == "BS":
            content = self.output_text.get("1.0", tk.END)
            if len(content) > 1:
                self.output_text.delete("end-2c", "end-1c")
        elif char:
            self.output_text.insert(tk.END, char)
            self.output_text.see(tk.END)

    def _send_to_focus(self, key, char):
        if not PYAUTOGUI_AVAILABLE:
            return
        try:
            if key == "BS":
                pyautogui.press("backspace")
            elif key == "Enter":
                pyautogui.press("enter")
            elif key == "Tab":
                pyautogui.press("tab")
            elif key == "Space":
                pyautogui.press("space")
            elif key == "Esc":
                pyautogui.press("escape")
            elif key.startswith("F") and key[1:].isdigit():
                pyautogui.press(key.lower())
            elif char:
                pyautogui.typewrite(char, interval=0)
        except Exception as e:
            self.status_var.set(f"エラー: {e}")

    def _update_shift_display(self):
        effective_shift = self._shift ^ self._caps
        for row in self.ROWS:
            for key in row:
                if key in self.SPECIAL_KEYS or key not in self._key_buttons:
                    continue
                display = key
                if effective_shift:
                    if key in self.SHIFTED:
                        display = self.SHIFTED[key]
                    else:
                        display = key.upper()
                else:
                    display = key.lower()
                for btn in self._key_buttons[key]:
                    btn.config(text=display)

    def _highlight_key(self, key, active):
        if key in self._key_buttons:
            color = self.PRESSED_COLOR if active else self.SPECIAL_COLOR
            for btn in self._key_buttons[key]:
                btn.config(bg=color)

    def _copy_text(self):
        text = self.output_text.get("1.0", tk.END).strip()
        self.root.clipboard_clear()
        self.root.clipboard_append(text)
        self.status_var.set("クリップボードにコピーしました")


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

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

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

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

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

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

    App41クラスを定義し、__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.42に挑戦しましょう。