README-ja.md

TkEasyGUI

TkEasyGUIは、Pythonで最も簡単にGUIアプリケーション開発するライブラリです。Tkinterのような従来のUIライブラリが持つ複雑さを解消し、より多くの開発者がGUIアプリの開発を楽しめます。本ライブラリは、簡単にGUIを構築できるライブラリPySimpleGUIの概念を引き継ぎつつ、独自の機能を追加しています。

• 👉English

TkEasyGUIの特徴:

• TkEasyGUIは、GUIアプリケーションを簡単かつシンプルに作成することができるPythonライブラリです。
• イベントモデルでは、よく知られたGUIライブラリPySimpleGUIと互換性があります。
• Pythonの標準UIライブラリTkinterは、学習障壁が高と考えられていますが、このライブラリを使用すると、GUIアプリケーションを直感的に作成できます。
• 型ヒントに対応しているので、コード補完でプロパティを選択できます。(本パッケージの利用には、Python 3.9以降が必要です。)
• ライセンスには比較的緩いMITライセンスを採用しています。将来このライセンスを変えることはありません。

対象プラットフォーム

• Windows / macOS / Linux (Tkinterが動く環境)

インストール:

pypiからインストールします。

python -m pip install TkEasyGUI

GitHubリポジトリからインストールします。

python -m pip install git+https://github.com/kujirahand/tkeasygui-python

• (memo) v0.2.24未満のバージョンからのアップデートに失敗する場合があります。その場合、こちらを確認してください。

簡単な使い方 - ポップアップダイアログを使う

TkEasyGUIの使い方は簡単です。もし、ダイアログにメッセージを表示したい場合、次のように記述します。

import TkEasyGUI as eg
eg.print("A joyful heart is good medicine.")

入力ボックス付きのダイアログで尋ねることもできます。次のコードは、名前を尋ねて、続くダイアログに名前を表示します。

import TkEasyGUI as eg
name = eg.input("What is your name?")
eg.print(f"Hello, {name}.")

簡単な使い方 - カスタムウィンドウを定義して使う

ラベルとボタンのみを持つシンプルなウィンドウを作成するには、以下のように記述します。with文を使うことで、イベントループを抜けると自動的にウィンドウが閉じるように指定できます。

import TkEasyGUI as eg
# 画面レイアウトの定義
layout = [
    [eg.Text("Hello, World!")],
    [eg.Button("OK")]
]
# ウィンドウを表示する
with eg.Window("Hello App", layout) as window:
    # イベントループを処理する
    for event, values in window.event_iter():
        if event == "OK":
            eg.print("Thank you.")
            break # ループを抜ける

有名GUIライブラリのPySimpleGUIと同じイベントモデルの使い勝手で記述できます。（多くのGUI部品でPySimpleGUIと互換性を持たせています。）

import TkEasyGUI as eg
# define layout
layout = [[eg.Text("Hello, World!")],
          [eg.Button("Exit")]]
# create a window
window = eg.Window("test", layout)
# event loop
while True:
    event, values = window.read()
    if event in ["Exit", eg.WINDOW_CLOSED]:
        eg.popup("Thank you.")
        break
# close window
window.close()

日本語チュートリアル

• TkEasyGUI - Pythonで最も素早くデスクトップアプリを創るライブラリ
• マイナビニュースPython連載116回目 - 金額合計ツールでExcel要らず - 合計/整形/コピーのツールを作ろう

サンプル

簡単な使い方を示すサンプルを揃えました。確認してみてください。

• samples.

tests/file_viewer.pyを実行することで、すべてのサンプルを手軽に起動できます。

ドキュメント

ライブラリの詳細なクラスやメソッドの一覧です。

• docs

PySimpleGUIとの関係について

• 基本機能を使う場合、PySimpleGUIと互換性があります。PySimpleGUIと同じイベントモデルでプログラムを記述できます。
• 基本的なGUI部品の名前も同じにしてあります。しかし、いくつかのプロパティの名前が異なっていますが、多くの独自機能が実装されています。
• 本プロジェクトは、PySimpleGUIの存在を意識して開発しましたが、完全にゼロから実装しています。ライセンス的にも問題はありません。

PySimpleGUIと完全な互換性は考えていません。

TkEasyGUI独自の機能

• for文と window.event_iter() を使って気軽にイベント処理が可能
• 任意のボタンを持つダイアログ(eg.popup_buttons)や色選択ダイアログ(eg.popup_color)など、独自のポップアップダイアログを用意
• ImageはPNGだけでなくJPEGも読み込み可能
• 便利なイベントフックや一括イベント登録機能 - docs/custom_events
• テキストボックス(Muliline/Input)に便利なCopy/Paste/Cutなどのメソッドを追加

リンク

• pypi.org > TkEasyGUI
• GitHub > TkEasyGUI