Toplevel
Toplevel creates a secondary window that shares the application's theme and event loop.
Use it for dialogs, tool palettes, inspectors, or any auxiliary window.
Quick start
import bootstack as bs
app = bs.App(title="Main Window")
def open_window():
win = bs.Toplevel(title="Settings", minsize=(400, 300))
bs.Label(win, text="Secondary window").pack(padx=20, pady=20)
bs.Button(app, text="Open Window", command=open_window).pack(pady=20)
app.mainloop()
When to use
Use Toplevel when:
-
you need a secondary window (settings panel, inspector, tool palette)
-
you need a custom dialog beyond what the built-in dialogs provide
Consider a different control when: