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()

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)