QuickWin Function: Returns the size and position of a window.
Module: USE IFQWIN
Syntax
result = GETWSIZEQQ (unit, ireq, winfo)
unit
(Input) INTEGER(4). Specifies the window unit. Unit numbers 0, 5 and 6 refer to the default startup window only if you have not explicitly opened them with the OPEN statement. To access information about the frame window (as opposed to a child window), set unit to the symbolic constant QWIN$FRAMEWINDOW, defined in IFQWIN.F90
.
ireq
(Input) INTEGER(4). Specifies what information is obtained. The following symbolic constants, defined in IFQWIN.F90
, are available:
winfo
(Output) Derived type qwinfo
. Physical coordinates of the window's upper-left corner, and the current or maximum height and width of the window's client area (the area within the frame). The derived type qwinfo
is defined in IFQWIN.F90
as follows:
TYPE QWINFO
INTEGER(2) TYPE ! request type (controls
! SETWSIZEQQ)
INTEGER(2) X ! x coordinate for upper left
INTEGER(2) Y ! y coordinate for upper left
INTEGER(2) H ! window height
INTEGER(2) W ! window width
END TYPE QWINFO
Results
The result type is INTEGER(4). The result is zero if successful; otherwise, nonzero.
The position and dimensions of child windows are expressed in units of character height and width. The position and dimensions of the frame window are expressed in screen pixels.
The height and width returned for a frame window reflects the size in pixels of the client area excluding any borders, menus, and status bar at the bottom of the frame window. You should adjust the values used in SETWSIZEQQ to take this into account.
The client area is the area actually available to place child windows.
Compatibility
QUICKWIN GRAPHICS LIB
See Also: GETWINDOWCONFIG, SETWSIZEQQ, Building Applications: Using QuickWin Overview, Building Applications: Controlling Size and Position of Windows