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 09d6dd5442c2223788af699b40b96de54063bda2..5e8d266e65a54423abf8eae142801144eef8248f 100644 --- 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<void>): void -设置导航栏、状态栏的可见模式,使用callback异步回调。 +设置窗口全屏模式时导航栏、状态栏的可见模式,使用callback异步回调。 **系统能力:** SystemCapability.WindowManager.WindowManager.Core @@ -2160,7 +2160,7 @@ setWindowSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncC | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------- | -- | --------- | -| names | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | +| names | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **错误码:** @@ -2194,7 +2194,7 @@ try { setWindowSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void> -设置导航栏、状态栏的可见模式,使用Promise异步回调。 +设置窗口全屏模式时导航栏、状态栏的可见模式,使用Promise异步回调。 **系统能力:** SystemCapability.WindowManager.WindowManager.Core @@ -2202,7 +2202,7 @@ setWindowSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void | 参数名 | 类型 | 必填 | 说明 | | ----- | ---------------------------- | -- | --------------------------------- | -| names | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | +| names | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | **返回值:** @@ -2240,7 +2240,7 @@ try { setWindowSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback<void>): void -设置窗口内导航栏、状态栏的属性,使用callback异步回调。 +设置窗口全屏模式时窗口内导航栏、状态栏的属性,使用callback异步回调。 **系统能力:** SystemCapability.WindowManager.WindowManager.Core @@ -2287,7 +2287,7 @@ try { setWindowSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<void> -设置窗口内导航栏、状态栏的属性,使用Promise异步回调。 +设置窗口全屏模式时窗口内导航栏、状态栏的属性,使用Promise异步回调。 **系统能力:** SystemCapability.WindowManager.WindowManager.Core @@ -2795,7 +2795,7 @@ try { on(type: 'keyboardHeightChange', callback: Callback<number>): void -开启键盘高度变化的监听。 +开启固定态输入法窗口软键盘高度变化的监听。从API version 10开始,改变输入法窗口为固定态或者悬浮态方法详细介绍请参见[输入法服务](js-apis-inputmethodengine.md#changeflag10)。 **系统能力:** SystemCapability.WindowManager.WindowManager.Core @@ -2822,7 +2822,7 @@ try { off(type: 'keyboardHeightChange', callback?: Callback<number>): 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<void>): void -设置是否为全屏状态,使用callback异步回调。 +设置窗口的布局是否为全屏布局,使用callback异步回调。 +全屏布局是指窗口大小为全屏幕,状态栏与导航栏不显示。 +非全屏布局是指状态栏与导航栏显示,窗口大小避让状态栏与导航栏位置。 > **说明:** > @@ -5456,7 +5458,7 @@ setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------------------------- | ---- | ---------------------------------------------- | -| isFullScreen | boolean | 是 | 是否设为全屏状态(该全屏状态隐藏状态栏导航栏)。true表示全屏;false表示非全屏。 | +| isFullScreen | boolean | 是 | 是否设为全屏布局(该全屏布局影响状态栏导航栏显示)。true表示全屏;false表示非全屏。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例:** @@ -5476,7 +5478,9 @@ windowClass.setFullScreen(isFullScreen, (err) => { setFullScreen(isFullScreen: boolean): Promise<void> -设置是否为全屏状态,使用Promise异步回调。 +设置窗口的布局是否为全屏布局,使用Promise异步回调。 +全屏布局是指窗口大小为全屏幕,状态栏与导航栏不显示。 +非全屏布局是指状态栏与导航栏显示,窗口大小避让状态栏与导航栏位置。 > **说明:** > @@ -5488,7 +5492,7 @@ setFullScreen(isFullScreen: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------- | ---- | ---------------------------------------------- | -| isFullScreen | boolean | 是 | 是否设为全屏状态(该全屏状态隐藏状态栏导航栏)。true表示全屏;false表示非全屏。 | +| isFullScreen | boolean | 是 | 是否设为全屏布局(该全屏布局影响状态栏导航栏显示)。true表示全屏;false表示非全屏。 | **返回值:** @@ -5526,7 +5530,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------------------------- | ---- | ------------------------------------------------------------ | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局状态栏、导航栏仍然显示)。true表示沉浸式布局;false表示非沉浸式布局。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局不影响状态栏、导航栏显示)。true表示沉浸式布局;false表示非沉浸式布局。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例:** @@ -5560,7 +5564,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------- | ---- | ------------------------------------------------------------ | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局状态栏、导航栏仍然显示)。true表示沉浸式布局;false表示非沉浸式布局。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局不影响状态栏、导航栏显示)。true表示沉浸式布局;false表示非沉浸式布局。 | **返回值:** @@ -5584,7 +5588,7 @@ promise.then(()=> { setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallback<void>): void -设置导航栏、状态栏的可见模式,使用callback异步回调。 +设置窗口全屏模式时导航栏、状态栏的可见模式,使用callback异步回调。 > **说明:** > @@ -5596,7 +5600,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallbac | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------- | ---- | ------------------------------------------------------------ | -| names | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | +| names | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例:** @@ -5617,7 +5621,7 @@ windowClass.setSystemBarEnable(names, (err) => { setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void> -设置导航栏、状态栏的可见模式,使用Promise异步回调。 +设置窗口全屏模式时导航栏、状态栏的可见模式,使用Promise异步回调。 > **说明:** > @@ -5629,7 +5633,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------- | ---- | ------------------------ | -| names | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | +| names | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | **返回值:** @@ -5654,7 +5658,7 @@ promise.then(()=> { setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback<void>): void -设置窗口内导航栏、状态栏的属性,使用callback异步回调。 +设置窗口全屏模式时窗口内导航栏、状态栏的属性,使用callback异步回调。 > **说明:** > @@ -5692,7 +5696,7 @@ windowClass.setSystemBarProperties(SystemBarProperties, (err) => { setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<void> -设置窗口内导航栏、状态栏的属性,使用Promise异步回调。 +设置窗口全屏模式时窗口内导航栏、状态栏的属性,使用Promise异步回调。 > **说明:** >