Tk_MainWindow, Tk_GetNumMainWindows - functions for querying main window information
Contents
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
Tk 7.0 Tk_MainWindow(3tk)
Name
Tk_MainWindow, Tk_GetNumMainWindows - 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()
