Class AboutWindow.Builder<B extends AboutWindow.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.adw.Window.Builder<B>
org.gnome.adw.AboutWindow.Builder<B>
Type Parameters:
B - the type of the Builder that is returned
All Implemented Interfaces:
Accessible.Builder<B>, BuilderInterface
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.
Since:
1.2

  • 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(Type, String[], 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.
      Use AboutDialog.

      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
      Since:
      1.2

    • setApplicationName

      @Deprecated public B setApplicationName(String applicationName)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setArtists

      @Deprecated public B setArtists(String[] artists)
      Deprecated.
      Use AboutDialog.

      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:

      Parameters:
      artists - the value for the artists property
      Returns:
      the Builder instance is returned, to allow method chaining
      Since:
      1.2

    • setComments

      @Deprecated public B setComments(String comments)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setCopyright

      @Deprecated public B setCopyright(String copyright)
      Deprecated.
      Use AboutDialog.

      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(String, String, License, 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
      Since:
      1.2

    • setDebugInfo

      @Deprecated public B setDebugInfo(String debugInfo)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setDebugInfoFilename

      @Deprecated public B setDebugInfoFilename(String debugInfoFilename)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setDesigners

      @Deprecated public B setDesigners(String[] designers)
      Deprecated.
      Use AboutDialog.

      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:

      Parameters:
      designers - the value for the designers property
      Returns:
      the Builder instance is returned, to allow method chaining
      Since:
      1.2

    • setDeveloperName

      @Deprecated public B setDeveloperName(String developerName)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setDevelopers

      @Deprecated public B setDevelopers(String[] developers)
      Deprecated.
      Use AboutDialog.

      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:

      Parameters:
      developers - the value for the developers property
      Returns:
      the Builder instance is returned, to allow method chaining
      Since:
      1.2

    • setDocumenters

      @Deprecated public B setDocumenters(String[] documenters)
      Deprecated.
      Use AboutDialog.

      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:

      Parameters:
      documenters - the value for the documenters property
      Returns:
      the Builder instance is returned, to allow method chaining
      Since:
      1.2

    • setIssueUrl

      @Deprecated public B setIssueUrl(String issueUrl)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setLicense

      @Deprecated public B setLicense(String license)
      Deprecated.
      Use AboutDialog.

      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(String, String, License, 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
      Since:
      1.2

    • setLicenseType

      @Deprecated public B setLicenseType(License licenseType)
      Deprecated.
      Use AboutDialog.

      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(String, String, License, 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
      Since:
      1.2

    • setReleaseNotes

      @Deprecated public B setReleaseNotes(String releaseNotes)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setReleaseNotesVersion

      @Deprecated public B setReleaseNotesVersion(String releaseNotesVersion)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setSupportUrl

      @Deprecated public B setSupportUrl(String supportUrl)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setTranslatorCredits

      @Deprecated public B setTranslatorCredits(String translatorCredits)
      Deprecated.
      Use AboutDialog.

      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:

      Parameters:
      translatorCredits - the value for the translator-credits property
      Returns:
      the Builder instance is returned, to allow method chaining
      Since:
      1.2

    • setVersion

      @Deprecated public B setVersion(String version)
      Deprecated.
      Use AboutDialog.

      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
      Since:
      1.2

    • setWebsite

      @Deprecated public B setWebsite(String website)
      Deprecated.
      Use AboutDialog.

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

      Parameters:
      website - the value for the website property
      Returns:
      the Builder instance is returned, to allow method chaining
      Since:
      1.2

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

      Parameters:
      handler - the signal handler
      Returns:
      the Builder instance is returned, to allow method chaining
      Since:
      1.2
      See Also: