MoveWindow(), SizeWindow(), WindowToFront() and WindowToBack() allow the program to modify the size and placement of its windows. These calls are available in all versions of the operating system. MoveWindowInFrontOf(), ChangeWindowBox() and ZipWindow() have been added in Release 2 to provide more flexible control over the size and placement of windows. All of these functions are asynchronous. The window will not be affected by them immediately, rather, Intuition will act on the request the next time it receives an input event. Currently this happens at a minimum rate of ten times per second, and a maximum of sixty times per second. There is no guarantee that the operation has taken place when the function returns. In some cases, there are IDCMP messages which will inform the application when the change has completed (for example, an IDCMP_NEWSIZE event indicates that a resize operation has completed). Use the MoveWindow() function to move a window to a new position in the screen. Use SizeWindow() to change the size of the window: void MoveWindow( struct Window *window, long dx, long dy ); void SizeWindow( struct Window *window, long dx, long dy ); Note that both MoveWindow() and SizeWindow() take the amount of change in each axis (delta values instead of absolute coordinates). To specify the coordinates as absolute numbers, use ChangeWindowBox(). The SizeWindow() function will respect the window's maximum and minimum dimensions only if the window has a sizing gadget. A new function in Release 2, ChangeWindowBox(), allows an application to change the window size and position in a single call: void ChangeWindowBox( struct Window *window, long left, long top, long width, long height ); Note that the position and size values are absolutes and not deltas. The window's maximum and minimum dimensions are always respected. To depth arrange windows under program control, use WindowToFront() and WindowToBack(): void WindowToFront( struct Window *window ); void WindowToBack( struct Window *window ); WindowToFront() depth arranges a given window in front of all other windows on its screen. WindowToBack() depth arranges a given window behind all other windows on its screen. To move a window in front of a specific, given window (as opposed to all windows), use MoveWindowInFrontOf(): void MoveWindowInFrontOf( struct Window *window, struct Window *behindWindow ); MoveWindowInFrontOf() is a new call provided in Release 2 and is not available in older versions of the OS. To toggle the window size between its two zoom settings use ZipWindow(). This performs the same action that occurs when the user selects the zoom gadget: void ZipWindow( struct Window *window ); The two zoom settings are the initial size and position of the window when it was first opened and the alternate position specified with the WA_Zoom tag. If no WA_Zoom tag is provided, the alternate position is taken from the window's minimum dimensions, unless the window was opened at its minimum dimension. In that case, the alternate position is taken from the window's maximum dimension. ZipWindow() is a new call provided in Release 2 and is not available in older versions of the OS.
[Back to Amiga Developer Docs]