window functions - continued

XgrCreateWindow  ( @window, @winType, xDisp, yDisp, width, height, winFunc, display$ )

XgrCreateWindow() creates and displays a new winType graphics window, and returns its window number in window, which will be no larger then the number of windows currently defined in the system. winType contains window type bits in the upper 16-bits and parent window in the low 16-bits. The low 16-bits are usually zero because most windows do not have a parent window. One exception is the pulldown list windows displayed by menu bars.

The location of the graphics window on the display can be requested by setting (xDisp,yDisp) to coordinates within the display boundaries. -1 for xDisp or yDisp specifies no preference for that axis. (xDisp,yDisp) values determines window placement to the extent supported by the window system.

If available from the window system, (xDisp,yDisp) are returned with the display coordinates of the upper left corner of the drawable area of the window - within the resize frame and title-bar.

(width,height) request the drawable size of the window in pixels. (width,height) determines the size of windows to the extent supported by the window system. Requests that extend a window beyond the limits of the display are generally not honored. If available from the window system, (width,height) are returned with the size of the drawable area of the window.

In systems where windows can be directed to more than one display, display$ is the name of the target display screen, like "max:0.0" . 

If the window system represents displays with numbers, display$ is a string form of the number, as in "32" or "0x4F7D192C" . 

disp$ = "" denotes the default display.

*** window type *** - *** characteristics ***

$$WindowTopMost - stays above other windows
$$WindowNoSelect - window is not selected by mouse button events
$$WindowNoFrame - window has no resize frame
$$WindowResizeFrame - window has a resize frame
$$WindowTitleBar - window has a title bar to display a window name
$$WindowSystemMenu - window has a system menu button
$$WindowMinimizeBox - window has a minimize button
$$WindowMaximizeBox - window has a maximize button

XgrDestroyWindow  ( window )

XgrDestroyWindow() destroys window after destroying its grids. window is then removed from the display and a WindowDestroyed message is added to the message queue. If window has child windows, they and their grids are destroyed and additional WindowDestroyed message is added to the message queue for each child window. All information about the window and its grids is permanently lost.

XgrDisplayWindow  ( window )

XgrDisplayWindow() displays window if it hidden or inconified, then selects window if it is not already selected.

Displaying window with XgrDisplayWindow() is the same as selecting window with XgrSetSelectedWindow() . window is selected and displayed above all others. The window argument of subsequent keyboard messages will be window . 

XgrGetWindowFunction  ( window, @func )

XgrGetWindowFunction() returns in func the address of the window function assigned to window . func is the address function called by XgrProcessMessages() when it processes messages for window or a grid in window .

XgrGetWindowIcon  ( window, @icon )

XgrGetWindowIcon() returns the image of the icon displayed for window when it is minimized.

XgrGetWindowPositionAndSize  ( window, @xDisp, @yDisp, @width, @height )

XgrGetWindowPositionAndSize() returns the display coordinates of window on the display in (xDisp,yDisp), and its (width,height) in pixels.

XgrGetWindowState  ( window, @state )

XgrGetWindowState() returns the current display state of window .

state=0,1,2,3 for hidden, displayed, minimized, maximized.

XgrGetWindowTitle  ( window, @title$ )

XgrGetWindowTitle() returns the title$ of window . title$ is displayed on the title-bar of windows with title-bars.

XgrHideWindow  ( window )

XgrHideWindow() makes window invisible until it is made visible again by XgrDisplayWindow() .