CustomTkinter

---

이 프로젝트를 돕기 위해 기부해주신 모든 분들께 진심으로 감사드립니다.

공식 웹사이트: https://customtkinter.tomschimansky.com

CustomTkinter는 Tkinter를 기반으로 하는 Python UI 라이브러리로, 새롭고 현대적이며 완전히 사용자 정의 가능한 위젯을 제공합니다. 이는 일반 Tkinter 위젯처럼 생성 및 사용되며 일반 Tkinter 요소와 결합하여 사용할 수도 있습니다. 위젯과 창 색상은 시스템 모양이나 수동으로 설정된 모드('밝음', '어두움')에 맞게 조정되며 모든 CustomTkinter 위젯과 창은 HighDPI 스케일링(Windows, macOS)을 지원합니다. CustomTkinter를 사용하면 모든 데스크탑 플랫폼(Windows, macOS, Linux)에서 일관되고 현대적인 모습을 얻을 수 있습니다.

| 어두운 모드와 '파란색' 테마가 있는 Windows 11의 complex_example.py

| macOS의 light 모드 및 표준 '파란색' 테마의 complex_example.py

설치

pip를 사용하여 모듈을 설치합니다.

pip3 install customtkinter

기존 설치 업데이트: pip3 install customtkinter --upgrade
(이 라이브러리는 활발히 개발 중이므로 가능한 자주 업데이트하세요)

선적 서류 비치

공식 문서는 여기에서 찾을 수 있습니다:

➡️ https://customtkinter.tomschimansky.com/documentation .

예제 프로그램

customtkinter를 테스트하려면 버튼 하나만 사용하여 다음과 같은 간단한 예제를 시도해 볼 수 있습니다.

 import customtkintercustomtkinter.set_appearance_mode("System") # 모드: system(기본값), light, darkcustomtkinter.set_default_color_theme("blue") # 테마: blue(기본값), dark-blue, greenapp = customtkinter.CTk() # CTk 창 생성 Tk windowapp.geometry("400x240")defbutton_function():print("button)에서 하는 것처럼 Pressed")# tkinter 대신 CTkButton 사용 Buttonbutton = customtkinter.CTkButton(master=app, text="CTkButton", command=button_function)button.place(relx=0.5,reli=0.5,anchor=customtkinter.CENTER)app.mainloop ()

macOS에서는 다음과 같은 창이 나타납니다.

예제 폴더에서 더 많은 예제 프로그램을 찾을 수 있으며 문서에서 모양 모드, 크기 조정, 테마 및 모든 위젯에 대한 추가 정보를 찾을 수 있습니다.

더 많은 예시와 쇼케이스

외형 모드 변경 및 스케일링 변경

CustomTkinter는 Windows 10/11 밝은 모드 또는 어두운 모드에 적응할 수 있습니다.

complex_example_mode_switch_Windows.mp4

| 시스템 모양 모드 변경 및 표준 '파란색' 테마가 있는 Windows 11의 complex_example.py

macOS에서는 어두운 창 헤더를 얻으려면 python3.10 이상 또는 anaconda python 버전이 필요합니다(Tcl/Tk >= 8.6.9 필요).

complex_example_mode_switch_scaling_macOS.mp4

| 시스템 모양 모드 변경, 사용자 크기 조정 변경 및 표준 '파란색' 테마가 포함된 macOS의 complex_example.py

이미지가 포함된 버튼

CTkButton에 이미지를 넣을 수 있습니다. image 인수를 사용하여 PhotoImage 객체를 CTkButton에 전달하기만 하면 됩니다. 텍스트를 전혀 원하지 않으면 text="" 로 설정하거나 compound 옵션을 사용하여 텍스트와 이미지를 동시에 배치하는 방법을 지정해야 합니다.

| Windows 11의 image_example.py

스크롤 가능한 프레임

스크롤 가능한 프레임은 수직 또는 수평 방향으로 가능하며 다른 위젯과 결합될 수 있습니다. | Windows 11의 scrollable_frame_example.py

TkinterMapView 위젯 통합

다음 예제에서는 CustomTkinter 프로그램과 잘 통합되는 TkinterMapView를 사용했습니다. OpenStreetMap 또는 기타 타일 기반 지도를 표시하는 타일 기반 지도 위젯입니다.

tkintermapview_customtkinter_Windows.mp4

| Windows 11의 TkinterMapView 저장소의 examples/map_with_customtkinter.py

TkinterMapView 라이브러리와 예제 프로그램은 여기에서 찾을 수 있습니다: https://github.com/TomSchimansky/TkinterMapView