mirror of
https://gitee.com/openharmony/interface_sdk-js
synced 2024-11-23 07:10:52 +00:00
236 lines
9.4 KiB
TypeScript
236 lines
9.4 KiB
TypeScript
/*
|
|
* Copyright (c) 2023-2024 Huawei Device Co., Ltd.
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
* @kit ArkUI
|
|
*/
|
|
|
|
|
|
import { Callback } from './@ohos.base';
|
|
import window from './@ohos.window';
|
|
/**
|
|
* uiExtensionHost.
|
|
*
|
|
* @namespace uiExtensionHost
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
declare namespace uiExtensionHost {
|
|
/**
|
|
* Transition Controller
|
|
*
|
|
* @interface UIExtensionHostWindowProxy
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
interface UIExtensionHostWindowProxy {
|
|
/**
|
|
* Get the avoid area
|
|
*
|
|
* @param { window.AvoidAreaType } type - Type of the area
|
|
* @returns { window.AvoidArea } Area where the window cannot be displayed.
|
|
* @throws { BusinessError } 401 - Parameter error.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
getWindowAvoidArea(type: window.AvoidAreaType): window.AvoidArea;
|
|
|
|
/**
|
|
* Register the callback of avoidAreaChange
|
|
*
|
|
* @param { 'avoidAreaChange' } type - The value is fixed at 'avoidAreaChange', indicating the event of changes to the avoid area.
|
|
* @param { Callback<{ type: window.AvoidAreaType, area: window.AvoidArea }> } callback - Callback used to return the area.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
on(type: 'avoidAreaChange', callback: Callback<{ type: window.AvoidAreaType, area: window.AvoidArea }>): void;
|
|
|
|
/**
|
|
* Unregister the callback of avoidAreaChange
|
|
*
|
|
* @param { 'avoidAreaChange' } type - The value is fixed at 'avoidAreaChange', indicating the event of changes to the avoid area.
|
|
* @param { Callback<{ type: window.AvoidAreaType, area: window.AvoidArea }> } callback - Callback used to return the area.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
off(type: 'avoidAreaChange', callback?: Callback<{ type: window.AvoidAreaType, area: window.AvoidArea }>): void;
|
|
|
|
/**
|
|
* Register the callback of windowSizeChange
|
|
*
|
|
* @param { 'windowSizeChange' } type - The value is fixed at 'windowSizeChange', indicating the window size change event.
|
|
* @param { Callback<window.Size> } callback - Callback used to return the window size.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
on(type: 'windowSizeChange', callback: Callback<window.Size>): void;
|
|
|
|
/**
|
|
* Unregister the callback of windowSizeChange
|
|
*
|
|
* @param { 'windowSizeChange' } type - The value is fixed at 'windowSizeChange', indicating the window size change event.
|
|
* @param { Callback<window.Size> } callback - Callback used to return the window size.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
off(type: 'windowSizeChange', callback?: Callback<window.Size>): void;
|
|
|
|
/**
|
|
* The properties of the UIExtension window
|
|
*
|
|
* @type { UIExtensionHostWindowProxyProperties }
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
properties: UIExtensionHostWindowProxyProperties;
|
|
|
|
/**
|
|
* Hide the non-secure windows
|
|
*
|
|
* @param { boolean } shouldHide - Hide the non-secure windows if true, otherwise means the opposite.
|
|
* @returns { Promise<void> } - The promise returned by the function.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
/**
|
|
* Hide the non-secure windows.
|
|
* When called by modal UIExtension and shouldHide == false, the "ohos.permission.ALLOW_SHOW_NON_SECURE_WINDOWS" permission is required.
|
|
*
|
|
* @permission ohos.permission.ALLOW_SHOW_NON_SECURE_WINDOWS
|
|
* @param { boolean } shouldHide - Hide the non-secure windows if true, otherwise means the opposite.
|
|
* @returns { Promise<void> } - The promise returned by the function.
|
|
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @throws { BusinessError } 1300002 - Abnormal state. Possible causes:
|
|
* <br> 1. Permission denied. Interface caller does not have permission "ohos.permission.ALLOW_SHOW_NON_SECURE_WINDOWS".
|
|
* <br> 2. The UIExtension window proxy is abnormal.
|
|
* @throws { BusinessError } 1300003 - This window manager service works abnormally.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 12
|
|
*/
|
|
hideNonSecureWindows(shouldHide: boolean): Promise<void>;
|
|
|
|
/**
|
|
* Create sub window.
|
|
*
|
|
* @param { string } name - window name of sub window
|
|
* @param { window.SubWindowOptions } subWindowOptions - options of sub window creation
|
|
* @returns { Promise<window.Window> } Promise used to return the subwindow.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @throws { BusinessError } 801 - Capability not supported. Failed to call the API due to limited device capabilities.
|
|
* @throws { BusinessError } 1300002 - This window state is abnormal.
|
|
* @throws { BusinessError } 1300005 - This window proxy is abnormal.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @StageModelOnly
|
|
* @since 12
|
|
*/
|
|
createSubWindowWithOptions(name: string, subWindowOptions: window.SubWindowOptions): Promise<window.Window>;
|
|
|
|
/**
|
|
* Set the watermark flag on the UIExtension window
|
|
*
|
|
* @param { boolean } enable - Add water mark flag to the UIExtension window if true, or remove flag if false
|
|
* @returns { Promise<void> } - The promise returned by the function
|
|
* @throws { BusinessError } 1300002 - The UIExtension window proxy is abnormal.
|
|
* @throws { BusinessError } 1300003 - This window manager service works abnormally.
|
|
* @throws { BusinessError } 1300008 - The display device is abnormal.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 12
|
|
*/
|
|
setWaterMarkFlag(enable: boolean): Promise<void>;
|
|
|
|
/**
|
|
* Hide the display content when snapshot.
|
|
*
|
|
* @param { boolean } shouldHide - Hide the display content of UIExtensionAbility when the host application takes snapshots if true,
|
|
* otherwise means the opposite.
|
|
* @returns { Promise<void> } - The promise returned by the function.
|
|
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
|
|
* @throws { BusinessError } 401 - Parameter error. Possible causes:
|
|
* <br> 1. Mandatory parameters are left unspecified.
|
|
* <br> 2. Incorrect parameters types.
|
|
* <br> 3. Parameter verification failed.
|
|
* @throws { BusinessError } 1300002 - Abnormal state. Possible causes:
|
|
* <br> 1. The UIExtension window proxy is abnormal.
|
|
* <br> 2. Not the UIExtensionAbility process calling.
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 13
|
|
*/
|
|
hidePrivacyContentForHost(shouldHide: boolean): Promise<void>;
|
|
}
|
|
|
|
/**
|
|
* Properties of UIExtension window
|
|
*
|
|
* @interface UIExtensionHostWindowProxyProperties
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
interface UIExtensionHostWindowProxyProperties {
|
|
/**
|
|
* The position and size of the UIExtension window
|
|
*
|
|
* @type { window.Rect }
|
|
* @syscap SystemCapability.ArkUI.ArkUI.Full
|
|
* @systemapi
|
|
* @since 11
|
|
*/
|
|
uiExtensionHostWindowProxyRect: window.Rect;
|
|
}
|
|
}
|
|
|
|
export default uiExtensionHost;
|