Package org.gnome.gtk

Class Statusbar

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.gtk.Statusbar

All Implemented Interfaces:

Proxy, Accessible, Buildable, ConstraintTarget

@Generated("io.github.jwharm.JavaGI")
@Deprecated
public class Statusbar
extends Widget
implements Accessible, Buildable, ConstraintTarget

Deprecated.

A GtkStatusbar widget is usually placed along the bottom of an application's main Window.

A GtkStatusBar may provide a regular commentary of the application's status (as is usually the case in a web browser, for example), or may be used to simply output a message when the status changes, (when an upload is complete in an FTP client, for example).

Status bars in GTK maintain a stack of messages. The message at the top of the each bar’s stack is the one that will currently be displayed.

Any messages added to a statusbar’s stack must specify a context id that is used to uniquely identify the source of a message. This context id can be generated by getContextId(java.lang.String), given a message and the statusbar that it will be added to. Note that messages are stored in a stack, and when choosing which message to display, the stack structure is adhered to, regardless of the context identifier of a message.

One could say that a statusbar maintains one stack of messages for display purposes, but allows multiple message producers to maintain sub-stacks of the messages they produced (via context ids).

Status bars are created using Statusbar().

Messages are added to the bar’s stack with push(int, java.lang.String).

The message at the top of the stack can be removed using pop(int). A message can be removed from anywhere in the stack if its message id was recorded at the time it was added. This is done using remove(int, int).

CSS node
GtkStatusbar has a single CSS node with name statusbar.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Statusbar.Builder<B extends Statusbar.Builder<B>>	Deprecated. Inner class implementing a builder pattern to construct a GObject with properties.
static interface	Statusbar.TextPoppedCallback	Deprecated.
static interface	Statusbar.TextPushedCallback	Deprecated.

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.Buildable

Buildable.BuildableIface, Buildable.BuildableImpl

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

ConstraintTarget.ConstraintTargetImpl, ConstraintTarget.ConstraintTargetInterface

Constructor Summary

Constructors

Constructor	Description
Statusbar()	Deprecated. This widget will be removed in GTK 5
Statusbar(MemorySegment address)	Deprecated. Create a Statusbar proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected Statusbar	asParent()	Deprecated. Returns this instance as if it were its parent type.
static Statusbar.Builder<? extends Statusbar.Builder>	builder()	Deprecated. A Statusbar.Builder object constructs a Statusbar with the specified properties.
void	emitTextPopped(int contextId, String text)	Deprecated.
void	emitTextPushed(int contextId, String text)	Deprecated.
int	getContextId(String contextDescription)	Deprecated. This widget will be removed in GTK 5
static Type	getType()	Deprecated. Get the GType of the Statusbar class
SignalConnection<Statusbar.TextPoppedCallback>	onTextPopped(Statusbar.TextPoppedCallback handler)	Deprecated. This widget will be removed in GTK 5
SignalConnection<Statusbar.TextPushedCallback>	onTextPushed(Statusbar.TextPushedCallback handler)	Deprecated. This widget will be removed in GTK 5
void	pop(int contextId)	Deprecated. This widget will be removed in GTK 5
int	push(int contextId, String text)	Deprecated. This widget will be removed in GTK 5
void	remove(int contextId, int messageId)	Deprecated. This widget will be removed in GTK 5
void	removeAll(int contextId)	Deprecated. This widget will be removed in GTK 5

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.Buildable

getBuildableId

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

handle

Constructor Details

Statusbar

public Statusbar(MemorySegment address)

Deprecated.

Create a Statusbar proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Statusbar

@Deprecated
public Statusbar()

Deprecated.

This widget will be removed in GTK 5

Creates a new GtkStatusbar ready for messages.

Method Details

getType

public static Type getType()

Deprecated.

Get the GType of the Statusbar class

Returns:

the GType

asParent

protected Statusbar asParent()

Deprecated.

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

getContextId

@Deprecated
public int getContextId(String contextDescription)

Deprecated.

This widget will be removed in GTK 5

Returns a new context identifier, given a description of the actual context.

Note that the description is not shown in the UI.

Parameters:

contextDescription - textual description of what context the new message is being used in

Returns:

an integer id

pop

@Deprecated
public void pop(int contextId)

Deprecated.

This widget will be removed in GTK 5

Removes the first message in the GtkStatusbar’s stack with the given context id.

Note that this may not change the displayed message, if the message at the top of the stack has a different context id.

Parameters:

contextId - a context identifier

push

@Deprecated
public int push(int contextId,
 String text)

Deprecated.

This widget will be removed in GTK 5

Pushes a new message onto a statusbar’s stack.

Parameters:

contextId - the message’s context id, as returned by gtk_statusbar_get_context_id()

text - the message to add to the statusbar

Returns:

a message id that can be used with remove(int, int).

remove

@Deprecated
public void remove(int contextId,
 int messageId)

Deprecated.

This widget will be removed in GTK 5

Forces the removal of a message from a statusbar’s stack. The exact contextId and messageId must be specified.

Parameters:

contextId - a context identifier

messageId - a message identifier, as returned by push(int, java.lang.String)

removeAll

@Deprecated
public void removeAll(int contextId)

Deprecated.

This widget will be removed in GTK 5

Forces the removal of all messages from a statusbar's stack with the exact contextId.

Parameters:

contextId - a context identifier

onTextPopped

@Deprecated
public SignalConnection<Statusbar.TextPoppedCallback> onTextPopped(Statusbar.TextPoppedCallback handler)

Deprecated.

This widget will be removed in GTK 5

Emitted whenever a new message is popped off a statusbar's stack.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• Statusbar.TextPoppedCallback.run(int, java.lang.String)

emitTextPopped

@Deprecated
public void emitTextPopped(int contextId,
 String text)

Deprecated.

Emits the "text-popped" signal. See onTextPopped(org.gnome.gtk.Statusbar.TextPoppedCallback).

onTextPushed

@Deprecated
public SignalConnection<Statusbar.TextPushedCallback> onTextPushed(Statusbar.TextPushedCallback handler)

Deprecated.

This widget will be removed in GTK 5

Emitted whenever a new message gets pushed onto a statusbar's stack.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• Statusbar.TextPushedCallback.run(int, java.lang.String)

emitTextPushed

@Deprecated
public void emitTextPushed(int contextId,
 String text)

Deprecated.

Emits the "text-pushed" signal. See onTextPushed(org.gnome.gtk.Statusbar.TextPushedCallback).

builder

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

Deprecated.

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