diff --git a/zh-cn/native_sdk/AbilityKit/ability_runtime/application_context.h b/zh-cn/native_sdk/AbilityKit/ability_runtime/application_context.h index a4137157e425217c72b4b6982b0a750997655a7e..ac401d553422e36bb026dd6c9cdf04d3eb3c8e06 100644 --- a/zh-cn/native_sdk/AbilityKit/ability_runtime/application_context.h +++ b/zh-cn/native_sdk/AbilityKit/ability_runtime/application_context.h @@ -34,121 +34,122 @@ * @since 13 */ -#ifndef ABILITY_RUNTIME_APPLICATION_CONTEXT_H -#define ABILITY_RUNTIME_APPLICATION_CONTEXT_H - -#include -#include -#include -#include "ability_runtime_common.h" -#include "context_constant.h" - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * @brief 获取应用级别上下文的缓存目录。 - * - * @param buffer 指向缓冲区的指针，用于接收应用级别上下文的缓存目录。 - * @param bufferSize 缓冲区大小，单位为字节。 - * @param writeLength 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示实际写入到缓冲区的字符串长度。 - * @return The error code. - * {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 查询成功。 - * {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 入参buffer或者writeLength为空，或者缓冲区大小小于需要写入的大小。 - * @since 13 - */ -AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetCacheDir( - char* buffer, int32_t bufferSize, int32_t* writeLength); - -/** - * @brief 获取应用级别上下文的文件数据加密等级。 - * - * @param areaMode 指向接收数据加密等级的指针 - * @return The error code. - * {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 查询成功。 - * {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 入参areaMode为空。 - * @since 13 - */ -AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetAreaMode(AbilityRuntime_AreaMode* areaMode); - -/** - * @brief 获取应用包名。 - * - * @param buffer 指向缓冲区的指针，用于接收应用包名。 - * @param bufferSize 缓冲区大小，单位为字节。 - * @param writeLength 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示实际写入到缓冲区的字符串长度。 - * @return The error code. - * {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 查询成功。 - * {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 入参buffer或者writeLength为空，或者缓冲区大小小于需要写入的大小。 - * @since 13 - */ -AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetBundleName( - char* buffer, int32_t bufferSize, int32_t* writeLength); - -/** - * @brief 启动当前应用的UIAbility。 - * - * @permission {@code ohos.permission.NDK_START_SELF_UI_ABILITY} - * @param want 启动当前应用UIAbility时需要的Want信息。 - * 详细内容参考 {@link AbilityBase_Want}. - * @return 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示接口调用成功。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PERMISSION_DENIED} 时，表示调用方权限校验失败。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 时，表示调用方入参校验失败。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_SUPPORTED} 时，表示设备类型不支持。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_SUCH_ABILITY} 时，表示指定的Ability名称不存在。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INCORRECT_ABILITY_TYPE} 时，表示接口调用Ability类型错误。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROWDTEST_EXPIRED} 时，表示众测应用到期。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_WUKONG_MODE} 时，表示Wukong模式，不允许启动/停止Ability。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CONTROLLED} 时，表示应用被管控。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_EDM_CONTROLLED} 时，表示应用被EDM管控。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROSS_APP} 时，表示限制API 11以上版本三方应用跳转。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INTERNAL} 时，表示内部错误。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_TOP_ABILITY} 时，表示非顶层应用。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_UPPER_LIMIT_REACHED} 时，表示应用多实例已达到上限（从API17开始）。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_APP_INSTANCE_KEY_NOT_SUPPORTED} 时，表示不允许设置APP_INSTANCE_KEY（从API17开始）。 - * 详细内容参考 {@link AbilityRuntime_ErrorCode}. - * @since 15 - */ -AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbility(AbilityBase_Want *want); - -/** - * @brief 通过StartOptions启动当前应用的UIAbility。 - * - * @permission {@code ohos.permission.NDK_START_SELF_UI_ABILITY} - * @param want 启动当前应用UIAbility时需要的Want信息。 - * 详细内容参考 {@link AbilityBase_Want}。 - * @param options 启动当前应用UIAbility时需要的StartOptions信息。如果该参数中startVisibility属性的值不为空，必须确保当前应用已添加到状态栏， - * 否则会返回ABILITY_RUNTIME_ERROR_VISIBILITY_SETTING_DISABLED错误码。 - * 详细内容参考 {@link AbilityRuntime_StartOptions}。 - * @return 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示接口调用成功。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PERMISSION_DENIED} 时，表示调用方权限校验失败。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 时，表示调用方入参校验失败。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_SUPPORTED} 时，表示设备类型不支持。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_SUCH_ABILITY} 时，表示指定的Ability名称不存在。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INCORRECT_ABILITY_TYPE} 时，表示接口调用Ability类型错误。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROWDTEST_EXPIRED} 时，表示众测应用到期。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_WUKONG_MODE} 时，表示Wukong模式，不允许启动/停止Ability。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CONTROLLED} 时，表示应用被管控。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_EDM_CONTROLLED} 时，表示应用被EDM管控。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROSS_APP} 时，表示限制API 11以上版本三方应用跳转。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INTERNAL} 时，表示内部错误。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_TOP_ABILITY} 时，表示非顶层应用。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_VISIBILITY_SETTING_DISABLED} 时，表示不允许设置窗口启动可见性。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_MULTI_APP_NOT_SUPPORTED} 时，表示不支持应用分身和多实例。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INVALID_APP_INSTANCE_KEY} 时，表示无效多实例。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_UPPER_LIMIT_REACHED} 时，表示应用多实例以达到上限。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_MULTI_INSTANCE_NOT_SUPPORTED} 时，表示不支持应用多实例。 - * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_APP_INSTANCE_KEY_NOT_SUPPORTED} 时，表示不允许设置APP_INSTANCE_KEY。 - * 详细内容参考 {@link AbilityRuntime_ErrorCode}。 - * @since 17 - */ -AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbilityWithStartOptions(AbilityBase_Want *want, - AbilityRuntime_StartOptions *options); - -#ifdef __cplusplus -} // extern "C" -#endif - -/** @} */ -#endif // ABILITY_RUNTIME_APPLICATION_CONTEXT_H + #ifndef ABILITY_RUNTIME_APPLICATION_CONTEXT_H + #define ABILITY_RUNTIME_APPLICATION_CONTEXT_H + + #include + #include + #include + #include "ability_runtime_common.h" + #include "context_constant.h" + + #ifdef __cplusplus + extern "C" { + #endif + + /** + * @brief 获取应用级别上下文的缓存目录。 + * + * @param buffer 指向缓冲区的指针，用于接收应用级别上下文的缓存目录。 + * @param bufferSize 缓冲区大小，单位为字节。 + * @param writeLength 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示实际写入到缓冲区的字符串长度。 + * @return The error code. + * {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 查询成功。 + * {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 入参buffer或者writeLength为空，或者缓冲区大小小于需要写入的大小。 + * @since 13 + */ + AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetCacheDir( + char* buffer, int32_t bufferSize, int32_t* writeLength); + + /** + * @brief 获取应用级别上下文的文件数据加密等级。 + * + * @param areaMode 指向接收数据加密等级的指针 + * @return The error code. + * {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 查询成功。 + * {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 入参areaMode为空。 + * @since 13 + */ + AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetAreaMode(AbilityRuntime_AreaMode* areaMode); + + /** + * @brief 获取应用包名。 + * + * @param buffer 指向缓冲区的指针，用于接收应用包名。 + * @param bufferSize 缓冲区大小，单位为字节。 + * @param writeLength 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示实际写入到缓冲区的字符串长度。 + * @return The error code. + * {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 查询成功。 + * {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 入参buffer或者writeLength为空，或者缓冲区大小小于需要写入的大小。 + * @since 13 + */ + AbilityRuntime_ErrorCode OH_AbilityRuntime_ApplicationContextGetBundleName( + char* buffer, int32_t bufferSize, int32_t* writeLength); + + /** + * @brief 启动当前应用的UIAbility。 + * + * @permission {@code ohos.permission.NDK_START_SELF_UI_ABILITY} + * @param want 启动当前应用UIAbility时需要的Want信息。 + * 详细内容参考 {@link AbilityBase_Want}. + * @return 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示接口调用成功。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PERMISSION_DENIED} 时，表示调用方权限校验失败。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 时，表示调用方入参校验失败。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_SUPPORTED} 时，表示设备类型不支持。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_SUCH_ABILITY} 时，表示指定的Ability名称不存在。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INCORRECT_ABILITY_TYPE} 时，表示接口调用Ability类型错误。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROWDTEST_EXPIRED} 时，表示众测应用到期。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_WUKONG_MODE} 时，表示Wukong模式，不允许启动/停止Ability。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CONTROLLED} 时，表示应用被管控。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_EDM_CONTROLLED} 时，表示应用被EDM管控。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROSS_APP} 时，表示限制API 11以上版本三方应用跳转。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INTERNAL} 时，表示内部错误。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_TOP_ABILITY} 时，表示非顶层应用。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_UPPER_LIMIT_REACHED} 时，表示应用多实例已达到上限（从API17开始）。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_APP_INSTANCE_KEY_NOT_SUPPORTED} 时，表示不允许设置APP_INSTANCE_KEY（从API17开始）。 + * 详细内容参考 {@link AbilityRuntime_ErrorCode}. + * @since 15 + */ + AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbility(AbilityBase_Want *want); + + /** + * @brief 通过StartOptions启动当前应用的UIAbility。 + * + * @permission {@code ohos.permission.NDK_START_SELF_UI_ABILITY} + * @param want 启动当前应用UIAbility时需要的Want信息。 + * 详细内容参考 {@link AbilityBase_Want}。 + * @param options 启动当前应用UIAbility时需要的StartOptions信息。如果该参数中startVisibility属性的值不为空，必须确保当前应用已添加到状态栏， + * 否则会返回ABILITY_RUNTIME_ERROR_VISIBILITY_SETTING_DISABLED错误码。 + * 详细内容参考 {@link AbilityRuntime_StartOptions}。 + * @return 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} 时，表示接口调用成功。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PERMISSION_DENIED} 时，表示调用方权限校验失败。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} 时，表示调用方入参校验失败。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_SUPPORTED} 时，表示设备类型不支持。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NO_SUCH_ABILITY} 时，表示指定的Ability名称不存在。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INCORRECT_ABILITY_TYPE} 时，表示接口调用Ability类型错误。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROWDTEST_EXPIRED} 时，表示众测应用到期。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_WUKONG_MODE} 时，表示Wukong模式，不允许启动/停止Ability。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CONTROLLED} 时，表示应用被管控。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_EDM_CONTROLLED} 时，表示应用被EDM管控。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_CROSS_APP} 时，表示限制API 11以上版本三方应用跳转。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INTERNAL} 时，表示内部错误。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_NOT_TOP_ABILITY} 时，表示非顶层应用。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_VISIBILITY_SETTING_DISABLED} 时，表示不允许设置窗口启动可见性。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_MULTI_APP_NOT_SUPPORTED} 时，表示不支持应用分身和多实例。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_INVALID_APP_INSTANCE_KEY} 时，表示无效多实例。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_UPPER_LIMIT_REACHED} 时，表示应用多实例以达到上限。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_MULTI_INSTANCE_NOT_SUPPORTED} 时，表示不支持应用多实例。 + * 在返回 {@link ABILITY_RUNTIME_ERROR_CODE_APP_INSTANCE_KEY_NOT_SUPPORTED} 时，表示不允许设置APP_INSTANCE_KEY。 + * 详细内容参考 {@link AbilityRuntime_ErrorCode}。 + * @since 17 + */ + AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbilityWithStartOptions(AbilityBase_Want *want, + AbilityRuntime_StartOptions *options); + + #ifdef __cplusplus + } // extern "C" + #endif + + /** @} */ + #endif // ABILITY_RUNTIME_APPLICATION_CONTEXT_H + \ No newline at end of file diff --git a/zh-cn/native_sdk/AbilityKit/ability_runtime/context_constant.h b/zh-cn/native_sdk/AbilityKit/ability_runtime/context_constant.h index a7557bba3e1c89a876604e68280607870919d353..0643b099a72e06a22399caad33c2aae5c96c8fa5 100644 --- a/zh-cn/native_sdk/AbilityKit/ability_runtime/context_constant.h +++ b/zh-cn/native_sdk/AbilityKit/ability_runtime/context_constant.h @@ -17,7 +17,7 @@ * @addtogroup AbilityRuntime * @{ * - * @brief 提供AbilityRuntime模块上下文常量的定义。 + * @brief 提供AbilityRuntime模块上下文常量的描述。 * * @syscap SystemCapability.Ability.AbilityRuntime.Core * @since 13 @@ -34,110 +34,111 @@ * @since 13 */ -#ifndef ABILITY_RUNTIME_CONTEXT_CONSTANT_H -#define ABILITY_RUNTIME_CONTEXT_CONSTANT_H - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * @brief 文件数据加密等级。 + #ifndef ABILITY_RUNTIME_CONTEXT_CONSTANT_H + #define ABILITY_RUNTIME_CONTEXT_CONSTANT_H + + #ifdef __cplusplus + extern "C" { + #endif + + /** + * @brief 文件数据加密等级。 + * + * @since 13 + */ + typedef enum { + /** + * 设备级加密区，设备开机后可访问的数据区。 + */ + ABILITY_RUNTIME_AREA_MODE_EL1 = 0, + /** + * 用户级加密区，设备开机，首次输入密码后才能够访问的数据区。 + */ + ABILITY_RUNTIME_AREA_MODE_EL2 = 1, + /** + * 用户级加密区，不同场景的文件权限如下： + * 已打开文件：锁屏时，可读写；解锁后，可读写。 + * 未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。 + * 创建新文件：锁屏时，可创建、可打开、可写不可读；解锁后，可创建、可打开、可读写。 + */ + ABILITY_RUNTIME_AREA_MODE_EL3 = 2, + /** + * 用户级加密区，不同场景的文件权限如下： + * 已打开文件：锁屏时，FEB2.0可读写、FEB3.0不可读写；解锁后，可读写。 + * 未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。 + * 创建新文件：锁屏时，不可创建；解锁后，可创建、可打开、可读写。 + */ + ABILITY_RUNTIME_AREA_MODE_EL4 = 3, + /** + * 应用级加密区，不同场景的文件权限如下： + * 已打开文件：锁屏时，可读写；解锁后，可读写。 + * 未打开文件：锁屏时，获取DataAccessLock（JS API）下可打开、可读写，否则不可打开、不可读写；解锁后，可打开、可读写。 + * 创建新文件：锁屏时，可创建、可打开、可读写；解锁后，可创建、可打开、可读写。 + */ + ABILITY_RUNTIME_AREA_MODE_EL5 = 4, + } AbilityRuntime_AreaMode; + + /** + * @brief 启动Ability时的窗口和dock栏图标的显示模式。 + * + * @since 17 + */ + typedef enum { + /** + * 隐藏窗口及dock栏图标。仅在2in1设备上生效。 + */ + ABILITY_RUNTIME_HIDE_UPON_START = 0, + + /** + * 显示窗口及dock栏图标。仅在2in1设备上生效。 + */ + ABILITY_RUNTIME_SHOW_UPON_START = 1, + } AbilityRuntime_StartVisibility; + + /** + * @brief 窗口模式。 * - * @since 13 + * @since 17 */ -typedef enum { - /** - * 设备级加密区，设备开机后可访问的数据区。 - */ - ABILITY_RUNTIME_AREA_MODE_EL1 = 0, - /** - * 用户级加密区，设备开机，首次输入密码后才能够访问的数据区。 - */ - ABILITY_RUNTIME_AREA_MODE_EL2 = 1, - /** - * 用户级加密区，不同场景的文件权限如下： - * 已打开文件：锁屏时，可读写；解锁后，可读写。 - * 未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。 - * 创建新文件：锁屏时，可创建、可打开、可写不可读；解锁后，可创建、可打开、可读写。 - */ - ABILITY_RUNTIME_AREA_MODE_EL3 = 2, - /** - * 用户级加密区，不同场景的文件权限如下： - * 已打开文件：锁屏时，FEB2.0可读写、FEB3.0不可读写；解锁后，可读写。 - * 未打开文件：锁屏时，不可打开、不可读写；解锁后，可打开、可读写。 - * 创建新文件：锁屏时，不可创建；解锁后，可创建、可打开、可读写。 - */ - ABILITY_RUNTIME_AREA_MODE_EL4 = 3, - /** - * 应用级加密区，不同场景的文件权限如下： - * 已打开文件：锁屏时，可读写；解锁后，可读写。 - * 未打开文件：锁屏时，获取DataAccessLock（JS API）下可打开、可读写，否则不可打开、不可读写；解锁后，可打开、可读写。 - * 创建新文件：锁屏时，可创建、可打开、可读写；解锁后，可创建、可打开、可读写。 - */ - ABILITY_RUNTIME_AREA_MODE_EL5 = 4, -} AbilityRuntime_AreaMode; - -/** - * @brief 启动Ability时的窗口和dock栏图标的显示模式。 + typedef enum { + /** + * 窗口模式未定义。 + */ + ABILITY_RUNTIME_WINDOW_MODE_UNDEFINED = 0, + /** + * 全屏模式。 + */ + ABILITY_RUNTIME_WINDOW_MODE_FULL_SCREEN = 1, + } AbilityRuntime_WindowMode; + + /** + * 组件所支持的窗口模式。 + * 在应用内启动UIAbility时，指定窗口是否显示最大化/窗口化/分屏按键。 * * @since 17 */ -typedef enum { - /** - * 隐藏窗口及dock栏图标。仅在2in1设备上生效。 - */ - ABILITY_RUNTIME_HIDE_UPON_START = 0, - - /** - * 显示窗口及dock栏图标。仅在2in1设备上生效。 - */ - ABILITY_RUNTIME_SHOW_UPON_START = 1, -} AbilityRuntime_StartVisibility; - -/** -* @brief 窗口模式。 -* -* @since 17 -*/ -typedef enum { - /** - * 窗口模式未定义。 - */ - ABILITY_RUNTIME_WINDOW_MODE_UNDEFINED = 0, - /** - * 全屏模式。 - */ - ABILITY_RUNTIME_WINDOW_MODE_FULL_SCREEN = 1, -} AbilityRuntime_WindowMode; - -/** -* 组件所支持的窗口模式。 -* 在应用内启动UIAbility时，指定窗口是否显示最大化/窗口化/分屏按键。 -* -* @since 17 -*/ -typedef enum { - /** - * 窗口支持全屏显示。 - */ - ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FULL_SCREEN = 0, - /** - * 窗口支持分屏显示。 - * 通常需要配合ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FULL_SCREEN或ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FLOATING一起使用， - * 不建议只配置ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT。 - * 当仅配置ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT时，2in1设备上的窗口默认为悬浮窗模式，支持进入分屏模式。 - */ - ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT = 1, - /** - * 支持窗口化显示。 - */ - ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FLOATING = 2, -} AbilityRuntime_SupportedWindowMode; - -#ifdef __cplusplus -} // extern "C" -#endif - -/** @} */ -#endif // ABILITY_RUNTIME_CONTEXT_CONSTANT_H + typedef enum { + /** + * 窗口支持全屏显示。 + */ + ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FULL_SCREEN = 0, + /** + * 窗口支持分屏显示。 + * 通常需要配合ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FULL_SCREEN或ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FLOATING一起使用， + * 不建议只配置ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT。 + * 当仅配置ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT时，2in1设备上的窗口默认为悬浮窗模式，支持进入分屏模式。 + */ + ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_SPLIT = 1, + /** + * 支持窗口化显示。 + */ + ABILITY_RUNTIME_SUPPORTED_WINDOW_MODE_FLOATING = 2, + } AbilityRuntime_SupportedWindowMode; + + #ifdef __cplusplus + } // extern "C" + #endif + + /** @} */ + #endif // ABILITY_RUNTIME_CONTEXT_CONSTANT_H + \ No newline at end of file