NAME [Toc] [Back]
DtWsmDeleteWorkspace - delete a specific workspace
SYNOPSIS [Toc] [Back]
DESCRIPTION [Toc] [Back]
The DtWsmDeleteWorkspace() function works with the CDE workspace
manager, dtwm(1), and deletes a specific workspace. Applications can
use this function to implement an interface to the workspace manager.
If the DtWsmDeleteWorkspace() function is not successful, the most
likely reason for failure is that the CDE workspace manager, dtwm(1),
is not running. The DtWsmDeleteWorkspace() function requires a widget.
A gadget (or unrealized widget) is not acceptable for the widget
DtWsmDeleteWorkspace() sends a message to the CDE workspace manager,
dtwm(1), to delete the workspace. If the workspace name is not valid,
no action is taken and the workspace manager reports no error.
ARGUMENTS [Toc] [Back]
widget a realized widget
workspace the name of the workspace (in X atom form) to delete
RETURN VALUE [Toc] [Back]
The function returns Success (0) when it succeeds, and non-zero when
it fails. Note that these are not the same values
SEE ALSO [Toc] [Back]
"Communicating with the Workspace Manager" section in the CDE
"Workspace Manager" section in the CDE Programmer's Overview
- 1 - Formatted: January 24, 2005 [ Back ]