FirstWindow Variable (ROM Call 0x0)

wingraph.h

WINDOW *FirstWindow;

A pointer to the head of the list of all windows.

FirstWindow is a pointer to the first window in the linked list of all created windows. By starting from FirstWindow and tracking the Next field of a WINDOW structure pointed to by it, it is possible to access to all created windows (the last one is the window which Next field is equal to NULL).

Note: Under normal conditions, FirstWindow points to the Home screen window, which is defined as a window without a border, which occupies the space between the toolbar menu and the command input line. When this is just a window which you want to use in your program, you can pass FirstWindow as a parameter to any window routine (although DeskTop is probably a better choice). And, by changing a structure pointed to by FirstWindow, it is possible to make Home screen "larger" or "smaller", or to perform similar "dirty" tricks. See EV_registerMenu for a dirty example.


Used by: WinActivate, WinOpen, WinRemove, WinReOpen, EV_paintOneWindow, MO_notifyModeChange, UpdateWindows