MenuButton


Object Hierarchy:

Object hierarchy for MenuButton

Description:

[ CCode ( type_id = "gtk_menu_button_get_type ()" ) ]
public class MenuButton : Widget, Accessible, Buildable, ConstraintTarget

The `GtkMenuButton` widget is used to display a popup when clicked.

![An example GtkMenuButton](menu-button.png)

This popup can be provided either as a `GtkPopover` or as an abstract `GMenuModel`.

The `GtkMenuButton` widget can show either an icon (set with the [property@Gtk.MenuButton:icon-name] property) or a label (set with the [ property@Gtk.MenuButton:label] property). If neither is explicitly set, a [class@Gtk.Image] is automatically created, using an arrow image oriented according to [property@Gtk.MenuButton:direction] or the generic “open-menu-symbolic” icon if the direction is not set.

The positioning of the popup is determined by the [property@Gtk.MenuButton:direction] property of the menu button.

For menus, the [property@Gtk.Widget:halign] and [property@Gtk.Widget:valign] properties of the menu are also taken into account. For example, when the direction is gtk_arrow_down and the horizontal alignment is gtk_align_start, the menu will be positioned below the button, with the starting edge (depending on the text direction) of the menu aligned with the starting edge of the button. If there is not enough space below the button, the menu is popped up above the button instead. If the alignment would move part of the menu offscreen, it is “pushed in”.

| | start | center | end | | - | --- | --- | --- | | **down** | ![](down-start.png) | ![](down-center.png) | ![](down-end.png) | | **up** | ![] (up-start.png) | ![](up-center.png) | ![](up-end.png) | | **left** | ![](left-start.png) | ![](left-center.png) | ![](left-end.png) | | **right** | ![](right-start.png) | ![](right-center.png) | ![](right-end.png) |

CSS nodes

``` menubutton ╰── button.toggle ╰── <content> ╰── [arrow] ```

`GtkMenuButton` has a single CSS node with name `menubutton` which contains a `button` node with a `.toggle` style class.

Inside the toggle button content, there is an `arrow` node for the indicator, which will carry one of the `.none`, `.up`, `.down`, `.left` or `.right` style classes to indicate the direction that the menu will appear in. The CSS is expected to provide a suitable image for each of these cases using the `-gtk-icon-source` property.

Optionally, the `menubutton` node can carry the `.circular` style class to request a round appearance.

Accessibility

`GtkMenuButton` uses the BUTTON role.


Namespace: Gtk
Package: gtk4

Content:

Properties:

Creation methods:

Methods:

Inherited Members:

All known members inherited from class Gtk.Widget