1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>Migrating from GnomeAbout to GtkAboutDialog</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
8
<link rel="up" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
9
<link rel="prev" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
10
<link rel="next" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
14
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
15
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
30
<link rel="chapter" href="Printing.html" title="Printing">
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
37
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
48
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
49
<link rel="glossary" href="glossary.html" title="Glossary">
50
<link rel="index" href="ix01.html" title="Index">
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
60
<td><a accesskey="p" href="gtk-migrating-GtkIconView.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
61
<td><a accesskey="u" href="migrating.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
62
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
63
<th width="100%" align="center">GTK+ Reference Manual</th>
64
<td><a accesskey="n" href="gtk-migrating-GtkColorButton.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
66
<div class="chapter" lang="en">
67
<div class="titlepage"><div><div><h2 class="title">
68
<a name="gtk-migrating-GtkAboutDialog"></a>Migrating from GnomeAbout to GtkAboutDialog</h2></div></div></div>
70
Since version 2.6, GTK+ provides the <a href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> widget as a replacement for
71
the <span class="structname">GnomeAbout</span> dialog in the libgnomeui library.
74
<a href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> supports all features found in <span class="structname">GnomeAbout</span>.
75
The <span class="structname">GtkAboutDialog</span> API is bigger, since it follows
76
the GTK+ policy to have getters and setters for all widget properties,
77
but it isn't much more complex than <span class="structname">GnomeAbout</span>.
80
To convert an application that uses <span class="structname">GnomeAbout</span> to
81
<span class="structname">GtkAboutDialog</span>, as a first step, replace calls
84
<div class="informalexample"><pre class="programlisting">
85
const gchar *documentors[] = {
91
const gchar *documentors[] = {
97
GtkWidget *about = gnome_about_new ("GNOME Test Program", VERSION,
98
"(C) 1998-2001 The Free Software Foundation",
99
"Program to display GNOME functions.",
102
_("translator-credits"),
108
<div class="informalexample"><pre class="programlisting">
109
GdkPixbuf *logo = gdk_pixbuf_new_from_file ("logo.png", NULL);
110
GtkWidget *about = g_object_new (GTK_TYPE_ABOUT_DIALOG,
111
"name", "GNOME Test Program",
113
"copyright", "(C) 1998-2001 The Free Software Foundation",
114
"comments", "Program to display GNOME functions.",
116
"documenters", documenters,
117
"translator-credits", _("translator-credits"),
120
g_object_unref (pixbuf);
123
If the <code class="function">g_object_new()</code> construction scares you, you can also use
124
<a href="GtkAboutDialog.html#gtk-about-dialog-new"><code class="function">gtk_about_dialog_new()</code></a> to construct the dialog and then use the setters for
125
the individual properties.
128
Once you are done with the initial conversion, you may want to look into
129
using some of the features of <span class="structname">GtkAboutDialog</span>
130
which are not present in <span class="structname">GnomeAbout</span>.
132
<div class="itemizedlist"><ul type="disc">
134
You can specify license information with the
135
<a href="GtkAboutDialog.html#GtkAboutDialog--license">license</a> property
138
You can add separate credits for artists with the
139
<a href="GtkAboutDialog.html#GtkAboutDialog--artists">artists</a> property
142
You can add a pointer to the website of your application, using the
143
<a href="GtkAboutDialog.html#GtkAboutDialog--website">website</a> and
144
<a href="GtkAboutDialog.html#GtkAboutDialog--website-label">website-label</a>
148
If your credits contain email addresses or URLs, you can turn them
149
into clickable links using <a href="GtkAboutDialog.html#gtk-about-dialog-set-email-hook"><code class="function">gtk_about_dialog_set_email_hook()</code></a> and
150
<a href="GtkAboutDialog.html#gtk-about-dialog-set-url-hook"><code class="function">gtk_about_dialog_set_url_hook()</code></a>.