nCode ASC(<cExp>) cChar CHR(<nCode>) cKeyLabel FKLABEL(<nFunctionKey>) nFunctionKeys FKMAX() nButStatus FT_MBUTPRS( <nButton> [, @nButPrs [, @nX [, @nY] ] ] ) nBStat FT_MBUTREL( nButton [, @nButRel [, @nX [, @nY] ] ]) FT_MCONOFF( <nTop>, <nLeft>, <nBottom>, <nRight> ) lCursorState FT_MCURSOR( [ <lState> ] ) lIsDoubleClk FT_MDBLCLK( [ <nClick> [, <nButton> [, <nInterval> [, <nRow> [, <nCol>; [, <nTime> ] ] ] ] ] ] ) NIL FT_MDEFCRS( <nCrsType>, <nScrMask>, <nCrsMask> ) nButtonStatus FT_MGETPOS( @<nX>, @<nY> ) <nPage> FT_MGETPAGE() nButtonStatus FT_MGETPOS( @<nX>, @<nY> ) NIL FT_MGETSENS( <@nHoriz>, <@nVert>, <@nDouble> ) nRowPos FT_MGETX() nColPos FT_MGETY() NIL FT_MHIDECRS() lMouseStatus FT_MINIT() lInRegion FT_MINREGION( <nT>, <nL>, <nB>, <nR> ) NIL FT_MMICKEYS( @<nX>, @<nY> ) nMouseStatus FT_MRESET() NIL FT_MSETPOS( <nX>, <nY> ) NIL FT_MSETPAGE( <@nPage> ) NIL FT_MSETPOS( <nX>, <nY> ) NIL FT_MSETSENS( <nHoriz>, <nVert>, <nDouble> ) NIL FT_MSHOWCRS() <nMajor> FT_MVERSION( <@nMinor>, <@nType>, <@nIRQ> ) NIL FT_MXLIMIT( <nX1>, <nX2> ) NIL FT_MYLIMIT( <nY1>, <nY2> ) cCode FT_SCANCODE() nInkeyCode INKEY([<nSeconds>] [,<nEventMask>]) nInkeyCode LASTKEY() nCurrentMouseColumn MCOL() nSpeed MDBLCLK([<nNewSpeed>]) NIL MHIDE() lIsPressed MLEFTDOWN() lIsPresent MPRESENT() NIL MRESTSTATE( <cSaveState> ) lIsPressed MRIGHTDOWN() nCurrentMouseRow MROW() cSaveState MSAVESTATE() NIL MSETBOUNDS( [<nTop>], [<nLeft>], [<nBottom>], [<nRight>] ) aRegions MSETCLIP([<nCoord list>], [<nMode>]) lIsVisible MSETCURSOR( [<lVisible>] ) NIL MSETPOS( <nRow>, <nCol> ) nOldCursorShape MSHOW([<nCol>, <nRow>, <nStyle>]) --> nOldCursorShape MSHOW([<nCursorShape>]) --> nOldCursorShape MSHOW([<nCursorShape>] | [<nCol>, <nRow>, <nMode>]) aState | 0 MSTATE() nInkeyCode NEXTKEY() bCurrentAction SETKEY(<nInkeyCode>, [<bAction>])
FKLABEL(<код клавиши>) --> символ
FKLABEL() является эмулирующей функцией, которая используется для замены функции FKLABEL() в dBASE III PLUS. Там ее назначение, вероятно, заключается в том, чтобы создавать возможность перехода к различным машинам, но ее применение для пользователя ограничено. Обычно использование этой функции в xClipper-программах не рекомендуется.
Имена функциональных клавиш имеют вид Fn, где n изменяется от 1 до 40 и задается как аргумент <код клавиши>, а имя функциональной клавиши возвращается в виде аргумента FKLABEL().
FKMAX() --> максимальное число функциональных клавиш
FKMAX() - это эмулирующая функция, используемая для замены функции FKMAX() в dBASE III PLUS. Там ее назначение, вероятно, заключается в том, чтобы создавать возможность перехода к различным машинам, но ее применение для пользователя ограничено.
Обычно использование этой функции в xClipper-программах не рекомендуется. Она просто возвращает константу 40, которую можно очень легко и более эффектно задать в программе в виде явной константы.
FT_MBUTPRS( <nButton> [, @nButPrs [, @nX [, @nY] ] ] ) --> nButStatus
Retrieves the mouse button status and the position of the cursor when a button was last pressed.
<nButton> | is the mouse button number: 0 - Left Button 1 - Right Button 2 - Middle Button [if applicable] |
<nButPrs> | is the number of times the specified button was pressed since the last call to this routine. PASSED BY REFERENCE. |
<nX> | is the X position of the cursor when the last press occurred. PASSED BY REFERENCE. |
<nY> | is the Y position of the cursor when the last press occurred. PASSED BY REFERENCE. |
Returns : | An integer representing the button status: 0 - no buttons pressed 1 - left button pressed 2 - right button pressed 3 - left and right pressed 4 - middle pressed 5 - left and middle pressed 6 - middle and right buttons pressed 7 - all 3 buttons pressed |
See also : | FT_MBUTREL() FT_MDBLCLK() |
FT_MBUTREL( nButton [, @nButRel [, @nX [, @nY] ] ]) --> nBStat
This function returns the release status of the mouse buttons and the coordinates of the last release.
<nButton> | is the mouse button number 0 - Left Button 1 - Right Button 2 - Middle Button [if applicable] |
<nButRel> | is the number of times the specified button was released since the last call to this routine. PASSED BY REFERENCE. |
<nX> | is the X position of the cursor when the last release occurred. PASSED BY REFERENCE. |
<nY> | is the Y position of the cursor when the last release occurred. PASSED BY REFERENCE. |
Returns : | <nBStat> - an integer representing button release status 0 - None 1 - Left 2 - Right 3 - Middle |
See also : | FT_MBUTPRS() FT_MDBLCLK() |
FT_MCONOFF( <nTop>, <nLeft>, <nBottom>, <nRight> )
This function tells the mouse driver to hide the cursor if it is in the given region. The driver hides the cursor by decrementing the cursor flag. A call to FT_MSHOWCRS is required to turn the cursor back on. Calling FT_MSHOWCRS also disables this function.
See FT_MSHOWCRS for a discussion of the cursor display flag.
<nTop> | , <nLeft> <nBottom> <nRight> are the four corners of the screen region in row and column coordinates. |
Returns : | NIL |
See also : | FT_MSHOWCRS() FT_MHIDECRS() FT_MXLIMIT() FT_MYLIMIT() FT_MINREGION() |
FT_MCURSOR( [ <lState> ] ) --> lCursorState
This function works like most Clipper state functions. If no value is sent to FT_MCURSOR() it will return the state of the mouse cursor.
FT_MDBLCLK( [ <nClick> [, <nButton> [, <nInterval> [, <nRow> [, <nCol>; [, <nTime> ] ] ] ] ] ] ) --> lIsDoubleClk
This is a mouse meta function that checks for the presence of a double click.
<nClick> | is a numeric value. If it is zero FT_MDBLCLK() will not check for the first press but rather will simply wait the specified period for a single press. This is useful if this routine is called from one which in turn responded to a button press. If it is not present or not equal to 0, then FT_MDBLCLK() will wait for two presses of the specified button. |
<nButton> | is the mouse button number 0 - Left Button 1 - Right Button 2 - Middle Button [if applicable] |
<nInterval> | is the interval to wait for the first click if requested and the time to wait for the second. If not present then defaults to 0.5 second. |
<nRow> | is the row number for the mouse cursor location for a double click to be valid. If not present then the current position is taken as the valid location. |
<nCol> | is the column number for the mouse cursor location for a double click to be valid. If not present, then the current position is taken as the valid location. |
<nTime> | is an optional start time for the waiting period for the first click (of either one or two requested). If not given then the time is set at entry into this routine. This is useful when this routine is called from another routine which was called in response to a mouse click but needs to know if a double click has occurred |
Returns : | .T. if a double click was detected. |
See also : | FT_MBUTPRS() FT_MBUTREL() |
FT_MDEFCRS( <nCrsType>, <nScrMask>, <nCrsMask> ) --> NIL
In text mode the mouse cursor can either be a software generated or the actual hardware cursor. This routine allows one choose between them. The software cursor is the default and its effect on the character it covers is determined by the screen mask and the cursor mask. Both of these masks are 16 bit values (which in Clipper are passed as standard numerical values). The 16 bit masks are arranged in a manner identical to the way information is stored for each character cell on the screen. The low order 8 bits represent the actual character displayed while the high order bits represent the display atributes such as blinking, intensity and forground and background colors. The mask is represented in the diagram below:
Bit: |15 |14 12|11 |10 8|7 0| Function:|blink |background|intensity|foreground|character|
Blinking and high intensity are on when the bit is 1. The background and foreground indicate which colors are used for each. The software mouse cursor uses these two values by taking the mask from the screen cell it is on and performing a logical AND on each bit with the screen mask value. The result is then logically XOR'ed with the cursor mask value. Thus to keep the character the same but invert the foreground and background colors the following values would be used:
Bit: |15 |14 12|11 |10 8|7 0| Function:|blink |background|intensity|foreground|character| screen: | 0 | 111 | 0 | 111 |11111111 | =30719 cursor: | 0 | 111 | 0 | 111 |00000000 | =30464
The hardware cursor is the text cursor provided by the video board. One specifies the range of scan lines which are on using <nScrMask> and <nCrsMask>. The range of values is dependant upon the type of monitor. The first scan line is 0.
<nCrsType> | is the cursor type. A value of 0 indicates the software cursor (the default) and a value of 1 indicates the hardware cursor. |
<nScrMask> | is the screen mask for the software cursor or the first scan line of the hardware cursor. See the description for more information. |
<nCrsMask> | is the cursor mask for the software cursor of the last scan line of the hardware cursor. See the description for more information. |
Returns : | NIL |
FT_MGETPOS( @<nX>, @<nY> ) --> nButtonStatus
Loads cursor position into x and y coordinates passed by reference and returns the button status.
<nX> | is a variable that will receive the mouse X position in text screen coordinates. It must be passed by reference. |
<nY> | is a variable that will receive the mouse Y position in text screen coordinates. It must be passed by reference. |
Returns : | an integer representing button status - 0 for no button pressed - 1 for left pressed - 2 for right pressed - 3 for left and right pressed - 4 for middle pressed - 5 for left and middle pressed - 6 for right and middle pressed - 7 for all three buttons pressed |
See also : | FT_MGETPOS() FT_MSETPOS() FT_MDEFCRS() FT_MGETX() FT_MGETY() |
FT_MGETPAGE() --> <nPage>
This function gets the display page for the mouse cursor. The valid values of nPage is dependent upon the display mode. See FT_SETVPG() for changing the current video page
Returns : | <nPage> is the display page on which the mouse is currently being displayed |
See also : | FT_MSETPAGE() |
FT_MGETPOS( @<nX>, @<nY> ) --> nButtonStatus
Loads cursor position into x and y coordinates passed by reference and returns the button status. The coordinate system in text mode has eight virtual coordinates per character cell. Thus x=16 means that you are in the Row 2. The values returned by this routine when in text mode and with mouse driver versions 6 and above are multiples of 8. We have experience with drivers prior to that version
<nX> | is a variable that will receive the mouse X position in virtual screen coordinates. It must be passed by reference. |
<nY> | is a variable that will receive the mouse Y position in virtual screen coordinates. It must be passed by reference. |
Returns : | an integer representing button status - 0 for no button pressed - 1 for left pressed - 2 for right pressed - 3 for left and right pressed - 4 for middle pressed - 5 for left and middle pressed - 6 for right and middle pressed - 7 for all three buttons pressed |
See also : | FT_MGETCOORD() FT_MSETPOS() FT_MDEFCRS() FT_MGETX() FT_MGETY() |
FT_MGETSENS( <@nHoriz>, <@nVert>, <@nDouble> ) --> NIL
This function returns the current values of the mouse movement sensitivity parameters. The first two arguments control the amount of movement necessary to move the cursor a given amount. The third argument determines the threshold above which the mouse moves at twice the normal speed. For further discussion of these values see FT_MSETSENS()
<nHoriz> | is the percentage of maximum horizontal sensitivity. PASSED BY REFERENCE. |
<nVert> | is the percentage of maximum vertical sensitivity. PASSED BY REFERENCE. |
<nDouble> | is the percentage of maximum sensitivity for doubling the mouse cursor's speed on the screen. PASSED BY REFERENCE. |
Returns : | NIL |
See also : | FT_MSETSENS() |
FT_MGETX() --> nRowPos
Retrieves mouse's row position in virtual screen coordinates. The values returned are multiples of 8 when in text mode and with at least Microsoft drivers 6 and above.
Returns : | <nRowPos> which is the row position of mouse in virtual screen coordinates. |
See also : | FT_MGETCOORD() FT_MDEFCRS() FT_MGETPOS() FT_MGETY() |
FT_MGETY() --> nColPos
Retrieves mouse's column position in virtual screen coordinates. The values returned are multiples of 8 when in text mode and with at least Microsoft drivers 6 and above.
Returns : | <nColPos> Column position of mouse in virtual screen coordinates |
See also : | FT_MGETCOORD() FT_MDEFCRS() FT_MGETPOS() FT_MGETX() |
FT_MHIDECRS() --> NIL
Hides the mouse cursor. Make sure to turn the mouse cursor off when redrawing screens. The mouse cursor dutifully saves the screen under it, so if you draw over the mouse cursor it will create a "hole" in your screen when you move the mouse cursor.
Note: A call to FT_MHIDECRS() decrements a mouse driver variable which indicates whether the cursor is shown. The cursor is visible only when the variable = 0. Thus multiple calls to FT_MHIDECRS() require an equal number of calls to FT_MSHOWCRS() before the cursor will again be visible. Once the variable is 0 calls to FT_MSHOWCRS() does not increment the varaible above 0.
Returns : | NIL |
See also : | FT_MSHOWCRS() FT_MCONOFF() |
FT_MINIT() --> lMouseStatus
Initializes the mouse drive, associated variables and returns mouse status. It checks to see if the mouse has been previously initialized and if so it does not reinitialize. The row and column limits of mouse movement is set to the maximum for the current video mode. Use FT_MSHOWCRS() to display the mouse cursor.
Returns : | An logical representing the mouse status (.F. == mouse not installed) |
See also : | FT_MRESET() |
FT_MINREGION( <nT>, <nL>, <nB>, <nR> ) --> lInRegion
This function will check to see if the mouse cursor is within the confines of the specified region.
<nT> | , <nL> <nB> <nR> are the four corners of the screen region. |
Returns : | .T. if mouse is in specified region. |
See also : | FT_MXLIMIT() FT_MYLIMIT() FT_MINREGION() |
FT_MMICKEYS( @<nX>, @<nY> ) --> NIL
<nX> and <nY> must be passed by reference to receive the mouse position in Mickeys.
FT_MRESET() --> nMouseStatus
Resets the mouse driver and returns mouse status. Use FT_MSHOWCRS() to display the mouse cursor. The mouse is set to allow it to cover the complete screen (as defined by MAXCOL() and MAXROW()). This is necessary because at least some versions of the mouse drivers do not operate according to the documentation when confronted with a 43 or 50 line screen.
Normally, FT_MINIT() should be used to initialize the mouse since it will not reinitialize if already done.
Returns : | An integer representing the mouse status (0 == mouse not installed) |
See also : | FT_MINIT() FT_MSHOWCRS() |
FT_MSETPOS( <nX>, <nY> ) --> NIL
Positions mouse cursor on screen using text (normal row and column) coordinates.
<nX> | is the desired mouse row. |
<nY> | is the desired mouse column. |
Returns : | NIL |
See also : | FT_MGETPOS() FT_MGETCOORD() FT_MSETPOS() FT_MDEFCRS() FT_MGETX() FT_MGETY() |
FT_MSETPAGE( <@nPage> ) --> NIL
This function sets the display page for the mouse cursor. The valid values of nPage is dependent upon the display mode. See FT_SETVPG() for changing the current video page
<nPage> | is the desired display page. |
Returns : | NIL |
See also : | FT_MGETPAGE() |
FT_MSETPOS( <nX>, <nY> ) --> NIL
Positions mouse cursor on screen. The virtual coordinate system in text mode has eight virtual coordinates per character cell. Thus x=16 means that you are in the Row 2.
<nX> | is the desired mouse row. |
<nY> | is the desired mouse column. |
Returns : | NIL |
See also : | FT_MGETPOS() FT_MGETCOORD() FT_MSETCOORD() FT_MGETX() FT_MGETY() |
FT_MSETSENS( <nHoriz>, <nVert>, <nDouble> ) --> NIL
This function allows one to control the mouse movement sensitivity. The first two arguments control the amount of movement necessary to move the cursor a given amount. The values are the percentage of full sensitivity and the default values after installing the mouse driver is 50 which represents approximately 3.2 inches of horizontal and 2 inches of vertical mouse movement to cover the entire screen. A value of 100 requires about 0.9 inches of horizontal mouse movement to cover the screen from one side to the other.
The third argument changes the threshold above which the mouse moves at twice the normal speed. The value is a percentage of full sensitivity with the default (50) providing doubling at 64 mickeys per second.
NOTE: These values are NOT restored after resetting the mouse driver/ hardware. A well behaved application should reset them to the original value upon exiting.
NOTE: The above description is counter to all of the documentation I have available. However, it does not work the way it is documented with Microsoft drivers versions 6.16, 6.24, 7.04 and 8.20. The above movement values are documented to be the number of mickeys per 8 pixels and the double speed value as the number mickeys per second required to double the speed. Each of these values should range from 1 to 32K but the driver forces a maximum of 100. Also the documentation states that resetting the mouse will reset these values. This is not the case.
<nHoriz> | is the sensitivity of the mouse on the horizontal axis. This value is the integer percentage of highest sensitivity and thus has a range of 1 to 100. The default value is 50 and at this setting about 3.2 inches of mouse movement will move the mouse cursor across the screen. If NIL, the current value is used. |
<nVert> | is the relative sensitivity of the mouse on the vertical axis. The value is an integer percentage of the highest sensitivity and thus has a range of 1 to 100. The default value is 50 and requires about 2 inches of mouse movement will move from top to bottom of the screen.If NIL, the current value is used. |
<nDouble> | is the relative sensitivity of the mouse to doubling the ratio of cursor movement to mouse movement. The default value is 50. If NIL, the current value is used. |
Returns : | NIL |
See also : | FT_MGETSENS() |
FT_MSHOWCRS() --> NIL
Displays the mouse cursor. Make sure to turn the mouse cursor off when redrawing screens. The mouse cursor dutifully saves the screen under it, so if you draw over the mouse cursor it will create a "hole" in your screen when you move the mouse cursor.
Note: A call to FT_MHIDECRS() decrements a mouse driver variable which indicates whether the cursor is shown. The cursor is visible only when the variable = 0. Thus multiple calls to FT_MHIDECRS() require an equal number of calls to FT_MSHOWCRS() before the cursor will again be visible. Once the variable is 0 calls to FT_MSHOWCRS() does not increment the variable above 0.
Returns : | NIL |
See also : | FT_MHIDECRS() FT_MCONOFF() |
FT_MVERSION( <@nMinor>, <@nType>, <@nIRQ> ) --> <nMajor>
This function returns the current values of the mouse driver version number and type. The major version would be 6 and the minor version would be 10 if the driver were version 6.10. The mouse type and IRQ numbers are also returned.
NOTE: It appears that the values reported when one starts the mouse driver actually have the minor version in hexadecimal! Thus on bootup my screen showed 6.24 but this routine returned 30 for the minor version number!
<nMinor> | is the Minor version number. PASSED BY REFERENCE. |
<nType> | is the Mouse type. PASSED BY REFERENCE. 1 = Bus Mouse 2 = Serial Mouse 3 = InPort Mouse 4 = PS/2 Mouse 5 = HP Mouse |
<nIRQ> | is the IRQ number used for the mouse. PASSED BY REFERENCE. 0 = PS/2 2,3,4,5 or 7 = IRQ number |
Returns : | <nMajor> which is the major version number of the mouse driver. |
See also : | FT_MSETSENS() |
FT_MXLIMIT( <nX1>, <nX2> ) --> NIL
Set maximum vertical bounds of mouse using virtual screen coordinates.
<nX1> | is the top row limit. |
<nX2> | is the bottom row limit. |
Returns : | NIL |
See also : | FT_MYLIMIT() FT_MINREGION() |
FT_MYLIMIT( <nY1>, <nY2> ) --> NIL
Set maximum horizontal bounds of mouse using virtual screen coordinates.
<nY1> | is the left column limit. |
<nY2> | is the right column limit. |
Returns : | NIL |
See also : | FT_MXLIMIT() FT_MINREGION() |
FT_SCANCODE() --> cCode
FT_SCANCODE() enables you to distinguish the different scancodes of similar keys (such as Grey minus versus regular minus), thus increasing the number of keys your input routine can recognize.
It works like INKEY(), in that it waits for a key to be pressed. The scan code consists of two bytes, which are returned as a two-character string.
For example, calling FT_SCANCODE() and pressing the Grey-minus key will return a two character string:
CHR(45) + CHR(74)
LASTKEY() is not updated by FT_SCANCODE(), so don't try to test LASTKEY() to see what was pressed during an FT_SCANCODE() call. Simply assign the return value to a variable and test that (see the test driver below).
* This was adapted from a short C routine posted by John Kaster on NANFORUM. It was written in Clipper to help demonstrate the FT_INT86 function of the Nanforum Toolkit.
This program requires FT_INT86().
INKEY([<время ожидания в секундах>] [,<маска событий>]) --> код клавиши
INKEY() - это функция работы с клавиатурой, которая выбирает код очередной клавиши из буфера клавиатуры и возвращает значение этого кода. Код этот, однако, запоминается и может быть прочитан с помощью функции LAST KEY(). Если задано ненулевое значение аргумента <время ожидания в секундах> и буфер пуст, то выполнение программы приостанавливается до тех пор, пока либо не будет нажата клавиша, либо не истечет заданное время ожидания. Время ожидания INKEY() определяется при помощи системного таймера и не зависит от скорости микропроцессора. Если аргумент <время ожидания в секундах> равен нулю, выполнение программы приостанавливается до тех пор, пока не будет нажата клавиша. Отметим, что INKEY() не переводит программу в состояние ожидания и поэтому в данной ситуации установки SET KEY не активны.
INKEY() подобна функции NEXTKEY(). Однако в отличие от INKEY() функция NEXTKEY() считывает, но не удаляет код клавиши из буфера клавиатуры. Это полезно, когда нужно проверить нажатие клавиши без ее обработки.
INKEY() - это основной примитив системы xClipper для получения кодов клавиш из буфера клавиатуры. Функция служит для опроса клавиатуры или приостановки исполнения программы, чтобы дождаться нажатия клавиши. Например, можно использовать INKEY(), чтобы завершить команды, работающие со списками, такие, как LIST, LABEL FORM и REPORT FORM, включая INKEY() в условие WHILE. Обратитесь к примеру ниже.
<время ожидания в секундах> | задает количество секунд, которое INKEY() ждет нажатия клавиши. Значение может быть задано с точностью до десятых долей секунды. Нулевое значение времени приостанавливает программу до тех пор, пока не будет нажата клавиша. Если аргумент |
<время ожидания в секундах> | опущен, то INKEY() не ждет нажатия клавиши. |
<маска событий> | определяет какие события обслуживать. Возможные значения или их комбинации: ------------------------------------------------------------------------ Constant Value Descripiton ------------------------------------------------------------------------ INKEY_MOVE 1 Mouse Events INKEY_LDOWN 2 Mouse Left Click Down INKEY_LUP 4 Mouse Left Click Up INKEY_RDOWN 8 Mouse Right Click Down INKEY_RUP 16 Mouse Right Click Up INKEY_KEYBOARD 128 Keyboard Events INKEY_ALL 159 All Mouse and Keyboard Events ------------------------------------------------------------------------ |
Returns : | INKEY() возвращает целое числовое значение в диапазоне от -39 до 386, идентифицируя клавишу, принятую из буфера клавиатуры или от 1001 до 1007 для событий мыши. Если буфер клавиатуры пуст, то INKEY() возвращает нуль. INKEY() возвращает значения для всех символов ASCII, функциональных клавиш, <Alt>-функциональных клавиш, <Ctrl>-функциональных клавиш и сочетаний клавиш <Alt>-буква и <Ctrl>-буква. |
See also : | CHR() LASTKEY() NEXTKEY() |
LASTKEY() --> INKEY-код.
LASTKEY() является функцией работы с клавиатурой, которая возвращает INKEY-код последней нажатой клавиши, вызванной из буфера клавиатуры функцией INKEY(), или в состоянии ожидания - командами ACCEPT, INPUT, READ, WAIT, ACHOICE(), DBEDIT() и функциями MEMOEDIT(). LASTKEY() сохраняет свое значение до тех пор, пока новая клавиша не будет считана из буфера клавиатуры.
В программах LASTKEY() может быть использована в следующих случаях:
Определение кода клавиши, использованной для прерывания READ.
Определения кода клавиши, использованной для выхода из текущего GET-объекта внутри функции пользователя, вызванной в предложении VALID.
Определения ключа выхода в функциях пользователя в ACHOICE(), DBEDIT() или MEMOEDIT().
LASTKEY() используется также в комбинации с UPDATED(), чтобы определить, изменялся ли какой-либо из буферов GET-объектов во время выполнения команды READ.
Функция LASTKEY() аналогична функциям NEXTKEY() и READKEY(). NEXTKEY() читает текущий введенный код клавиши в буфер клавиатуры без его удаления. NEXTKEY() используется вместо INKEY(), когда осуществляется выбор кода клавиши.
За полным списком INKEY-кодов и констант из файла описаний Inkey.ch следует обратиться к Приложению В.
MCOL() --> nCurrentMouseColumn
Returns : | MCOL() returns the mouse cursor's current screen column position. |
See also : | MROW() |
MHIDE() --> NIL
MHIDE() hides the mouse pointer. This function should be used together with MSHOW() when updating the screen. It is important to hide the mouse pointer before changing the screen display and then show it again after the change.
Note: The MSETCURSOR() function should be used in place of MSHOW() and MHIDE(). It is kept here for compatibility.
Returns : | MHIDE() always returns NIL. |
See also : | MSHOW() MSETCLIP() MSETCURSOR() |
MLEFTDOWN() --> lIsPressed
Returns : | MLEFTDOWN() returns true (.T.) if the left mouse button is currently pressed; otherwise, it returns false (.F.). |
See also : | MRIGHTDOWN() |
MRESTSTATE( <cSaveState> ) --> NIL
Returns : | MRESTSTATE() always returns NIL. |
See also : | MSAVESTATE() |
MRIGHTDOWN() --> lIsPressed
Returns : | MRIGHTDOWN() returns true (.T.) if the mouse's right button is currently pressed; otherwise, it returns false (.F.) . |
See also : | MLEFTDOWN() |
MROW() --> nCurrentMouseRow
Returns : | MROW() returns the mouse cursor's current screen row position. |
See also : | MCOL() |
MSAVESTATE() --> cSaveState
Returns : | MSAVESTATE() returns a character string that describes the mouse's current state. |
See also : | MRESTSTATE() |
MSETBOUNDS( [<nTop>], [<nLeft>], [<nBottom>], [<nRight>] ) --> NIL
<nTop> | defines the uppermost allowable screen row for the mouse cursor or 0 if omitted. This value may range from 0 to the value of |
<nBottom> | . |
<nLeft> | defines the leftmost allowable screen column for the mouse or 0 if omitted. This value may range from 0 to the value of <nRight>. |
<nBottom> | defines the bottommost screen row for the mouse cursor or MaxRow() if omitted. This value may range from the value of <nTop> to MaxRow(). |
<nRight> | defines the rightmost allowable screen column for the mouse or MaxCol() if omitted. This value may range from the value of <nLeft> to MaxCol(). |
Returns : | MSETBOUNDS() always returns NIL. |
MSETCLIP([<nCoord list>], [<nMode>]) --> aRegions
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.
<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} |
See also : | MHIDE() MSETCURSOR() MSHOW() |
MSETPOS( <nRow>, <nCol> ) --> NIL
Returns : | MSETPOS() always returns NIL. |
See also : | MSETCURSOR() MROW() MCOL() |
MSHOW([<nCol>, <nRow>, <nStyle>]) --> nOldCursorShape MSHOW([<nCursorShape>]) --> nOldCursorShape MSHOW([<nCursorShape>] | [<nCol>, <nRow>, <nMode>]) --> nOldCursorShape
MSHOW() displays the mouse pointer. It is generally used without parameters to simply redisplay the mouse pointer at the position where MHIDE() hid it (assuming the user has not moved the mouse).
It is possible to use two sets of parameters with this function.
Specify the coordinates where the pointer should appear. In this case, three parameters must be passed: the mode and its coordinates. In text mode, coordinates are passed as row and column. In graphic mode, you can pass either text or graphic coordinates. Conversion is done automatically based on the font size of the current characters.
You can also specify the mouse cursor shape to be displayed when the mouse is visible. This feature is available in graphic mode only.
It is important to hide the mouse pointer before any new screen display, and then show it again. See MHIDE() for further information on how to do this.
Note: The MSETCURSOR() function should be used in place of MSHOW() and MHIDE(). It is kept here for compatibility.
<nCol> | and <nRow> define mouse pointer coordinates. |
<nStyle> | defines the style of mouse pointer using one of the constants listed in the table below: Text and Graph Constants ------------------------------------------------------------------------ Constant Description ------------------------------------------------------------------------ LLM_COOR_TEXT Specifies that the coordinates are passed in rows and columns of text LLM_COOR_GRAPH Specifies that the coordinates are passed in pixels ------------------------------------------------------------------------ |
<nCursorShape> | is a numeric value representing the mouse cursor shape. The following are the possible values predefined for this parameter: Cursor Shape Constants ------------------------------------------------------------------------ Constant Description ------------------------------------------------------------------------ LLM_CURSOR_ARROW Standard pointer LLM_CURSOR_SIZE_NS North South arrow LLM_CURSOR_SIZE_WE West East arrow LLM_CURSOR_SIZE_NW_SE North-West South-East arrow LLM_CURSOR_SIZE_NE_SW North-East South-West arrow LLM_CURSOR_HAND Hand LLM_CURSOR_FINGER Hand with one pointing finger LLM_CURSOR_CROSS Cross LLM_CURSOR_WAIT Hourglass ------------------------------------------------------------------------ |
Returns : | MSHOW() returns the previously used cursor shape. See <nCurorShape> above for further information. |
See also : | MHIDE() MSETCLIP() MSHOW() |
MSTATE() --> aState | 0
MSTATE() returns information on the mouse state, i.e., the current screen position of the pointer, the state of the left and right mouse buttons, the visibility status of the mouse pointer, and the version of the mouse driver.
Returns : |
MSTATE() Return Array ------------------------------------------------------------------------ Position Description ------------------------------------------------------------------------ LLM_STATE_X State of X position. LLM_STATE_Y State of Y position. LLM_STATE_ROW State of column position. LLM_STATE_COL State of line position. LLM_STATE_LEFT State of left mouse button. LLM_BUTTON_DOWN means down and LLM_BUTTON_UP means up. LLM_STATE_RIGHT State of right mouse button. LLM_BUTTON_DOWN means down and LLM_BUTTON_UP means up. LLM_STATE_VISIBLE State of mouse pointer. True (.T) means visible and false (.F) means invisible. (See MSHOW() and MHIDE() for more information.) LLM_STATE_DRIVER Indicates version of mouse driver. LLM_STATE_SHAPE Mouse cursor shape. (See note below.) LLM_STATE_CLICKS_LEFT Number of left clicks since last MSTATE() call. LLM_STATE_CLICKS_RIGHT Number of right clicks since last MSTATE() call. ------------------------------------------------------------------------Note: The following are the possible values predefined for this return array position: LLM_CURSOR_ARROW, LLM_CURSOR_SIZE_NS, LLM_CURSOR_SIZE_WE, LLM_CURSOR_SIZE_NW_SE, LLM_CURSOR_SIZE_NE_SW, LLM_CURSOR_HAND, LLM_CURSOR_FINGER, LLM_CURSOR_CROSS, LLM_CURSOR_WAIT. For a description of these values see the MSHOW() table of Cursor Shape Constants. If the mouse is missing, 0 is returned. The number of clicks (i.e., aState[LLM_STATE_CLICKS_LEFT] and aState[LLM_STATE_CLICKS_RIGHT]) is reset each time MSTATE() is called. Use MSTATE() to reset the mouse settings when needed. |
See also : | MHIDE() MSETCURSOR() MSHOW() |
NEXTKEY() --> код клавиши
NEXTKEY() - функция работы с клавиатурой, которая считывает код очередной нажатой клавиши без его удаления из буфера клавиатуры. Возвращаемые значения - это INKEY-коды нажатых клавиш - такие же, что возвращают функции INKEY() и LASTKEY(). NEXTKEY() возвращает значения кодов для всех ASCII символов, функциональных клавиш, <Alt>-функциональных клавиш, <Ctrl>-функциональных клавиш, <Alt>-символов, <Ctrl>-символов. NEXTKEY() похожа на функцию INKEY(), но отличается одним основным свойством. INKEY() удаляет код нажатой клавиши из буфера клавиатуры, изменяя значение LASTKEY(). NEXTKEY() считывает, но не удаляет код нажатой клавиши из буфера клавиатуры и не изменяет значения LASTKEY().
Поскольку NEXTKEY() не удаляет клавишу из буфера клавиатуры, можно использовать эту функцию для опроса клавиатуры и затем передавать управление программе, которая использует состояние ожидания для того, чтобы извлечь клавишу из буфера. Полный список INKEY-кодов и описаний констант файла описаний Inkey.ch приведен в приложении С этой книги.
SETKEY(<INKEY-код>, [<блок кода>]) --> текущий блок кода
SETKEY() является функцией работы с клавиатурой, используемой для установки или запроса автоматического действия, связанного с нажатием конкретной клавиши в режиме ожидания. Режим ожидания - это любой режим, при котором программа ожидает ввода информации с клавиатуры. Режим ожидания создается функциями ACHOICE(), DBEDIT(), MEMOEDIT(), и командами ACCEPT, INPUT, READ и WAIT. Функция INKEY() в эту группу не входит. Одновременно может назначаться до 32 клавиш. По умолчанию система автоматически назначает клавишу F1 для выполнения процедуры или функции пользователя с названием Help.
Когда назначенная клавиша нажимается во время состояния ожидания, соответствующему блоку кода в качестве параметров передаются значения PROCNAME(), PROCLINE() и READVAR(), и он выполняется путем передачи его функции EVAL(). Однако нет необходимости перечислять эти аргументы при задании значения аргумента <блок кода>, если вы не планируете их использование.
SETKEY() подобна команде SET KEY, которая связывает вызов процедуры с определенной клавишей.
<INKEY-код> | - значение INKEY()-кода клавиши, связываемой с выполнением блока кода. |
<блок кода> | - задает блок кода, автоматически выполняемого при нажатии заданной клавиши в режиме ожидания. |
Returns : | SETKEY() возвращает блок кода, связанный в текущий момент с заданной клавишей или NIL, если заданная клавиша не связана ни с каким блоком кода. |
See also : | EVAL() INKEY() |
Пред. | Начало | След. |
DATE/TIME | Уровень выше | GAME |