Tcl 9.0/Tk9.0 Documentation > Tk C API, version 9.0.0 > MainWin

Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

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

DESCRIPTION

KEYWORDS

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