2004-07-12 17:03:06 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkAboutDialog
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2004-10-16 02:55:23 +00:00
|
|
|
Display information about an application
|
2004-07-12 17:03:06 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2004-07-13 06:02:24 +00:00
|
|
|
The #GtkAboutDialog offers a simple way to display information about
|
|
|
|
a program like its logo, name, copyright, website and license. It is
|
|
|
|
also possible to give credits to the authors, documenters, translators
|
|
|
|
and artists who have worked on the program. An about dialog is typically
|
|
|
|
opened when the user selects the <literal>About</literal> option from
|
|
|
|
the <literal>Help</literal> menu. All parts of the dialog are optional.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
About dialog often contain links and email addresses. #GtkAboutDialog
|
|
|
|
supports this by offering global hooks, which are called when the user
|
|
|
|
clicks on a link or email address, see gtk_about_dialog_set_email_hook()
|
2004-11-04 15:23:48 +00:00
|
|
|
and gtk_about_dialog_set_url_hook(). Email addresses in the
|
|
|
|
authors, documenters and artists properties are recognized by looking for
|
2004-11-05 06:07:44 +00:00
|
|
|
<literal><user@<!-- -->host></literal>, URLs are
|
2004-11-04 15:32:14 +00:00
|
|
|
recognized by looking for <literal>http://url</literal>, with
|
|
|
|
<literal>url</literal> extending to the next space, tab or line break.
|
2004-07-12 17:03:06 +00:00
|
|
|
</para>
|
2004-11-01 20:14:15 +00:00
|
|
|
<para>
|
|
|
|
To make constructing a #GtkAboutDialog as convenient as possible, you can
|
|
|
|
use the function gtk_show_about_dialog() which constructs and shows a dialog
|
|
|
|
and keeps it around so that it can be shown again.
|
|
|
|
</para>
|
2004-07-12 17:03:06 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2004-07-13 06:02:24 +00:00
|
|
|
#GTK_STOCK_ABOUT
|
2004-07-12 17:03:06 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkAboutDialog ##### -->
|
|
|
|
<para>
|
2004-07-13 06:02:24 +00:00
|
|
|
The <structname>GtkAboutDialog</structname> struct contains
|
|
|
|
only private fields and should not be directly accessed.
|
2004-07-12 17:03:06 +00:00
|
|
|
</para>
|
|
|
|
|
2004-10-24 07:05:00 +00:00
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:artists ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:authors ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:comments ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:copyright ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:documenters ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:license ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:logo ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
Rework of GtkFileChooserButton, some cleanups. Fixes #154388, #154390,
2004-10-25 James M. Cape <jcape@ignore-your.tv>
Rework of GtkFileChooserButton, some cleanups. Fixes #154388,
#154390, #154390, #156272.
* docs/reference/gtk/gtk-docs.sgml: Moved GtkFileChooserButton
below GtkFileChooser.
* docs/reference/gtk/gtk-sections.txt: Added
gtk_file_chooser_button_get_width_chars(),
gtk_file_chooser_button_set_width_chars(),
gtk_label_set_width_chars(), gtk_label_get_width_chars().
* docs/reference/gtk/gtk.types: Added
gtk_cell_renderer_combo_get_type,
gtk_cell_view_get_type,
gtk_text_iter_get_type.
* docs/reference/gtk/tmpl/gtkaboutdialog.sgml: Add
"logo-icon-name" property.
* docs/reference/gtk/tmpl/gtkcellview.sgml: Updates for
properties
(b/c of get_type() inclusion above).
* docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml:
* docs/reference/gtk/tmpl/gtklabel.sgml: Add "width-chars"
property,
getters/setters.
* docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml: Added.
* gtk/gtkentrycompletion.c:
(_gtk_entry_completion_popdown): Don't show if the entry isn't
mapped.
* gtk/gtkfilechooserbutton.[c,h]: (*): About 45%
rewritten, adds "width-chars" property, icons, working save
modes, volume/Home/Desktop friendly-naming support.
* gtk/gtklabel.[c,h]:
(gtk_label_class_init), (gtk_label_init),
(gtk_label_get_property), (gtk_label_set_property),
(gtk_label_get_width_chars), (gtk_label_set_width_chars),
(gtk_label_size_request): Add "width-chars" property.
* tests/testfilechooserbutton.c: Update, use 4 different buttons
for the different ACTIONs.
* gtk/.cvsignore: Ignore gtk-update-icon-cache.
* tests/.cvsignore: Ignore testimage.
2004-10-26 04:29:56 +00:00
|
|
|
<!-- ##### ARG GtkAboutDialog:logo-icon-name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2004-10-24 07:05:00 +00:00
|
|
|
<!-- ##### ARG GtkAboutDialog:name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:translator-credits ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:version ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:website ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:website-label ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkAboutDialog:link-color ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
2004-07-12 17:03:06 +00:00
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@name:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_version ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_version ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@version:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_copyright ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_copyright ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@copyright:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_comments ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_comments ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@comments:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_license ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_license ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@license:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_website ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_website ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@website:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_website_label ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_website_label ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@website_label:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_authors ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_authors ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@authors:
|
|
|
|
|
|
|
|
|
2004-08-01 05:55:01 +00:00
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_artists ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_artists ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@artists:
|
|
|
|
|
|
|
|
|
2004-07-12 17:03:06 +00:00
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_documenters ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_documenters ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@documenters:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_translator_credits ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_translator_credits ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@translator_credits:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_logo ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_logo ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@logo:
|
|
|
|
|
|
|
|
|
2004-11-01 20:14:15 +00:00
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_logo_icon_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_logo_icon_name ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@about:
|
|
|
|
@icon_name:
|
|
|
|
|
|
|
|
|
2004-07-12 17:03:06 +00:00
|
|
|
<!-- ##### USER_FUNCTION GtkAboutDialogActivateLinkFunc ##### -->
|
|
|
|
<para>
|
2004-07-13 06:02:24 +00:00
|
|
|
The type of a function which is called when a URL or email
|
|
|
|
link is activated.
|
2004-07-12 17:03:06 +00:00
|
|
|
</para>
|
|
|
|
|
2004-07-13 06:02:24 +00:00
|
|
|
@about: the #GtkAboutDialog in which the link was activated
|
|
|
|
@link: the URL or email address to whiche the activated link points
|
2004-08-25 16:21:15 +00:00
|
|
|
@data:
|
2004-07-12 17:03:06 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_email_hook ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@func:
|
2004-08-25 16:21:15 +00:00
|
|
|
@data:
|
|
|
|
@destroy:
|
2004-07-12 17:03:06 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_url_hook ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@func:
|
2004-08-25 16:21:15 +00:00
|
|
|
@data:
|
|
|
|
@destroy:
|
2004-07-12 17:03:06 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_show_about_dialog ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@parent:
|
|
|
|
@first_property_name:
|
|
|
|
@Varargs:
|
|
|
|
|
|
|
|
|