Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

GETWSIZEQQ

QuickWin Function: Returns the size and position of a window. This routine is only available for Windows.

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 qwinfois 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.