hpux man page for dtwsmsetcurrentworkspace

Query: dtwsmsetcurrentworkspace

OS: hpux

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

DtWsmSetCurrentWorkspace(library call)									    DtWsmSetCurrentWorkspace(library call)

NAME
DtWsmSetCurrentWorkspace -- set the current workspace
SYNOPSIS
#include <Dt/Wsm.h> int 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
Dt/Wsm.h - DtWsm(5), dtwm(1), DtWsmGetCurrentWorkspace(3). DtWsmSetCurrentWorkspace(library call)
Related Man Pages
update-gap-workspace(1) - debian
dtwsmaddcurrentworkspacecallback(3) - hpux
dtwsmgetworkspacelist(3) - hpux
dtwsmremoveworkspacefunctions(3) - hpux
dtwsm(5) - hpux
Similar Topics in the Unix Linux Community
Running a script from CDE...
automating CDE X applications from boot
change wallpaper in CDE
11.0 fresh install: I never see CDE Login
Change value in a file using perl or shell script