harmony 鸿蒙@ohos.deviceStatus.dragInteraction（拖拽)(系统接口)

  • 2025-06-12
  • 浏览 (5)

@ohos.deviceStatus.dragInteraction（拖拽)(系统接口)

拖拽功能模块，提供注册和取消拖拽状态监听的能力。

说明：

  • 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

  • 本模块接口均为系统接口。

导入模块

import { dragInteraction } from '@kit.ArkUI';

DragState

拖拽状态。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Msdp.DeviceStatus.Drag

名称 值 说明
MSG_DRAG_STATE_START 1 表示开始拖拽。
MSG_DRAG_STATE_STOP 2 表示结束拖拽。
MSG_DRAG_STATE_CANCEL 3 表示取消拖拽。

Summary11+

拖拽对象的数据摘要。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Msdp.DeviceStatus.Drag

名称 类型 必填 说明
dataType string 是 拖拽对象类型。
dataSize number 是 拖拽对象数据长度。

dragInteraction.on(‘drag’)

on(type: ‘drag’, callback: Callback<DragState>): void

注册监听拖拽状态。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Msdp.DeviceStatus.Drag

参数：

参数名 类型 必填 说明
type string 是 监听类型，固定取值为 ‘drag’。
callback Callback<DragState> 是 回调函数，异步返回拖拽状态消息。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID 错误信息
202 Not system application.
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

try {
  dragInteraction.on('drag', (data: dragInteraction.DragState) => {
    console.log(`Drag interaction event: ${JSON.stringify(data)}`);
  });
} catch (error) {
  console.error(`Register failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

dragInteraction.off(‘drag’)

off(type: ‘drag’, callback?: Callback<DragState>): void

取消监听拖拽状态。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Msdp.DeviceStatus.Drag

参数：

参数名 类型 必填 说明
type string 是 监听类型，固定取值为 ‘drag’。
callback Callback<DragState> 否 需要取消注册的回调函数，若无此参数，则取消当前应用注册的所有回调函数。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID 错误信息
202 Not system application.
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

// 取消注册单个回调函数
function single_callback(event: dragInteraction.DragState) {
  console.log(`Drag interaction event: ${JSON.stringify(event)}`);
  return false;
}
try {
  dragInteraction.on('drag', single_callback);
  dragInteraction.off("drag", single_callback);
} catch (error) {
  console.error(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

// 取消注册所有回调函数
function all_callback(event: dragInteraction.DragState) {
  console.log(`Drag interaction event: ${JSON.stringify(event)}`);
  return false;
}
try {
  dragInteraction.on('drag', all_callback);
  dragInteraction.off("drag");
} catch (error) {
  console.error(`Execute failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

dragInteraction.getDataSummary11+

getDataSummary(): Array<Summary>

获取所有拖拽对象的摘要。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Msdp.DeviceStatus.Drag

返回值：

类型 说明
Array<Summary> 所有拖拽对象的数据摘要，包含拖拽对象的类型和数据长度。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID 错误信息
202 Not system application.

示例：

let summarys: Array<dragInteraction.Summary> = dragInteraction.getDataSummary();
console.log(`Drag interaction summarys: ${JSON.stringify(summarys)}`);

dragInteraction.setDragSwitchState18+

setDragSwitchState(enabled: boolean): void

控制统一拖拽功能总开关。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Msdp.DeviceStatus.Drag

参数：

参数名 类型 必填 说明
enabled boolean 是 设置开关状态。
false：关闭，true：开启。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID 错误信息
202 Not system application.

示例：

dragInteraction.setDragSwitchState(false);

dragInteraction.setAppDragSwitchState18+

setAppDragSwitchState(enabled: boolean, bundleName: string): void

控制统一拖拽适配应用开关。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Msdp.DeviceStatus.Drag

参数：

参数名 类型 必填 说明
enabled boolean 是 设置开关状态。
false：关闭，true：开启。
bundleName string 是 设置指定应用包名开关状态。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档。

错误码ID 错误信息
202 Not system application.
401 Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.2.Incorrect parameter types.3.Parameter verification failed.

示例：

dragInteraction.setAppDragSwitchState(true, "com.app.bundleName");

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkUI（方舟UI框架）

harmony 鸿蒙ARKUI_TextPickerCascadeRangeContent

harmony 鸿蒙ARKUI_TextPickerRangeContent

harmony 鸿蒙ArkUI_AnimateCompleteCallback

harmony 鸿蒙ArkUI_AttributeItem

harmony 鸿蒙ArkUI_ColorStop

harmony 鸿蒙ArkUI_ContextCallback

harmony 鸿蒙ArkUI_EventModule

harmony 鸿蒙ArkUI_ExpectedFrameRateRange

harmony 鸿蒙ArkUI_IntOffset

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/qPZeqf
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录