Next: Event Operations for OS/2 Graphics, Previous: Color Operations for OS/2 Graphics, Up: 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.
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.
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.
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).
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.
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.
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).
This operation raises the graphics-device window so that it is on top of any other windows on the desktop.
This operation lowers the graphics-device window so that it is below all other windows on the desktop.
This operation hides the graphics-device window. The window disappears from the desktop, but still appears in the window list.
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.
This operation maximizes the graphics-device window. This causes the window to fill the entire desktop.
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.
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.