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("org.javagi.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(String, String, 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 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 InitiallyUnowned

InitiallyUnowned.InitiallyUnownedClass

Nested classes/interfaces inherited from class GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface Accessible

Accessible.Accessible$Impl, Accessible.AccessibleInterface

Nested classes/interfaces inherited from interface AppChooser

AppChooser.AppChooser$Impl

Nested classes/interfaces inherited from interface Buildable

Buildable.Buildable$Impl, Buildable.BuildableIface

Nested classes/interfaces inherited from interface ConstraintTarget

ConstraintTarget.ConstraintTarget$Impl, ConstraintTarget.ConstraintTargetInterface

Constructor Summary

Constructors

Constructor	Description
AppChooserButton()	Deprecated. Create a new AppChooserButton.
AppChooserButton(MemorySegment address)	Deprecated. Create a AppChooserButton 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. Return 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
static MemoryLayout	getMemoryLayout()	Deprecated. The memory layout of the native struct.
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 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, 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 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 TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class ProxyInstance

equals, handle, hashCode

Methods inherited from class Object

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

Methods inherited from interface Accessible

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

Methods inherited from interface AppChooser

getAppInfo, getContentType, refresh

Methods inherited from interface Buildable

getBuildableId

Methods inherited from interface Proxy

handle

Constructor Details

AppChooserButton

public AppChooserButton(MemorySegment address)

Deprecated.

Create a AppChooserButton 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.

Create a new AppChooserButton.

Method Details

getType

public static @Nullable Type getType()

Deprecated.

Get the GType of the AppChooserButton class.

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

Deprecated.

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected AppChooserButton asParent()

Deprecated.

Return this instance as if it were its parent type. Comparable to the Java super keyword, but ensures the parent typeclass is also used in native code.

Overrides:

asParent in class Widget

Returns:

the instance as if it were its parent type

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(String, String, 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(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(AppChooserButton.ChangedCallback).

onCustomItemActivated

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

Deprecated.

Emitted when a custom item is activated.

Use appendCustomItem(String, String, 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(String)

emitCustomItemActivated

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

Deprecated.

Emits the "custom-item-activated" signal. See onCustomItemActivated(String, 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