:right-sidebar: True

AboutDialog
===================================================================

.. currentmodule:: gi.repository.Adw


.. versionadded:: 1.5




.. class:: AboutDialog(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Adw.Dialog`, :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`



A dialog showing information about the application.

.. image:: https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/about-dialog.png

an about dialog is typically opened when the user activates the ``About …``
item in the application's primary menu. All parts of the dialog are optional.

Main page
--------------------------------------------------------------------------------

``AdwAboutDialog`` prominently displays the application's icon, name, developer
name and version. They can be set with the :obj:`~gi.repository.Adw.AboutDialog.props.application_icon`\,
:obj:`~gi.repository.Adw.AboutDialog.props.application_name`\,
:obj:`~gi.repository.Adw.AboutDialog.props.developer_name` and :obj:`~gi.repository.Adw.AboutDialog.props.version`
respectively.

What's New
--------------------------------------------------------------------------------

``AdwAboutDialog`` provides a way for applications to display their release
notes, set with the :obj:`~gi.repository.Adw.AboutDialog.props.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 :obj:`~gi.repository.Adw.AboutDialog.props.version`\. Use
:obj:`~gi.repository.Adw.AboutDialog.props.release_notes_version` to override it.

Details
--------------------------------------------------------------------------------

The Details page displays the application comments and links.

The comments can be set with the :obj:`~gi.repository.Adw.AboutDialog.props.comments` property.
Unlike :obj:`~gi.repository.Gtk.AboutDialog.props.comments`\, this string can be long and
detailed. It can also contain links and Pango markup.

To set the application website, use :obj:`~gi.repository.Adw.AboutDialog.props.website`\.
To add extra links below the website, use :obj:`~gi.repository.AboutDialog.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
--------------------------------------------------------------------------------

``AdwAboutDialog`` displays the following two links on the main page:

- Support Questions, set with the :obj:`~gi.repository.Adw.AboutDialog.props.support_url` property,
- Report an Issue, set with the :obj:`~gi.repository.Adw.AboutDialog.props.issue_url` property.


Additionally, applications can provide debugging information. It will be
shown separately on the Troubleshooting page. Use the
:obj:`~gi.repository.Adw.AboutDialog.props.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.

``AdwAboutDialog`` provides a quick way to save debug information to a file.
When saving, :obj:`~gi.repository.Adw.AboutDialog.props.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 :obj:`~gi.repository.Adw.AboutDialog.props.developers` property,
- Designers, set with the :obj:`~gi.repository.Adw.AboutDialog.props.designers` property,
- Artists, set with the :obj:`~gi.repository.Adw.AboutDialog.props.artists` property,
- Documenters, set with the :obj:`~gi.repository.Adw.AboutDialog.props.documenters` property,
- Translators, set with the :obj:`~gi.repository.Adw.AboutDialog.props.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 :obj:`~gi.repository.AboutDialog.add_credit_section` to add them.

The Acknowledgements page can be used to acknowledge additional people and
organizations for their non-development contributions. Use
:obj:`~gi.repository.AboutDialog.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``\:

.. image:: https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/about-dialog-credits.png

Legal
--------------------------------------------------------------------------------

The Legal page displays the copyright and licensing information for the
application and other modules.

The copyright string is set with the :obj:`~gi.repository.Adw.AboutDialog.props.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 :obj:`~gi.repository.Adw.AboutDialog.props.license_type` property. If the application's
license is not in the list, :obj:`~gi.repository.Adw.AboutDialog.props.license` can be used
instead.

To add information about other modules, such as application dependencies or
data, use :obj:`~gi.repository.AboutDialog.add_legal_section`\.

Constructing
--------------------------------------------------------------------------------

To make constructing an ``AdwAboutDialog`` as convenient as possible, you can
use the function :obj:`~gi.repository.Adw.show_about_dialog` which constructs and shows a
dialog.


.. code-block:: c
    :dedent:

    static void
    show_about (GtkApplication *app)
    {
      const char *developers[] = {
        "Angela Avery",
        NULL
      };

      const char *designers[] = {
        "GNOME Design Team",
        NULL
      };

      adw_show_about_dialog (GTK_WIDGET (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
--------------------------------------------------------------------------------

``AdwAboutDialog`` has a main CSS node with the name ``dialog`` and the
style class ``.about``\.


Constructors
------------

.. rst-class:: interim-class

.. class:: AboutDialog
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Adw.Dialog

      Creates a new ``AdwAboutDialog``\.


      .. versionadded:: 1.5








   .. classmethod:: new_from_appdata(resource_path: str, release_notes_version: str | None = None) -> ~gi.repository.Adw.Dialog

      Creates a new ``AdwAboutDialog`` using AppStream metadata.

      This automatically sets the following properties with the following AppStream
      values:

      - :obj:`~gi.repository.Adw.AboutDialog.props.application_icon` is set from the ``<id>``
      - :obj:`~gi.repository.Adw.AboutDialog.props.application_name` is set from the ``<name>``
      - :obj:`~gi.repository.Adw.AboutDialog.props.developer_name` is set from the ``<name>`` within
           ``<developer>``
      - :obj:`~gi.repository.Adw.AboutDialog.props.version` is set from the version of the latest release
      - :obj:`~gi.repository.Adw.AboutDialog.props.website` is set from the ``<url type="homepage">``
      - :obj:`~gi.repository.Adw.AboutDialog.props.support_url` is set from the ``<url type="help">``
      - :obj:`~gi.repository.Adw.AboutDialog.props.issue_url` is set from the ``<url type="bugtracker">``
      - :obj:`~gi.repository.Adw.AboutDialog.props.license_type` is set from the ``<project_license>``\.
          If the license type retrieved from AppStream is not listed in
          :obj:`~gi.repository.Gtk.License`\, it will be set to ``GTK_LICENCE_CUSTOM``\.


      If ``release_notes_version`` is not ``NULL``\,
      :obj:`~gi.repository.Adw.AboutDialog.props.release_notes_version` is set to match it, while
      :obj:`~gi.repository.Adw.AboutDialog.props.release_notes` is set from the AppStream release
      description for that version.


      .. versionadded:: 1.5





      :param resource_path: The resource to use

      :param release_notes_version: The version to retrieve release notes for








Methods
-------

.. rst-class:: interim-class

.. class:: AboutDialog
   :no-index:


   .. method:: add_acknowledgement_section(name: str | None, people: list[str]) -> None

      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:

      - :obj:`~gi.repository.Adw.AboutDialog.props.developers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.designers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.artists`
      - :obj:`~gi.repository.Adw.AboutDialog.props.documenters`
      - :obj:`~gi.repository.Adw.AboutDialog.props.translator_credits`
      - :obj:`~gi.repository.AboutDialog.add_credit_section`


      .. versionadded:: 1.5





      :param name: the section name

      :param people: the list of names




   .. method:: add_credit_section(name: str | None, people: list[str]) -> None

      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:

      - :obj:`~gi.repository.Adw.AboutDialog.props.developers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.designers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.artists`
      - :obj:`~gi.repository.Adw.AboutDialog.props.documenters`
      - :obj:`~gi.repository.Adw.AboutDialog.props.translator_credits`
      - :obj:`~gi.repository.AboutDialog.add_acknowledgement_section`


      .. versionadded:: 1.5





      :param name: the section name

      :param people: the list of names




   .. method:: add_legal_section(title: str, copyright: str | None, license_type: ~gi.repository.Gtk.License, license: str | None = None) -> None

      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 :obj:`~gi.repository.Adw.AboutDialog.props.copyright`\,
      :obj:`~gi.repository.Adw.AboutDialog.props.license_type` and :obj:`~gi.repository.Adw.AboutDialog.props.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:


      .. code-block:: c
          :dedent:

          adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
                                              _("Copyright and a known license"),
                                              "© 2022 Example",
                                              GTK_LICENSE_LGPL_2_1,
                                              NULL);

          adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
                                              _("Copyright and custom license"),
                                              "© 2022 Example",
                                              GTK_LICENSE_CUSTOM,
                                              "Custom license text");

          adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
                                              _("Copyright only"),
                                              "© 2022 Example",
                                              GTK_LICENSE_UNKNOWN,
                                              NULL);

          adw_about_dialog_add_legal_section (ADW_ABOUT_DIALOG (about),
                                              _("Custom license only"),
                                              NULL,
                                              GTK_LICENSE_CUSTOM,
                                              "Something completely custom here.");


      .. versionadded:: 1.5





      :param title: the name of the section

      :param copyright: a copyright string

      :param license_type: the type of license

      :param license: custom license information




   .. method:: add_link(title: str, url: str) -> None

      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 :obj:`~gi.repository.Adw.AboutDialog.props.website`\.


      .. versionadded:: 1.5





      :param title: the link title

      :param url: the link URL




   .. method:: get_application_icon() -> str

      Gets the name of the application icon for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_application_name() -> str

      Gets the application name for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_artists() -> list[str] | None

      Gets the list of artists of the application.


      .. versionadded:: 1.5








   .. method:: get_comments() -> str

      Gets the comments about the application.


      .. versionadded:: 1.5








   .. method:: get_copyright() -> str

      Gets the copyright information for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_debug_info() -> str

      Gets the debug information for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_debug_info_filename() -> str

      Gets the debug information filename for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_designers() -> list[str] | None

      Gets the list of designers of the application.


      .. versionadded:: 1.5








   .. method:: get_developer_name() -> str

      Gets the developer name for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_developers() -> list[str] | None

      Gets the list of developers of the application.


      .. versionadded:: 1.5








   .. method:: get_documenters() -> list[str] | None

      Gets the list of documenters of the application.


      .. versionadded:: 1.5








   .. method:: get_issue_url() -> str

      Gets the issue tracker URL for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_license() -> str

      Gets the license for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_license_type() -> ~gi.repository.Gtk.License

      Gets the license type for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_release_notes() -> str

      Gets the release notes for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_release_notes_version() -> str

      Gets the version described by the application's release notes.


      .. versionadded:: 1.5








   .. method:: get_support_url() -> str

      Gets the URL of the support page for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_translator_credits() -> str

      Gets the translator credits string.


      .. versionadded:: 1.5








   .. method:: get_version() -> str

      Gets the version for ``self``\.


      .. versionadded:: 1.5








   .. method:: get_website() -> str

      Gets the application website URL for ``self``\.


      .. versionadded:: 1.5








   .. method:: set_application_icon(application_icon: str) -> None

      Sets the name of the application icon for ``self``\.

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


      .. versionadded:: 1.5





      :param application_icon: the application icon name




   .. method:: set_application_name(application_name: str) -> None

      Sets the application name for ``self``\.

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


      .. versionadded:: 1.5





      :param application_name: the application name




   .. method:: set_artists(artists: list[str] | None = None) -> None

      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:

      - :obj:`~gi.repository.Adw.AboutDialog.props.developers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.designers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.documenters`
      - :obj:`~gi.repository.Adw.AboutDialog.props.translator_credits`
      - :obj:`~gi.repository.AboutDialog.add_credit_section`
      - :obj:`~gi.repository.AboutDialog.add_acknowledgement_section`


      .. versionadded:: 1.5





      :param artists: the list of artists




   .. method:: set_comments(comments: str) -> None

      Sets the comments about the application.

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

      Unlike :obj:`~gi.repository.Gtk.AboutDialog.props.comments`\, this string can be long and
      detailed. It can also contain links and Pango markup.


      .. versionadded:: 1.5





      :param comments: the comments




   .. method:: set_copyright(copyright: str) -> None

      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.

      :obj:`~gi.repository.AboutDialog.add_legal_section` can be used to add copyright
      information for the application dependencies or other components.


      .. versionadded:: 1.5





      :param copyright: the copyright information




   .. method:: set_debug_info(debug_info: str) -> None

      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.

      ``AdwAboutDialog`` provides a quick way to save debug information to a file.
      When saving, :obj:`~gi.repository.Adw.AboutDialog.props.debug_info_filename` would be used as
      the suggested filename.

      Debug information cannot contain markup or links.


      .. versionadded:: 1.5





      :param debug_info: the debug information




   .. method:: set_debug_info_filename(filename: str) -> None

      Sets the debug information filename for ``self``\.

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

      See :obj:`~gi.repository.Adw.AboutDialog.props.debug_info`\.


      .. versionadded:: 1.5





      :param filename: the debug info filename




   .. method:: set_designers(designers: list[str] | None = None) -> None

      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:

      - :obj:`~gi.repository.Adw.AboutDialog.props.developers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.artists`
      - :obj:`~gi.repository.Adw.AboutDialog.props.documenters`
      - :obj:`~gi.repository.Adw.AboutDialog.props.translator_credits`
      - :obj:`~gi.repository.AboutDialog.add_credit_section`
      - :obj:`~gi.repository.AboutDialog.add_acknowledgement_section`


      .. versionadded:: 1.5





      :param designers: the list of designers




   .. method:: set_developer_name(developer_name: str) -> None

      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 :obj:`~gi.repository.Adw.AboutDialog.props.developers` and related properties.


      .. versionadded:: 1.5





      :param developer_name: the developer name




   .. method:: set_developers(developers: list[str] | None = None) -> None

      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:

      - :obj:`~gi.repository.Adw.AboutDialog.props.designers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.artists`
      - :obj:`~gi.repository.Adw.AboutDialog.props.documenters`
      - :obj:`~gi.repository.Adw.AboutDialog.props.translator_credits`
      - :obj:`~gi.repository.AboutDialog.add_credit_section`
      - :obj:`~gi.repository.AboutDialog.add_acknowledgement_section`


      .. versionadded:: 1.5





      :param developers: the list of developers




   .. method:: set_documenters(documenters: list[str] | None = None) -> None

      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:

      - :obj:`~gi.repository.Adw.AboutDialog.props.developers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.designers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.artists`
      - :obj:`~gi.repository.Adw.AboutDialog.props.translator_credits`
      - :obj:`~gi.repository.AboutDialog.add_credit_section`
      - :obj:`~gi.repository.AboutDialog.add_acknowledgement_section`


      .. versionadded:: 1.5





      :param documenters: the list of documenters




   .. method:: set_issue_url(issue_url: str) -> None

      Sets the issue tracker URL for ``self``\.

      The issue tracker link is displayed on the main page.


      .. versionadded:: 1.5





      :param issue_url: the issue tracker URL




   .. method:: set_license(license: str) -> None

      Sets the license for ``self``\.

      This can be used to set a custom text for the license if it can't be set via
      :obj:`~gi.repository.Adw.AboutDialog.props.license_type`\.

      When set, :obj:`~gi.repository.Adw.AboutDialog.props.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.

      :obj:`~gi.repository.AboutDialog.add_legal_section` can be used to add license information
      for the application dependencies or other components.


      .. versionadded:: 1.5





      :param license: the license




   .. method:: set_license_type(license_type: ~gi.repository.Gtk.License) -> None

      Sets the license for ``self`` from a list of known licenses.

      If the application's license is not in the list,
      :obj:`~gi.repository.Adw.AboutDialog.props.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``\.
      :obj:`~gi.repository.Adw.AboutDialog.props.license` will be cleared out.

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

      :obj:`~gi.repository.AboutDialog.add_legal_section` can be used to add license information
      for the application dependencies or other components.


      .. versionadded:: 1.5





      :param license_type: the license type




   .. method:: set_release_notes(release_notes: str) -> None

      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.

      ``AdwAboutDialog`` displays the version above the release notes. If set, the
      :obj:`~gi.repository.Adw.AboutDialog.props.release_notes_version` of the property will be used
      as the version; otherwise, :obj:`~gi.repository.Adw.AboutDialog.props.version` is used.


      .. versionadded:: 1.5





      :param release_notes: the release notes




   .. method:: set_release_notes_version(version: str) -> None

      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, :obj:`~gi.repository.Adw.AboutDialog.props.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 :obj:`~gi.repository.Adw.AboutDialog.props.release_notes`\.


      .. versionadded:: 1.5





      :param version: the release notes version




   .. method:: set_support_url(support_url: str) -> None

      Sets the URL of the support page for ``self``\.

      The support page link is displayed on the main page.


      .. versionadded:: 1.5





      :param support_url: the support page URL




   .. method:: set_translator_credits(translator_credits: str) -> None

      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:

      - :obj:`~gi.repository.Adw.AboutDialog.props.developers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.designers`
      - :obj:`~gi.repository.Adw.AboutDialog.props.artists`
      - :obj:`~gi.repository.Adw.AboutDialog.props.documenters`
      - :obj:`~gi.repository.AboutDialog.add_credit_section`
      - :obj:`~gi.repository.AboutDialog.add_acknowledgement_section`


      .. versionadded:: 1.5





      :param translator_credits: the translator credits




   .. method:: set_version(version: str) -> None

      Sets the version for ``self``\.

      The version is displayed on the main page.

      If :obj:`~gi.repository.Adw.AboutDialog.props.release_notes_version` is not set, the version will
      also be displayed above the release notes on the What's New page.


      .. versionadded:: 1.5





      :param version: the version




   .. method:: set_website(website: str) -> None

      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 :obj:`~gi.repository.AboutDialog.add_link`\.


      .. versionadded:: 1.5





      :param website: the website URL








Properties
----------

.. rst-class:: interim-class

.. class:: AboutDialog
   :no-index:
   

   .. attribute:: props.application_icon
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.application_name
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.artists
      :type: list[str]

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.comments
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.copyright
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.debug_info
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.debug_info_filename
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.designers
      :type: list[str]

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.developer_name
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.developers
      :type: list[str]

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.documenters
      :type: list[str]

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.issue_url
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.license
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.license_type
      :type: ~gi.repository.Gtk.License

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.release_notes
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.release_notes_version
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.support_url
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.translator_credits
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.version
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5





   .. attribute:: props.website
      :type: str

      The type of the None singleton.



      .. versionadded:: 1.5









Signals
-------

.. rst-class:: interim-class

.. class:: AboutDialog.signals
   :no-index:
   

   .. method:: activate_link(uri: str) -> bool

      The type of the None singleton.



      .. versionadded:: 1.5





      :param uri: the URI to activate