Programming guideline of WinDom

The WindGet()/WindSet() functions

As we said, WinDom uses iconification in the same way than AES. So the standard iconifier functions use the WindSet(), WindGet() functions. If you want to customize the way your windows are iconified, you have to use these two functions. The other cases or usually fully handled by the standard functions. Let's describe these functions.

          WindSet( win, WF_ICONIFY, x, y, w, h);

This call iconifies the window win at the position (x,y,w,h) on the screen. These coordinates are provided by the message WM_ICONIFY (or WM_UNICONIFY). If you want to iconify a window in response to another event, then AES doesn't provide you with an icon position. You can use the function

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

which provides you with an admissible position to iconify a window. When running under AES 4.1 (MultiTOS 1.1), there is no way to guess this position, so the function returns a constant position.

       WindSet( win, WF_UNICONIFY, x, y, w, h);

This function uniconifies an icon window standing at position (x,y,w,h). These four values are provided by the message WM_UNICONIFY or by the function WindGet( win, WF_UNICONIFY, &x, &y, &w, &h).

          WindSet( win, WF_UNICONIFYXYWH, x, y, w, h);

Sets the uniconified coordinates of an inconifed window. This call is useful when you create a window that is already iconified. Then you have to tell the system the uniconified coordinates of this window.

AES 4.1 does not implement the following calls. So WinDom emulates its (for a forward compatibility), the remark is true with the WF_BOTTOM message too).

          WindGet( win, WF_ICONIFY, &icon, &w, &h);

Gives informations about a window. The variable icon is zero if the window is not iconified and a diferent value else. w and h give the width and height of the icon. the standard value is 72x72. When WinDom controls the iconification, this size can be customized with app.wicon and app.hicon global variables.

          WindGet( win, WF_UNICONIFY, &x, &y, &w, &h):

gives the uniconified position of an icon window.

WinDom makes the difference between the name of the normal window and the name of the icon window. The WF_ICONTITLE mode of WindSet() sets the name of icon window:

		  static char[] = "Icon";
          WindSet( win, WF_ICONTITLE, icon_title);

If the icon title is not set, the same title is used for both normal and icon windows.