Volume 6A: Motif Programming Manual

the window we just created.

We use the image pixmap to set the window's background pixmap, which saves us the hassle of rendering it using

XCopyArea() or XCopyPlane(). If the shell widget already has an icon window,

XSetWindowBackgroundPixmap() is still called so that the specified image is displayed. The final call to

XClearWindow() causes the icon to be repainted. This call isn't necessary if the window has just been created, but

it is necessary if the window is merely updated with a new image.

The XmNiconX and XmNiconY resources can be used to set the position of the icon window on the screen.

However, you probably shouldn't set these resources arbitrarily without a really good reason. Most window managers

deal with positioning icon windows, or leave the positioning for the user to specify, so it is best not to interfere.

The XmNtitle and XmNiconName resources specify the titles used for the application window and the icon

window, respectively. These resources are set to regular character strings, not compound strings. These values are

typically both set to the name of the program, argv[0], by default. The values also affect the WM_NAME property for

the top−level window, which is important for session managers and other applications that monitor all top−level

windows on a desktop. These programs look for the WM_NAME property to provide menus or buttons that allow the

user to control the desktop in a GUI−like fashion, rather than through tty−like shells such as xterm and csh. It is best ...