Skip to content

Latest commit

 

History

History
161 lines (115 loc) · 6.3 KB

README-ko.md

File metadata and controls

161 lines (115 loc) · 6.3 KB

TkEasyGUI

TkEasyGUI는 Python에서 GUI를 가장 쉽게 작성할 수 있는 라이브러리입니다.

TkEasyGUI 로고

  • Python 표준 UI 라이브러리인 Tkinter는 종종 접근 장벽이 높고 사용하기 어렵다고 여겨집니다. 이 라이브러리를 사용하면 GUI 애플리케이션을 쉽고 직관적으로 만들 수 있습니다.

  • 이벤트 모델은 잘 알려진 GUI 라이브러리인 PySimpleGUI와 호환됩니다.

  • 이 패키지는 타입 힌트를 지원하여 코드 완성을 통해 속성을 선택할 수 있습니다. Python 3.9 이상이 필요합니다.

  • 이 프로젝트는 관대한 MIT 라이선스를 채택하고 있으며, 이 라이선스는 향후 변경되지 않을 것입니다. 함께 GUI 프로그램 제작을 즐겨보세요.

  • 👉English

This document has been translated automatically. Please let us know if you find any unnatural expressions.

플랫폼

  • Windows / macOS / Linux (Tkinter 필요)

TkEasyGUI

설치

PyPI에서 패키지 설치:

pip install TkEasyGUI
# 또는
python -m pip install TkEasyGUI

GitHub Repository에서 패키지 설치:

python -m pip install git+https://github.com/kujirahand/tkeasygui-python
  • (메모) 0.2.24 이전 버전에서 업데이트 시 실패할 수 있습니다. (해결 방법 보기)

사용 방법 - 팝업 대화상자

TkEasyGUI를 사용하는 것은 간단합니다. 대화상자만 표시하려면 두 줄의 코드만 필요합니다.

import TkEasyGUI as eg
# 텍스트 대화상자 표시
eg.print("기쁨의 마음은 좋은 약이다.")

사용자에게 이름을 묻고 창에 이름을 표시합니다.

import TkEasyGUI as eg
# 입력 대화상자 표시
name = eg.input("당신의 이름은 무엇인가요?")
eg.print(f"안녕하세요, {name}님.")

또한, 여러 입력 필드를 지정할 수 있는 대화상자도 사용할 수 있습니다.

import TkEasyGUI as eg
# 폼 대화상자 표시
form = eg.popup_get_form(["이름", "나이", "취미"])
if form:
    name = form["이름"]
    age = form["나이"]
    hobbies = form["취미"]
    eg.print(f"이름={name}, 나이={age}, 취미={hobbies}")

사용 방법 - 위젯

레이블과 버튼만 있는 간단한 창을 생성하려면 다음과 같이 작성할 수 있습니다.

import TkEasyGUI as eg
# 레이아웃 정의
layout = [
    [eg.Text("안녕하세요, 세상!")],
    [eg.Button("확인")]
]
# 창 생성
with eg.Window("Hello App", layout) as window:
    # 이벤트 루프
    for event, values in window.event_iter():
        if event == "확인":
            eg.print("감사합니다.")
            break

PySimpleGUI와 유사한 이벤트 모델을 사용하여 설명할 수 있습니다.

import TkEasyGUI as eg

# 레이아웃 정의
layout = [[eg.Text("안녕하세요, 세상!")], [eg.Button("확인")]]
# 창 생성
window = eg.Window("Hello App", layout)
# 이벤트 루프
while True:
    event, values = window.read()
    if event in ["확인", eg.WINDOW_CLOSED]:
        eg.popup("감사합니다.")
        break
# 창 닫기
window.close()

샘플

간단한 사용 방법을 보여주는 여러 샘플을 준비했습니다. 확인해 보세요.

tests/file_viewer.py를 실행하면 모든 샘플을 쉽게 실행할 수 있습니다.

문서

다음은 클래스와 메서드의 상세 목록입니다.

튜토리얼

일본어 튜토리얼:

PySimpleGUI와의 호환성

  • 기본 기능을 사용할 때 PySimpleGUI와 호환됩니다. PySimpleGUI와 동일한 이벤트 구동 모델을 사용하여 프로그램을 작성할 수 있습니다.
  • 기본 GUI 구성 요소의 이름은 동일하게 유지되지만, 일부 속성 이름은 다릅니다.
  • TkEasyGUI는 완전히 새로 구현되었으며 MIT 라이선스 하에 제공됩니다.
  • 그러나 PySimpleGUI와의 완전한 호환성을 목표로 하지는 않습니다.

TkEasyGUI의 주요 기능:

  • for 루프와 window.event_iter()를 사용하여 간단한 이벤트 처리가 가능합니다.
  • 색상 선택 대화상자(eg.popup_color), 폼 대화상자(eg.popup_get_form) 등 맞춤형 팝업 대화상자가 제공됩니다.
  • Image 클래스는 PNG뿐만 아니라 JPEG 형식도 지원합니다.
  • 대량 이벤트 등록을 위한 편리한 이벤트 훅 및 기능 제공 - docs/custom_events.
  • 텍스트 박스(Multiline/Input)에 복사, 붙여넣기, 잘라내기 기능이 추가되었습니다.
  • 시스템의 기본 색상 스킴을 활용합니다.

링크