Home > SCH_Event > addMouseEventListener

SCH_Event.addMouseEventListener() method

新增鼠标事件监听

签名

function addMouseEventListener(
	id: string,
	eventType: 'all' | ESCH_MouseEventType,
	callFn: (eventType: ESCH_MouseEventType) => void | Promise<void>,
	onlyOnce?: boolean,
): void;

参数名

参数	类型	描述
id	string	事件 ID，用以防止重复注册事件
eventType	'all' | ESCH_MouseEventType	事件类型
callFn	(eventType: ESCH_MouseEventType) => void | Promise<void>	事件触发时的回调函数
onlyOnce	boolean	（可选） 是否仅监听一次

返回值

void

备注

注意：本接口仅扩展有效，在独立脚本环境内调用将始终 throw Error

示例

const listenerId = '嘉立创示例_sch_mouse_event';

// 1. 注册鼠标事件监听，eventType 用 'all' 接收全部鼠标事件，onlyOnce 为 false 持续监听
eda.sch_Event.addMouseEventListener(
	listenerId,
	'all',
	(eventType) => {
		// 回调在用户画布操作时触发
		console.log('mouseEvent:', eventType);
	},
	false
);

// 2. 回读确认注册成功
const registered = eda.sch_Event.isEventListenerAlreadyExist(listenerId);
console.log('registered:', registered);

// 3. 清理监听
const removed = eda.sch_Event.removeEventListener(listenerId);
console.log('removed:', removed);