Skip to main content

A modern messagebox for customtkinter

Project description

CTkMessagebox

A modern and fully customizable messagebox for customtkinter

Features:

  • Customize all elements inside the messagebox
  • Add custom icons or images
  • Spawns at center of the screen
  • Add multiple buttons according to your wish
  • No ugly looking header or borders
  • Comes with 5 default icons
  • Draggable window

Installation

pip install CTkMessagebox

GitHub repo size

Latest version: 1.3

How it looks?

Screenshot

Example

from CTkMessagebox import CTkMessagebox
import customtkinter

def show_info():
    # Default messagebox for showing some information
    CTkMessagebox(title="Info", message="This is a CTkMessagebox!")

def show_checkmark():
    # Show some positive message with the checkmark icon
    CTkMessagebox(message="CTkMessagebox is successfully installed.",
                  icon="check", option_1="Thanks")
    
def show_error():
    # Show some error message
    CTkMessagebox(title="Error", message="Something went wrong!!!", icon="cancel")
    
def show_warning():
    # Show some retry/cancel warnings
    msg = CTkMessagebox(title="Warning Message!", message="Unable to connect!",
                  icon="warning", option_1="Cancel", option_2="Retry")
    
    if msg.get()=="Retry":
        show_warning()
        
def ask_question():
    # get yes/no answers
    msg = CTkMessagebox(title="Exit?", message="Do you want to close the program?",
                        icon="question", option_1="Cancel", option_2="No", option_3="Yes")
    response = msg.get()
    
    if response=="Yes":
        app.destroy()       
    else:
        print("Click 'Yes' to exit!")
              
app = customtkinter.CTk()
app.rowconfigure((0,1,2,3,4,5), weight=1)
app.columnconfigure(0, weight=1)
app.minsize(200,250)

customtkinter.CTkLabel(app, text="CTk Messagebox Examples").grid(padx=20)
customtkinter.CTkButton(app, text="Check CTkMessagebox", command=show_checkmark).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Show Info", command=show_info).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Show Error", command=show_error).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Show Warning", command=show_warning).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Ask Question", command=ask_question).grid(padx=20, pady=(10,20), sticky="news")

app.mainloop()

OPTIONS

Parameters Description
width width of the window in px (optional)
height height of the window in px (optional)
fg_color forground color of the messagebox [middle portion]
bg_color background color of the messagebox
title title of the messagebox
message main message of the messagebox which will be shown at the center
option_1 the text on the first button [Default is 'OK']
option_2 the text on the second button
option_3 the text on the last button
button_color color of the buttons
text_color color of the message-text
title_color color of the title-text
button_text_color color of the button-text
button_width width of the buttons in px
border_width width of the border around the main frame [Default is 0]
border_color color of the frame border
cancel_button_color color of the close button, set it to 'transparent' if you want to hide it
icon icon that will be shown in the messagebox [Default is the 'info' icon]
icon_size define the size of the icon image manually (tuple)
corner_radius corner roundness of the messagebox window [not applicable in linux]
font font of the messagebox text (tuple)

Icons

Default icons:

icons

(These icons are created by me using Paint.NET, free to use!)

For custom images, just use icon="path_to_the_image.png"

That's all, hope it will help in UI development!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

CTkMessagebox-1.3.tar.gz (123.6 kB view details)

Uploaded Source

Built Distribution

CTkMessagebox-1.3-py3-none-any.whl (123.2 kB view details)

Uploaded Python 3

File details

Details for the file CTkMessagebox-1.3.tar.gz.

File metadata

  • Download URL: CTkMessagebox-1.3.tar.gz
  • Upload date:
  • Size: 123.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.0

File hashes

Hashes for CTkMessagebox-1.3.tar.gz
Algorithm Hash digest
SHA256 5844b0cd61bbb184ea9ee5674306ad2f7a3ad4f09c7e21723800dd08a8fcd62f
MD5 c62f0c428d4f38e7093f68bd94f8a2c3
BLAKE2b-256 1c2cb4370552991918a83732184225615beeacfb18fc868a8113a659fec251a5

See more details on using hashes here.

File details

Details for the file CTkMessagebox-1.3-py3-none-any.whl.

File metadata

  • Download URL: CTkMessagebox-1.3-py3-none-any.whl
  • Upload date:
  • Size: 123.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.0

File hashes

Hashes for CTkMessagebox-1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7b2ead38f39ab1aa99b75dadda2b94f3ee1ca95f0fec8d658af45d19f88e91e7
MD5 200069e4d6c6d6dfea1003ecb48b06b4
BLAKE2b-256 4d0505f9afee9bdf3620006354311c933b640972afd7920d87f1d48d6f5821ee

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page