Basics
Guides
API Reference
Basics
Guides
API Reference
[16:7] extends: object
A single child container with a popover. You should use GtkPopoverBin
whenever you need to present a [class@Gtk.Popover] to the user. ## Actions
GtkPopoverBin defines the menu.popup action, which can be activated to
present the popover to the user. ## CSS nodes GtkPopoverBin has a single
CSS node with the name popoverbin.
PopoverBin ()
Creates a new popover bin widget.
toNativeHandle (Source)
Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from
fn.call(...), another generated wrapper exposinghandle(), or null. Returns null when the argument carries no pointer.
Source is the raw handle, raw buffer, wrapper, or null.A raw pointer carrier or null when no pointer is present.getLib ()
Returns the opened native library for this generated wrapper.
The opened native library.handle ()
Returns the wrapped NativeHandle.
The wrapped NativeHandle.isNull ()
Returns true when the wrapped handle is null.
A bool.describe ()
Returns a small string for debugging generated wrappers.
A string.asWidget ()
Wraps this handle as
Widget.
A Widget object.asAccessible ()
Wraps this handle as
Accessible.
A Accessible object.asBuildable ()
Wraps this handle as
Buildable.
A Buildable object.asConstraintTarget ()
Wraps this handle as
ConstraintTarget.
A ConstraintTarget object.getProperty (string Name)
Reads one generated property by name.
setProperty (string Name, Value)
Writes one generated property by name.
setChild (object Value)
The child widget of the popover bin.
Value is the new property value.None.setHandleinput (bool Value)
Whether the popover bin will handle input to trigger the popup.
Value is the new property value.None.setMenumodel (object Value)
The
GMenuModelfrom which the popup will be created. See [method@Gtk.PopoverBin.set_menu_model] for the interaction with the [property@Gtk.PopoverBin:popover] property.
Value is the new property value.None.setPopover (object Value)
The
GtkPopoverthat will be popped up when calling [method@Gtk.PopoverBin.popup].
Value is the new property value.None.get_child ()
Retrieves the child widget of the popover bin.
get_handle_input ()
Generated wrapper for GIR method
get_handle_input. Native symbol:gtk_popover_bin_get_handle_input.
get_menu_model ()
Retrieves the menu model set using [method@Gtk.PopoverBin.set_menu_model].
get_popover ()
Retrieves the
GtkPopoverset using [method@Gtk.PopoverBin.set_popover].
popdown ()
Hides the popover from the user. See: [method@Gtk.PopoverBin.popup]
None.popup ()
Presents the popover to the user. Use [method@Gtk.PopoverBin.set_popover] or [method@Gtk.PopoverBin.set_menu_model] to define the popover. See: [method@Gtk.PopoverBin.popdown]
None.set_child (object child)
Sets the child of the popover bin.
child is the child of the popover bin.None.set_handle_input (bool handle_input)
Enables or disables input handling. If enabled, the popover bin will pop up the popover on right-click or long press, as expected for a context menu.
handle_input is whether to handle input.None.set_menu_model (object model)
Sets the menu model used to create the popover that will be presented when calling [method@Gtk.PopoverBin.popup]. If @model is
NULL, the popover will be unset. A [class@Gtk.Popover] will be created from the menu model with [ctor@Gtk.PopoverMenu.new_from_model]. Actions will be connected as documented for this function. If [property@Gtk.PopoverBin:popover] is already set, it will be dissociated from the popover bin, and the property is set toNULL. See: [method@Gtk.PopoverBin.set_popover]
model is a menu model.None.set_popover (object popover)
Sets the
GtkPopoverthat will be presented when calling [method@Gtk.PopoverBin.popup]. If @popover isNULL, the popover will be unset. If [property@Gtk.PopoverBin:menu-model] is set before calling this function, then the menu model property will be unset. See: [method@Gtk.PopoverBin.set_menu_model]
popover is a GtkPopover.None.[309:14] static extends: object
Generated metadata helpers for PopoverBin class surfaces.
properties ()
Returns property metadata for
PopoverBin.
A list.
Aussom
Write once. Embed everywhere.
Copyright 2026 Austin Lehman. All rights reserved.