DtWsmAddWorkspace(API)                               DtWsmAddWorkspace(API)




 NAME    [Toc]    [Back]
      DtWsmAddWorkspace - add a workspace

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Wsm.h>
      int DtWsmAddWorkspace(
      Widget widget,
      char *title);

 DESCRIPTION    [Toc]    [Back]
      The DtWsmAddWorkspace() function works with the CDE workspace manager,
      dtwm(1), and adds a new workspace. Applications can use this function
      to implement an interface to the workspace manager.

      If the DtWsmAddWorkspace() function is not successful, the most likely
      reason for failure is that the CDE workspace manager, dtwm(1), is not
      running.

      DtWsmAddWorkspace() sends a message to the CDE workspace manager,
      dtwm(1), to add the workspace.

 ARGUMENTS    [Toc]    [Back]
      widget    a realized widget

      title     a user visible title for the new workspace

 RETURN VALUE    [Toc]    [Back]
      The function returns Success (0) when it succeeds, and non-zero upon
      failure.

 SEE ALSO    [Toc]    [Back]
      DtWsm(5)

      "Communicating with the Workspace Manager" section in the CDE
      Programmer's Guide

      "Workspace Manager" section in the CDE Programmer's Overview


                                    - 1 -       Formatted:  January 24, 2005