Tk\_MainWindow(3) Tk Library Procedures Tk\_MainWindow(3)

```

```

# [NAME](#NAME)

Tk\_MainWindow, Tk\_GetNumMainWindows - functions for querying main window information

# [SYNOPSIS](#SYNOPSIS)

```
#include <tk.h>

Tk_Window
Tk_MainWindow(interp)

Tk_SetMainMenubar(interp, tkwin, menuName)

Tk_SetWindowMenubar(interp, tkwin, oldMenuName, menuName)

int
Tk_GetNumMainWindows()
```

# [ARGUMENTS](#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](#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](#KEYWORDS)

application, main window

7.0 Tk

---

Document: Tk_GetNumMainWindows(3) from tk 9.1.0-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.1.0-src.tar.gz