DtWsmSetCurrentWorUNIXcSystem V (1 AugDtWsmSetCurrentWorkspace(3)
NAME
DtWsmSetCurrentWorkspace - set the current workspace
SYNOPSIS
#include <Dt/Wsm.h>
Status DtWsmSetCurrentWorkspace(Widget widget,
Atom aWorkspace);
DESCRIPTION
The DtWsmSetCurrentWorkspace() function works with the CDE
workspace manager, dtwm(1), and sets the current workspace.
Applications can use this function to switch from the
current workspace to another workspace.
The widget argument is a realized widget on the screen of
interest.
The aWorkspace argument is the name (in X atom form) of the
workspace to be made current.
RETURN VALUE
Upon successful completion, the DtWsmSetCurrentWorkspace()
function returns Success; otherwise, it returns a value not
equal to Success.
APPLICATION USAGE
If the DtWsmSetCurrentWorkspace() function is not
successful, the most likely reason for failure is that the
CDE workspace manager, dtwm(1), is not running. The
DtWsmSetCurrentWorkspace() function requires a widget. A
gadget is not acceptable for the widget argument.
DtWsmSetCurrentWorkspace() sends a message to the CDE
workspace manager, dtwm(1), to switch workspaces. If the
workspace name is not valid, no action is taken and the
workspace manager reports no error.
SEE ALSO
DtWsm(5), dtwm(1), DtWsmGetCurrentWorkspace(3).
Page 1 (printed 9/3/04)