DtWsmChangeBackdrop(API)												  DtWsmChangeBackdrop(API)

NAME

       DtWsmChangeBackdrop -- 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 for-
       mat (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 ALSO

       DtWsm(5)

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

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

															  DtWsmChangeBackdrop(API)