forked from AuroraMiddleware/gtk
ede3c39918
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.
372 lines
5.1 KiB
Plaintext
372 lines
5.1 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkAboutDialog
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Display information about an application
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
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()
|
|
and gtk_about_dialog_set_url_hook().
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GTK_STOCK_ABOUT
|
|
</para>
|
|
|
|
<!-- ##### STRUCT GtkAboutDialog ##### -->
|
|
<para>
|
|
The <structname>GtkAboutDialog</structname> struct contains
|
|
only private fields and should not be directly accessed.
|
|
</para>
|
|
|
|
|
|
<!-- ##### 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>
|
|
|
|
<!-- ##### ARG GtkAboutDialog:logo-icon-name ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### 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>
|
|
|
|
<!-- ##### 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:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_get_artists ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@about:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_artists ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@about:
|
|
@artists:
|
|
|
|
|
|
<!-- ##### 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:
|
|
|
|
|
|
<!-- ##### USER_FUNCTION GtkAboutDialogActivateLinkFunc ##### -->
|
|
<para>
|
|
The type of a function which is called when a URL or email
|
|
link is activated.
|
|
</para>
|
|
|
|
@about: the #GtkAboutDialog in which the link was activated
|
|
@link: the URL or email address to whiche the activated link points
|
|
@data:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_email_hook ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@func:
|
|
@data:
|
|
@destroy:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_about_dialog_set_url_hook ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@func:
|
|
@data:
|
|
@destroy:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_show_about_dialog ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@parent:
|
|
@first_property_name:
|
|
@Varargs:
|
|
|
|
|