---
name: "ttk_menubutton"
section: "3tk"
platform: "linux"
package: "tk8.6-doc"
version: "8.6.16-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ttk_menubutton"
---

# ttk\_menubutton(3tk)

Widget that pops down a menu when pressed

```

```

## NAME

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

## SYNOPSIS

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

```

```

## DESCRIPTION

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

## STANDARD OPTIONS

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

See the  manual entry for details on the standard 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

Menubutton widgets support the standard **cget**, **configure**, **identify**, **instate**, and **state** methods.  No other widget methods are used.

## STANDARD STYLES

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

## 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

[ttk::widget(3tk)](/ttk::widget/3tk.md), [menu(3tk)](/menu/3tk.md), [menubutton(3tk)](/menubutton/3tk.md)

## KEYWORDS

widget, button, menu