DtWsmChangeBackdrop(API)DtWsmChangeBackdrop(API)NAMEDtWsmChangeBackdrop — set current workspace's backdrop
SYNOPSIS
#include <Dt/Wsm.h>
int DtWsmChangeBackdrop(
Display *display,
Window root,
char *path,
Pixmap pixmap);
DESCRIPTION
The DtWsmChangeBackdrop function works with the CDE workspace manager,
dtwm(1), and changes the current workspace's backdrop. Applications can
use this function to implement an interface to the workspace manager.
If the DtWsmChangeBackdrop function is not successful, the most likely
reason for failure is that the CDE workspace manager, dtwm(1), is not
running.
DtWsmChangeBackdrop sends a message to the CDE workspace manager,
dtwm(1), to change the backdrop.
The path argument points to a backdrop file name. The file must be in
either X Bitmap file format (with extension .bm) or Pixmap file format
(with extension .pm). The workspace management services look for the
file along the same path used for searching icons. The directory
/usr/dt/backdrops is the default directory if the file cannot be found
along the icon search path.
ARGUMENTS
display display
root root window of the screen
path file path to bitmap file
pixmap pixmap ID of backdrop pixmap
SEE ALSODtWsm(5)
"Communicating with the Workspace Manager" section in the CDE Program‐
mer's Guide
"Workspace Manager" section in the CDE Programmer's Overview
DtWsmChangeBackdrop(API)