diff --git a/zh-cn/application-dev/reference/apis/js-apis-screen.md b/zh-cn/application-dev/reference/apis/js-apis-screen.md index 2ad6cfdbd0bb03dccb912bd2d67d67c6e24c1cd8..ec90213b049c0a140bea2d3837d6ee697ddab435 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-screen.md +++ b/zh-cn/application-dev/reference/apis/js-apis-screen.md @@ -744,7 +744,7 @@ try { | id | number | 是 | 否 | 屏幕的id。 | | parent | number | 是 | 否 | 屏幕所属群组的id。 | | supportedModeInfo | Array<[ScreenModeInfo](#screenmodeinfo)> | 是 | 否 | 屏幕支持的模式集合。 | -| activeModeIndex | number | 是 | 否 | 当前屏幕所处模式索引。 | +| activeModeIndex | number | 是 | 否 | 当前屏幕所处模式索引。模式索引的当前值和值的范围，会根据屏幕当前分辨率、刷新率和设备硬件差异产生变化。 | | orientation | [Orientation](#orientation) | 是 | 否 | 屏幕方向。 | | sourceMode10+ | [ScreenSourceMode](#screensourcemode10) | 是 | 否 | 屏幕来源模式。 | @@ -836,7 +836,7 @@ setScreenActiveMode(modeIndex: number, callback: AsyncCallback<void>): voi | 参数名 | 类型 | 必填 | 说明 | | --------- | ------------------------- | ---- | ------------------------------------------------------------ | -| modeIndex | number | 是 | 模式索引。 | +| modeIndex | number | 是 | 模式索引。模式索引的当前值和值的范围，会根据屏幕当前分辨率、刷新率和设备硬件差异产生变化。 | | callback | AsyncCallback<void> | 是 | 回调函数。当设置屏幕当前显示模式成功，err为undefined，否则为错误对象。 | **错误码：** @@ -874,7 +874,7 @@ setScreenActiveMode(modeIndex: number): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | ---------- | -| modeIndex | number | 是 | 模式索引。 | +| modeIndex | number | 是 | 模式索引。模式索引的当前值和值的范围，会根据屏幕当前分辨率、刷新率和设备硬件差异产生变化。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-window.md b/zh-cn/application-dev/reference/apis/js-apis-window.md index 97b19f0524b0a4a0a8c9a2a00732b1ea79abb38d..4f45ba009dea105841691b4b8faf5e3057c24194 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-window.md +++ b/zh-cn/application-dev/reference/apis/js-apis-window.md @@ -1910,7 +1910,9 @@ try { setWindowLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void>): void -设置窗口的布局是否为全屏显示状态，使用callback异步回调。 +设置窗口的布局是否为沉浸式布局，使用callback异步回调。 +沉浸式布局是指布局不避让状态栏与导航栏，组件可能产生与其重叠的情况。 +非沉浸式布局是指布局避让状态栏与导航栏，组件不会与其重叠。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core @@ -1918,7 +1920,7 @@ setWindowLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback&l | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------------------------- | -- | --------- | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态（该全屏状态下状态栏、导航栏仍然显示）。true表示全屏显示；false表示非全屏显示。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局（该沉浸式布局状态栏、导航栏仍然显示）。true表示沉浸式布局；false表示非沉浸式布局。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **错误码：** @@ -1951,7 +1953,9 @@ try { setWindowLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> -设置窗口的布局是否为全屏显示状态，使用Promise异步回调。 +设置窗口的布局是否为沉浸式布局，使用Promise异步回调。 +沉浸式布局是指布局不避让状态栏与导航栏，组件可能产生与其重叠的情况。 +非沉浸式布局是指布局避让状态栏与导航栏，组件不会与其重叠。 **系统能力：** SystemCapability.WindowManager.WindowManager.Core @@ -1959,7 +1963,7 @@ setWindowLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------- | -- | ------------------------------------------------------------------------------------------------ | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态(该全屏状态下状态栏、导航栏仍然显示)。true表示全屏显示；false表示非全屏显示。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局（该沉浸式布局状态栏、导航栏仍然显示）。true表示沉浸式布局；false表示非沉浸式布局。 | **返回值：** @@ -5149,7 +5153,7 @@ setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------------------------- | ---- | ---------------------------------------------- | -| isFullScreen | boolean | 是 | 是否设为全屏状态（该全屏状态隐藏状态栏导航栏)。true表示全屏；false表示非全屏。 | +| isFullScreen | boolean | 是 | 是否设为全屏状态（该全屏状态隐藏状态栏导航栏）。true表示全屏；false表示非全屏。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例：** @@ -5205,7 +5209,9 @@ promise.then(()=> { setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void>): void -设置窗口的布局是否为全屏显示状态，使用callback异步回调。 +设置窗口的布局是否为沉浸式布局，使用callback异步回调。 +沉浸式布局是指布局不避让状态栏与导航栏，组件可能产生与其重叠的情况。 +非沉浸式布局是指布局避让状态栏与导航栏，组件不会与其重叠。 > **说明：** > @@ -5217,7 +5223,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------------------------- | ---- | ------------------------------------------------------------ | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态（该全屏状态下状态栏、导航栏仍然显示）。true表示全屏；false表示非全屏。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局（该沉浸式布局状态栏、导航栏仍然显示）。true表示沉浸式布局；false表示非沉浸式布局。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例：** @@ -5237,7 +5243,9 @@ windowClass.setLayoutFullScreen(isLayoutFullScreen, (err) => { setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> -设置窗口的布局是否为全屏显示状态，使用Promise异步回调。 +设置窗口的布局是否为沉浸式布局，使用Promise异步回调。 +沉浸式布局是指布局不避让状态栏与导航栏，组件可能产生与其重叠的情况。 +非沉浸式布局是指布局避让状态栏与导航栏，组件不会与其重叠。 > **说明：** > @@ -5249,7 +5257,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------- | ---- | ------------------------------------------------------------ | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为全屏显示状态（该全屏状态下状态栏、导航栏仍然显示）。true表示全屏；false表示非全屏。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局（该沉浸式布局状态栏、导航栏仍然显示）。true表示沉浸式布局；false表示非沉浸式布局。 | **返回值：**