<refentry id="libgnomeui-gnome-window">
<refmeta>
<refentrytitle role="top_of_page" id="libgnomeui-gnome-window.top_of_page">gnome-window</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>gnome-window</refname>
<refpurpose>Convenience functions for setting window attributes.</refpurpose>
</refnamediv>

<refsynopsisdiv id="libgnomeui-gnome-window.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;libgnomeui/libgnomeui.h&gt;

<link linkend="void">void</link>                <link linkend="gnome-window-toplevel-set-title">gnome_window_toplevel_set_title</link>     (<link linkend="GtkWindow">GtkWindow</link> *window,
                                                         const <link linkend="gchar">gchar</link> *doc_name,
                                                         const <link linkend="gchar">gchar</link> *app_name,
                                                         const <link linkend="gchar">gchar</link> *extension);
</synopsis>
</refsynopsisdiv>









<refsect1 id="libgnomeui-gnome-window.description" role="desc">
<title role="desc.title">Description</title>
<para>
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.
</para>
</refsect1>

<refsect1 id="libgnomeui-gnome-window.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="gnome-window-toplevel-set-title" role="function" condition="deprecated:">
<title>gnome_window_toplevel_set_title ()</title>
<indexterm zone="gnome-window-toplevel-set-title" role="deprecated"><primary sortas="gnome_window_toplevel_set_title">gnome_window_toplevel_set_title</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_window_toplevel_set_title     (<link linkend="GtkWindow">GtkWindow</link> *window,
                                                         const <link linkend="gchar">gchar</link> *doc_name,
                                                         const <link linkend="gchar">gchar</link> *app_name,
                                                         const <link linkend="gchar">gchar</link> *extension);</programlisting>
<warning><para><literal>gnome_window_toplevel_set_title</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
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 "&lt;appname&gt; : &lt;docname&gt;".
</para>
<para>
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).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>window</parameter>&#160;:</term>
<listitem><simpara> A pointer to the toplevel window.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>doc_name</parameter>&#160;:</term>
<listitem><simpara> The window-specific name.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>app_name</parameter>&#160;:</term>
<listitem><simpara> The application name.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>extension</parameter>&#160;:</term>
<listitem><simpara> The default extension that the application uses. <link linkend="NULL--CAPS"><literal>NULL</literal></link> if there
is not a default extension.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
