Package org.gnome.gtk

Class AppChooserButton

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gobject.InitiallyUnowned

org.gnome.gtk.Widget

org.gnome.gtk.AppChooserButton

All Implemented Interfaces:

Accessible, AppChooser, Buildable, ConstraintTarget, Proxy

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

Deprecated.

The application selection widgets should be implemented according to the design of each platform and/or application requiring them.

The GtkAppChooserButton lets the user select an application.

Initially, a GtkAppChooserButton selects the first application in its list, which will either be the most-recently used application or, if Gtk.AppChooserButton:show-default-item is true, the default application.

The list of applications shown in a GtkAppChooserButton includes the recommended applications for the given content type. When Gtk.AppChooserButton:show-default-item is set, the default application is also included. To let the user chooser other applications, you can set the Gtk.AppChooserButton:show-dialog-item property, which allows to open a full AppChooserDialog.

It is possible to add custom items to the list, using appendCustomItem(java.lang.String, java.lang.String, org.gnome.gio.Icon). These items cause the Gtk.AppChooserButton::custom-item-activated signal to be emitted when they are selected.

To track changes in the selected application, use the Gtk.AppChooserButton::changed signal.

CSS nodes
GtkAppChooserButton has a single CSS node with the name “appchooserbutton”.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AppChooserButton.ActivateCallback	Deprecated. Functional interface declaration of the ActivateCallback callback.
static class	AppChooserButton.Builder<B extends AppChooserButton.Builder<B>>	Deprecated. Inner class implementing a builder pattern to construct a GObject with properties.
static interface	AppChooserButton.ChangedCallback	Deprecated. Functional interface declaration of the ChangedCallback callback.
static interface	AppChooserButton.CustomItemActivatedCallback	Deprecated. Functional interface declaration of the CustomItemActivatedCallback 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.Widget$Impl, Widget.WidgetClass

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.Accessible$Impl, Accessible.AccessibleInterface

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

AppChooser.AppChooser$Impl

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

Buildable.Buildable$Impl, Buildable.BuildableIface

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

ConstraintTarget.ConstraintTarget$Impl, ConstraintTarget.ConstraintTargetInterface

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
void	appendCustomItem(String name, String label, Icon icon)	Deprecated. This widget will be removed in GTK 5
void	appendSeparator()	Deprecated. This widget will be removed in GTK 5
protected AppChooserButton	asParent()	Deprecated. Returns this instance as if it were its parent type.
static AppChooserButton.Builder<? extends AppChooserButton.Builder>	builder()	Deprecated. A AppChooserButton.Builder object constructs a AppChooserButton with the specified properties.
void	emitActivate()	Deprecated. Emits the "activate" signal.
void	emitChanged()	Deprecated. Emits the "changed" signal.
void	emitCustomItemActivated(@Nullable String detail, String itemName)	Deprecated. Emits the "custom-item-activated" signal.
@Nullable String	getHeading()	Deprecated. This widget will be removed in GTK 5
boolean	getModal()	Deprecated. This widget will be removed in GTK 5
boolean	getShowDefaultItem()	Deprecated. This widget will be removed in GTK 5
boolean	getShowDialogItem()	Deprecated. This widget will be removed in GTK 5
static @Nullable Type	getType()	Deprecated. Get the GType of the AppChooserButton class
SignalConnection<AppChooserButton.ActivateCallback>	onActivate(AppChooserButton.ActivateCallback handler)	Deprecated. Emitted to when the button is activated.
SignalConnection<AppChooserButton.ChangedCallback>	onChanged(AppChooserButton.ChangedCallback handler)	Deprecated. Emitted when the active application changes.
SignalConnection<AppChooserButton.CustomItemActivatedCallback>	onCustomItemActivated(@Nullable String detail, AppChooserButton.CustomItemActivatedCallback handler)	Deprecated. Emitted when a custom item is activated.
void	setActiveCustomItem(String name)	Deprecated. This widget will be removed in GTK 5
void	setHeading(String heading)	Deprecated. This widget will be removed in GTK 5
void	setModal(boolean modal)	Deprecated. This widget will be removed in GTK 5
void	setShowDefaultItem(boolean setting)	Deprecated. This widget will be removed in GTK 5
void	setShowDialogItem(boolean setting)	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, getLimitEvents, 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, setLimitEvents, 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, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.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, updatePlatformState, updateProperty, updateRelation, updateState

Methods inherited from interface org.gnome.gtk.AppChooser

getAppInfo, getContentType, refresh

Methods inherited from interface org.gnome.gtk.Buildable

getBuildableId

Methods inherited from interface org.javagi.base.Proxy

handle

Constructor Details

AppChooserButton

public AppChooserButton(MemorySegment address)

Deprecated.

Create a AppChooserButton proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

AppChooserButton

@Deprecated
public AppChooserButton(String contentType)

Deprecated.

This widget will be removed in GTK 5

Creates a new GtkAppChooserButton for applications that can handle content of the given type.

Parameters:

contentType - the content type to show applications for

AppChooserButton

public AppChooserButton()

Deprecated.

Creates a new AppChooserButton.

Method Details

getType

public static @Nullable Type getType()

Deprecated.

Get the GType of the AppChooserButton class

Returns:

the GType

asParent

protected AppChooserButton 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

appendCustomItem

@Deprecated
public void appendCustomItem(String name,
 String label,
 Icon icon)

Deprecated.

This widget will be removed in GTK 5

Appends a custom item to the list of applications that is shown in the popup.

The item name must be unique per-widget. Clients can use the provided name as a detail for the Gtk.AppChooserButton::custom-item-activated signal, to add a callback for the activation of a particular custom item in the list.

See also appendSeparator().

Parameters:

name - the name of the custom item

label - the label for the custom item

icon - the icon for the custom item

appendSeparator

@Deprecated
public void appendSeparator()

Deprecated.

This widget will be removed in GTK 5

Appends a separator to the list of applications that is shown in the popup.

getHeading

@Deprecated
public @Nullable String getHeading()

Deprecated.

This widget will be removed in GTK 5

Returns the text to display at the top of the dialog.

Returns:

the text to display at the top of the dialog, or null, in which case a default text is displayed

getModal

@Deprecated
public boolean getModal()

Deprecated.

This widget will be removed in GTK 5

Gets whether the dialog is modal.

Returns:

true if the dialog is modal

getShowDefaultItem

@Deprecated
public boolean getShowDefaultItem()

Deprecated.

This widget will be removed in GTK 5

Returns whether the dropdown menu should show the default application at the top.

Returns:

the value of Gtk.AppChooserButton:show-default-item

getShowDialogItem

@Deprecated
public boolean getShowDialogItem()

Deprecated.

This widget will be removed in GTK 5

Returns whether the dropdown menu shows an item for a GtkAppChooserDialog.

Returns:

the value of Gtk.AppChooserButton:show-dialog-item

setActiveCustomItem

@Deprecated
public void setActiveCustomItem(String name)

Deprecated.

This widget will be removed in GTK 5

Selects a custom item.

See appendCustomItem(java.lang.String, java.lang.String, org.gnome.gio.Icon).

Use AppChooser.refresh() to bring the selection to its initial state.

Parameters:

name - the name of the custom item

setHeading

@Deprecated
public void setHeading(String heading)

Deprecated.

This widget will be removed in GTK 5

Sets the text to display at the top of the dialog.

If the heading is not set, the dialog displays a default text.

Parameters:

heading - a string containing Pango markup

setModal

@Deprecated
public void setModal(boolean modal)

Deprecated.

This widget will be removed in GTK 5

Sets whether the dialog should be modal.

Parameters:

modal - true to make the dialog modal

setShowDefaultItem

@Deprecated
public void setShowDefaultItem(boolean setting)

Deprecated.

This widget will be removed in GTK 5

Sets whether the dropdown menu of this button should show the default application for the given content type at top.

Parameters:

setting - the new value for Gtk.AppChooserButton:show-default-item

setShowDialogItem

@Deprecated
public void setShowDialogItem(boolean setting)

Deprecated.

This widget will be removed in GTK 5

Sets whether the dropdown menu of this button should show an entry to trigger a GtkAppChooserDialog.

Parameters:

setting - the new value for Gtk.AppChooserButton:show-dialog-item

onActivate

public SignalConnection<AppChooserButton.ActivateCallback> onActivate(AppChooserButton.ActivateCallback handler)

Deprecated.

Emitted to when the button is activated.

The ::activate signal on GtkAppChooserButton is an action signal and emitting it causes the button to pop up its dialog.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

Since:

4.4

See Also:

• AppChooserButton.ActivateCallback.run()

emitActivate

public void emitActivate()

Deprecated.

Emits the "activate" signal. See onActivate(org.gnome.gtk.AppChooserButton.ActivateCallback).

onChanged

public SignalConnection<AppChooserButton.ChangedCallback> onChanged(AppChooserButton.ChangedCallback handler)

Deprecated.

Emitted when the active application changes.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• AppChooserButton.ChangedCallback.run()

emitChanged

public void emitChanged()

Deprecated.

Emits the "changed" signal. See onChanged(org.gnome.gtk.AppChooserButton.ChangedCallback).

onCustomItemActivated

public SignalConnection<AppChooserButton.CustomItemActivatedCallback> onCustomItemActivated(@Nullable String detail,
 AppChooserButton.CustomItemActivatedCallback handler)

Deprecated.

Emitted when a custom item is activated.

Use appendCustomItem(java.lang.String, java.lang.String, org.gnome.gio.Icon), to add custom items.

Parameters:

detail - the signal detail

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• AppChooserButton.CustomItemActivatedCallback.run(java.lang.String)

emitCustomItemActivated

public void emitCustomItemActivated(@Nullable String detail,
 String itemName)

Deprecated.

Emits the "custom-item-activated" signal. See onCustomItemActivated(java.lang.String, org.gnome.gtk.AppChooserButton.CustomItemActivatedCallback).

builder

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

Deprecated.

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

Returns:

the builder object