DtWsmGetCurrentBackdropWindow(3)

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).