# 特效绘制合并

用于对背景模糊等特效进行绘制合并。

*   从API version 12开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
    
*   本模块接口仅可在Stage模型下使用。
    

#### useEffect

useEffect(value: boolean): T

用于对背景模糊等特效进行绘制合并。

**元服务API：** 从API version 12开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| value | boolean | 是 | 控制组件是否继承特效绘制合并组件的特效属性参数，从而合并绘制特效。 useEffect为true时子组件继承特效绘制合并组件的特效属性参数，为false时子组件不继承特效绘制合并组件的特效属性参数。 默认值：false |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| T | 返回当前组件。 |

#### useEffect14+

useEffect(useEffect: boolean, effectType: EffectType): T

用于设置组件是否应用窗口定义的效果模板。

**元服务API：** 从API version 14开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| useEffect | boolean | 是 | 控制组件是否应用窗口定义的效果模板。 useEffect为true时表示应用窗口定义的效果模板。 默认值：false |
| effectType | EffectType | 是 | 设置组件应用窗口定义的效果模板。 默认值：EffectType.DEFAULT |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| T | 返回当前组件。 |

#### useEffect18+

useEffect(useEffect: Optional<boolean>, effectType?: EffectType): T

用于设置组件是否应用窗口定义的效果模板。与useEffect14+相比，useEffect参数新增了对undefined类型的支持。

**元服务API：** 从API version 18开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| useEffect | Optional<boolean> | 是 | 控制组件是否应用窗口定义的效果模板。 useEffect为true时表示应用窗口定义的效果模板。 默认值：false 当useEffect的值为undefined时，维持之前取值。 |
| effectType | EffectType | 否 | 设置组件应用窗口定义的效果模板。 默认值：EffectType.DEFAULT |

**返回值：**

| 类型 | 说明 |
| --- | --- |
| T | 返回当前组件。 |

#### EffectType14+

使用效果模板种类的枚举值。

**元服务API：** 从API version 14开始，该接口支持在元服务中使用。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

| 名称 | 值 | 说明 |
| --- | --- | --- |
| DEFAULT | 0 | 使用效果模板进行定义。 |
| WINDOW_EFFECT | 1 | 使用窗口定义的效果模板进行定义。 |

效果模板

| 设备类型 | 模糊半径(单位: px) | 饱和度 | 亮度 | 颜色 |
| --- | --- | --- | --- | --- |
| 移动设备 | 0 | 0 | 0 | '#ffffffff'，显示为白色。 |
| 2in1设备：深色模式 | 80 | 1.5 | 1.0 | '#e52e3033'，显示为半透明的深灰色。 |
| 2in1设备：浅色模式 | 80 | 1.9 | 1.0 | '#e5ffffff'，显示为半透明的白色。 |
| Tablet设备 | 0 | 0 | 0 | '#ffffffff'，显示为白色。 |