openharmony 鸿蒙 arkts-apis-graphics-drawing-ShadowLayer

2026-08-25 浏览 (1)

Class (ShadowLayer)

阴影层对象。

说明:

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

  • 本Class首批接口从API version 12开始支持。

  • 本模块使用屏幕物理像素单位px。

  • 本模块为单线程模型策略,需要调用方自行管理线程安全和上下文状态的切换。

导入模块

import { drawing } from '@kit.ArkGraphics2D';

create12+

static create(blurRadius: number, x: number, y: number, color: common2D.Color): ShadowLayer

创建阴影层对象。

系统能力: SystemCapability.Graphics.Drawing

参数:

参数名类型必填说明
blurRadiusnumber阴影的半径,必须为大于零的浮点数。单位为物理像素px。
xnumberx轴上的偏移点,该参数为浮点数。单位为物理像素px。
ynumberY轴上的偏移点,该参数为浮点数。单位为物理像素px。
colorcommon2D.ColorARGB格式的颜色,每个颜色通道的值是0到255之间的整数。

返回值:

类型说明
ShadowLayer返回创建的阴影层对象。

错误码:

以下错误码的详细介绍请参见通用错误码

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

示例:

import { RenderNode } from '@kit.ArkUI';
import { common2D, drawing } from '@kit.ArkGraphics2D';

class DrawingRenderNode extends RenderNode {
  draw(context : DrawContext) {
    const canvas = context.canvas;
    let color : common2D.Color = {alpha: 0xFF, red: 0x00, green: 0xFF, blue: 0x00};
    let shadowLayer = drawing.ShadowLayer.create(3, -3, 3, color);
  }
}

create18+

static create(blurRadius: number, x: number, y: number, color: common2D.Color|number): ShadowLayer

创建阴影层对象。

系统能力: SystemCapability.Graphics.Drawing

参数:

参数名类型必填说明
blurRadiusnumber阴影的半径,必须为大于零的浮点数。单位为物理像素px。
xnumberx轴上的偏移点,该参数为浮点数。单位为物理像素px。
ynumberY轴上的偏移点,该参数为浮点数。单位为物理像素px。
colorcommon2D.Color |number颜色,可以用16进制ARGB格式的无符号整数表示。

返回值:

类型说明
ShadowLayer返回创建的阴影层对象。

错误码:

以下错误码的详细介绍请参见通用错误码

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

示例:

import { RenderNode } from '@kit.ArkUI';
import { drawing } from '@kit.ArkGraphics2D';

class DrawingRenderNode extends RenderNode {
  draw(context : DrawContext) {
    const canvas = context.canvas;
    let shadowLayer = drawing.ShadowLayer.create(3, -3, 3, 0xff00ff00);
  }
}

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 capi-drawing-gpu-context-h

openharmony 鸿蒙 capi-drawing-nativepixelmap-

openharmony 鸿蒙 capi-nativevsync-oh-nativevsync-expectedraterange

openharmony 鸿蒙 capi-drawing-oh-drawing-brush

openharmony 鸿蒙 capi-drawing-oh-drawing-image-info

openharmony 鸿蒙 capi-drawing-text-linetypography-h

openharmony 鸿蒙 capi-oh-nativeimage-oh-nativeimage

openharmony 鸿蒙 capi-drawing-typeface-h

openharmony 鸿蒙 capi-drawing-brush-h

openharmony 鸿蒙 capi-nativewindow

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/rtj5Fdff