Package org.gnome.adw

Class AboutWindow.Builder<B extends AboutWindow.Builder<B>>

java.lang.Object

io.github.jwharm.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.adw.Window.Builder<B>

org.gnome.adw.AboutWindow.Builder<B>

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

BuilderInterface, Accessible.Builder<B>

Enclosing class:

AboutWindow

public static class AboutWindow.Builder<B extends AboutWindow.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
AboutWindow	build()	Finish building the AboutWindow object.
B	onActivateLink(AboutWindow.ActivateLinkCallback handler)	Deprecated. Use AboutDialog.
B	setApplicationIcon(String applicationIcon)	Deprecated.
B	setApplicationName(String applicationName)	Deprecated.
B	setArtists(String[] artists)	Deprecated.
B	setComments(String comments)	Deprecated.
B	setCopyright(String copyright)	Deprecated.
B	setDebugInfo(String debugInfo)	Deprecated.
B	setDebugInfoFilename(String debugInfoFilename)	Deprecated.
B	setDesigners(String[] designers)	Deprecated.
B	setDeveloperName(String developerName)	Deprecated.
B	setDevelopers(String[] developers)	Deprecated.
B	setDocumenters(String[] documenters)	Deprecated.
B	setIssueUrl(String issueUrl)	Deprecated.
B	setLicense(String license)	Deprecated.
B	setLicenseType(License licenseType)	Deprecated.
B	setReleaseNotes(String releaseNotes)	Deprecated.
B	setReleaseNotesVersion(String releaseNotesVersion)	Deprecated.
B	setSupportUrl(String supportUrl)	Deprecated.
B	setTranslatorCredits(String translatorCredits)	Deprecated.
B	setVersion(String version)	Deprecated.
B	setWebsite(String website)	Deprecated.

Methods inherited from class org.gnome.adw.Window.Builder

setContent

Methods inherited from class org.gnome.gtk.Window.Builder

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

Methods inherited from class org.gnome.gtk.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, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setOpacity, setOverflow, setReceivesDefault, setSensitive, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, setWidthRequest

Methods inherited from class org.gnome.gobject.GObject.Builder

onNotify

Methods inherited from class io.github.jwharm.javagi.gobject.Builder

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gnome.gtk.Accessible.Builder

setAccessibleRole

Methods inherited from interface io.github.jwharm.javagi.gobject.BuilderInterface

addBuilderProperty, connect, connect, getArena

Constructor Details

Builder

protected Builder()

Default constructor for a Builder object.

Method Details

build

public AboutWindow build()

Finish building the AboutWindow object. This will call GObject.withProperties(org.gnome.glib.Type, java.lang.String[], org.gnome.gobject.Value[]) to create a new GObject instance, which is then cast to AboutWindow.

Overrides:

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

Returns:

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

setApplicationIcon

@Deprecated
public B setApplicationIcon(String applicationIcon)

Deprecated.

The name of the application icon.

The icon is displayed at the top of the main page.

Parameters:

applicationIcon - the value for the application-icon property

Returns:

the Builder instance is returned, to allow method chaining

setApplicationName

@Deprecated
public B setApplicationName(String applicationName)

Deprecated.

The name of the application.

The name is displayed at the top of the main page.

Parameters:

applicationName - the value for the application-name property

Returns:

the Builder instance is returned, to allow method chaining

setArtists

@Deprecated
public B setArtists(String[] artists)

Deprecated.

The list of artists of the application.

It will be displayed on the Credits page.

Each name may contain email addresses and URLs, see the introduction for more details.

See also:

• AboutWindow:developers
• AboutWindow:designers
• AboutWindow:documenters
• AboutWindow:translator-credits
• AboutWindow.addCreditSection(java.lang.String, java.lang.String[])
• AboutWindow.addAcknowledgementSection(java.lang.String, java.lang.String[])

Parameters:

artists - the value for the artists property

Returns:

the Builder instance is returned, to allow method chaining

setComments

@Deprecated
public B setComments(String comments)

Deprecated.

The comments about the application.

Comments will be shown on the Details page, above links.

Unlike Gtk.AboutDialog:comments, this string can be long and detailed. It can also contain links and Pango markup.

Parameters:

comments - the value for the comments property

Returns:

the Builder instance is returned, to allow method chaining

setCopyright

@Deprecated
public B setCopyright(String copyright)

Deprecated.

The copyright information.

This should be a short string of one or two lines, for example: © 2022 Example.

The copyright information will be displayed on the Legal page, above the application license.

AboutWindow.addLegalSection(java.lang.String, java.lang.String, org.gnome.gtk.License, java.lang.String) can be used to add copyright information for the application dependencies or other components.

Parameters:

copyright - the value for the copyright property

Returns:

the Builder instance is returned, to allow method chaining

setDebugInfo

@Deprecated
public B setDebugInfo(String debugInfo)

Deprecated.

The debug information.

Debug information will be shown on the Troubleshooting page. It's intended to be attached to issue reports when reporting issues against the application.

AdwAboutWindow provides a quick way to save debug information to a file. When saving, AboutWindow:debug-info-filename would be used as the suggested filename.

Debug information cannot contain markup or links.

Parameters:

debugInfo - the value for the debug-info property

Returns:

the Builder instance is returned, to allow method chaining

setDebugInfoFilename

@Deprecated
public B setDebugInfoFilename(String debugInfoFilename)

Deprecated.

The debug information filename.

It will be used as the suggested filename when saving debug information to a file.

See AboutWindow:debug-info.

Parameters:

debugInfoFilename - the value for the debug-info-filename property

Returns:

the Builder instance is returned, to allow method chaining

setDesigners

@Deprecated
public B setDesigners(String[] designers)

Deprecated.

The list of designers of the application.

It will be displayed on the Credits page.

Each name may contain email addresses and URLs, see the introduction for more details.

See also:

• AboutWindow:developers
• AboutWindow:artists
• AboutWindow:documenters
• AboutWindow:translator-credits
• AboutWindow.addCreditSection(java.lang.String, java.lang.String[])
• AboutWindow.addAcknowledgementSection(java.lang.String, java.lang.String[])

Parameters:

designers - the value for the designers property

Returns:

the Builder instance is returned, to allow method chaining

setDeveloperName

@Deprecated
public B setDeveloperName(String developerName)

Deprecated.

The developer name.

The developer name is displayed on the main page, under the application name.

If the application is developed by multiple people, the developer name can be set to values like "AppName team", "AppName developers" or "The AppName project", and the individual contributors can be listed on the Credits page, with AboutWindow:developers and related properties.

Parameters:

developerName - the value for the developer-name property

Returns:

the Builder instance is returned, to allow method chaining

setDevelopers

@Deprecated
public B setDevelopers(String[] developers)

Deprecated.

The list of developers of the application.

It will be displayed on the Credits page.

Each name may contain email addresses and URLs, see the introduction for more details.

See also:

• AboutWindow:designers
• AboutWindow:artists
• AboutWindow:documenters
• AboutWindow:translator-credits
• AboutWindow.addCreditSection(java.lang.String, java.lang.String[])
• AboutWindow.addAcknowledgementSection(java.lang.String, java.lang.String[])

Parameters:

developers - the value for the developers property

Returns:

the Builder instance is returned, to allow method chaining

setDocumenters

@Deprecated
public B setDocumenters(String[] documenters)

Deprecated.

The list of documenters of the application.

It will be displayed on the Credits page.

Each name may contain email addresses and URLs, see the introduction for more details.

See also:

• AboutWindow:developers
• AboutWindow:designers
• AboutWindow:artists
• AboutWindow:translator-credits
• AboutWindow.addCreditSection(java.lang.String, java.lang.String[])
• AboutWindow.addAcknowledgementSection(java.lang.String, java.lang.String[])

Parameters:

documenters - the value for the documenters property

Returns:

the Builder instance is returned, to allow method chaining

setIssueUrl

@Deprecated
public B setIssueUrl(String issueUrl)

Deprecated.

The URL for the application's issue tracker.

The issue tracker link is displayed on the main page.

Parameters:

issueUrl - the value for the issue-url property

Returns:

the Builder instance is returned, to allow method chaining

setLicense

@Deprecated
public B setLicense(String license)

Deprecated.

The license text.

This can be used to set a custom text for the license if it can't be set via AboutWindow:license-type.

When set, AboutWindow:license-type will be set to GTK_LICENSE_CUSTOM.

The license text will be displayed on the Legal page, below the copyright information.

License text can contain Pango markup and links.

AboutWindow.addLegalSection(java.lang.String, java.lang.String, org.gnome.gtk.License, java.lang.String) can be used to add license information for the application dependencies or other components.

Parameters:

license - the value for the license property

Returns:

the Builder instance is returned, to allow method chaining

setLicenseType

@Deprecated
public B setLicenseType(License licenseType)

Deprecated.

The license type.

Allows to set the application's license froma list of known licenses.

If the application's license is not in the list, AboutWindow:license can be used instead. The license type will be automatically set to GTK_LICENSE_CUSTOM in that case.

If set to GTK_LICENSE_UNKNOWN, no information will be displayed.

If the license type is different from GTK_LICENSE_CUSTOM. AboutWindow:license will be cleared out.

The license description will be displayed on the Legal page, below the copyright information.

AboutWindow.addLegalSection(java.lang.String, java.lang.String, org.gnome.gtk.License, java.lang.String) can be used to add license information for the application dependencies or other components.

Parameters:

licenseType - the value for the license-type property

Returns:

the Builder instance is returned, to allow method chaining

setReleaseNotes

@Deprecated
public B setReleaseNotes(String releaseNotes)

Deprecated.

The release notes of the application.

Release notes are displayed on the the What's New page.

Release notes are formatted the same way as AppStream descriptions.

The supported formatting options are:

• Paragraph (<p>)
• Ordered list (<ol>), with list items (<li>)
• Unordered list (<ul>), with list items (<li>)

Within paragraphs and list items, emphasis (<em>) and inline code (<code>) text styles are supported. The emphasis is rendered in italic, while inline code is shown in a monospaced font.

Any text outside paragraphs or list items is ignored.

Nested lists are not supported.

AdwAboutWindow displays the version above the release notes. If set, the AboutWindow:release-notes-version of the property will be used as the version; otherwise, AboutWindow:version is used.

Parameters:

releaseNotes - the value for the release-notes property

Returns:

the Builder instance is returned, to allow method chaining

setReleaseNotesVersion

@Deprecated
public B setReleaseNotesVersion(String releaseNotesVersion)

Deprecated.

The version described by the application's release notes.

The release notes version is displayed on the What's New page, above the release notes.

If not set, AboutWindow:version will be used instead.

For example, an application with the current version 2.0.2 might want to keep the release notes from 2.0.0, and set the release notes version accordingly.

See AboutWindow:release-notes.

Parameters:

releaseNotesVersion - the value for the release-notes-version property

Returns:

the Builder instance is returned, to allow method chaining

setSupportUrl

@Deprecated
public B setSupportUrl(String supportUrl)

Deprecated.

The URL of the application's support page.

The support page link is displayed on the main page.

Parameters:

supportUrl - the value for the support-url property

Returns:

the Builder instance is returned, to allow method chaining

setTranslatorCredits

@Deprecated
public B setTranslatorCredits(String translatorCredits)

Deprecated.

The translator credits string.

It will be displayed on the Credits page.

This string should be "translator-credits" or "translator_credits" and should be marked as translatable.

The string may contain email addresses and URLs, see the introduction for more details.

See also:

• AboutWindow:developers
• AboutWindow:designers
• AboutWindow:artists
• AboutWindow:documenters
• AboutWindow.addCreditSection(java.lang.String, java.lang.String[])
• AboutWindow.addAcknowledgementSection(java.lang.String, java.lang.String[])

Parameters:

translatorCredits - the value for the translator-credits property

Returns:

the Builder instance is returned, to allow method chaining

setVersion

@Deprecated
public B setVersion(String version)

Deprecated.

The version of the application.

The version is displayed on the main page.

If AboutWindow:release-notes-version is not set, the version will also be displayed above the release notes on the What's New page.

Parameters:

version - the value for the version property

Returns:

the Builder instance is returned, to allow method chaining

setWebsite

@Deprecated
public B setWebsite(String website)

Deprecated.

The URL of the application's website.

Website is displayed on the Details page, below comments, or on the main page if the Details page doesn't have any other content.

Applications can add other links below, see AboutWindow.addLink(java.lang.String, java.lang.String).

Parameters:

website - the value for the website property

Returns:

the Builder instance is returned, to allow method chaining

onActivateLink

@Deprecated
public B onActivateLink(AboutWindow.ActivateLinkCallback handler)

Deprecated.

Use AboutDialog.

Emitted when a URL is activated.

Applications may connect to it to override the default behavior, which is to call Gtk.showUri(org.gnome.gtk.Window, java.lang.String, int).

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• AboutWindow.ActivateLinkCallback.run(java.lang.String)