MouseArea

MouseArea

MouseArea 是一个不可见的组件,通常与可见的组件一起使用, 以提供鼠标事件处理功能。

鼠标位置信息通过 clickmousedownmousemovemouseup 等事件提供。

Constructor

new MouseArea()

初始化 MouseArea 的新实例

Extends

Members

height :Number

Overrides:

此属性表示组件的高度。

Type:
  • Number

opacity :Number

Overrides:

此属性表示组件的不透明度。 不透明度的有效范围为 1.0(完全不透明)到 0.0(完全透明)。

Type:
  • Number

(readonly) pressed :Boolean

此属性为只读,表示当前是否有鼠标按钮被按下。

Type:
  • Boolean

rotation :Number

Overrides:

此属性表示组件顺时针旋转的角度(单位:度)。

Type:
  • Number

width :Number

Overrides:

此属性表示组件的宽度。

Type:
  • Number

x :Number

Overrides:

此属性表示组件相对于其父级的 x 坐标。

Type:
  • Number

y :Number

Overrides:

此属性表示组件相对于其父级的 y 坐标。

Type:
  • Number

Events

click

当发生点击事件时触发。点击事件的定义是按下(例如鼠标按下)后, 在 MouseArea 内部释放(例如鼠标抬起)。

Type:
Example
var mouseArea = new MouseArea();
this.widget.add(mouseArea);

mouseArea.on('click', (mouseEvent) => {
  // 执行某些操作
});

mousedown

当鼠标按钮在 MouseArea 内部被按下时触发。

Type:
Example
var mouseArea = new MouseArea();
this.widget.add(mouseArea);

mouseArea.on('mousedown', (mouseEvent) => {
  // 执行某些操作
});

mousemove

当鼠标指针在按下鼠标按钮的状态下发生位置变化时触发。 注意,MouseArea 必须先接收到 mousedown 事件, 然后才能(可能)接收 mousemove 事件。

Type:
Example
var mouseArea = new MouseArea();
this.widget.add(mouseArea);

mouseArea.on('mousemove', (mouseEvent) => {
  // 执行某些操作
});

mouseup

当鼠标按钮被释放时触发。 注意,mouseup 事件是 mousedown 事件的对应事件, 也就是说,MouseArea 必须先接收到 mousedown 事件, 然后才能(可能)接收 mouseup 事件。

Type:
Example
var mouseArea = new MouseArea();
this.widget.add(mouseArea);

mouseArea.on('mouseup', (mouseEvent) => {
  // 执行某些操作
});