get_mbuttonT_get_mbuttonGetMbuttonGetMbuttonget_mbutton (算子)

名称

get_mbuttonT_get_mbuttonGetMbuttonGetMbuttonget_mbutton — 等待鼠标按钮被按下。

签名

描述

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton returns the pixel accurate image coordinates of the mouse pointer in the output window and the mouse button pressed. In addition the state of the modifier keys is returned. The following values are assigned to the individual buttons and keys:

1：

Left button,

2：

Middle button,

4：

Right button,

8：

Shift key,

16：

Ctrl key,

32：

Alt key.

The sum of the values for all pressed keys added to the value of the pressed mouse button is returned in ButtonButtonButtonButtonbuttonbutton。

The operator waits until a mouse button is pressed in the output window. For graphics windows the coordinates RowRowRowRowrowrow and ColumnColumnColumnColumncolumncolumn are expressed with consideration of the current image part (see set_partset_partSetPartSetPartSetPartset_part).

If subpixel accurate image coordinates are required, you can use the operator get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix。

注意

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton only returns if a mouse button is pressed in the window.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

参数

结果

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton 返回值 2 ( H_MSG_TRUE )。

可能的前趋

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window

替代

get_mpositionget_mpositionGetMpositionGetMpositionGetMpositionget_mposition, get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix, get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPixget_mposition_sub_pix

另见

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window

模块

基础