diff --git a/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md b/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md index 84d98a596e75d947a854f7e3b6c535cb878d7e46..ae7bd134ebda72e9da09a034801f949b6a9ee395 100644 --- a/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md +++ b/zh-cn/application-dev/reference/apis-arkui/js-apis-arkui-UIContext.md @@ -1618,6 +1618,10 @@ vp2px(value : number) : number 像素密度:当前窗口生效的像素密度值,即屏幕物理像素密度[VirtualScreenConfig.density](js-apis-display.md#virtualscreenconfig16)。 +> **说明:** +> +> 本接口需要在[windowStage.loadContent](./arkts-apis-window-WindowStage.md#loadcontent9)后调用以确保UIContext初始化完成,否则可能无法返回准确的结果。 + **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 **系统能力:** SystemCapability.ArkUI.ArkUI.Full @@ -1651,6 +1655,10 @@ px2vp(value : number) : number 像素密度:当前窗口生效的像素密度值,即屏幕物理像素密度[VirtualScreenConfig.density](js-apis-display.md#virtualscreenconfig16)。 +> **说明:** +> +> 本接口需要在[windowStage.loadContent](./arkts-apis-window-WindowStage.md#loadcontent9)后调用以确保UIContext初始化完成,否则可能无法返回准确的结果。 + **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 **系统能力:** SystemCapability.ArkUI.ArkUI.Full @@ -1686,6 +1694,10 @@ fp2px(value : number) : number 字体缩放比例:系统设置的字体缩放系数,对应 [Configuration.fontScale](arkui-ts/ts-types.md#configuration)。 +> **说明:** +> +> 本接口需要在[windowStage.loadContent](./arkts-apis-window-WindowStage.md#loadcontent9)后调用以确保UIContext初始化完成,否则可能无法返回准确的结果。 + **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 **系统能力:** SystemCapability.ArkUI.ArkUI.Full @@ -1721,6 +1733,10 @@ px2fp(value : number) : number 字体缩放比例:系统设置的字体缩放系数,对应 [Configuration.fontScale](arkui-ts/ts-types.md#configuration)。 +> **说明:** +> +> 本接口需要在[windowStage.loadContent](./arkts-apis-window-WindowStage.md#loadcontent9)后调用以确保UIContext初始化完成,否则可能无法返回准确的结果。 + **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 **系统能力:** SystemCapability.ArkUI.ArkUI.Full @@ -1750,7 +1766,11 @@ lpx2px(value : number) : number 将lpx单位的数值转换为以px为单位的数值。 -转换公式为:px值 = lpx值 × 实际屏幕宽度与逻辑宽度(通过[designWidth](../../quick-start/module-configuration-file.md#pages标签)配置)的比值 +转换公式为:px值 = lpx值 × 实际屏幕宽度与逻辑宽度(通过[designWidth](../../quick-start/module-configuration-file.md#pages标签)配置)的比值。 + +> **说明:** +> +> 本接口需要在[windowStage.loadContent](./arkts-apis-window-WindowStage.md#loadcontent9)后调用以确保UIContext初始化完成,否则可能无法返回准确的结果。 **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 @@ -1781,7 +1801,11 @@ px2lpx(value : number) : number 将px单位的数值转换为以lpx为单位的数值。 -转换公式为:lpx值 = px值 ÷ 实际屏幕宽度与逻辑宽度(通过[designWidth](../../quick-start/module-configuration-file.md#pages标签)配置)的比值 +转换公式为:lpx值 = px值 ÷ 实际屏幕宽度与逻辑宽度(通过[designWidth](../../quick-start/module-configuration-file.md#pages标签)配置)的比值。 + +> **说明:** +> +> 本接口需要在[windowStage.loadContent](./arkts-apis-window-WindowStage.md#loadcontent9)后调用以确保UIContext初始化完成,否则可能无法返回准确的结果。 **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。