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 und hover_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 einem Frame 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 auf True 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()