[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
MSETCLIP()
Define an inclusion region
------------------------------------------------------------------------------
Syntax
MSETCLIP([<nCoord list>], [<nMode>])
Arguments
<nCoord List> contains the coordinates of the inclusion region which
is represented as a comma-separated list of four coordinates whose
interpretation differs depending on mode. If <nMode> is LLM_COOR_TEXT,
the coordinates look like this: <nTop>, <nLeft>, <nBottom>, <nRight>.
If <nMode> is LLM_COOR_GRAPH, the coordinates are <nX1>, <nY1>, <nX2>,
<nY2>.
<nMode> is one of the following two constants:
Coordinate Type Constants
------------------------------------------------------------------------
Constant Description
------------------------------------------------------------------------
LLM_COOR_TEXT Specifies that the coordinates are given in lines and
columns of text
LLM_COOR_GRAPH Specifies that the coordinates are given in pixels
------------------------------------------------------------------------
Returns
MSETCLIP() returns an array of coordinate information. The coordinates
of the inclusion area are given in pixels and then in row/col format:
aRegions := {nIncX1, nIncY1, nIncX2, nIncY2,;
nIncR1, nIncC1, nIncR2, nIncC2,;
nCoorType}
Description
MSETCLIP() controls mouse pointer movements. It allows you to restrict
movement to a region. When an inclusion is defined and the user tries
to move the mouse pointer out of the rectangle, it remains stuck at the
edge of the area, but is still visible. This mode should be used to
restrict the range of user choices for moving or clicking the mouse.
Notes
The inclusion area is initialized to be the entire screen. To eliminate
an inclusion region you just pass the value LLM_INCLUDE as the first
parameter or pass the four parameters for maximum screen values 0, 0,
MAXCOL(), MAXROW().
Examples
. This example shows how the MSETCLIP() function works:
// Define an inclusion region and save the current
// inclusion region in the array aOldInc
aOldInc := MSETCLIP(5, 5, 20, 75,LLM_COOR_TEXT)
// Code for selecting objects and buttons
// Restore old inclusion region
MSETCLIP(aOldInc[5],;
aOldInc[6],;
aOldInc[7],;
aOldInc[8],;
LLG_VIDEO_TEXT)
Files Library is LLIBG.LIB, header file is Llibg.ch.
See Also:
MHIDE()
MSETCURSOR()
MSHOW()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson