Class Dialog.Builder<B extends Dialog.Builder<B>>

java.lang.Object

org.javagi.gobject.Builder<B>

org.gnome.gobject.GObject.Builder<B>

org.gnome.gobject.InitiallyUnowned.Builder<B>

org.gnome.gtk.Widget.Builder<B>

org.gnome.gtk.Window.Builder<B>

org.gnome.gtk.Dialog.Builder<B>

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

Accessible.Builder<B>, BuilderInterface

Direct Known Subclasses:

AppChooserDialog.Builder, ColorChooserDialog.Builder, FileChooserDialog.Builder, FontChooserDialog.Builder, MessageDialog.Builder, PageSetupUnixDialog.Builder, PrintUnixDialog.Builder

Enclosing class:

Dialog

public static class Dialog.Builder<B extends Dialog.Builder<B>>
extends Window.Builder<B>
implements Accessible.Builder<B>

Inner class implementing a builder pattern to construct a GObject with properties.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder()	Default constructor for a Builder object.

Method Summary

Modifier and Type	Method	Description
Dialog	build()	Finish building the Dialog object.
B	onClose(Dialog.CloseCallback handler)	Deprecated. Use Window instead
B	onResponse(Dialog.ResponseCallback handler)	Deprecated. Use Window instead
B	setUseHeaderBar(int useHeaderBar)	Deprecated. Use Window instead

Methods inherited from class Window.Builder

onActivateDefault, onActivateFocus, onCloseRequest, onEnableDebugging, onKeysChanged, setApplication, setChild, setDecorated, setDefaultHeight, setDefaultWidget, setDefaultWidth, setDeletable, setDestroyWithParent, setDisplay, setFocusVisible, setFocusWidget, setFullscreened, setGravity, setHandleMenubarAccel, setHideOnClose, setIconName, setMaximized, setMnemonicsVisible, setModal, setResizable, setStartupId, setTitle, setTitlebar, setTransientFor

Methods inherited from class Widget.Builder

onDestroy, onDirectionChanged, onHide, onKeynavFailed, onMap, onMnemonicActivate, onMoveFocus, onQueryTooltip, onRealize, onShow, onStateFlagsChanged, onUnmap, onUnrealize, setCanFocus, setCanTarget, setCssClasses, setCssName, setCursor, setFocusable, setFocusOnClick, setHalign, setHasTooltip, setHeightRequest, setHexpand, setHexpandSet, setLayoutManager, setLimitEvents, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setOpacity, setOverflow, setReceivesDefault, setSensitive, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, setWidthRequest

Methods inherited from class GObject.Builder

onNotify

Methods inherited from class Builder

addBuilderProperty, connect, connect, connectSignals, getArena, getNames, getValues

Methods inherited from class Object

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

Methods inherited from interface Accessible.Builder

setAccessibleRole

Methods inherited from interface BuilderInterface

addBuilderProperty, connect, connect, getArena

Constructor Details

Builder

protected Builder()

Default constructor for a Builder object.

Method Details

build

public Dialog build()

Finish building the Dialog object. This will call GObject.withProperties(Type, String[], Value[]) to create a new GObject instance, which is then cast to Dialog.

Overrides:

build in class Window.Builder<B extends Dialog.Builder<B>>

Returns:

a new instance of Dialog with the properties that were set in the Builder object.

setUseHeaderBar

@Deprecated
public B setUseHeaderBar(int useHeaderBar)

Deprecated.

Use Window instead

true if the dialog uses a headerbar for action buttons instead of the action-area.

For technical reasons, this property is declared as an integer property, but you should only set it to true or false.

Creating a dialog with headerbar

Builtin GtkDialog subclasses such as ColorChooserDialog set this property according to platform conventions (using the Gtk.Settings:gtk-dialogs-use-header setting).

Here is how you can achieve the same:

g_object_get (settings, "gtk-dialogs-use-header", &header, NULL);
dialog = g_object_new (GTK_TYPE_DIALOG, header, TRUE, NULL);

Parameters:

useHeaderBar - the value for the use-header-bar property

Returns:

the Builder instance is returned, to allow method chaining

onClose

@Deprecated
public B onClose(Dialog.CloseCallback handler)

Deprecated.

Use Window instead

Emitted when the user uses a keybinding to close the dialog.

This is a keybinding signal.

The default binding for this signal is the Escape key.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• Dialog.CloseCallback.run()

onResponse

@Deprecated
public B onResponse(Dialog.ResponseCallback handler)

Deprecated.

Use Window instead

Emitted when an action widget is clicked.

The signal is also emitted when the dialog receives a delete event, and when Dialog.response(int) is called. On a delete event, the response ID is ResponseType.DELETE_EVENT. Otherwise, it depends on which action widget was clicked.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• Dialog.ResponseCallback.run(int)