ttk::menubutton(n) Tk Themed Widget ttk::menubutton(n)

```

```

# [NAME](#NAME)

ttk::menubutton - Widget that pops down a menu when pressed

# [SYNOPSIS](#SYNOPSIS)

**ttk::menubutton pathName** ?*options*?

```

```

# [DESCRIPTION](#DESCRIPTION)

A **ttk::menubutton** widget displays a textual label and/or image, and displays a menu when pressed.

# [STANDARD OPTIONS](#STANDARD_OPTIONS)

```
-class	-compound	-cursor
-image	-state	-style
-takefocus	-text	-textvariable
-underline	-width
```

See the **ttk\_widget** manual entry for details on the standard options.

# [WIDGET-SPECIFIC OPTIONS](#WIDGET-SPECIFIC_OPTIONS)

```
Command-Line Name:	-direction
Database Name:	direction
Database Class:	Direction
```

Specifies where the menu is to be popped up relative to the menubutton. One of: **above**, **below**, **left**, **right**, or **flush**. The default is **below**. **flush** pops the menu up directly over the menubutton.

```
Command-Line Name:	-menu
Database Name:	menu
Database Class:	Menu
```

Specifies the path name of the menu associated with the menubutton. To be on the safe side, the menu ought to be a direct child of the menubutton.

# [WIDGET COMMAND](#WIDGET_COMMAND)

Menubutton widgets support the standard commands **cget**, **configure**, **identify element**, **instate**, **state** and **style** (see **ttk::widget**).

# [STANDARD STYLES](#STANDARD_STYLES)

**Ttk::menubutton** widgets support the **Toolbutton** style in all standard themes, which is useful for creating widgets for toolbars.

# [STYLING OPTIONS](#STYLING_OPTIONS)

The class name for a **ttk::menubutton** is **TMenubutton**.

Dynamic states: **active**, **disabled**, **readonly**.

**TMenubutton** styling options configurable with **ttk::style** are:

**-arrowsize** *amount*  
**-background** *color*  
**-compound** *compound*  
**-foreground** *color*  
**-font** *font*  
**-padding** *padding*  
**-relief** *relief*  
**-width** *amount*

Some options are only available for specific themes.

See the **ttk::style** manual page for information on how to configure ttk styles.

# [SEE ALSO](#SEE_ALSO)

[ttk::widget(n)](/man/os/tk/ttk::widget.n), [menu(n)](/man/os/tk/menu.n), [menubutton(n)](/man/os/tk/menubutton.n)

# [KEYWORDS](#KEYWORDS)

widget, button, menu

8.5 Tk

---

Document: ttk_menubutton(n) from tk 9.0.4-r2 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.0.4-src.tar.gz