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 _DtWsmSetWorkspaceTitle returns.

NAME

SYNOPSIS

DESCRIPTION

ARGUMENTS

RETURN VALUE

SEE ALSO