Package ch.bailu.gtk.gtk

Klasse Popover

java.lang.Object
ch.bailu.gtk.type.Type
ch.bailu.gtk.type.Pointer
ch.bailu.gtk.gobject.Object
ch.bailu.gtk.type.PropertyHolder
ch.bailu.gtk.gobject.InitiallyUnowned
ch.bailu.gtk.gtk.Widget
ch.bailu.gtk.gtk.Popover
Alle implementierten Schnittstellen:
PointerInterface
Bekannte direkte Unterklassen:
EmojiChooser, PopoverMenu
public class Popover extends Widget
Presents a bubble-like popup.

<picture>
<source srcset="popover-dark.png" media="(prefers-color-scheme: dark)">
<img alt="An example GtkPopover" src="popover.png">
</picture>

It is primarily meant to provide context-dependent information
or options. Popovers are attached to a parent widget. By default,
they point to the whole widget area, although this behavior can be
changed with [method@Gtk.Popover.set_pointing_to].

The position of a popover relative to the widget it is attached to
can also be changed with [method@Gtk.Popover.set_position]

By default, `GtkPopover` performs a grab, in order to ensure input
events get redirected to it while it is shown, and also so the popover
is dismissed in the expected situations (clicks outside the popover,
or the Escape key being pressed). If no such modal behavior is desired
on a popover, [method@Gtk.Popover.set_autohide] may be called on it to
tweak its behavior.

## GtkPopover as menu replacement

`GtkPopover` is often used to replace menus. The best way to do this
is to use the [class@Gtk.PopoverMenu] subclass which supports being
populated from a `GMenuModel` with [ctor@Gtk.PopoverMenu.new_from_model].

```xml
<section>
<attribute name="display-hint">horizontal-buttons</attribute>
<item>
<attribute name="label">Cut</attribute>
<attribute name="action">app.cut</attribute>
<attribute name="verb-icon">edit-cut-symbolic</attribute>
</item>
<item>
<attribute name="label">Copy</attribute>
<attribute name="action">app.copy</attribute>
<attribute name="verb-icon">edit-copy-symbolic</attribute>
</item>
<item>
<attribute name="label">Paste</attribute>
<attribute name="action">app.paste</attribute>
<attribute name="verb-icon">edit-paste-symbolic</attribute>
</item>
</section>
```

# Shortcuts and Gestures

`GtkPopover` supports the following keyboard shortcuts:

- <kbd>Escape</kbd> closes the popover.
- <kbd>Alt</kbd> makes the mnemonics visible.

The following signals have default keybindings:

- [signal@Gtk.Popover::activate-default]

# CSS nodes

```
popover.background[.menu]
├── arrow
╰── contents
╰── <child>
```

`GtkPopover` has a main node with name `popover`, an arrow with name `arrow`,
and another node for the content named `contents`. The `popover` node always
gets the `.background` style class. It also gets the `.menu` style class
if the popover is menu-like, e.g. is a [class@Gtk.PopoverMenu].

Particular uses of `GtkPopover`, such as touch selection popups or
magnifiers in `GtkEntry` or `GtkTextView` get style classes like
`.touch-selection` or `.magnifier` to differentiate from plain popovers.

When styling a popover directly, the `popover` node should usually
not have any background. The visible part of the popover can have
a shadow. To specify it in CSS, set the box-shadow of the `contents` node.

Note that, in order to accomplish appropriate arrow visuals, `GtkPopover`
uses custom drawing for the `arrow` node. This makes it possible for the
arrow to change its shape dynamically, but it also limits the possibilities
of styling it using CSS. In particular, the `arrow` gets drawn over the
`content` node's border and shadow, so they look like one shape, which
means that the border width of the `content` node and the `arrow` node should
be the same. The arrow also does not support any border shape other than
solid, no border-radius, only one border width (border-bottom-width is
used) and no box-shadow.

https://docs.gtk.org/gtk4/class.Popover.html

  • Felddetails

  • Konstruktordetails

    • Popover

      public Popover(PointerContainer pointer)

    • Popover

      public Popover()
      Creates a new `GtkPopover`.

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()

    • getAutohide

      public boolean getAutohide()
      Returns whether the popover is modal.

      See [method@Gtk.Popover.set_autohide] for the
      implications of this.
      Gibt zurück:
      %TRUE if @popover is modal

    • getCascadePopdown

      public boolean getCascadePopdown()
      Returns whether the popover will close after a modal child is closed.
      Gibt zurück:
      %TRUE if @popover will close after a modal child.

    • getChild

      public Widget getChild()
      Gets the child widget of @popover.
      Gibt zurück:
      the child widget of @popover

    • getHasArrow

      public boolean getHasArrow()
      Gets whether this popover is showing an arrow
      pointing at the widget that it is relative to.
      Gibt zurück:
      whether the popover has an arrow

    • getMnemonicsVisible

      public boolean getMnemonicsVisible()
      Gets whether mnemonics are visible.
      Gibt zurück:
      %TRUE if mnemonics are supposed to be visible in this popover

    • getOffset

      public void getOffset(@Nullable Int x_offset, @Nullable Int y_offset)
      Gets the offset previous set with [method@Gtk.Popover.set_offset()].
      Parameter:
      x_offset - a location for the x_offset
      y_offset - a location for the y_offset

    • getPointingTo

      public boolean getPointingTo(@Nonnull Rectangle rect)
      Gets the rectangle that the popover points to.

      If a rectangle to point to has been set, this function will
      return %TRUE and fill in @rect with such rectangle, otherwise
      it will return %FALSE and fill in @rect with the parent
      widget coordinates.
      Parameter:
      rect - location to store the rectangle
      Gibt zurück:
      %TRUE if a rectangle to point to was set.

    • getPosition

      public int getPosition()
      Returns the preferred position of @popover.
      Gibt zurück:
      The preferred position.

    • popdown

      public void popdown()
      Pops @popover down.

      This may have the side-effect of closing a parent popover
      as well. See [property@Gtk.Popover:cascade-popdown].

    • popup

      public void popup()
      Pops @popover up.

    • present

      public void present()
      Allocate a size for the `GtkPopover`.

      This function needs to be called in size-allocate by widgets
      who have a `GtkPopover` as child. When using a layout manager,
      this is happening automatically.

      To make a popover appear on screen, use [method@Gtk.Popover.popup].

    • setAutohide

      public void setAutohide(boolean autohide)
      Sets whether @popover is modal.

      A modal popover will grab the keyboard focus on it when being
      displayed. Focus will wrap around within the popover. Clicking
      outside the popover area or pressing Esc will dismiss the popover.

      Called this function on an already showing popup with a new
      autohide value different from the current one, will cause the
      popup to be hidden.
      Parameter:
      autohide - %TRUE to dismiss the popover on outside clicks

    • setCascadePopdown

      public void setCascadePopdown(boolean cascade_popdown)
      If @cascade_popdown is %TRUE, the popover will be
      closed when a child modal popover is closed.

      If %FALSE, @popover will stay visible.
      Parameter:
      cascade_popdown - %TRUE if the popover should follow a child closing

    • setChild

      public void setChild(@Nullable Widget child)
      Sets the child widget of @popover.
      Parameter:
      child - the child widget

    • setDefaultWidget

      public void setDefaultWidget(@Nullable Widget widget)
      Sets the default widget of a `GtkPopover`.

      The default widget is the widget that’s activated when the user
      presses Enter in a dialog (for example). This function sets or
      unsets the default widget for a `GtkPopover`.
      Parameter:
      widget - a child widget of @popover to set as the default, or %NULL to unset the default widget for the popover

    • setHasArrow

      public void setHasArrow(boolean has_arrow)
      Sets whether this popover should draw an arrow
      pointing at the widget it is relative to.
      Parameter:
      has_arrow - %TRUE to draw an arrow

    • setMnemonicsVisible

      public void setMnemonicsVisible(boolean mnemonics_visible)
      Sets whether mnemonics should be visible.
      Parameter:
      mnemonics_visible - the new value

    • setOffset

      public void setOffset(int x_offset, int y_offset)
      Sets the offset to use when calculating the position
      of the popover.

      These values are used when preparing the [struct@Gdk.PopupLayout]
      for positioning the popover.
      Parameter:
      x_offset - the x offset to adjust the position by
      y_offset - the y offset to adjust the position by

    • setPointingTo

      public void setPointingTo(@Nullable Rectangle rect)
      Sets the rectangle that @popover points to.

      This is in the coordinate space of the @popover parent.
      Parameter:
      rect - rectangle to point to

    • setPosition

      public void setPosition(int position)
      Sets the preferred position for @popover to appear.

      If the @popover is currently visible, it will be immediately
      updated.

      This preference will be respected where possible, although
      on lack of space (eg. if close to the window edges), the
      `GtkPopover` may choose to appear on the opposite side.
      Parameter:
      position - preferred popover position

    • onActivateDefault

      public SignalHandler onActivateDefault(Popover.OnActivateDefault signal)
      Connect to signal "activate-default".
      See Popover.OnActivateDefault.onActivateDefault() for signal description.
      Field SIGNAL_ON_ACTIVATE_DEFAULT contains original signal name and can be used as resource reference.
      Parameter:
      signal - callback function (lambda).
      Gibt zurück:
      SignalHandler. Can be used to disconnect signal and to release callback function.

    • onClosed

      public SignalHandler onClosed(Popover.OnClosed signal)
      Connect to signal "closed".
      See Popover.OnClosed.onClosed() for signal description.
      Field SIGNAL_ON_CLOSED contains original signal name and can be used as resource reference.
      Parameter:
      signal - callback function (lambda).
      Gibt zurück:
      SignalHandler. Can be used to disconnect signal and to release callback function.

    • asAccessible

      public Accessible asAccessible()
      Implements interface Accessible. Call this to get access to interface functions.
      Setzt außer Kraft:
      asAccessible in Klasse Widget
      Gibt zurück:
      Accessible

    • asBuildable

      public Buildable asBuildable()
      Implements interface Buildable. Call this to get access to interface functions.
      Setzt außer Kraft:
      asBuildable in Klasse Widget
      Gibt zurück:
      Buildable

    • asConstraintTarget

      public ConstraintTarget asConstraintTarget()
      Implements interface ConstraintTarget. Call this to get access to interface functions.
      Setzt außer Kraft:
      asConstraintTarget in Klasse Widget
      Gibt zurück:
      ConstraintTarget

    • asNative

      public Native asNative()
      Implements interface Native. Call this to get access to interface functions.
      Gibt zurück:
      Native

    • asShortcutManager

      public ShortcutManager asShortcutManager()
      Implements interface ShortcutManager. Call this to get access to interface functions.
      Gibt zurück:
      ShortcutManager

    • getTypeID

      public static long getTypeID()

    • getParentTypeID

      public static long getParentTypeID()

    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()

    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()

    • getInstanceSize

      public static int getInstanceSize()