*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> DtWsmSetCurrentWorkspace (3)              


 DtWsmSetCurrentWorkspace(library call)DtWsmSetCurrentWorkspace(library call)

 NAME    [Toc]    [Back]
      DtWsmSetCurrentWorkspace - set the current workspace

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Wsm.h>
      int DtWsmSetCurrentWorkspace(
      Widget widget,
      Atom aWorkspace);

 DESCRIPTION    [Toc]    [Back]
      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

      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    [Toc]    [Back]
      Upon successful completion, the DtWsmSetCurrentWorkspace function
      returns Success; otherwise, it returns a value not equal to Success.

 APPLICATION USAGE    [Toc]    [Back]
      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    [Toc]    [Back]
      Dt/Wsm.h - DtWsm(5), dtwm(1), DtWsmGetCurrentWorkspace(3).

                                    - 1 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
DtWsmGetCurrentWorkspace HP-UX get the current workspace
DtWsmAddCurrentWorkspaceCallback HP-UX add a callback to be called when the current workspace changes
DtWsmGetCurrentBackdropWindow HP-UX get the backdrop window for the current workspace
DtWsmAddWorkspace HP-UX add a workspace
DtWsmSetWorkspaceTitle HP-UX set workspace title
DtWsmRemoveWorkspaceCallback HP-UX remove a workspace callback
DtWsmDeleteWorkspace HP-UX delete a specific workspace
DtWsmAddWorkspaceFunctions HP-UX add workspace functions for a window
DtWsmFreeWorkspaceInfo HP-UX free workspace information
DtWsm HP-UX workspace manager definitions
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service