Tk_MainWindow(3tk)

Tk_MainWindow(3tk) 💖

okay so bestie, welcome to the Tk_MainWindow(3tk) page from the Tk Library Procedures! this is literally all about querying main window info in Tk, and it's giving very much "I need to know about my windows" energy. no cap. let's get into it. 🫶

---

NAME ✨

Tk_MainWindow, Tk_GetNumMainWindows — functions for querying main window information. yes, that's the whole vibe: querying main window info. periodt. 💅

SYNOPSIS 🎀

#include <tk.h>

Tk_Window
Tk_MainWindow(interp)

Tk_SetMainMenubar(interp, tkwin, menuName)

Tk_SetWindowMenubar(interp, tkwin, oldMenuName, menuName)

int
Tk_GetNumMainWindows()

ARGUMENTS 🌸

• Tcl_Interp *interp (in/out) — Interpreter associated with the application.
• Tk_Window tkwin (in) — Token for main window.
• const char (*menuName) — The name of the new menubar that the toplevel needs to be set to. NULL means that their is no menu now. (yes bestie, "their" — we're keeping it, it's iconic 😭)
• const char (*oldMenuName) — The name of the menubar previously set in this toplevel. NULL means no menu was set previously.

DESCRIPTION 🦋

A main window is a special kind of toplevel window used as the outermost window in an application. literally the main character of your app's window hierarchy. 👑

If interp is associated with a Tk application then Tk_MainWindow returns the application's main window. If there is no Tk application associated with interp then Tk_MainWindow returns NULL and leaves an error message in interpreter interp's result. so if you get NULL, check your interp result, bestie. 🙈

Tk_GetNumMainWindows returns a count of the number of main windows currently open in the current thread. Tk_SetMainMenubar Called when a toplevel widget is brought to front. On the Macintosh, sets up the menubar that goes across the top of the main monitor. On other platforms, nothing is necessary. Tk_SetWindowMenubar associates a menu with a window. The old menu clones for the menubar are thrown away, and a handler is set up to allocate the new ones.

KEYWORDS 💜

application, main window

---

this page brought to you by Tk 7.0, manual page Tk_MainWindow(3tk). mwah 💋 stay slaying, bestie.