give_iconifyxywh()

NAME

give_iconifyxywh - give a valid position where iconify a window.

PROTOTYPAGE

void give_iconifyxywh( int *x, int *y, int *w, int *h);

PARAMETRES

x,y,w,h: position and size of the icon window.

DESCRIPTION

This function can be used if one want iconify artificially a window. The function give valid parameters for WindSet() with the WF_ICONIFY mode :

     	{
     		int x,y,w,h;
     		give_iconify( win, &x, &y, &w, &h);
     		WindSet( win, WF_ICONFY, x, y, w, h;
     	}

Depending the OS, the way to compute the iconify position is different:

• with AES older then 4.1, WinDom uses its own icon position. Icon placement is local to the application.

• if cookie 'ICFS' is present, WinDom uses the iconify server to place the icon on the screen, thus icon placement is global.

• with system handling iconify (AES >= 4.1, MagiC), give_iconifyxywh() returns special values (-1 for each component). These values, given to WindSet(WF_ICONIFY), forces the screen manager to place itself the icon.

With PlainTOS, it is not necessary to have an iconify mechanism because EvntWindom() offers to the user to iconify a window when the smaller widget is not present (by shift-clicking the closer widget).