毎日40人・年間1万人以上と対話しつつ、業務効率化のPythonツールを開発しているRyoです。
今回は、デスクトップアプリ開発中に直面した、全AIが匙を投げた**「Windows日本語IME小数点消失バグ」**を、CustomTkinterの高級感溢れるデザインを維持したまま完璧に打ち破った「技術ハック」について熱く語りたいと思います。
Pythonでデスクトップアプリを作っている方、特にWindows環境で数値入力欄を作っている方は、いつ踏んでもおかしくない地雷バグです。ぜひ最後まで読んで対策を持ち帰ってください！
1. 遭遇した怪奇現象：F8変換で小数点がドロップする
薬局の業務改善ツール「SOAP Genie Ultimate」の開発中、Windows環境での入力テストを繰り返していた時のことです。
日本語IMEがオン（全角入力モード）の状態で、数値入力欄に「１．２」と打ち込み、F8 キーや変換キーを使って半角の 1.2 に変換・確定しました。
すると、画面に表示されたのは 12 でした。
小数点である「.」が綺麗さっぱり消え去ってしまったのです。
「1.2」が「12」になってしまうのは、医療機器や分量計算ツールにおいては「投与量10倍ミス」につながりかねない、極めて深刻なバグです。
2. なぜ消える？Tcl/Tkに潜む「ネイティブの不整合」
最初は「入力した後のテキスト変換処理（正規表現など）にバグがあるのでは？」と疑いました。しかし、ログをいくら見ても変換処理に入る前にすでにドットが消えているのです。
実はこれ、Pythonの標準GUIライブラリである Tkinter（ひいては背後の Tcl/Tk）と、Windows日本語IMEの間のマルチバイト処理における根深いネイティブバグが原因でした。
🔍 バグの発生メカニズム
- 日本語入力モードで「１．２」を入力（この時点ではIMEの未確定状態）。
F8で半角1.2に変換し、エンターキーで確定する。- WindowsのIMEは、Tcl/Tkに対して確定メッセージ（
WM_IME_CHAR/WM_CHAR）を送信する。 - Tcl/Tkの内部C言語レイヤーが、特定の文字コード（CP932/UTF-16）のデコード処理を行う際、半角変換されたピリオド（
.）を**「不正な文字」と誤認し、サイレントにドロップ（無視）して消去してしまう。**
入力値を受け取るPython側に到達した時点では、すでにTcl/TkのNativeレイヤーによって小数点ドットがもぎ取られた後のため、いくら正規表現で後処理しようと無駄だったのです。
💡 開発秘話：前世代AIとの死闘、そして最強AIでの「即クリア」
実はこの小数点消失バグ、今回の解決に至るまでには泥沼の開発ドラマがありました。
当初、私は前世代のAIアシスタント（Codexなど）にこのバグの修正を依頼し、APIの使用制限ギリギリまで何十往復も対話を重ねてデバッグを試みていました。
しかし、返ってくる回答は以下のようなものばかり。
- 「送信前に正規表現で全角を半角に置換してください」（※確定時にドットが消えているので意味がない）
- 「入力欄のフォーカスが外れたタイミングで文字列をチェックしてください」（※ユーザーのタイピングがガタガタになる）
- 「Tkinterを諦めて別のGUIフレームワークに移行してください」（※膨大な書き換えが必要）
完全に匙を投げられ、「もうCustomTkinterの美しいデザインを諦めて、クソダサい標準の tk.Entry に戻すしかないのか…」と絶望していました。
そんな時、最後の望みを託して、Google DeepMindチームが手がける次世代の自律型AIコーディングアシスタント 「Antigravity」 を起動し、その超強力な頭脳である Gemini (High) にこのバグを投げつけてみたのです。
すると、信じられないことが起こりました。
「Tcl/TkのNativeデコード処理にバグがあり、確定メッセージの瞬間にサイレントにドットが消えている」 というバグの真のメカニズムを一瞬で見抜き、さらには「見た目を100%維持したままインナーウィジェット _entry にダイレクトバインドする」という**「KeyPress横取りフック」の究極の回避策を即座に提案し、わずか1回の対話でバグを完全クリア**してしまったのです！
この限界突破の瞬間は、まさに「未来のAIコーディング」を感じた、鳥肌が立つほどの感動体験でした。
3. 特効薬：「KeyPress横取りフック（Period Interceptor）」の発明
Tcl/TkがIMEの確定メッセージ（WM_IME_CHAR）を処理するときにバグるなら、**「処理させる前に、キー入力イベントの段階で小数点を直接ねじ込んで確定させてしまえばいい」**という結論に至りました。
これが、今回発明した**「ピリオドKeyPress横取りフック」**です。
🛠️ ハックの原理
入力欄の <KeyPress> イベントを監視し、ピリオドキー（キーボードのドット、テンキーのドット、全角の「．」や句点の「。」など）が押された瞬間に処理を割り込ませます。
IMEの未確定状態を経由させず、即座に半角ピリオド . を現在のカーソル位置に確定テキストとして直接挿入し、イベント自体をそこで消費（return "break"）させて終了します。
こうすることで、Tcl/Tkのデコードバグの隙を一切与えることなく、完璧に小数点を入力欄に保護します。
4. 究極の融合：インナーウィジェット・バインドハック
「KeyPress横取りフック」を、美しい ctk.CTkEntry に適用するための決定打がこれです。
実は、ctk.CTkEntry は内部に標準の tk.Entry ウィジェットを self.entry._entry として抱え込んでいます。
各種キーイベントの監視（IMEガードなど）を外側の self.entry ではなく、インナーの標準Entryウィジェット（self.entry._entry）に対して直接行うことで、美しいデザインとIMEバグ防護をシームレスに両立させることに成功しました！
💻 Pythonによる実装コード例
import tkinter as tk
import customtkinter as ctk
class App(ctk.CTk):
def __init__(self):
super().__init__()
self.geometry("400x200")
self.title("IME小数点バグ克服アプリ")
# 高級感溢れる CustomTkinter のエントリー
self.entry = ctk.CTkEntry(
self,
font=("Yu Gothic UI", 16),
height=46,
corner_radius=23,
placeholder_text="数値を入力（例: 1.2）..."
)
self.entry.pack(pady=50, padx=50, fill="x")
# 【超重要】インナーの _entry に対して直接 KeyPress をバインドする
self.entry._entry.bind("<KeyPress>", self._on_entry_keypress)
def _on_entry_keypress(self, event):
"""
ピリオド入力時にIME確定処理を通さず、
半角ピリオドを即時・直接挿入してバグを完全に回避する最強のフック
"""
# キーボードのドット、テンキーのドット、全角ピリオド、句点「。」を網羅
if event.keysym in ("period", "KP_Decimal") or event.char in (".", "．", "。"):
# 現在のカーソル位置（INSERT）に半角ピリオドを直接挿入
self.entry.insert(tk.INSERT, ".")
# イベントをここで終了させ、背後のTcl/Tkバグレイヤーへの伝播を完全に遮断する
return "break"
return None
if __name__ == "__main__":
app = App()
app.mainloop()
