划词面板是用户选中文本后弹出的操作面板,适用于需要为选中文本提供翻译、搜索等快捷操作功能的场景,帮助开发者快速集成划词操作能力,提升用户交互体验。面板采用两级架构设计:菜单面板(MENU_PANEL)为一级面板,展示当前应用可提供的功能入口(如翻译、搜索等);主面板(MAIN_PANEL)为二级面板,在用户点击菜单面板中的功能按钮后弹出,展示具体的功能结果。本模块提供划词面板的属性信息和类型,开发者可通过PanelInfo设定面板的位置和尺寸,通过PanelType指定面板类型。划词面板的创建与显示接口请参见createPanel、show。
划词面板属性信息,包含面板类型、位置和宽高。开发者通过panelType指定面板类型(菜单面板或主面板),通过x、y设定面板左上角坐标,通过width、height设定面板尺寸,各项属性共同定义面板的呈现形态。
系统能力: SystemCapability.SelectionInput.Selection
模型约束: 此接口仅可在Stage模型下使用。
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| panelType | PanelType | 否 | 否 | 划词面板类型枚举,有两种面板可供选择,详见PanelType。 |
| x | number | 否 | 否 | 划词面板左上角的x轴坐标,单位为px。以主屏幕左上角为原点,x轴正方向向右。取值范围[0, +∞),传入负数时面板无法正常创建。 |
| y | number | 否 | 否 | 划词面板左上角的y轴坐标,单位为px。以主屏幕左上角为原点,y轴正方向向下。取值范围[0, +∞),传入负数时面板无法正常创建。 |
| width | number | 否 | 否 | 划词面板宽度,单位为px。取值范围(0, +∞),传入0或负数时面板无法正常创建。 |
| height | number | 否 | 否 | 划词面板高度,单位为px。取值范围(0, +∞),传入0或负数时面板无法正常创建。 |