GETWSIZEQQ

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

Module: USE DFLIB

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 DFLIB.F90 in the \DF98\INCLUDE subdirectory.

ireq
(Input) INTEGER(4). Specifies what information is obtained. The following symbolic constants, defined in DFLIB.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 DFLIB.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 is of type 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, Using QuickWin