DtWsmAddCurrentWorkspaceCallback(3)

     NAME
          DtWsmAddCurrentWorkspaceCallback - add a callback to be
          called when the current workspace changes

     SYNOPSIS
          #include <Dt/Wsm.h>

          DtWsmCBContext
          DtWsmAddCurrentWorkspaceCallback(Widget widget,
                                           DtWsmWsChangeProc ws_change,
                                           Pointer client_data);

     DESCRIPTION
          The DtWsmAddCurrentWorkspaceCallback() function registers an
          application function to be called when the CDE workspace
          manager, dtwm(1), switches to a new workspace.

          The workspace manager sends the new current workspace name
          to the DtWsmWsChangeProc callback.

          The widget argument is a realized widget.

          The ws_change argument is the procedure to be called when
          the workspace changes.

          The client_data argument points to arbitrary client data to
          be passed back to ws_change.

          The header defines the DtWsmWsChangeProc callback prototype
          as follows:

               typedef void (*DtWsmWsChangeProc)(Widget widget,
                                                 Atom aWorkspace,
                                                 Pointer client_data);

          The widget argument is the ID of the widget to be registered
          with the callback.

          The aWorkspace argument is the name of the new current
          workspace (converted to an X atom).

          The client_data argument points to the client data to be
          registered with the callback.

     RETURN VALUE
          Upon successful completion, the
          DtWsmAddCurrentWorkspaceCallback() function returns a
          workspace callback registration context.

     APPLICATION USAGE
          The DtWsmAddCurrentWorkspaceCallback() function returns a
          registration context that the application must save in order
          to remove this callback later.
          DtWsmAddCurrentWorkspaceCallback() requires a window; thus,
          a gadget is not acceptable for the widget argument.  The
          DtWsmRemoveWorkspaceCallback(3) function needs a
          registration context to remove the callback.

     SEE ALSO
          DtWsm(5), dtwm(1), DtWsmRemoveWorkspaceCallback(3).