【Mac・Tkinter】カレンダーが空白になる・再び開かないときに試した対処法

PythonのTkinterで勤怠アプリを作っていたところ、日付を選ぶカレンダーでつまずきました。矢印を押しても中が空白。やっと表示できたと思ったら、今度は一度日付を選ぶと、もう一度開けなくなってしまいました。

今回は、MacでtkcalendarのDateEntryを使ったときに起きた症状と、私の環境で日付を選び直せるようになった対処をまとめます。コードの意味も、一つずつ説明します。

この記事は、Tkinterのウィンドウ自体は開くけれど、カレンダーの表示や開閉がうまくいかない人向けです。ModuleNotFoundError: No module named '_tkinter'への対処とは別の話になります。

先に結果:表示方法を変更したら、再び開けるようになった

いくつかの対処を入れた状態で、最後に次の1行を追加したところ、日付を選んだあともカレンダーを開けるようになりました。

date_entry._top_cal.overrideredirect(False)

これは、カレンダーの小窓を通常のウィンドウとして扱わせる設定です。タイトルバーなどが付く場合があり、見た目は変わります。

ただし、この1行だけで直るかは確認していません。それまでに追加したフォーカス関連の対処も残した状態で動いたため、この記事では、試した順番と確認できた結果を分けて紹介します。

使っていた環境

  • macOS:14.1.1
  • Python:3.11.15
  • 仮想環境:プロジェクト内の.venv
  • 日付入力:tkcalendar.DateEntry
  • 画面の部品:tkinterとttk

環境構築時にはHomebrewのtcl-tk@8 8.6.18を導入していました。tkcalendarの正確なバージョンは、この記録では確認できていません。同じMacでも、PythonやTcl/Tkなどの組み合わせによって結果が変わる可能性があります。

症状1:カレンダーを開くと、中が空白になる

日付欄の矢印を押すと、小さなパネルは出てくるのに、月や日付が表示されませんでした。ターミナルにエラーが出るわけでもなく、どこを直せばよいのか分かりづらい状態でした。

そこで、DateEntryを作成して配置したあとに、次の処理を追加しました。

date_entry.grid(row=3, column=0, sticky="ew", padx=(0, 12))

# カレンダーへフォーカスを移す処理を無効にする
date_entry._calendar.focus_set = lambda: None

focus_set()は、キーボード操作などの対象をその部品へ移すための処理です。このコードでは、カレンダー内部のfocus_setを「何もしない関数」に置き換えています。

lambda: Noneは、ここでは「何もせずに終わる小さな関数」と考えると分かりやすいです。私の環境では、この変更のあとにカレンダーの中身が表示されるようになりました。

症状2:一度日付を選ぶと、カレンダーを再び開けない

表示できるようになって安心したのですが、次の問題が出ました。一度日付を選ぶと、日付欄の表示は変わるのに、そのあと矢印を押しても反応しなくなってしまいました。

まず試したのは、日付を選び終わったあとに、矢印ボタンの押された状態を解除し、日付欄へフォーカスを戻す処理です。

def on_date_selected(event):
    # 矢印ボタンの押された状態を解除
    date_entry.state(["!pressed"])

    # カレンダーを閉じる処理のあとに、日付欄へフォーカスを戻す
    date_entry.after_idle(date_entry.focus_set)


date_entry.bind("<<DateEntrySelected>>", on_date_selected, add="+")

<<DateEntrySelected>>は「日付が選ばれた」というイベントです。bind()で、そのタイミングに実行する関数を登録しています。after_idle()は、今のイベント処理などが落ち着いたあとに処理を実行するための指定です。

ただし、この追加だけでは、私の環境の症状は変わりませんでした。この時点で解決したわけではありません。

クリックの状態を確認してみた

次に、確認用のコードで、クリックした場所とカレンダーの状態をターミナルへ表示しました。最初の矢印クリックでは、クリック位置と矢印として登録された名前が、どちらもCombobox.buttonになっていました。

その直後のカレンダーの状態はnormalでした。これはウィンドウの状態を示す値で、画面上で正常に描画され、操作できていることまで保証するものではありません。その後、反応しなくなった矢印を押しても、確認用のログは増えませんでした。

この結果だけで原因を断定することはできませんが、矢印の認識だけではなく、カレンダーのウィンドウ表示やクリックの受け取り方も関係していそうだと考え、表示方法を変更することにしました。

最後に変更したのは、カレンダーの小窓の表示方法

空白表示の対処として入れていた行の下に、次の設定を追加しました。

# 空白表示への対処として残していた設定
date_entry._calendar.focus_set = lambda: None

# カレンダーの小窓を通常のウィンドウとして扱う
date_entry._top_cal.overrideredirect(False)

_top_calは、DateEntry内部にあるカレンダー用の小窓です。overrideredirect(True)は通常のウィンドウ管理から外す指定で、Falseにすると通常の管理へ戻します。

保存してアプリを完全に終了し、起動し直しました。そのあと「カレンダーを開く → 日付を選ぶ → もう一度開く」を試したところ、日付を選び直せるようになりました。

この確認時には、前のon_date_selectedの処理も残していました。それぞれの処理が単独で必要かどうかまでは切り分けていないため、以下も「動いたときに入っていた設定」として掲載します。

動いたときに入れていた設定をまとめる

以下は、今回追加した設定をまとめたものです。既存のdate_entry = DateEntry(...)とdate_entry.grid(...)の後、window.mainloop()の前に置く部分で、単独で起動するプログラムではありません。同じ関数やbind()をすでに書いている場合は、重複して追加しないでください。

# Macでカレンダーが空白になる問題への回避策
date_entry._calendar.focus_set = lambda: None

# カレンダーの小窓を通常のウィンドウとして扱う
date_entry._top_cal.overrideredirect(False)


# 日付を選び終わったあとの処理
def on_date_selected(event):
    date_entry.state(["!pressed"])
    date_entry.after_idle(date_entry.focus_set)


date_entry.bind("<<DateEntrySelected>>", on_date_selected, add="+")

なお、_calendarや_top_calは、ライブラリ内部の部品にアクセスしています。通常の設定項目とは異なる回避策なので、tkcalendarなどを更新した際は、表示と開閉を改めて確認する必要があります。

同じ症状でも、環境によって結果は異なる

tkcalendarのGitHubにも、MacでDateEntryが表示されないという不具合報告があり、フォーカス処理やoverrideredirectに関する回避策が共有されています。一方で、同じ対処では改善しなかったという報告もあります。

今回確認できたのは、私の環境で、先に入れた対処を残したままoverrideredirect(False)を追加すると、カレンダーを再び開けるようになったことです。Macが古いことや、自分のコードの書き方が原因だったと断定できる結果ではありません。

カレンダーを付けるだけのつもりが、思ったより苦戦しました。でも、表示されないときに何を確認するか、コードのどこで見た目や動きを変えているかを知るきっかけになりました。同じ症状で困ったときの、一つの参考になればうれしいです。

参考にした情報