/* * Copyright (c) 2022-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 AbilityKit */ import contextConstant from "./@ohos.app.ability.contextConstant"; import image from "./@ohos.multimedia.image"; import bundleManager from './@ohos.bundle.bundleManager'; /*** if arkts 1.1 */ import CompletionHandler from './@ohos.app.ability.CompletionHandler'; import window from './@ohos.window'; /*** endif */ /** * StartOptions is the basic communication component of the system. * * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since 9 */ /** * StartOptions is the basic communication component of the system. * * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @atomicservice * @since arkts {'1.1':'11', '1.2':'20'} * @arkts 1.1&1.2 */ export default class StartOptions { /** * The type of {@link ohos.app.ability.AbilityConstant#WindowMode} * {@link ohos.app.ability.AbilityConstant#WindowMode.WINDOW_MODE_SPLIT_PRIMARY} and * {@link ohos.app.ability.AbilityConstant#WindowMode.WINDOW_MODE_SPLIT_SECONDARY} are * valid only in intra-app redirection scenarios. * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'12', '1.2':'20'} * @arkts 1.1&1.2 */ windowMode?: number; /** * The type of displayId * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since 9 */ /** * The type of displayId * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @atomicservice * @since arkts {'1.1':'11', '1.2':'20'} * @arkts 1.1&1.2 */ displayId?: number; /** * The target ability with animation or without * * @type { ?boolean } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'11', '1.2':'20'} * @arkts 1.1&1.2 */ withAnimation?: boolean; /** * The left position of window rectangle * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'11', '1.2':'20'} * @arkts 1.1&1.2 */ windowLeft?: number; /** * The top position of window rectangle * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'11', '1.2':'20'} * @arkts 1.1&1.2 */ windowTop?: number; /** * The width of window rectangle * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'11', '1.2':'20'} * @arkts 1.1&1.2 */ windowWidth?: number; /** * The height of window rectangle * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'11', '1.2':'20'} * @arkts 1.1&1.2 */ windowHeight?: number; /** * Indicates the cold startup window is focused. * * @type { ?boolean } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @systemapi * @stagemodelonly * @since arkts {'1.1':'12', '1.2':'20'} * @arkts 1.1&1.2 */ windowFocused?: boolean; /** * The process mode. * This property only takes effect when calling UIAbilityContext.startAbility. * The properties processMode and startupVisibility must be set simultaneously. * * @type { ?contextConstant.ProcessMode } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'12', '1.2':'20'} * @arkts 1.1&1.2 */ processMode?: contextConstant.ProcessMode; /** * The ability visibility after the new process startup. * This property only takes effect when calling UIAbilityContext.startAbility. * The properties processMode and startupVisibility must be set simultaneously. * * @type { ?contextConstant.StartupVisibility } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'12', '1.2':'20'} * @arkts 1.1&1.2 */ startupVisibility?: contextConstant.StartupVisibility; /** * The start window Icon. * * @type { ?image.PixelMap } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'14', '1.2':'20'} * @arkts 1.1&1.2 */ startWindowIcon?: image.PixelMap; /** * The start window backgroundColor. * * @type { ?string } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'14', '1.2':'20'} * @arkts 1.1&1.2 */ startWindowBackgroundColor?: string; /** * The support window modes. * * @type { ?Array } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts {'1.1':'14', '1.2':'20'} * @arkts 1.1&1.2 */ supportWindowModes?: Array; /** * The min width of window rectangle. * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts{ '1.1':'17','1.2':'20'} * @arkts 1.1&1.2 */ minWindowWidth?: number; /** * The min height of window rectangle. * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts{ '1.1':'17','1.2':'20'} * @arkts 1.1&1.2 */ minWindowHeight?: number; /** * The max width of window rectangle. * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts{ '1.1':'17','1.2':'20'} * @arkts 1.1&1.2 */ maxWindowWidth?: number; /** * The max height of window rectangle. * * @type { ?number } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since arkts{ '1.1':'17','1.2':'20'} * @arkts 1.1&1.2 */ maxWindowHeight?: number; /** * The completion handler of StartAbility. * * @type { ?CompletionHandler } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @atomicservice * @since 20 */ completionHandler?: CompletionHandler; /** * Hide start window or not when launch ability from same bundle. * * @type { ?boolean } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since 20 */ hideStartWindow?: boolean; /** * Indicates the window creation parameters during application startup. * * @type { ?window.WindowCreateParams } * @syscap SystemCapability.Ability.AbilityRuntime.Core * @stagemodelonly * @since 20 */ windowCreateParams?: window.WindowCreateParams; }