Tk_MainWindow - Man Page
functions for querying main window information
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.
- 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.
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.
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
Referenced By
The man page Tk_GetNumMainWindows(3) is an alias of Tk_MainWindow(3).