gnome-window

Name

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

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.