1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gnome-window</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GNOME UI Library Reference Manual">
<link rel="up" href="deprecated.html" title="Deprecated Modules">
<link rel="prev" href="libgnomeui-GnomeThemeFile.html" title="GnomeThemeFile">
<link rel="next" href="libgnomeui-gnome-window-icon.html" title="gnome-window-icon">
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="pt01.html" title="Part I. GNOME UI Library (libgnomeui)">
<link rel="chapter" href="initialization.html" title="Initialization and Session Management">
<link rel="chapter" href="application-mgmt.html" title="Application Management">
<link rel="chapter" href="druids.html" title="Druids">
<link rel="chapter" href="fixme.html" title="Miscellaneous Widgets">
<link rel="chapter" href="miscellaneous.html" title="Miscellaneous Utility Functions and Macros">
<link rel="chapter" href="deprecated.html" title="Deprecated Modules">
<link rel="chapter" href="libgnomeui-objects.html" title="Object Hierarchy">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
<link rel="index" href="ix09.html" title="Index of new symbols in 2.14">
<link rel="index" href="ix10.html" title="Index of new symbols in 2.16">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libgnomeui-GnomeThemeFile.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="deprecated.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GNOME UI Library Reference Manual</th>
<td><a accesskey="n" href="libgnomeui-gnome-window-icon.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2808731" class="shortcut">Top</a>
 | 
<a href="#id2808792" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libgnomeui-gnome-window"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2808731"></a><span class="refentrytitle">gnome-window</span>
</h2>
<p>gnome-window — Convenience functions for setting window attributes.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <libgnomeui/libgnomeui.h>
void <a href="libgnomeui-gnome-window.html#gnome-window-toplevel-set-title">gnome_window_toplevel_set_title</a> (GtkWindow *window,
const gchar *doc_name,
const gchar *app_name,
const gchar *extension);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2808792"></a><h2>Description</h2>
<p>
This module is a convenience wrapper for some similar functions in GTK+. This
allows all GNOME applications to have a consistent way of setting their window
and dialog titles. It is possible that in the future, a configurable way of
setting window titles may be added.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2808811"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2808821"></a><h3>
<a name="gnome-window-toplevel-set-title"></a>gnome_window_toplevel_set_title ()</h3>
<a class="indexterm" name="id2808837"></a><pre class="programlisting">void gnome_window_toplevel_set_title (GtkWindow *window,
const gchar *doc_name,
const gchar *app_name,
const gchar *extension);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_window_toplevel_set_title</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set the title of a toplevel window. This is done by appending the
window-specific name (less the extension, if any) to the application name.
So it appears as "<appname> : <docname>".
</p>
<p>
This parameters to this function are appopriate in that it identifies
application windows as containing certain files that are being worked on at
the time (for example, a word processor file, a spreadsheet or an image).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>window</code></em> :</span></td>
<td> A pointer to the toplevel window.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>doc_name</code></em> :</span></td>
<td> The window-specific name.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>app_name</code></em> :</span></td>
<td> The application name.
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>extension</code></em> :</span></td>
<td> The default extension that the application uses. <a
href="../liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if there
is not a default extension.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>
|
