!19854 窗口管理文档描述更新

Merge pull request !19854 from ZhengJiangliang/master

!19854 窗口管理文档描述更新
Merge pull request !19854 from ZhengJiangliang/master
9daa1cf5 · openharmony_ci · Gitee · 91f68a77 · 059b11e7 · 9daa1cf5
隐藏空白更改
内联并排

Showing with 24 addition and 20 deletion

zh-cn/application-dev/reference/apis/js-apis-window.md zh-cn/application-dev/reference/apis/js-apis-window.md +24 -20

未找到文件。
--- a/zh-cn/application-dev/reference/apis/js-apis-window.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-window.md
@@ -2152,7 +2152,7 @@ try {

 setWindowSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallback&lt;void&gt;): void

-设置导航栏、状态栏的可见模式，使用callback异步回调。
+设置窗口全屏模式时导航栏、状态栏的可见模式，使用callback异步回调。

 **系统能力：** SystemCapability.WindowManager.WindowManager.Core

@@ -2160,7 +2160,7 @@ setWindowSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncC

 | 参数名 | 类型 | 必填 | 说明 |
 | -------- | ---------------------------- | -- | --------- |
-| names    | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |
+| names    | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |
 | callback | AsyncCallback&lt;void&gt; | 是 | 回调函数。 |

 **错误码：**
@@ -2194,7 +2194,7 @@ try {

 setWindowSystemBarEnable(names: Array<'status' | 'navigation'>): Promise&lt;void&gt;

-设置导航栏、状态栏的可见模式，使用Promise异步回调。
+设置窗口全屏模式时导航栏、状态栏的可见模式，使用Promise异步回调。

 **系统能力：** SystemCapability.WindowManager.WindowManager.Core

@@ -2202,7 +2202,7 @@ setWindowSystemBarEnable(names: Array<'status' | 'navigation'>): Promise&lt;void

 | 参数名 | 类型  | 必填 | 说明 |
 | ----- | ---------------------------- | -- | --------------------------------- |
-| names | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |
+| names | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |

 **返回值：**

@@ -2240,7 +2240,7 @@ try {

 setWindowSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback&lt;void&gt;): void

-设置窗口内导航栏、状态栏的属性，使用callback异步回调。
+设置窗口全屏模式时窗口内导航栏、状态栏的属性，使用callback异步回调。

 **系统能力：** SystemCapability.WindowManager.WindowManager.Core

@@ -2287,7 +2287,7 @@ try {

 setWindowSystemBarProperties(systemBarProperties: SystemBarProperties): Promise&lt;void&gt;

-设置窗口内导航栏、状态栏的属性，使用Promise异步回调。
+设置窗口全屏模式时窗口内导航栏、状态栏的属性，使用Promise异步回调。

 **系统能力：** SystemCapability.WindowManager.WindowManager.Core

@@ -2795,7 +2795,7 @@ try {

 on(type: 'keyboardHeightChange', callback: Callback&lt;number&gt;): void

-开启键盘高度变化的监听。
+开启固定态输入法窗口软键盘高度变化的监听。从API version 10开始，改变输入法窗口为固定态或者悬浮态方法详细介绍请参见[输入法服务](js-apis-inputmethodengine.md#changeflag10)。

 **系统能力：** SystemCapability.WindowManager.WindowManager.Core

@@ -2822,7 +2822,7 @@ try {

 off(type: 'keyboardHeightChange', callback?: Callback&lt;number&gt;): void

-关闭键盘高度变化的监听。
+关闭固定态输入法窗口软键盘高度变化的监听。从API version 10开始，改变输入法窗口为固定态或者悬浮态方法详细介绍请参见[输入法服务](js-apis-inputmethodengine.md#changeflag10)。

 **系统能力：** SystemCapability.WindowManager.WindowManager.Core

@@ -5444,7 +5444,9 @@ promise.then((data)=> {

 setFullScreen(isFullScreen: boolean, callback: AsyncCallback&lt;void&gt;): void

-设置是否为全屏状态，使用callback异步回调。
+设置窗口的布局是否为全屏布局，使用callback异步回调。
+全屏布局是指窗口大小为全屏幕，状态栏与导航栏不显示。
+非全屏布局是指状态栏与导航栏显示，窗口大小避让状态栏与导航栏位置。

 > **说明：**
 >
@@ -5456,7 +5458,7 @@ setFullScreen(isFullScreen: boolean, callback: AsyncCallback&lt;void&gt;): void

 | 参数名       | 类型                      | 必填 | 说明                                           |
 | ------------ | ------------------------- | ---- | ---------------------------------------------- |
-| isFullScreen | boolean                   | 是   | 是否设为全屏状态（该全屏状态隐藏状态栏导航栏）。true表示全屏；false表示非全屏。 |
+| isFullScreen | boolean                   | 是   | 是否设为全屏布局（该全屏布局影响状态栏导航栏显示）。true表示全屏；false表示非全屏。 |
 | callback     | AsyncCallback&lt;void&gt; | 是   | 回调函数。                                     |

 **示例：**
@@ -5476,7 +5478,9 @@ windowClass.setFullScreen(isFullScreen, (err) => {

 setFullScreen(isFullScreen: boolean): Promise&lt;void&gt;

-设置是否为全屏状态，使用Promise异步回调。
+设置窗口的布局是否为全屏布局，使用Promise异步回调。
+全屏布局是指窗口大小为全屏幕，状态栏与导航栏不显示。
+非全屏布局是指状态栏与导航栏显示，窗口大小避让状态栏与导航栏位置。

 > **说明：**
 >
@@ -5488,7 +5492,7 @@ setFullScreen(isFullScreen: boolean): Promise&lt;void&gt;

 | 参数名       | 类型    | 必填 | 说明                                           |
 | ------------ | ------- | ---- | ---------------------------------------------- |
-| isFullScreen | boolean | 是   | 是否设为全屏状态（该全屏状态隐藏状态栏导航栏）。true表示全屏；false表示非全屏。 |
+| isFullScreen | boolean | 是   | 是否设为全屏布局（该全屏布局影响状态栏导航栏显示）。true表示全屏；false表示非全屏。 |

 **返回值：**

@@ -5526,7 +5530,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback&lt;void

 | 参数名             | 类型                      | 必填 | 说明                                                         |
 | ------------------ | ------------------------- | ---- | ------------------------------------------------------------ |
-| isLayoutFullScreen | boolean                   | 是   | 窗口的布局是否为沉浸式布局（该沉浸式布局状态栏、导航栏仍然显示）。true表示沉浸式布局；false表示非沉浸式布局。 |
+| isLayoutFullScreen | boolean                   | 是   | 窗口的布局是否为沉浸式布局（该沉浸式布局不影响状态栏、导航栏显示）。true表示沉浸式布局；false表示非沉浸式布局。 |
 | callback           | AsyncCallback&lt;void&gt; | 是   | 回调函数。                                                   |

 **示例：**
@@ -5560,7 +5564,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean): Promise&lt;void&gt;

 | 参数名             | 类型    | 必填 | 说明                                                         |
 | ------------------ | ------- | ---- | ------------------------------------------------------------ |
-| isLayoutFullScreen | boolean | 是   | 窗口的布局是否为沉浸式布局（该沉浸式布局状态栏、导航栏仍然显示）。true表示沉浸式布局；false表示非沉浸式布局。 |
+| isLayoutFullScreen | boolean | 是   | 窗口的布局是否为沉浸式布局（该沉浸式布局不影响状态栏、导航栏显示）。true表示沉浸式布局；false表示非沉浸式布局。 |

 **返回值：**

@@ -5584,7 +5588,7 @@ promise.then(()=> {

 setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallback&lt;void&gt;): void

-设置导航栏、状态栏的可见模式，使用callback异步回调。
+设置窗口全屏模式时导航栏、状态栏的可见模式，使用callback异步回调。

 > **说明：**
 >
@@ -5596,7 +5600,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallbac

 | 参数名   | 类型                      | 必填 | 说明                                                         |
 | -------- | ---------------------------- | ---- | ------------------------------------------------------------ |
-| names    | Array<'status'\|'navigation'> | 是   | 设置状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |
+| names    | Array<'status'\|'navigation'> | 是   | 设置窗口全屏模式时状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |
 | callback | AsyncCallback&lt;void&gt; | 是   | 回调函数。                                                   |

 **示例：**
@@ -5617,7 +5621,7 @@ windowClass.setSystemBarEnable(names, (err) => {

 setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise&lt;void&gt;

-设置导航栏、状态栏的可见模式，使用Promise异步回调。
+设置窗口全屏模式时导航栏、状态栏的可见模式，使用Promise异步回调。

 > **说明：**
 >
@@ -5629,7 +5633,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise&lt;void&gt;

 | 参数名 | 类型  | 必填 | 说明                                                         |
 | ------ | ---------------------------- | ---- | ------------------------ |
-| names  | Array<'status'\|'navigation'> | 是   | 设置状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |
+| names  | Array<'status'\|'navigation'> | 是   | 设置窗口全屏模式时状态栏和导航栏是否显示。<br>例如，需全部显示，该参数设置为['status',&nbsp;'navigation']；不设置，则默认不显示。 |

 **返回值：**

@@ -5654,7 +5658,7 @@ promise.then(()=> {

 setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback&lt;void&gt;): void

-设置窗口内导航栏、状态栏的属性，使用callback异步回调。
+设置窗口全屏模式时窗口内导航栏、状态栏的属性，使用callback异步回调。

 > **说明：**
 >
@@ -5692,7 +5696,7 @@ windowClass.setSystemBarProperties(SystemBarProperties, (err) => {

 setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise&lt;void&gt;

-设置窗口内导航栏、状态栏的属性，使用Promise异步回调。
+设置窗口全屏模式时窗口内导航栏、状态栏的属性，使用Promise异步回调。

 > **说明：**
 >