DtWsmSetWorkspaceTitle(API)											       DtWsmSetWorkspaceTitle(API)

NAME

       DtWsmSetWorkspaceTitle -- set workspace title

SYNOPSIS

       #include <Dt/Wsm.h>
       int DtWsmSetWorkspaceTitle(
       Widget widget,
       Atom workspace,
       char *title);

DESCRIPTION

       The DtWsmSetWorkspaceTitle() function works with the CDE workspace manager, dtwm(1), and changes a specific workspace's title. Applications
       can use this function to implement an interface to the workspace manager.

       If the DtWsmSetWorkspaceTitle() function is not successful, the most likely reason for failure is that the CDE workspace manager,  dtwm(1),
       is  not running.  The DtWsmSetWorkspaceTitle() function requires a widget. A gadget (or unrealized widget) is not acceptable for the widget
       argument.

       DtWsmSetWorkspaceTitle() sends a message to the CDE workspace manager, dtwm(1), to set the title. If the workspace name is  not	valid,	no
       action is taken and the workspace manager reports no error.

ARGUMENTS

       widget	 A realized widget on the screen of interest

       workspace The name of the workspace (in X atom form) where the title should be set

       title	 The new title

RETURN VALUE

       The  function  returns  Success	(0)  when it succeeds, and non-zero upon failure.  Note that these are not the same values that _DtWsmSet-
       WorkspaceTitle returns.

SEE ALSO

       DtWsm(5)

       "Communicating with the Workspace Manager" section in the CDE Programmer's Guide

       "Workspace Manager" section in the CDE Programmer's Overview

														       DtWsmSetWorkspaceTitle(API)