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 bfee7e004ccd2290f269c66e2ae209ede3a2a326..73f452dca94417290c29d40b9bfd4e44083e9ddf 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 @@ -2740,7 +2740,7 @@ try { on(type: 'keyboardHeightChange', callback: Callback<number>): void -开启键盘高度变化的监听。 +开启固定态输入法窗口软键盘高度变化的监听。从API version 10开始,改变输入法窗口为固定态或者悬浮态方法详细介绍请参见[输入法服务](js-apis-inputmethodengine.md#changeflag10)。 **系统能力:** SystemCapability.WindowManager.WindowManager.Core @@ -2767,7 +2767,7 @@ try { off(type: 'keyboardHeightChange', callback?: Callback<number>): void -关闭键盘高度变化的监听。 +关闭固定态输入法窗口软键盘高度变化的监听。从API version 10开始,改变输入法窗口为固定态或者悬浮态方法详细介绍请参见[输入法服务](js-apis-inputmethodengine.md#changeflag10)。 **系统能力:** SystemCapability.WindowManager.WindowManager.Core @@ -5389,7 +5389,9 @@ promise.then((data)=> { setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void -设置是否为全屏状态,使用callback异步回调。 +设置窗口的布局是否为全屏布局,使用callback异步回调。 +全屏布局是指窗口大小为全屏幕,状态栏与导航栏不显示。 +非全屏布局是指状态栏与导航栏显示,窗口大小避让状态栏与导航栏位置。 > **说明:** > @@ -5401,7 +5403,7 @@ setFullScreen(isFullScreen: boolean, callback: AsyncCallback<void>): void | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------------------------- | ---- | ---------------------------------------------- | -| isFullScreen | boolean | 是 | 是否设为全屏状态(该全屏状态隐藏状态栏导航栏)。true表示全屏;false表示非全屏。 | +| isFullScreen | boolean | 是 | 是否设为全屏布局(该全屏布局影响状态栏导航栏显示)。true表示全屏;false表示非全屏。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例:** @@ -5421,7 +5423,9 @@ windowClass.setFullScreen(isFullScreen, (err) => { setFullScreen(isFullScreen: boolean): Promise<void> -设置是否为全屏状态,使用Promise异步回调。 +设置窗口的布局是否为全屏布局,使用Promise异步回调。 +全屏布局是指窗口大小为全屏幕,状态栏与导航栏不显示。 +非全屏布局是指状态栏与导航栏显示,窗口大小避让状态栏与导航栏位置。 > **说明:** > @@ -5433,7 +5437,7 @@ setFullScreen(isFullScreen: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------------ | ------- | ---- | ---------------------------------------------- | -| isFullScreen | boolean | 是 | 是否设为全屏状态(该全屏状态隐藏状态栏导航栏)。true表示全屏;false表示非全屏。 | +| isFullScreen | boolean | 是 | 是否设为全屏布局(该全屏布局影响状态栏导航栏显示)。true表示全屏;false表示非全屏。 | **返回值:** @@ -5471,7 +5475,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean, callback: AsyncCallback<void | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------------------------- | ---- | ------------------------------------------------------------ | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局状态栏、导航栏仍然显示)。true表示沉浸式布局;false表示非沉浸式布局。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局不影响状态栏、导航栏显示)。true表示沉浸式布局;false表示非沉浸式布局。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例:** @@ -5505,7 +5509,7 @@ setLayoutFullScreen(isLayoutFullScreen: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------------------ | ------- | ---- | ------------------------------------------------------------ | -| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局状态栏、导航栏仍然显示)。true表示沉浸式布局;false表示非沉浸式布局。 | +| isLayoutFullScreen | boolean | 是 | 窗口的布局是否为沉浸式布局(该沉浸式布局不影响状态栏、导航栏显示)。true表示沉浸式布局;false表示非沉浸式布局。 | **返回值:** @@ -5529,7 +5533,7 @@ promise.then(()=> { setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallback<void>): void -设置导航栏、状态栏的可见模式,使用callback异步回调。 +设置窗口全屏模式时导航栏、状态栏的可见模式,使用callback异步回调。 > **说明:** > @@ -5541,7 +5545,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>, callback: AsyncCallbac | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------- | ---- | ------------------------------------------------------------ | -| names | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | +| names | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | | callback | AsyncCallback<void> | 是 | 回调函数。 | **示例:** @@ -5562,7 +5566,7 @@ windowClass.setSystemBarEnable(names, (err) => { setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void> -设置导航栏、状态栏的可见模式,使用Promise异步回调。 +设置窗口全屏模式时导航栏、状态栏的可见模式,使用Promise异步回调。 > **说明:** > @@ -5574,7 +5578,7 @@ setSystemBarEnable(names: Array<'status' | 'navigation'>): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------- | ---- | ------------------------ | -| names | Array<'status'\|'navigation'> | 是 | 设置状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | +| names | Array<'status'\|'navigation'> | 是 | 设置窗口全屏模式时状态栏和导航栏是否显示。
例如,需全部显示,该参数设置为['status', 'navigation'];不设置,则默认不显示。 | **返回值:** @@ -5599,7 +5603,7 @@ promise.then(()=> { setSystemBarProperties(systemBarProperties: SystemBarProperties, callback: AsyncCallback<void>): void -设置窗口内导航栏、状态栏的属性,使用callback异步回调。 +设置窗口全屏模式时窗口内导航栏、状态栏的属性,使用callback异步回调。 > **说明:** > @@ -5637,7 +5641,7 @@ windowClass.setSystemBarProperties(SystemBarProperties, (err) => { setSystemBarProperties(systemBarProperties: SystemBarProperties): Promise<void> -设置窗口内导航栏、状态栏的属性,使用Promise异步回调。 +设置窗口全屏模式时窗口内导航栏、状态栏的属性,使用Promise异步回调。 > **说明:** >