DtWsmGetCurrentBackdropWindows(3)

DtWsmGetCurrentBackdropWindow - get the backdrop window for the current workspace

As shipped in IRIX 6.5.30. Added in IRIX 6.5.19.

     NAME
          DtWsmGetCurrentBackdropWindow - get the backdrop window for
          the current workspace

     SYNOPSIS
          #include <Dt/Wsm.h>

          Window DtWsmGetCurrentBackdropWindow(Display *display,
                                               Window root);

     DESCRIPTION
          The DtWsmGetCurrentBackdropWindow() function works with the
          CDE workspace manager, dtwm(1), and returns the window used
          as the backdrop for the current workspace.

          The display argument is the X display.

          The root argument is the root window of the screen of
          interest.

     RETURN VALUE
          Upon successful completion, the
          DtWsmGetCurrentBackdropWindow() returns the window used as
          the backdrop for the current workspace.  The function
          returns None if there is no backdrop window for the
          workspace or if the CDE workspace manager is not running.

     APPLICATION USAGE
          If the DtWsmGetCurrentBackdropWindow() function is not
          successful, failure may be due to a memory allocation error
          or failure to find the correct workspace information (that
          is, the CDE workspace manager, dtwm(1), is not running).

     SEE ALSO
          DtWsm(5), dtwm(1), DtWsmGetCurrentWorkspace(3),
          DtWsmGetWorkspaceInfo(3).