ncurses_mousemask
(PHP 4 >= 4.2.0, PHP 5, PECL ncurses:1.0.0)
ncurses_mousemask — Sets mouse options
Description
這個函數是實驗性質的。這個函數的行為ã€å稱ã€å’Œé—œæ–¼æ¤å‡½æ•¸çš„任何其他文件在未來PHP的發行ä¸å¯èƒ½æœƒåœ¨ä¸é€šçŸ¥çš„情æ³ä¸‹æ”¹è®Šã€‚ 使用æ¤å»¶ä¼¸éœ€è‡ªè¡Œæ‰¿æ“”風險。
Sets mouse events to be reported. By default no mouse events will be reported.
Mouse events are represented by NCURSES_KEY_MOUSE in the ncurses_wgetch() input stream. To read the event data and pop the event of queue, call ncurses_getmouse().
Parameters
- newmask
-
Mouse mask options can be set with the following predefined constants:
NCURSES_BUTTON1_PRESSED
NCURSES_BUTTON1_RELEASED
NCURSES_BUTTON1_CLICKED
NCURSES_BUTTON1_DOUBLE_CLICKED
NCURSES_BUTTON1_TRIPLE_CLICKED
NCURSES_BUTTON2_PRESSED
NCURSES_BUTTON2_RELEASED
NCURSES_BUTTON2_CLICKED
NCURSES_BUTTON2_DOUBLE_CLICKED
NCURSES_BUTTON2_TRIPLE_CLICKED
NCURSES_BUTTON3_PRESSED
NCURSES_BUTTON3_RELEASED
NCURSES_BUTTON3_CLICKED
NCURSES_BUTTON3_DOUBLE_CLICKED
NCURSES_BUTTON3_TRIPLE_CLICKED
NCURSES_BUTTON4_PRESSED
NCURSES_BUTTON4_RELEASED
NCURSES_BUTTON4_CLICKED
NCURSES_BUTTON4_DOUBLE_CLICKED
NCURSES_BUTTON4_TRIPLE_CLICKED
NCURSES_BUTTON_SHIFT>
NCURSES_BUTTON_CTRL
NCURSES_BUTTON_ALT
NCURSES_ALL_MOUSE_EVENTS
NCURSES_REPORT_MOUSE_POSITION
As a side effect, setting a zero mousemask in newmask turns off the mouse pointer. Setting a non zero value turns mouse pointer on.
- oldmask
-
This will be set to the previous value of the mouse event mask.
Return Values
Returns a mask to indicated which of the in parameter newmask specified mouse events can be reported. On complete failure, it returns 0.
範例
Example#1 ncurses_mousemask() example
<?php
$newmask = NCURSES_BUTTON1_CLICKED + NCURSES_BUTTON1_RELEASED;
$mask = ncurses_mousemask($newmask, &$oldmask);
if ($mask & $newmask){
printf("All specified mouse options will be supported\n");
}
?>