## gnome-window gnome-window — Convenience functions for setting window attributes. |

## Synopsis

    #include <libgnomeui/libgnomeui.h>

    void                gnome_window_toplevel_set_title     (GtkWindow *window,
                                                             const gchar *doc_name,
                                                             const gchar *app_name,
                                                             const gchar *extension);

## Description

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.

## Details

### gnome_window_toplevel_set_title ()

    void                gnome_window_toplevel_set_title     (GtkWindow *window,
                                                             const gchar *doc_name,
                                                             const gchar *app_name,
                                                             const gchar *extension);

### Warning

`gnome_window_toplevel_set_title` is deprecated and should not be used in newly-written code.

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>".

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).

`window` : | A pointer to the toplevel window.
`doc_name` : | The window-specific name.
`app_name` : | The application name.
`extension` : | The default extension that the application uses. `NULL` if there is not a default extension.