Package ch.bailu.gtk.adw

Klasse SplitButton

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.adw.SplitButton
Alle implementierten Schnittstellen:
PointerInterface
public class SplitButton extends Widget
A combined button and dropdown widget.

<picture>
<source srcset="split-button-dark.png" media="(prefers-color-scheme: dark)">
<img src="split-button.png" alt="split-button">
</picture>

`AdwSplitButton` is typically used to present a set of actions in a menu,
but allow access to one of them with a single click.

The API is very similar to [class@Gtk.Button] and [class@Gtk.MenuButton], see
their documentation for details.

## CSS nodes

```
splitbutton[.image-button][.text-button]
├── button
│ ╰── <content>
├── separator
╰── menubutton
╰── button.toggle
╰── arrow
```

`AdwSplitButton`'s CSS node is called `splitbutton`. It contains the css
nodes: `button`, `separator`, `menubutton`. See [class@Gtk.MenuButton]
documentation for the `menubutton` contents.

The main CSS node will contain the `.image-button` or `.text-button` style
classes matching the button contents. The nested button nodes will never
contain them.

## Style classes

`AdwSplitButton` can use some of the same style classes as [class@Gtk.Button]:

- [`.suggested-action`](style-classes.html#suggested-action)
- [`.destructive-action`](style-classes.html#destructive-action)
- [`.flat`](style-classes.html#flat)
- [`.raised`](style-classes.html#raised)

Other style classes, like `.pill`, cannot be used.

## Accessibility

`AdwSplitButton` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.

https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.SplitButton.html

  • Felddetails

  • Konstruktordetails

    • SplitButton

      public SplitButton(PointerContainer pointer)

    • SplitButton

      public SplitButton()
      Creates a new `AdwSplitButton`.

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()

    • getCanShrink

      public boolean getCanShrink()
      gets whether the button can be smaller than the natural size of its contents.
      Gibt zurück:
      whether the button can shrink

    • getChild

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

    • getDirection

      public int getDirection()
      Gets the direction in which the popup will be popped up.
      Setzt außer Kraft:
      getDirection in Klasse Widget
      Gibt zurück:
      the direction

    • getDropdownTooltip

      public Str getDropdownTooltip()
      Gets the tooltip of the dropdown button of @self.
      Gibt zurück:
      the dropdown tooltip of @self

    • getIconName

      public Str getIconName()
      Gets the name of the icon used to automatically populate the button.
      Gibt zurück:
      the icon name

    • getLabel

      public Str getLabel()
      Gets the label for @self.
      Gibt zurück:
      the label for @self

    • getMenuModel

      public MenuModel getMenuModel()
      Gets the menu model from which the popup will be created.
      Gibt zurück:
      the menu model

    • getPopover

      public Popover getPopover()
      Gets the popover that will be popped up when the dropdown is clicked.
      Gibt zurück:
      the popover

    • getUseUnderline

      public boolean getUseUnderline()
      Gets whether an underline in the text indicates a mnemonic.
      Gibt zurück:
      whether an underline in the text indicates a mnemonic

    • popdown

      public void popdown()
      Dismisses the menu.

    • popup

      public void popup()
      Pops up the menu.

    • setCanShrink

      public void setCanShrink(boolean can_shrink)
      Sets whether the button can be smaller than the natural size of its contents.

      If set to `TRUE`, the label will ellipsize.

      See [method@Gtk.Button.set_can_shrink] and
      [method@Gtk.MenuButton.set_can_shrink].
      Parameter:
      can_shrink - whether the button can shrink

    • setChild

      public void setChild(@Nullable Widget child)
      Sets the child widget.

      Setting the child widget will set [property@SplitButton:label] and
      [property@SplitButton:icon-name] to `NULL`.
      Parameter:
      child - the new child widget

    • setDirection

      public void setDirection(int direction)
      Sets the direction in which the popup will be popped up.

      The dropdown arrow icon will point at the same direction.

      If the does not fit in the available space in the given direction, GTK will
      try its best to keep it inside the screen and fully visible.

      If you pass `GTK_ARROW_NONE`, it's equivalent to `GTK_ARROW_DOWN`.
      Setzt außer Kraft:
      setDirection in Klasse Widget
      Parameter:
      direction - the direction

    • setDropdownTooltip

      public void setDropdownTooltip(@Nonnull Str tooltip)
      Sets the tooltip of the dropdown button of @self.

      The tooltip can be marked up with the Pango text markup language.
      Parameter:
      tooltip - the dropdown tooltip of @self

    • setDropdownTooltip

      public void setDropdownTooltip(String tooltip)
      Sets the tooltip of the dropdown button of @self.

      The tooltip can be marked up with the Pango text markup language.
      Parameter:
      tooltip - the dropdown tooltip of @self

    • setIconName

      public void setIconName(@Nonnull Str icon_name)
      Sets the name of the icon used to automatically populate the button.

      Setting the icon name will set [property@SplitButton:label] and
      [property@SplitButton:child] to `NULL`.
      Parameter:
      icon_name - the icon name to set

    • setIconName

      public void setIconName(String icon_name)
      Sets the name of the icon used to automatically populate the button.

      Setting the icon name will set [property@SplitButton:label] and
      [property@SplitButton:child] to `NULL`.
      Parameter:
      icon_name - the icon name to set

    • setLabel

      public void setLabel(@Nonnull Str label)
      Sets the label for @self.

      Setting the label will set [property@SplitButton:icon-name] and
      [property@SplitButton:child] to `NULL`.
      Parameter:
      label - the label to set

    • setLabel

      public void setLabel(String label)
      Sets the label for @self.

      Setting the label will set [property@SplitButton:icon-name] and
      [property@SplitButton:child] to `NULL`.
      Parameter:
      label - the label to set

    • setMenuModel

      public void setMenuModel(@Nullable MenuModel menu_model)
      Sets the menu model from which the popup will be created.

      If the menu model is `NULL`, the dropdown is disabled.

      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@SplitButton:popover] is already set, it will be dissociated from
      the button, and the property is set to `NULL`.
      Parameter:
      menu_model - the menu model

    • setPopover

      public void setPopover(@Nullable Popover popover)
      Sets the popover that will be popped up when the dropdown is clicked.

      If the popover is `NULL`, the dropdown is disabled.

      If [property@SplitButton:menu-model] is set, the menu model is dissociated
      from the button, and the property is set to `NULL`.
      Parameter:
      popover - the popover

    • setUseUnderline

      public void setUseUnderline(boolean use_underline)
      Sets whether an underline in the text indicates a mnemonic.

      See [property@SplitButton:label].
      Parameter:
      use_underline - whether an underline in the text indicates a mnemonic

    • onActivate

      public SignalHandler onActivate(SplitButton.OnActivate signal)
      Connect to signal "activate".
      See SplitButton.OnActivate.onActivate() for signal description.
      Field SIGNAL_ON_ACTIVATE 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.

    • onClicked

      public SignalHandler onClicked(SplitButton.OnClicked signal)
      Connect to signal "clicked".
      See SplitButton.OnClicked.onClicked() for signal description.
      Field SIGNAL_ON_CLICKED 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

    • asActionable

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

    • 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

    • 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()