From 24a15133b7600373f3b22e810b2af80a1e8b18b0 Mon Sep 17 00:00:00 2001 From: WangYing225 Date: Wed, 18 Jun 2025 16:57:21 +0800 Subject: [PATCH 1/2] =?UTF-8?q?XComponent=E6=8E=A5=E5=8F=A3=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E8=AF=B4=E6=98=8E=E8=A1=A5=E5=85=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: WangYing225 --- .../reference/apis-arkui/_o_h___native_x_component.md | 6 +++++- .../apis-arkui/arkui-ts/ts-basic-components-xcomponent.md | 6 ++++-- zh-cn/application-dev/ui/napi-xcomponent-guidelines.md | 2 ++ 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md b/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md index 496f1cf364d..48389ed9c21 100644 --- a/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md +++ b/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md @@ -218,6 +218,10 @@ typedef struct OH_NativeXComponent_KeyEvent OH_NativeXComponent_KeyEvent 提供封装的OH_NativeXComponent_KeyEvent实例。 +> **说明：** +> +> 此结构体的具体定义并不直接暴露。可通过[OH_NativeXComponent_GetKeyEventAction](#oh_nativexcomponent_getkeyeventaction)，[OH_NativeXComponent_GetKeyEventCode](#oh_nativexcomponent_getkeyeventcode)，[OH_NativeXComponent_GetKeyEventDeviceId](#oh_nativexcomponent_getkeyeventdeviceid)，[OH_NativeXComponent_GetKeyEventSourceType](#oh_nativexcomponent_getkeyeventsourcetype)，[OH_NativeXComponent_GetKeyEventTimestamp](#oh_nativexcomponent_getkeyeventtimestamp)等接口获取该结构体内的参数。 + **起始版本：** 10 @@ -2920,7 +2924,7 @@ uint32_t OH_NativeXComponent_TouchEvent::numPoints = 0 **描述:** -当前接触点的数量。 +当前接触点的数量，值为1时为单指触摸，大于1时为多指触摸。 **起始版本：** diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md index 3da387d0af4..29c93ea643a 100755 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md @@ -332,7 +332,7 @@ getXComponentContext(): Object setXComponentSurfaceRect(rect: SurfaceRect): void -设置XComponent持有Surface的显示区域，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。 +设置XComponent持有Surface的显示区域，包括宽高和相对于组件左上角的位置坐标，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -356,7 +356,7 @@ setXComponentSurfaceRect(rect: SurfaceRect): void getXComponentSurfaceRect(): SurfaceRect -获取XComponent持有Surface的显示区域，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。 +获取XComponent持有Surface的显示区域，包括宽高和相对于组件左上角的位置坐标，仅XComponent类型为SURFACE("surface")或TEXTURE时有效。 **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 @@ -609,6 +609,8 @@ unlockCanvasAndPost(canvas: DrawingCanvas): void > surfaceWidth和surfaceHeight属性在未调用[setXComponentSurfaceRect](ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)也未设置[border](ts-universal-attributes-border.md#border)和[padding](ts-universal-attributes-size.md#padding)等属性时，其取值大小为XComponent组件的大小。 > > surfaceWidth和surfaceHeight属性的取值都不可超过8192px，否则会导致渲染异常。 +> +> 沉浸式场景下，默认布局的SurfaceRect不包括安全区，需调用[setXComponentSurfaceRect](ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)接口手动设置Surface显示区域达到沉浸式效果。 ## DrawingCanvas12+对象说明 diff --git a/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md b/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md index fc50b1448a8..f794a009a4c 100644 --- a/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md +++ b/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md @@ -13,6 +13,8 @@ XComponent组件作为一种渲染组件，可用于EGL/OpenGLES和媒体数据 XComponent持有一个Surface，开发者能通过调用[NativeWindow](../graphics/native-window-guidelines.md)等接口，申请并提交Buffer至图形队列，以此方式将自绘制内容传送至该Surface。XComponent负责将此Surface整合进UI界面，其中展示的内容正是开发者传送的自绘制内容。Surface的默认位置与大小与XComponent组件一致，开发者可利用[setXComponentSurfaceRect](../reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)接口自定义调整Surface的位置和大小。 +XComponent组件的职责在于创建Surface，并将Surface的相关信息通过回调告知应用，应用可以通过一系列接口设置Surface的属性，组件本身对所绘制的内容并不感知，也没有渲染绘制接口。 + > **说明：** > > 当开发者传输的绘制内容包含透明元素时，Surface区域的显示效果会与下方内容进行合成展示。例如，若传输的内容完全透明，且XComponent的背景色被设置为黑色，同时Surface保持默认的大小与位置，则最终显示的将是一片黑色区域。 -- Gitee From f0bcb60601b2843950fca145a5d00d02c180a219 Mon Sep 17 00:00:00 2001 From: WangYing225 Date: Wed, 18 Jun 2025 16:57:21 +0800 Subject: [PATCH 2/2] =?UTF-8?q?XComponent=E6=8E=A5=E5=8F=A3=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E8=AF=B4=E6=98=8E=E8=A1=A5=E5=85=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: WangYing225 --- .../reference/apis-arkui/_o_h___native_x_component.md | 2 +- .../apis-arkui/arkui-ts/ts-basic-components-xcomponent.md | 2 +- zh-cn/application-dev/ui/napi-xcomponent-guidelines.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md b/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md index 48389ed9c21..91bc10832df 100644 --- a/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md +++ b/zh-cn/application-dev/reference/apis-arkui/_o_h___native_x_component.md @@ -220,7 +220,7 @@ typedef struct OH_NativeXComponent_KeyEvent OH_NativeXComponent_KeyEvent > **说明：** > -> 此结构体的具体定义并不直接暴露。可通过[OH_NativeXComponent_GetKeyEventAction](#oh_nativexcomponent_getkeyeventaction)，[OH_NativeXComponent_GetKeyEventCode](#oh_nativexcomponent_getkeyeventcode)，[OH_NativeXComponent_GetKeyEventDeviceId](#oh_nativexcomponent_getkeyeventdeviceid)，[OH_NativeXComponent_GetKeyEventSourceType](#oh_nativexcomponent_getkeyeventsourcetype)，[OH_NativeXComponent_GetKeyEventTimestamp](#oh_nativexcomponent_getkeyeventtimestamp)等接口获取该结构体内的参数。 +> 此结构体可通过[OH_NativeXComponent_GetKeyEventAction](#oh_nativexcomponent_getkeyeventaction)，[OH_NativeXComponent_GetKeyEventCode](#oh_nativexcomponent_getkeyeventcode)，[OH_NativeXComponent_GetKeyEventDeviceId](#oh_nativexcomponent_getkeyeventdeviceid)，[OH_NativeXComponent_GetKeyEventSourceType](#oh_nativexcomponent_getkeyeventsourcetype)，[OH_NativeXComponent_GetKeyEventTimestamp](#oh_nativexcomponent_getkeyeventtimestamp)等接口获取结构体内的参数。 **起始版本：** diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md index 29c93ea643a..952f9ffa096 100755 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md @@ -610,7 +610,7 @@ unlockCanvasAndPost(canvas: DrawingCanvas): void > > surfaceWidth和surfaceHeight属性的取值都不可超过8192px，否则会导致渲染异常。 > -> 沉浸式场景下，默认布局的SurfaceRect不包括安全区，需调用[setXComponentSurfaceRect](ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)接口手动设置Surface显示区域达到沉浸式效果。 +> 沉浸式场景下，默认布局的SurfaceRect不包括安全区，需调用[setXComponentSurfaceRect](ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)接口主动设置Surface显示区域达到沉浸式效果。 ## DrawingCanvas12+对象说明 diff --git a/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md b/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md index f794a009a4c..7aa798e2f05 100644 --- a/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md +++ b/zh-cn/application-dev/ui/napi-xcomponent-guidelines.md @@ -13,7 +13,7 @@ XComponent组件作为一种渲染组件，可用于EGL/OpenGLES和媒体数据 XComponent持有一个Surface，开发者能通过调用[NativeWindow](../graphics/native-window-guidelines.md)等接口，申请并提交Buffer至图形队列，以此方式将自绘制内容传送至该Surface。XComponent负责将此Surface整合进UI界面，其中展示的内容正是开发者传送的自绘制内容。Surface的默认位置与大小与XComponent组件一致，开发者可利用[setXComponentSurfaceRect](../reference/apis-arkui/arkui-ts/ts-basic-components-xcomponent.md#setxcomponentsurfacerect12)接口自定义调整Surface的位置和大小。 -XComponent组件的职责在于创建Surface，并将Surface的相关信息通过回调告知应用，应用可以通过一系列接口设置Surface的属性，组件本身对所绘制的内容并不感知，也没有渲染绘制接口。 +XComponent组件负责创建Surface，并通过回调将Surface的相关信息告知应用。应用可以通过一系列接口设定Surface的属性。该组件本身不对所绘制的内容进行感知，亦不提供渲染绘制的接口。 > **说明：** > -- Gitee