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

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.