Package org.gnome.adw

Class Banner

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gobject.InitiallyUnowned

org.gnome.gtk.Widget

org.gnome.adw.Banner

All Implemented Interfaces:

Proxy, Accessible, Actionable, Buildable, ConstraintTarget

@Generated("io.github.jwharm.JavaGI")
public final class Banner
extends Widget
implements Accessible, Actionable, Buildable, ConstraintTarget

A bar with contextual information.

Banners are hidden by default, use Banner:revealed to show them.

Banners have a title, set with Banner:title. Titles can be marked up with Pango markup, use Banner:use-markup to enable it.

The title will be shown centered or left-aligned depending on available space.

Banners can optionally have a button with text on it, set through Banner:button-label. The button can be used with a GAction, or with the Banner::button-clicked signal.

CSS nodes
AdwBanner has a main CSS node with the name banner.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Banner.BannerClass
static class	Banner.Builder<B extends Banner.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static interface	Banner.ButtonClickedCallback	Functional interface declaration of the ButtonClickedCallback callback.

Nested classes/interfaces inherited from class org.gnome.gtk.Widget

Widget.DestroyCallback, Widget.DirectionChangedCallback, Widget.HideCallback, Widget.KeynavFailedCallback, Widget.MapCallback, Widget.MnemonicActivateCallback, Widget.MoveFocusCallback, Widget.QueryTooltipCallback, Widget.RealizeCallback, Widget.ShowCallback, Widget.StateFlagsChangedCallback, Widget.UnmapCallback, Widget.UnrealizeCallback, Widget.WidgetClass, Widget.WidgetImpl

Nested classes/interfaces inherited from class org.gnome.gobject.InitiallyUnowned

InitiallyUnowned.InitiallyUnownedClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface org.gnome.gtk.Accessible

Accessible.AccessibleImpl, Accessible.AccessibleInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.Actionable

Actionable.ActionableImpl, Actionable.ActionableInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.Buildable

Buildable.BuildableIface, Buildable.BuildableImpl

Nested classes/interfaces inherited from interface org.gnome.gtk.ConstraintTarget

ConstraintTarget.ConstraintTargetImpl, ConstraintTarget.ConstraintTargetInterface

Constructor Summary

Constructors

Constructor	Description
Banner(MemorySegment address)	Create a Banner proxy instance for the provided memory address.
Banner(String title)	Creates a new AdwBanner.

Method Summary

Modifier and Type	Method	Description
protected Banner	asParent()	Returns this instance as if it were its parent type.
static Banner.Builder<? extends Banner.Builder>	builder()	A Banner.Builder object constructs a Banner with the specified properties.
void	emitButtonClicked()	Emits the "button-clicked" signal.
String	getButtonLabel()	Gets the button label for this Banner.
boolean	getRevealed()	Gets if a banner is revealed
String	getTitle()	Gets the title for this Banner.
static Type	getType()	Get the GType of the Banner class
boolean	getUseMarkup()	Gets whether to use Pango markup for the banner title.
SignalConnection<Banner.ButtonClickedCallback>	onButtonClicked(Banner.ButtonClickedCallback handler)	This signal is emitted after the action button has been clicked.
void	setButtonLabel(@Nullable String label)	Sets the button label for this Banner.
void	setRevealed(boolean revealed)	Sets whether a banner should be revealed
void	setTitle(String title)	Sets the title for this banner.
void	setUseMarkup(boolean useMarkup)	Sets whether to use Pango markup for the banner title.

Methods inherited from class org.gnome.gtk.Widget

actionSetEnabled, activateActionIfExists, activateDefault, activateWidget, addController, addCssClass, addMnemonicLabel, addTickCallback, allocate, childFocus, computeBounds, computeExpand, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, cssChanged, directionChanged, disposeTemplate, dragCheckThreshold, emitDestroy, emitDirectionChanged, emitHide, emitKeynavFailed, emitMap, emitMnemonicActivate, emitMoveFocus, emitQueryTooltip, emitRealize, emitShow, emitStateFlagsChanged, emitUnmap, emitUnrealize, errorBell, focus, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getBaseline, getCanFocus, getCanTarget, getChildVisible, getClipboard, getColor, getCssClasses, getCssName, getCursor, getDefaultDirection, getDirection, getDisplay, getFirstChild, getFocusable, getFocusChild, getFocusOnClick, getFontMap, getFontOptions, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getLastChild, getLayoutManager, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getMemoryLayout, getName, getNative, getNextSibling, getOpacity, getOverflow, getPangoContext, getParent, getPreferredSize, getPrevSibling, getPrimaryClipboard, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSensitive, getSettings, getSize, getSizeRequest, getStateFlags, getStyleContext, getTemplateChild, getTooltipMarkup, getTooltipText, getValign, getVexpand, getVexpandSet, getVisible, getWidth, grabFocus, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initTemplate, insertActionGroup, insertAfter, insertBefore, isAncestor, isDrawable, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, moveFocus, observeChildren, observeControllers, onDestroy, onDirectionChanged, onHide, onKeynavFailed, onMap, onMnemonicActivate, onMoveFocus, onQueryTooltip, onRealize, onShow, onStateFlagsChanged, onUnmap, onUnrealize, pick, pick, queryTooltip, queueAllocate, queueDraw, queueResize, realize, removeController, removeCssClass, removeMnemonicLabel, removeTickCallback, root, setCanFocus, setCanTarget, setChildVisible, setCssClasses, setCursor, setCursorFromName, setDefaultDirection, setDirection, setFocusable, setFocusChild, setFocusOnClick, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLayoutManager, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setOpacity, setOverflow, setParent, setReceivesDefault, setSensitive, setSizeRequest, setStateFlags, setStateFlags, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, shouldLayout, show, sizeAllocate, sizeAllocate, snapshot, snapshotChild, stateFlagsChanged, systemSettingChanged, translateCoordinates, triggerTooltipQuery, unmap, unparent, unrealize, unroot, unsetStateFlags, unsetStateFlags

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, getPrivate, readGClass, writeGClass

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gnome.gtk.Accessible

announce, getAccessibleParent, getAccessibleRole, getAtContext, getBounds, getFirstAccessibleChild, getNextAccessibleSibling, getPlatformState, resetProperty, resetRelation, resetState, setAccessibleParent, updateNextAccessibleSibling, updateProperty, updateRelation, updateState

Methods inherited from interface org.gnome.gtk.Actionable

getActionName, getActionTargetValue, setActionName, setActionTarget, setActionTargetValue, setDetailedActionName

Methods inherited from interface org.gnome.gtk.Buildable

getBuildableId

Methods inherited from interface io.github.jwharm.javagi.base.Proxy

handle

Constructor Details

Banner

public Banner(MemorySegment address)

Create a Banner proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Banner

public Banner(String title)

Creates a new AdwBanner.

Parameters:

title - the banner title

Method Details

getType

public static Type getType()

Get the GType of the Banner class

Returns:

the GType

asParent

protected Banner asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class Widget

getButtonLabel

public String getButtonLabel()

Gets the button label for this Banner.

Returns:

the button label for this Banner

getRevealed

public boolean getRevealed()

Gets if a banner is revealed

Returns:

Whether a banner is revealed

getTitle

public String getTitle()

Gets the title for this Banner.

Returns:

the title for this Banner

getUseMarkup

public boolean getUseMarkup()

Gets whether to use Pango markup for the banner title.

Returns:

whether to use markup

setButtonLabel

public void setButtonLabel(@Nullable
 @Nullable String label)

Sets the button label for this Banner.

If set to "" or NULL, the button won't be shown.

The button can be used with a GAction, or with the Banner::button-clicked signal.

Parameters:

label - the label

setRevealed

public void setRevealed(boolean revealed)

Sets whether a banner should be revealed

Parameters:

revealed - whether a banner should be revealed

setTitle

public void setTitle(String title)

Sets the title for this banner.

See also: Banner:use-markup.

Parameters:

title - the title

setUseMarkup

public void setUseMarkup(boolean useMarkup)

Sets whether to use Pango markup for the banner title.

See also Pango.parseMarkup(java.lang.String, int, int, io.github.jwharm.javagi.base.Out<org.gnome.pango.AttrList>, io.github.jwharm.javagi.base.Out<java.lang.String>, io.github.jwharm.javagi.base.Out<java.lang.Integer>).

Parameters:

useMarkup - whether to use markup

onButtonClicked

public SignalConnection<Banner.ButtonClickedCallback> onButtonClicked(Banner.ButtonClickedCallback handler)

This signal is emitted after the action button has been clicked.

It can be used as an alternative to setting an action.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• Banner.ButtonClickedCallback.run()

emitButtonClicked

public void emitButtonClicked()

Emits the "button-clicked" signal. See onButtonClicked(org.gnome.adw.Banner.ButtonClickedCallback).

builder

public static Banner.Builder<? extends Banner.Builder> builder()

A Banner.Builder object constructs a Banner with the specified properties. Use the various set...() methods to set properties, and finish construction with Banner.Builder.build().