设置组件是否独占事件,事件范围包括组件自带的事件和开发者自定义的点击、触摸、手势事件。
在一个窗口内,设置了独占控制的组件上的事件如果首先响应,则本次交互只允许此组件上设置的事件响应,窗口内其他组件上的事件不会响应。
说明:
从API Version 11开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
monopolizeEvents
monopolizeEvents(monopolize: boolean)
设置组件是否独占事件。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
monopolize | boolean | 是 | 设置组件是否独占事件。 默认值:false 说明: 1、如果第一根手指触发了组件事件独占,在抬起前又按下了一根手指,则第二根手指的交互继续处于组件独占状态,依次类推。 2、如果开发者通过parallelGesture绑定了与子组件同时触发的手势,如PanGesture,子组件设置了独占控制且首个响应事件,则父组件的手势不会响应。 |
示例
// xxx.ets
@Entry
@Component
struct Index {
@State message: string = 'set monopolizeEvents false'
@State monopolize: boolean = false
build(