Package ch.bailu.gtk.adw
Klasse AboutWindow
- Alle implementierten Schnittstellen:
PointerInterface
A window showing information about the application.
<picture>
<source srcset="about-window-dark.png" media="(prefers-color-scheme: dark)">
<img src="about-window.png" alt="about-window">
</picture>
An about window is typically opened when the user activates the `About …`
item in the application's primary menu. All parts of the window are optional.
## Main page
`AdwAboutWindow` prominently displays the application's icon, name, developer
name and version. They can be set with the [property@AboutWindow:application-icon],
[property@AboutWindow:application-name],
[property@AboutWindow:developer-name] and [property@AboutWindow:version]
respectively.
## What's New
`AdwAboutWindow` provides a way for applications to display their release
notes, set with the [property@AboutWindow:release-notes] property.
Release notes are formatted the same way as
[AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
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.
Only one version can be shown at a time. By default, the displayed version
number matches [property@AboutWindow:version]. Use
[property@AboutWindow:release-notes-version] to override it.
## Details
The Details page displays the application comments and links.
The comments can be set with the [property@AboutWindow:comments] property.
Unlike [property@Gtk.AboutDialog:comments], this string can be long and
detailed. It can also contain links and Pango markup.
To set the application website, use [property@AboutWindow:website].
To add extra links below the website, use [method@AboutWindow.add_link].
If the Details page doesn't have any other content besides website, the
website will be displayed on the main page instead.
## Troubleshooting
`AdwAboutWindow` displays the following two links on the main page:
* Support Questions, set with the [property@AboutWindow:support-url] property,
* Report an Issue, set with the [property@AboutWindow:issue-url] property.
Additionally, applications can provide debugging information. It will be
shown separately on the Troubleshooting page. Use the
[property@AboutWindow:debug-info] property to specify it.
It's intended to be attached to issue reports when reporting issues against
the application. As such, it cannot contain markup or links.
`AdwAboutWindow` provides a quick way to save debug information to a file.
When saving, [property@AboutWindow:debug-info-filename] would be used as
the suggested filename.
## Credits and Acknowledgements
The Credits page has the following default sections:
* Developers, set with the [property@AboutWindow:developers] property,
* Designers, set with the [property@AboutWindow:designers] property,
* Artists, set with the [property@AboutWindow:artists] property,
* Documenters, set with the [property@AboutWindow:documenters] property,
* Translators, set with the [property@AboutWindow:translator-credits] property.
When setting translator credits, use the strings `"translator-credits"` or
`"translator_credits"` and mark them as translatable.
The default sections that don't contain any names won't be displayed.
The Credits page can also contain an arbitrary number of extra sections below
the default ones. Use [method@AboutWindow.add_credit_section] to add them.
The Acknowledgements page can be used to acknowledge additional people and
organizations for their non-development contributions. Use
[method@AboutWindow.add_acknowledgement_section] to add sections to it. For
example, it can be used to list backers in a crowdfunded project or to give
special thanks.
Each of the people or organizations can have an email address or a website
specified. To add a email address, use a string like
`Edgar Allan Poe <edgar@poe.com>`. To specify a website with a title, use a
string like `The GNOME Project https://www.gnome.org`:
<picture>
<source srcset="about-window-credits-dark.png" media="(prefers-color-scheme: dark)">
<img src="about-window-credits.png" alt="about-window-credits">
</picture>
## Legal
The Legal page displays the copyright and licensing information for the
application and other modules.
The copyright string is set with the [property@AboutWindow:copyright]
property and should be a short string of one or two lines, for example:
`© 2022 Example`.
Licensing information can be quickly set from a list of known licenses with
the [property@AboutWindow:license-type] property. If the application's
license is not in the list, [property@AboutWindow:license] can be used
instead.
To add information about other modules, such as application dependencies or
data, use [method@AboutWindow.add_legal_section].
## Constructing
To make constructing an `AdwAboutWindow` as convenient as possible, you can
use the function [func@show_about_window] which constructs and shows a
window.
```c
static void
show_about (GtkApplication *app)
{
const char *developers[] = {
"Angela Avery",
NULL
};
const char *designers[] = {
"GNOME Design Team",
NULL
};
adw_show_about_window (gtk_application_get_active_window (app),
"application-name", _("Example"),
"application-icon", "org.example.App",
"version", "1.2.3",
"copyright", "© 2022 Angela Avery",
"issue-url", "https://gitlab.gnome.org/example/example/-/issues/",
"license-type", GTK_LICENSE_GPL_3_0,
"developers", developers,
"designers", designers,
"translator-credits", _("translator-credits"),
NULL);
}
```
## CSS nodes
`AdwAboutWindow` has a main CSS node with the name `window` and the
style class `.about`.
<picture>
<source srcset="about-window-dark.png" media="(prefers-color-scheme: dark)">
<img src="about-window.png" alt="about-window">
</picture>
An about window is typically opened when the user activates the `About …`
item in the application's primary menu. All parts of the window are optional.
## Main page
`AdwAboutWindow` prominently displays the application's icon, name, developer
name and version. They can be set with the [property@AboutWindow:application-icon],
[property@AboutWindow:application-name],
[property@AboutWindow:developer-name] and [property@AboutWindow:version]
respectively.
## What's New
`AdwAboutWindow` provides a way for applications to display their release
notes, set with the [property@AboutWindow:release-notes] property.
Release notes are formatted the same way as
[AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
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.
Only one version can be shown at a time. By default, the displayed version
number matches [property@AboutWindow:version]. Use
[property@AboutWindow:release-notes-version] to override it.
## Details
The Details page displays the application comments and links.
The comments can be set with the [property@AboutWindow:comments] property.
Unlike [property@Gtk.AboutDialog:comments], this string can be long and
detailed. It can also contain links and Pango markup.
To set the application website, use [property@AboutWindow:website].
To add extra links below the website, use [method@AboutWindow.add_link].
If the Details page doesn't have any other content besides website, the
website will be displayed on the main page instead.
## Troubleshooting
`AdwAboutWindow` displays the following two links on the main page:
* Support Questions, set with the [property@AboutWindow:support-url] property,
* Report an Issue, set with the [property@AboutWindow:issue-url] property.
Additionally, applications can provide debugging information. It will be
shown separately on the Troubleshooting page. Use the
[property@AboutWindow:debug-info] property to specify it.
It's intended to be attached to issue reports when reporting issues against
the application. As such, it cannot contain markup or links.
`AdwAboutWindow` provides a quick way to save debug information to a file.
When saving, [property@AboutWindow:debug-info-filename] would be used as
the suggested filename.
## Credits and Acknowledgements
The Credits page has the following default sections:
* Developers, set with the [property@AboutWindow:developers] property,
* Designers, set with the [property@AboutWindow:designers] property,
* Artists, set with the [property@AboutWindow:artists] property,
* Documenters, set with the [property@AboutWindow:documenters] property,
* Translators, set with the [property@AboutWindow:translator-credits] property.
When setting translator credits, use the strings `"translator-credits"` or
`"translator_credits"` and mark them as translatable.
The default sections that don't contain any names won't be displayed.
The Credits page can also contain an arbitrary number of extra sections below
the default ones. Use [method@AboutWindow.add_credit_section] to add them.
The Acknowledgements page can be used to acknowledge additional people and
organizations for their non-development contributions. Use
[method@AboutWindow.add_acknowledgement_section] to add sections to it. For
example, it can be used to list backers in a crowdfunded project or to give
special thanks.
Each of the people or organizations can have an email address or a website
specified. To add a email address, use a string like
`Edgar Allan Poe <edgar@poe.com>`. To specify a website with a title, use a
string like `The GNOME Project https://www.gnome.org`:
<picture>
<source srcset="about-window-credits-dark.png" media="(prefers-color-scheme: dark)">
<img src="about-window-credits.png" alt="about-window-credits">
</picture>
## Legal
The Legal page displays the copyright and licensing information for the
application and other modules.
The copyright string is set with the [property@AboutWindow:copyright]
property and should be a short string of one or two lines, for example:
`© 2022 Example`.
Licensing information can be quickly set from a list of known licenses with
the [property@AboutWindow:license-type] property. If the application's
license is not in the list, [property@AboutWindow:license] can be used
instead.
To add information about other modules, such as application dependencies or
data, use [method@AboutWindow.add_legal_section].
## Constructing
To make constructing an `AdwAboutWindow` as convenient as possible, you can
use the function [func@show_about_window] which constructs and shows a
window.
```c
static void
show_about (GtkApplication *app)
{
const char *developers[] = {
"Angela Avery",
NULL
};
const char *designers[] = {
"GNOME Design Team",
NULL
};
adw_show_about_window (gtk_application_get_active_window (app),
"application-name", _("Example"),
"application-icon", "org.example.App",
"version", "1.2.3",
"copyright", "© 2022 Angela Avery",
"issue-url", "https://gitlab.gnome.org/example/example/-/issues/",
"license-type", GTK_LICENSE_GPL_3_0,
"developers", developers,
"designers", designers,
"translator-credits", _("translator-credits"),
NULL);
}
```
## CSS nodes
`AdwAboutWindow` has a main CSS node with the name `window` and the
style class `.about`.
https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.AboutWindow.html
-
Verschachtelte Klassen - Übersicht
Verschachtelte KlassenVon Klasse geerbte verschachtelte Klassen/Schnittstellen ch.bailu.gtk.gtk.Window
Window.OnActivateDefault, Window.OnActivateFocus, Window.OnCloseRequest, Window.OnEnableDebugging, Window.OnKeysChanged
Von Klasse geerbte verschachtelte Klassen/Schnittstellen ch.bailu.gtk.gtk.Widget
Widget.OnDestroy, Widget.OnDestroyNotify, Widget.OnDirectionChanged, Widget.OnHide, Widget.OnKeynavFailed, Widget.OnMap, Widget.OnMnemonicActivate, Widget.OnMoveFocus, Widget.OnQueryTooltip, Widget.OnRealize, Widget.OnShow, Widget.OnStateFlagsChanged, Widget.OnTickCallback, Widget.OnUnmap, Widget.OnUnrealize
Von Klasse geerbte verschachtelte Klassen/Schnittstellen ch.bailu.gtk.gobject.Object
Object.OnBindingTransformFunc, Object.OnDuplicateFunc, Object.OnNotify, Object.OnToggleNotify, Object.OnWeakNotify
-
Feldübersicht
FelderVon Klasse geerbte Felder ch.bailu.gtk.gtk.Window
SIGNAL_ON_ACTIVATE_DEFAULT, SIGNAL_ON_ACTIVATE_FOCUS, SIGNAL_ON_CLOSE_REQUEST, SIGNAL_ON_ENABLE_DEBUGGING, SIGNAL_ON_KEYS_CHANGED
Von Klasse geerbte Felder ch.bailu.gtk.gtk.Widget
SIGNAL_ON_DESTROY, SIGNAL_ON_DIRECTION_CHANGED, SIGNAL_ON_HIDE, SIGNAL_ON_KEYNAV_FAILED, SIGNAL_ON_MAP, SIGNAL_ON_MNEMONIC_ACTIVATE, SIGNAL_ON_MOVE_FOCUS, SIGNAL_ON_QUERY_TOOLTIP, SIGNAL_ON_REALIZE, SIGNAL_ON_SHOW, SIGNAL_ON_STATE_FLAGS_CHANGED, SIGNAL_ON_UNMAP, SIGNAL_ON_UNREALIZE
Von Klasse geerbte Felder ch.bailu.gtk.gobject.Object
SIGNAL_ON_NOTIFY
-
Konstruktorübersicht
Konstruktoren -
Methodenübersicht
Modifizierer und TypMethodeBeschreibungvoid
addAcknowledgementSection
(Str name, Strs people) Veraltet.void
addAcknowledgementSection
(String name, Strs people) Veraltet.void
addCreditSection
(Str name, Strs people) Veraltet.void
addCreditSection
(String name, Strs people) Veraltet.void
addLegalSection
(Str title, Str copyright, int license_type, Str license) Veraltet.void
addLegalSection
(String title, String copyright, int license_type, String license) Veraltet.void
Veraltet.void
Veraltet.Implements interfaceAccessible
.Implements interfaceBuildable
.Implements interfaceConstraintTarget
.asNative()
Implements interfaceNative
.asRoot()
Implements interfaceRoot
.Implements interfaceShortcutManager
.Veraltet.Veraltet.Veraltet.static ClassHandler
Veraltet.Veraltet.Veraltet.Veraltet.Veraltet.Veraltet.Veraltet.Veraltet.static int
Veraltet.Veraltet.int
Veraltet.static long
static TypeSystem.TypeSize
Veraltet.Veraltet.Veraltet.Veraltet.static long
static TypeSystem.TypeSize
Veraltet.Veraltet.static AboutWindow
newFromAppdataAboutWindow
(Str resource_path, Str release_notes_version) Veraltet.static AboutWindow
newFromAppdataAboutWindow
(String resource_path, String release_notes_version) Veraltet.Connect to signal "activate-link".void
setApplicationIcon
(Str application_icon) Veraltet.void
setApplicationIcon
(String application_icon) Veraltet.void
setApplicationName
(Str application_name) Veraltet.void
setApplicationName
(String application_name) Veraltet.void
setArtists
(Strs artists) Veraltet.void
setComments
(Str comments) Veraltet.void
setComments
(String comments) Veraltet.void
setCopyright
(Str copyright) Veraltet.void
setCopyright
(String copyright) Veraltet.void
setDebugInfo
(Str debug_info) Veraltet.void
setDebugInfo
(String debug_info) Veraltet.void
setDebugInfoFilename
(Str filename) Veraltet.void
setDebugInfoFilename
(String filename) Veraltet.void
setDesigners
(Strs designers) Veraltet.void
setDeveloperName
(Str developer_name) Veraltet.void
setDeveloperName
(String developer_name) Veraltet.void
setDevelopers
(Strs developers) Veraltet.void
setDocumenters
(Strs documenters) Veraltet.void
setIssueUrl
(Str issue_url) Veraltet.void
setIssueUrl
(String issue_url) Veraltet.void
setLicense
(Str license) Veraltet.void
setLicense
(String license) Veraltet.void
setLicenseType
(int license_type) Veraltet.void
setReleaseNotes
(Str release_notes) Veraltet.void
setReleaseNotes
(String release_notes) Veraltet.void
setReleaseNotesVersion
(Str version) Veraltet.void
setReleaseNotesVersion
(String version) Veraltet.void
setSupportUrl
(Str support_url) Veraltet.void
setSupportUrl
(String support_url) Veraltet.void
setTranslatorCredits
(Str translator_credits) Veraltet.void
setTranslatorCredits
(String translator_credits) Veraltet.void
setVersion
(Str version) Veraltet.void
setVersion
(String version) Veraltet.void
setWebsite
(Str website) Veraltet.void
setWebsite
(String website) Veraltet.Von Klasse geerbte Methoden ch.bailu.gtk.adw.Window
addBreakpoint, getAdaptivePreview, getContent, getCurrentBreakpoint, getDialogs, getVisibleDialog, setAdaptivePreview, setContent
Von Klasse geerbte Methoden ch.bailu.gtk.gtk.Window
close, destroy, fullscreen, fullscreenOnMonitor, getApplication, getChild, getDecorated, getDefaultIconName, getDefaultSize, getDefaultWidget, getDeletable, getDestroyWithParent, getFocus, getFocusVisible, getGroup, getHandleMenubarAccel, getHideOnClose, getIconName, getMnemonicsVisible, getModal, getResizable, getTitle, getTitlebar, getToplevels, getTransientFor, hasGroup, isActive, isFullscreen, isMaximized, isSuspended, listToplevels, maximize, minimize, onActivateDefault, onActivateFocus, onCloseRequest, onEnableDebugging, onKeysChanged, present, presentWithTime, setApplication, setAutoStartupNotification, setChild, setDecorated, setDefaultIconName, setDefaultSize, setDefaultWidget, setDeletable, setDestroyWithParent, setDisplay, setFocus, setFocusVisible, setHandleMenubarAccel, setHideOnClose, setIconName, setIconName, setInteractiveDebugging, setMnemonicsVisible, setModal, setResizable, setStartupId, setStartupId, setTitle, setTitle, setTitlebar, setTransientFor, unfullscreen, unmaximize, unminimize
Von Klasse geerbte Methoden ch.bailu.gtk.gtk.Widget
actionSetEnabled, actionSetEnabled, activate, activateAction, activateAction, activateActionVariant, activateActionVariant, activateDefault, addController, addCssClass, addCssClass, addMnemonicLabel, addTickCallback, allocate, childFocus, computeBounds, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, createPangoLayout, disposeTemplate, dragCheckThreshold, errorBell, 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, getTemplateChild, getTooltipMarkup, getTooltipText, getValign, getVexpand, getVexpandSet, getVisible, getWidth, grabFocus, hasCssClass, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initTemplate, insertActionGroup, insertActionGroup, insertAfter, insertBefore, isAncestor, isDrawable, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, observeChildren, observeControllers, onDestroy, onDirectionChanged, onHide, onKeynavFailed, onMap, onMnemonicActivate, onMoveFocus, onQueryTooltip, onRealize, onShow, onStateFlagsChanged, onUnmap, onUnrealize, pick, queueAllocate, queueDraw, queueResize, realize, removeController, removeCssClass, removeCssClass, removeMnemonicLabel, removeTickCallback, setCanFocus, setCanTarget, setChildVisible, setCssClasses, setCursor, setCursorFromName, setCursorFromName, setDefaultDirection, setDirection, setFocusable, setFocusChild, setFocusOnClick, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLayoutManager, setLimitEvents, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setName, setOpacity, setOverflow, setParent, setReceivesDefault, setSensitive, setSizeRequest, setStateFlags, setTooltipMarkup, setTooltipMarkup, setTooltipText, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, shouldLayout, show, sizeAllocate, snapshotChild, triggerTooltipQuery, unmap, unparent, unrealize, unsetStateFlags
Von Klasse geerbte Methoden ch.bailu.gtk.type.PropertyHolder
getBooleanProperty, getIntProperty, getObjectProperty, getStringProperty, getStrProperty, setBooleanProperty, setIntProperty, setObjectProperty, setStringProperty, setStrProperty
Von Klasse geerbte Methoden ch.bailu.gtk.gobject.Object
addToggleRef, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, disconnect, disconnect, dupData, dupData, dupQdata, forceFloating, freezeNotify, get, get, getData, getData, getProperty, getProperty, getQdata, interfaceFindProperty, interfaceInstallProperty, isFloating, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, replaceData, replaceData, replaceQdata, runDispose, set, set, setData, setData, setDataFull, setDataFull, setProperty, setProperty, setQdata, setQdataFull, stealData, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref
Von Klasse geerbte Methoden ch.bailu.gtk.type.Pointer
asCPointer, cast, connectSignal, disconnectSignals, disconnectSignals, equals, hashCode, throwIfNull, throwNullPointerException, toString, unregisterCallbacks, unregisterCallbacks
Von Klasse geerbte Methoden ch.bailu.gtk.type.Type
asCPointer, asCPointer, asCPointerNotNull, asJnaPointer, asJnaPointer, asPointer, asPointer, cast, cast, throwIfNull
Von Klasse geerbte Methoden java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Von Schnittstelle geerbte Methoden ch.bailu.gtk.type.PointerInterface
asCPointerNotNull, asJnaPointer, asPointer, isNotNull, isNull
-
Felddetails
-
SIGNAL_ON_ACTIVATE_LINK
Veraltet.- Siehe auch:
-
-
Konstruktordetails
-
AboutWindow
-
AboutWindow
Veraltet.Creates a new `AdwAboutWindow`.
-
-
Methodendetails
-
getClassHandler
-
newFromAppdataAboutWindow
@Deprecated public static AboutWindow newFromAppdataAboutWindow(@Nonnull Str resource_path, @Nullable Str release_notes_version) Veraltet.Creates a new `AdwAboutWindow` using AppStream metadata.
This automatically sets the following properties with the following AppStream
values:
* [property@AboutWindow:application-icon] is set from the `<id>`
* [property@AboutWindow:application-name] is set from the `<name>`
* [property@AboutWindow:developer-name] is set from the `<name>` within
`<developer>`
* [property@AboutWindow:version] is set from the version of the latest release
* [property@AboutWindow:website] is set from the `<url type="homepage">`
* [property@AboutWindow:support-url] is set from the `<url type="help">`
* [property@AboutWindow:issue-url] is set from the `<url type="bugtracker">`
* [property@AboutWindow:license-type] is set from the `<project_license>`.
If the license type retrieved from AppStream is not listed in
[enum@Gtk.License], it will be set to `GTK_LICENCE_CUSTOM`.
If @release_notes_version is not `NULL`,
[property@AboutWindow:release-notes-version] is set to match it, while
[property@AboutWindow:release-notes] is set from the AppStream release
description for that version.- Parameter:
resource_path
- The resource to userelease_notes_version
- The version to retrieve release notes for- Gibt zurück:
- the newly created `AdwAboutWindow`
-
newFromAppdataAboutWindow
@Deprecated public static AboutWindow newFromAppdataAboutWindow(String resource_path, String release_notes_version) Veraltet.Creates a new `AdwAboutWindow` using AppStream metadata.
This automatically sets the following properties with the following AppStream
values:
* [property@AboutWindow:application-icon] is set from the `<id>`
* [property@AboutWindow:application-name] is set from the `<name>`
* [property@AboutWindow:developer-name] is set from the `<name>` within
`<developer>`
* [property@AboutWindow:version] is set from the version of the latest release
* [property@AboutWindow:website] is set from the `<url type="homepage">`
* [property@AboutWindow:support-url] is set from the `<url type="help">`
* [property@AboutWindow:issue-url] is set from the `<url type="bugtracker">`
* [property@AboutWindow:license-type] is set from the `<project_license>`.
If the license type retrieved from AppStream is not listed in
[enum@Gtk.License], it will be set to `GTK_LICENCE_CUSTOM`.
If @release_notes_version is not `NULL`,
[property@AboutWindow:release-notes-version] is set to match it, while
[property@AboutWindow:release-notes] is set from the AppStream release
description for that version.- Parameter:
resource_path
- The resource to userelease_notes_version
- The version to retrieve release notes for- Gibt zurück:
- the newly created `AdwAboutWindow`
-
addAcknowledgementSection
Veraltet.Adds a section to the Acknowledgements page.
This can be used to acknowledge additional people and organizations for their
non-development contributions - for example, backers in a crowdfunded
project.
Each name may contain email addresses and URLs, see the introduction for more
details.
See also:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_credit_section]- Parameter:
name
- the section namepeople
- the list of names
-
addAcknowledgementSection
Veraltet.Adds a section to the Acknowledgements page.
This can be used to acknowledge additional people and organizations for their
non-development contributions - for example, backers in a crowdfunded
project.
Each name may contain email addresses and URLs, see the introduction for more
details.
See also:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_credit_section]- Parameter:
name
- the section namepeople
- the list of names
-
addCreditSection
Veraltet.Adds an extra section to the Credits page.
Extra sections are displayed below the standard categories.
Each name may contain email addresses and URLs, see the introduction for more
details.
See also:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
name
- the section namepeople
- the list of names
-
addCreditSection
Veraltet.Adds an extra section to the Credits page.
Extra sections are displayed below the standard categories.
Each name may contain email addresses and URLs, see the introduction for more
details.
See also:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
name
- the section namepeople
- the list of names
-
addLegalSection
@Deprecated public void addLegalSection(@Nonnull Str title, @Nullable Str copyright, int license_type, @Nullable Str license) Veraltet.Adds an extra section to the Legal page.
Extra sections will be displayed below the application's own information.
The parameters @copyright, @license_type and @license will be used to present
the it the same way as [property@AboutWindow:copyright],
[property@AboutWindow:license-type] and [property@AboutWindow:license] are
for the application's own information.
See those properties for more details.
This can be useful to attribute the application dependencies or data.
Examples:
```c
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Copyright and a known license"),
"© 2022 Example",
GTK_LICENSE_LGPL_2_1,
NULL);
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Copyright and custom license"),
"© 2022 Example",
GTK_LICENSE_CUSTOM,
"Custom license text");
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Copyright only"),
"© 2022 Example",
GTK_LICENSE_UNKNOWN,
NULL);
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Custom license only"),
NULL,
GTK_LICENSE_CUSTOM,
"Something completely custom here.");
```- Parameter:
title
- the name of the sectioncopyright
- a copyright stringlicense_type
- the type of licenselicense
- custom license information
-
addLegalSection
@Deprecated public void addLegalSection(String title, String copyright, int license_type, String license) Veraltet.Adds an extra section to the Legal page.
Extra sections will be displayed below the application's own information.
The parameters @copyright, @license_type and @license will be used to present
the it the same way as [property@AboutWindow:copyright],
[property@AboutWindow:license-type] and [property@AboutWindow:license] are
for the application's own information.
See those properties for more details.
This can be useful to attribute the application dependencies or data.
Examples:
```c
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Copyright and a known license"),
"© 2022 Example",
GTK_LICENSE_LGPL_2_1,
NULL);
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Copyright and custom license"),
"© 2022 Example",
GTK_LICENSE_CUSTOM,
"Custom license text");
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Copyright only"),
"© 2022 Example",
GTK_LICENSE_UNKNOWN,
NULL);
adw_about_window_add_legal_section (ADW_ABOUT_WINDOW (about),
_("Custom license only"),
NULL,
GTK_LICENSE_CUSTOM,
"Something completely custom here.");
```- Parameter:
title
- the name of the sectioncopyright
- a copyright stringlicense_type
- the type of licenselicense
- custom license information
-
addLink
Veraltet.Adds an extra link to the Details page.
Extra links are displayed under the comment and website.
Underlines in @title will be interpreted as indicating a mnemonic.
See [property@AboutWindow:website].- Parameter:
title
- the link titleurl
- the link URL
-
addLink
Veraltet.Adds an extra link to the Details page.
Extra links are displayed under the comment and website.
Underlines in @title will be interpreted as indicating a mnemonic.
See [property@AboutWindow:website].- Parameter:
title
- the link titleurl
- the link URL
-
getApplicationIcon
Veraltet.Gets the name of the application icon for @self.- Gibt zurück:
- the application icon name
-
getApplicationName
Veraltet.Gets the application name for @self.- Gibt zurück:
- the application name
-
getArtists
Veraltet.Gets the list of artists of the application.- Gibt zurück:
- The list of artists
-
getComments
Veraltet.Gets the comments about the application.- Gibt zurück:
- the comments
-
getCopyright
Veraltet.Gets the copyright information for @self.- Gibt zurück:
- the copyright information
-
getDebugInfo
Veraltet.Gets the debug information for @self.- Gibt zurück:
- the debug information
-
getDebugInfoFilename
Veraltet.Gets the debug information filename for @self.- Gibt zurück:
- the debug information filename
-
getDesigners
Veraltet.Gets the list of designers of the application.- Gibt zurück:
- The list of designers
-
getDeveloperName
Veraltet.Gets the developer name for @self.- Gibt zurück:
- the developer_name
-
getDevelopers
Veraltet.Gets the list of developers of the application.- Gibt zurück:
- The list of developers
-
getDocumenters
Veraltet.Gets the list of documenters of the application.- Gibt zurück:
- The list of documenters
-
getIssueUrl
Veraltet.Gets the issue tracker URL for @self.- Gibt zurück:
- the issue tracker URL
-
getLicense
Veraltet.Gets the license for @self.- Gibt zurück:
- the license
-
getLicenseType
Veraltet.Gets the license type for @self.- Gibt zurück:
- the license type
-
getReleaseNotes
Veraltet.Gets the release notes for @self.- Gibt zurück:
- the release notes
-
getReleaseNotesVersion
Veraltet.Gets the version described by the application's release notes.- Gibt zurück:
- the release notes version
-
getSupportUrl
Veraltet.Gets the URL of the support page for @self.- Gibt zurück:
- the support page URL
-
getTranslatorCredits
Veraltet.Gets the translator credits string.- Gibt zurück:
- The translator credits string
-
getVersion
Veraltet.Gets the version for @self.- Gibt zurück:
- the version
-
getWebsite
Veraltet.Gets the application website URL for @self.- Gibt zurück:
- the website URL
-
setApplicationIcon
Veraltet.Sets the name of the application icon for @self.
The icon is displayed at the top of the main page.- Parameter:
application_icon
- the application icon name
-
setApplicationIcon
Veraltet.Sets the name of the application icon for @self.
The icon is displayed at the top of the main page.- Parameter:
application_icon
- the application icon name
-
setApplicationName
Veraltet.Sets the application name for @self.
The name is displayed at the top of the main page.- Parameter:
application_name
- the application name
-
setApplicationName
Veraltet.Sets the application name for @self.
The name is displayed at the top of the main page.- Parameter:
application_name
- the application name
-
setArtists
Veraltet.Sets 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:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:documenters]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_credit_section]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
artists
- the list of artists
-
setComments
Veraltet.Sets the comments about the application.
Comments will be shown on the Details page, above links.
Unlike [property@Gtk.AboutDialog:comments], this string can be long and
detailed. It can also contain links and Pango markup.- Parameter:
comments
- the comments
-
setComments
Veraltet.Sets the comments about the application.
Comments will be shown on the Details page, above links.
Unlike [property@Gtk.AboutDialog:comments], this string can be long and
detailed. It can also contain links and Pango markup.- Parameter:
comments
- the comments
-
setCopyright
Veraltet.Sets the copyright information for @self.
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, before the
application license.
[method@AboutWindow.add_legal_section] can be used to add copyright
information for the application dependencies or other components.- Parameter:
copyright
- the copyright information
-
setCopyright
Veraltet.Sets the copyright information for @self.
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, before the
application license.
[method@AboutWindow.add_legal_section] can be used to add copyright
information for the application dependencies or other components.- Parameter:
copyright
- the copyright information
-
setDebugInfo
Veraltet.Sets the debug information for @self.
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, [property@AboutWindow:debug-info-filename] would be used as
the suggested filename.
Debug information cannot contain markup or links.- Parameter:
debug_info
- the debug information
-
setDebugInfo
Veraltet.Sets the debug information for @self.
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, [property@AboutWindow:debug-info-filename] would be used as
the suggested filename.
Debug information cannot contain markup or links.- Parameter:
debug_info
- the debug information
-
setDebugInfoFilename
Veraltet.Sets the debug information filename for @self.
It will be used as the suggested filename when saving debug information to a
file.
See [property@AboutWindow:debug-info].- Parameter:
filename
- the debug info filename
-
setDebugInfoFilename
Veraltet.Sets the debug information filename for @self.
It will be used as the suggested filename when saving debug information to a
file.
See [property@AboutWindow:debug-info].- Parameter:
filename
- the debug info filename
-
setDesigners
Veraltet.Sets 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:
* [property@AboutWindow:developers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_credit_section]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
designers
- the list of designers
-
setDeveloperName
Veraltet.Sets the developer name for @self.
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 [property@AboutWindow:developers] and related properties.- Parameter:
developer_name
- the developer name
-
setDeveloperName
Veraltet.Sets the developer name for @self.
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 [property@AboutWindow:developers] and related properties.- Parameter:
developer_name
- the developer name
-
setDevelopers
Veraltet.Sets 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:
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_credit_section]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
developers
- the list of developers
-
setDocumenters
Veraltet.Sets 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:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:translator-credits]
* [method@AboutWindow.add_credit_section]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
documenters
- the list of documenters
-
setIssueUrl
Veraltet.Sets the issue tracker URL for @self.
The issue tracker link is displayed on the main page.- Parameter:
issue_url
- the issue tracker URL
-
setIssueUrl
Veraltet.Sets the issue tracker URL for @self.
The issue tracker link is displayed on the main page.- Parameter:
issue_url
- the issue tracker URL
-
setLicense
Veraltet.Sets the license for @self.
This can be used to set a custom text for the license if it can't be set via
[property@AboutWindow:license-type].
When set, [property@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.
[method@AboutWindow.add_legal_section] can be used to add license information
for the application dependencies or other components.- Parameter:
license
- the license
-
setLicense
Veraltet.Sets the license for @self.
This can be used to set a custom text for the license if it can't be set via
[property@AboutWindow:license-type].
When set, [property@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.
[method@AboutWindow.add_legal_section] can be used to add license information
for the application dependencies or other components.- Parameter:
license
- the license
-
setLicenseType
Veraltet.Sets the license for @self from a list of known licenses.
If the application's license is not in the list,
[property@AboutWindow:license] can be used instead. The license type will be
automatically set to `GTK_LICENSE_CUSTOM` in that case.
If @license_type is `GTK_LICENSE_UNKNOWN`, no information will be displayed.
If @license_type is different from `GTK_LICENSE_CUSTOM`.
[property@AboutWindow:license] will be cleared out.
The license description will be displayed on the Legal page, below the
copyright information.
[method@AboutWindow.add_legal_section] can be used to add license information
for the application dependencies or other components.- Parameter:
license_type
- the license type
-
setReleaseNotes
Veraltet.Sets the release notes for @self.
Release notes are displayed on the the What's New page.
Release notes are formatted the same way as
[AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
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
[property@AboutWindow:release-notes-version] of the property will be used
as the version; otherwise, [property@AboutWindow:version] is used.- Parameter:
release_notes
- the release notes
-
setReleaseNotes
Veraltet.Sets the release notes for @self.
Release notes are displayed on the the What's New page.
Release notes are formatted the same way as
[AppStream descriptions](https://freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description).
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
[property@AboutWindow:release-notes-version] of the property will be used
as the version; otherwise, [property@AboutWindow:version] is used.- Parameter:
release_notes
- the release notes
-
setReleaseNotesVersion
Veraltet.Sets 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, [property@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 [property@AboutWindow:release-notes].- Parameter:
version
- the release notes version
-
setReleaseNotesVersion
Veraltet.Sets 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, [property@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 [property@AboutWindow:release-notes].- Parameter:
version
- the release notes version
-
setSupportUrl
Veraltet.Sets the URL of the support page for @self.
The support page link is displayed on the main page.- Parameter:
support_url
- the support page URL
-
setSupportUrl
Veraltet.Sets the URL of the support page for @self.
The support page link is displayed on the main page.- Parameter:
support_url
- the support page URL
-
setTranslatorCredits
Veraltet.Sets 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:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [method@AboutWindow.add_credit_section]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
translator_credits
- the translator credits
-
setTranslatorCredits
Veraltet.Sets 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:
* [property@AboutWindow:developers]
* [property@AboutWindow:designers]
* [property@AboutWindow:artists]
* [property@AboutWindow:documenters]
* [method@AboutWindow.add_credit_section]
* [method@AboutWindow.add_acknowledgement_section]- Parameter:
translator_credits
- the translator credits
-
setVersion
Veraltet.Sets the version for @self.
The version is displayed on the main page.
If [property@AboutWindow:release-notes-version] is not set, the version will
also be displayed above the release notes on the What's New page.- Parameter:
version
- the version
-
setVersion
Veraltet.Sets the version for @self.
The version is displayed on the main page.
If [property@AboutWindow:release-notes-version] is not set, the version will
also be displayed above the release notes on the What's New page.- Parameter:
version
- the version
-
setWebsite
Veraltet.Sets the application website URL for @self.
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 [method@AboutWindow.add_link].- Parameter:
website
- the website URL
-
setWebsite
Veraltet.Sets the application website URL for @self.
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 [method@AboutWindow.add_link].- Parameter:
website
- the website URL
-
onActivateLink
Connect to signal "activate-link".
SeeAboutWindow.OnActivateLink.onActivateLink(ch.bailu.gtk.type.Str)
for signal description.
FieldSIGNAL_ON_ACTIVATE_LINK
contains original signal name and can be used as resource reference.- Parameter:
signal
- callback function (lambda).- Gibt zurück:
SignalHandler
. Can be used to disconnect signal and to release callback function.
-
asAccessible
Implements interfaceAccessible
. Call this to get access to interface functions.- Setzt außer Kraft:
asAccessible
in KlasseWindow
- Gibt zurück:
Accessible
-
asBuildable
Implements interfaceBuildable
. Call this to get access to interface functions.- Setzt außer Kraft:
asBuildable
in KlasseWindow
- Gibt zurück:
Buildable
-
asConstraintTarget
Implements interfaceConstraintTarget
. Call this to get access to interface functions.- Setzt außer Kraft:
asConstraintTarget
in KlasseWindow
- Gibt zurück:
ConstraintTarget
-
asNative
Implements interfaceNative
. Call this to get access to interface functions. -
asRoot
Implements interfaceRoot
. Call this to get access to interface functions. -
asShortcutManager
Implements interfaceShortcutManager
. Call this to get access to interface functions.- Setzt außer Kraft:
asShortcutManager
in KlasseWindow
- Gibt zurück:
ShortcutManager
-
getTypeID
public static long getTypeID() -
getParentTypeID
public static long getParentTypeID() -
getTypeSize
-
getParentTypeSize
-
getInstanceSize
public static int getInstanceSize()
-