BetterTkinter Documentation
BetterTkinter
👋 Welcome to the Documentation for BetterTkinter! 👋
Overview
BetterTkinter is a Python library designed to simplify the development of GUI applications using Tkinter. It provides additional components and utilities to streamline UI creation and enhance the default Tkinter toolkit.
Getting Started
To get started with BetterTkinter, you can install it via pip:
pip install bettertkinter
Examples
You can download all examples in the BetterTkinterDocs repository on GitHub. Check out our other documentation on BTkButton or BTkFrame.
BTk
Base documentation from https://docs.python.org/3/library/tkinter.html
Theme and more stuff is Coming soon!
BTkButton
Beschreibung: btk.button ist eine benutzerfreundliche und anpassbare Schaltfläche für die GUI-Entwicklung mit BetterTkinter. Sie bietet einfache Anpassungen des Aussehens und Verhaltens der Schaltfläche, einschließlich abgerundeter Ecken und Hover-Effekten.
Verwendung
import bettertkinter as btk
# Erstellen eines Buttons
button = btk.button(parent, text="Klicken Sie hier", command=my_function)
Argumente:
- parent (tk.Widget): Der Eltern-Widget (normalerweise ein Fenster oder Frame), in dem der Button angezeigt wird.
- text (str): Der Text, der auf dem Button angezeigt wird. Standardwert: ""
- bg_color (str): Die Hintergrundfarbe des Buttons. Standardwert: "#0078D7" (Blau).
- fg_color (str): Die Farbe des Textes auf dem Button. Standardwert: "white" (Weiß).
- hover_color (str): Die Farbe des Buttons, wenn der Mauszeiger darüber schwebt. Standardwert: "#005A9E" (Dunkleres Blau).
- rounded_radius (int): Der Radius der abgerundeten Ecken des Buttons. Standardwert: 20.
- width (int): Die Breite des Buttons in Pixel. Standardwert: 100.
- height (int): Die Höhe des Buttons in Pixel. Standardwert: 40.
- command (function): Eine Funktion, die ausgeführt wird, wenn der Button geklickt wird.
Beispiel:
import tkinter as tk
import bettertkinter as btk
def on_button_click():
print("Button wurde geklickt!")
# Hauptfenster erstellen
root = tk.Tk()
root.title("BetterTkinter Beispiel")
# Button hinzufügen
button = btk.BTkButton(
root,
text="Klicken Sie hier",
bg_color="#4CAF50",
fg_color="white",
hover_color="#45a049",
rounded_radius=25,
width=150,
height=50,
command=on_button_click
)
# Button im Fenster platzieren
button.pack(pady=20)
# Hauptloop starten
root.mainloop()
Beschreibung der Funktionen:
- Text und Stil: Der Button kann durch die Parameter
text
,bg_color
,fg_color
undhover_color
individuell angepasst werden. - Abgerundete Ecken: Mit der Option
rounded_radius
können abgerundete Ecken für den Button festgelegt werden. - Hover-Effekt: Der Button ändert seine Farbe beim Überfahren mit der Maus, basierend auf der
hover_color
.
Tipps:
- Stellen Sie sicher, dass der
parent
-Parameter korrekt gesetzt ist, wenn der Button in einemFrame
oder einem anderen Container-Widget angezeigt wird. - Mit der
command
-Option können Sie jede gewünschte Funktion ausführen, wenn der Button angeklickt wird.
BTkSlider
Coming soon!
BTkSwitch
Coming soon!
BTkFrame
Beschreibung: BTkFrame ist eine benutzerdefinierte Klasse, die von tk.Frame
erbt und es ermöglicht, Frames mit erweiterten Anpassungsoptionen zu erstellen. Sie bietet die Möglichkeit, abgerundete Ecken, Farben, Rahmen und vieles mehr zu konfigurieren.
Verwendung
import tkinter as tk
import bettertkinter as btk
# Erstellen eines BTkFrame
frame = btk.BTkFrame(parent, radius=25, width=200, height=150, color="#4CAF50",
border=True, border_color="#FF4500", border_thick=5, border_bg_color="#FFFFFF")
Argumente:
- parent (tk.Widget): Der Eltern-Widget (normalerweise ein Fenster oder ein anderes Frame), in dem das Frame angezeigt wird.
- radius (int): Der Radius der abgerundeten Ecken des Frames. Standardwert: 25.
- width (int): Die Breite des Frames in Pixel. Standardwert: 100.
- height (int): Die Höhe des Frames in Pixel. Standardwert: 100.
- color (str): Die Hintergrundfarbe des Frames, entweder als Hex-Farbcode oder als benannter Farbstring. Standardwert: "#005A9E".
- border (bool): Bestimmt, ob der Frame einen Rand haben soll. Standardwert:
False
. - border_color (str): Die Farbe des Rahmens, wenn
border
aufTrue
gesetzt ist. Standardwert: "#FF4500". - border_thick (int): Die Dicke des Rahmens. Standardwert: 0 (kein Rahmen).
- border_bg_color (str): Die Hintergrundfarbe des Rahmens. Standardwert: "#000000".
Beispiel:
import tkinter as tk
import bettertkinter as btk
def create_frame():
root = tk.Tk()
root.title("BetterTkinter BTkFrame")
# Erstellen eines Frames
frame = btk.BTkFrame(root, radius=15, width=300, height=200, color="#4CAF50",
border=True, border_color="#FF4500", border_thick=5, border_bg_color="#FFFFFF")
frame.pack(padx=10, pady=10)
root.mainloop()