dbusmenu-gtk3 0.1.0

<!-- file * -->
<!-- struct Client -->
A subclass of [`dbusmenu_glib::Client`][crate::dbusmenu_glib::Client] to add functionality with regarding
building GTK items out of the abstract tree.

# Implements

[`ClientExt`][trait@crate::prelude::ClientExt], [`trait@dbusmenu_glib::prelude::ClientExt`]
<!-- struct Menu -->
A [`gtk::Menu`][crate::gtk::Menu] that is built using an abstract tree built from
a [`Client`][crate::Client].

## Properties


#### `dbus-name`
 Readable | Writeable | Construct Only


#### `dbus-object`
 Readable | Writeable | Construct Only
<details><summary><h4>Menu</h4></summary>


#### `accel-group`
 The accel group holding accelerators for the menu.

Readable | Writeable


#### `accel-path`
 An accel path used to conveniently construct accel paths of child items.

Readable | Writeable


#### `active`
 The index of the currently selected menu item, or -1 if no
menu item is selected.

Readable | Writeable


#### `anchor-hints`
 Positioning hints for aligning the menu relative to a rectangle.

These hints determine how the menu should be positioned in the case that
the menu would fall off-screen if placed in its ideal position.

![](popup-flip.png)

For example, `GDK_ANCHOR_FLIP_Y` will replace `GDK_GRAVITY_NORTH_WEST` with
`GDK_GRAVITY_SOUTH_WEST` and vice versa if the menu extends beyond the
bottom edge of the monitor.

See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
gtk_menu_popup_at_pointer (), [`rect-anchor-dx`][struct@crate::gtk::Menu#rect-anchor-dx],
[`rect-anchor-dy`][struct@crate::gtk::Menu#rect-anchor-dy], [`menu-type-hint`][struct@crate::gtk::Menu#menu-type-hint], and [`popped-up`][struct@crate::gtk::Menu#popped-up].

Readable | Writeable | Construct


#### `attach-widget`
 The widget the menu is attached to. Setting this property attaches
the menu without a `GtkMenuDetachFunc`. If you need to use a detacher,
use [`MenuExtManual::attach_to_widget()`][crate::gtk::prelude::MenuExtManual::attach_to_widget()] directly.

Readable | Writeable


#### `menu-type-hint`
 The `GdkWindowTypeHint` to use for the menu's `GdkWindow`.

See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::gtk::Menu#anchor-hints],
[`rect-anchor-dx`][struct@crate::gtk::Menu#rect-anchor-dx], [`rect-anchor-dy`][struct@crate::gtk::Menu#rect-anchor-dy], and [`popped-up`][struct@crate::gtk::Menu#popped-up].

Readable | Writeable | Construct


#### `monitor`
 The monitor the menu will be popped up on.

Readable | Writeable


#### `rect-anchor-dx`
 Horizontal offset to apply to the menu, i.e. the rectangle or widget
anchor.

See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::gtk::Menu#anchor-hints],
[`rect-anchor-dy`][struct@crate::gtk::Menu#rect-anchor-dy], [`menu-type-hint`][struct@crate::gtk::Menu#menu-type-hint], and [`popped-up`][struct@crate::gtk::Menu#popped-up].

Readable | Writeable | Construct


#### `rect-anchor-dy`
 Vertical offset to apply to the menu, i.e. the rectangle or widget anchor.

See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::gtk::Menu#anchor-hints],
[`rect-anchor-dx`][struct@crate::gtk::Menu#rect-anchor-dx], [`menu-type-hint`][struct@crate::gtk::Menu#menu-type-hint], and [`popped-up`][struct@crate::gtk::Menu#popped-up].

Readable | Writeable | Construct


#### `reserve-toggle-size`
 A boolean that indicates whether the menu reserves space for
toggles and icons, regardless of their actual presence.

This property should only be changed from its default value
for special-purposes such as tabular menus. Regular menus that
are connected to a menu bar or context menus should reserve
toggle space for consistency.

Readable | Writeable


#### `tearoff-state`
 A boolean that indicates whether the menu is torn-off.

Readable | Writeable


#### `tearoff-title`
 A title that may be displayed by the window manager when this
menu is torn-off.

Readable | Writeable
</details>
<details><summary><h4>MenuShell</h4></summary>


#### `take-focus`
 A boolean that determines whether the menu and its submenus grab the
keyboard focus. See [`MenuShellExtManual::set_take_focus()`][crate::gtk::prelude::MenuShellExtManual::set_take_focus()] and
[`MenuShellExtManual::takes_focus()`][crate::gtk::prelude::MenuShellExtManual::takes_focus()].

Readable | Writeable
</details>
<details><summary><h4>Container</h4></summary>


#### `border-width`
 Readable | Writeable


#### `child`
 Writeable


#### `resize-mode`
 Readable | Writeable
</details>
<details><summary><h4>Widget</h4></summary>


#### `app-paintable`
 Readable | Writeable


#### `can-default`
 Readable | Writeable


#### `can-focus`
 Readable | Writeable


#### `composite-child`
 Readable


#### `double-buffered`
 Whether the widget is double buffered.

Readable | Writeable


#### `events`
 Readable | Writeable


#### `expand`
 Whether to expand in both directions. Setting this sets both [`hexpand`][struct@crate::gtk::Widget#hexpand] and [`vexpand`][struct@crate::gtk::Widget#vexpand]

Readable | Writeable


#### `focus-on-click`
 Whether the widget should grab focus when it is clicked with the mouse.

This property is only relevant for widgets that can take focus.

Before 3.20, several widgets (GtkButton, GtkFileChooserButton,
GtkComboBox) implemented this property individually.

Readable | Writeable


#### `halign`
 How to distribute horizontal space if widget gets extra space, see `GtkAlign`

Readable | Writeable


#### `has-default`
 Readable | Writeable


#### `has-focus`
 Readable | Writeable


#### `has-tooltip`
 Enables or disables the emission of [`query-tooltip`][struct@crate::gtk::Widget#query-tooltip] on `widget`.
A value of [`true`] indicates that `widget` can have a tooltip, in this case
the widget will be queried using [`query-tooltip`][struct@crate::gtk::Widget#query-tooltip] to determine
whether it will provide a tooltip or not.

Note that setting this property to [`true`] for the first time will change
the event masks of the GdkWindows of this widget to include leave-notify
and motion-notify events. This cannot and will not be undone when the
property is set to [`false`] again.

Readable | Writeable


#### `height-request`
 Readable | Writeable


#### `hexpand`
 Whether to expand horizontally. See [`WidgetExtManual::set_hexpand()`][crate::gtk::prelude::WidgetExtManual::set_hexpand()].

Readable | Writeable


#### `hexpand-set`
 Whether to use the [`hexpand`][struct@crate::gtk::Widget#hexpand] property. See [`WidgetExtManual::is_hexpand_set()`][crate::gtk::prelude::WidgetExtManual::is_hexpand_set()].

Readable | Writeable


#### `is-focus`
 Readable | Writeable


#### `margin`
 Sets all four sides' margin at once. If read, returns max
margin on any side.

Readable | Writeable


#### `margin-bottom`
 Margin on bottom side of widget.

This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
[`WidgetExtManual::set_size_request()`][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable


#### `margin-end`
 Margin on end of widget, horizontally. This property supports
left-to-right and right-to-left text directions.

This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
[`WidgetExtManual::set_size_request()`][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable


#### `margin-left`
 Margin on left side of widget.

This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
[`WidgetExtManual::set_size_request()`][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable


#### `margin-right`
 Margin on right side of widget.

This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
[`WidgetExtManual::set_size_request()`][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable


#### `margin-start`
 Margin on start of widget, horizontally. This property supports
left-to-right and right-to-left text directions.

This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
[`WidgetExtManual::set_size_request()`][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable


#### `margin-top`
 Margin on top side of widget.

This property adds margin outside of the widget's normal size
request, the margin will be added in addition to the size from
[`WidgetExtManual::set_size_request()`][crate::gtk::prelude::WidgetExtManual::set_size_request()] for example.

Readable | Writeable


#### `name`
 Readable | Writeable


#### `no-show-all`
 Readable | Writeable


#### `opacity`
 The requested opacity of the widget. See [`WidgetExtManual::set_opacity()`][crate::gtk::prelude::WidgetExtManual::set_opacity()] for
more details about window opacity.

Before 3.8 this was only available in GtkWindow

Readable | Writeable


#### `parent`
 Readable | Writeable


#### `receives-default`
 Readable | Writeable


#### `scale-factor`
 The scale factor of the widget. See [`WidgetExtManual::scale_factor()`][crate::gtk::prelude::WidgetExtManual::scale_factor()] for
more details about widget scaling.

Readable


#### `sensitive`
 Readable | Writeable


#### `style`
 The style of the widget, which contains information about how it will look (colors, etc).

Readable | Writeable


#### `tooltip-markup`
 Sets the text of tooltip to be the given string, which is marked up
with the [Pango text markup language][PangoMarkupFormat].
Also see `gtk_tooltip_set_markup()`.

This is a convenience property which will take care of getting the
tooltip shown if the given string is not [`None`]: [`has-tooltip`][struct@crate::gtk::Widget#has-tooltip]
will automatically be set to [`true`] and there will be taken care of
[`query-tooltip`][struct@crate::gtk::Widget#query-tooltip] in the default signal handler.

Note that if both [`tooltip-text`][struct@crate::gtk::Widget#tooltip-text] and [`tooltip-markup`][struct@crate::gtk::Widget#tooltip-markup]
are set, the last one wins.

Readable | Writeable


#### `tooltip-text`
 Sets the text of tooltip to be the given string.

Also see `gtk_tooltip_set_text()`.

This is a convenience property which will take care of getting the
tooltip shown if the given string is not [`None`]: [`has-tooltip`][struct@crate::gtk::Widget#has-tooltip]
will automatically be set to [`true`] and there will be taken care of
[`query-tooltip`][struct@crate::gtk::Widget#query-tooltip] in the default signal handler.

Note that if both [`tooltip-text`][struct@crate::gtk::Widget#tooltip-text] and [`tooltip-markup`][struct@crate::gtk::Widget#tooltip-markup]
are set, the last one wins.

Readable | Writeable


#### `valign`
 How to distribute vertical space if widget gets extra space, see `GtkAlign`

Readable | Writeable


#### `vexpand`
 Whether to expand vertically. See [`WidgetExtManual::set_vexpand()`][crate::gtk::prelude::WidgetExtManual::set_vexpand()].

Readable | Writeable


#### `vexpand-set`
 Whether to use the [`vexpand`][struct@crate::gtk::Widget#vexpand] property. See [`WidgetExtManual::is_vexpand_set()`][crate::gtk::prelude::WidgetExtManual::is_vexpand_set()].

Readable | Writeable


#### `visible`
 Readable | Writeable


#### `width-request`
 Readable | Writeable


#### `window`
 The widget's window if it is realized, [`None`] otherwise.

Readable
</details>

# Implements

[`MenuExt`][trait@crate::prelude::MenuExt], [`trait@gtk::prelude::MenuExt`], [`trait@gtk::prelude::MenuShellExt`], [`trait@gtk::prelude::ContainerExt`], [`trait@gtk::prelude::WidgetExt`], [`trait@glib::InitiallyUnownedExt`], [`trait@atk::prelude::ImplementorIfaceExt`], [`trait@gtk::prelude::BuildableExt`]