Window Operations for OS/2 Graphics - MIT/GNU Scheme 7.7.91
Description: MIT/GNU Scheme 7.7.91

Next: Event Operations for OS/2 Graphics, Previous: Color Operations for OS/2 Graphics, Up: OS/2 Graphics

#### 17.11.3 Window Operations for OS/2 Graphics

These operations control the window that contains the OS/2 graphics device. They provide facilities to change the window's size and position; to raise and lower the window relative to other windows on the desktop; to hide or minimize the window, and to restore it from the hidden or minimized state; to activate or deactivate the window (that is, control the keyboard focus); and to control the text that appears in the window's title bar.

— operation on os2-graphics-device: window-position

> This operation returns the position of the graphics-device window on the desktop. The position is returned as two values (see Continuations), which are the x and y coordinates of the position. These coordinates are in units of pels (pixels), and measure the distance between the lower left hand corner of the desktop and the lower left hand corner of the graphics device window's frame.

— operation on os2-graphics-device: set-window-position x y

> The graphics-device window is moved to the screen position specified by x and y. The coordinates x and y are in units of pels (pixels), and measure the distance between the lower left hand corner of the desktop and the lower left hand corner of the graphics device window's frame.

— operation on os2-graphics-device: window-size

> This operation returns the size of the client area of the graphics-device window. The client area is the part of the window that you draw on; it does not include the window frame, title bar, etc. The size is returned as two values (see Continuations), which are the width and height of the client area in units of pels (pixels).

— operation on os2-graphics-device: set-window-size width height

> This operation sets the size of the client area of the graphics-device window to the specified width and height, which are in units of pels (pixels). The client area is the part of the window that you draw on; it does not include the window frame, title bar, etc.

— operation on os2-graphics-device: window-frame-size

> This operation returns the size of the graphics-device window's frame. This includes the client area, as well as the border, title bar, etc. The size is returned as two values (see Continuations), which are the width and height of the frame in units of pels (pixels).

> The frame size is useful in conjunction with the window position and the desktop size to determine relative placement of the window or to guarantee that the entire window is visible on the desktop.

— operation on os2-graphics-device: desktop-size

> This operation returns the size of the OS/2 desktop. The size is returned as two values (see Continuations), which are the width and height of the frame in units of pels (pixels).

— operation on os2-graphics-device: raise-window

> This operation raises the graphics-device window so that it is on top of any other windows on the desktop.

— operation on os2-graphics-device: lower-window

> This operation lowers the graphics-device window so that it is below all other windows on the desktop.

— operation on os2-graphics-device: hide-window

> This operation hides the graphics-device window. The window disappears from the desktop, but still appears in the window list.

— operation on os2-graphics-device: minimize-window

> This operation minimizes the graphics-device window. The window disappears from the desktop, but still appears in the window list. Depending on how you have configured your desktop, the window may appear as an icon, either on the desktop or in the minimized window viewer.

— operation on os2-graphics-device: maximize-window

> This operation maximizes the graphics-device window. This causes the window to fill the entire desktop.

— operation on os2-graphics-device: restore-window

> This operation restores the graphics-device window to its normal state. If the window is hidden or minimized, it is shown again, at its former position on the desktop. If the window is maximized, it is returned to its normal size.

— operation on os2-graphics-device: activate-window

> This operation makes the graphics-device window be the active window. This causes the window to be put in front of all other windows on the desktop, highlights its frame, and gives it the keyboard focus.

— operation on os2-graphics-device: deactivate-window

> This operation deactivates the graphics-device window if it was active (otherwise it has no effect). This causes some other window to be chosen to be active in its place.

— operation on os2-graphics-device: set-window-title title

> This operation changes the text that appears in the graphics device window's title bar. The new text is given by title, which must be a string.