# GETWSIZEQQ (W*S)

QuickWin Function: Returns the size and position of a window.

## Module

USE IFQWIN

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: QWIN$SIZEMAX - Gets information about the maximum window size. QWIN$SIZECURR - Gets information about the current window size.
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.

Parent topic: QuickWin Library Routines

## See Also

GETWINDOWCONFIG
SETWSIZEQQ