1 /* 2 * Copyright (c) 2021 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16 #ifndef OHOS_ABILITY_RUNTIME_PAGE_ABILITY_IMPL_H 17 #define OHOS_ABILITY_RUNTIME_PAGE_ABILITY_IMPL_H 18 19 #include "ability_impl.h" 20 21 namespace OHOS { 22 namespace AppExecFwk { 23 class Ability; 24 class AbilityHandler; 25 class AbilityLocalRecord; 26 class AbilityImpl; 27 class PageAbilityImpl final : public AbilityImpl { 28 public: 29 /** 30 * @brief Constructor. 31 * 32 */ 33 PageAbilityImpl() = default; 34 35 /** 36 * @brief Destructor. 37 * 38 */ 39 ~PageAbilityImpl() = default; 40 41 /** 42 * @brief Handling the life cycle switching of PageAbility. 43 * 44 * @param want Indicates the structure containing information about the ability. 45 * @param targetState The life cycle state to switch to. 46 * 47 */ 48 void HandleAbilityTransaction(const Want &want, const AAFwk::LifeCycleStateInfo &targetState) override; 49 50 /** 51 * @brief Handling the life cycle switching of PageAbility in switch. 52 * 53 * @param want Indicates the structure containing information about the ability. 54 * @param targetState The life cycle state to switch to. 55 * 56 * @return return true if the lifecycle transaction successfully, otherwise return false. 57 * 58 */ 59 bool AbilityTransaction(const Want &want, const AAFwk::LifeCycleStateInfo &targetState); 60 61 /** 62 * @brief Execution the KeyDown callback of the ability 63 * @param keyEvent Indicates the key-down event. 64 * 65 * @return Returns true if this event is handled and will not be passed further; returns false if this event is 66 * not handled and should be passed to other handlers. 67 * 68 */ 69 void DoKeyDown(const std::shared_ptr<MMI::KeyEvent>& keyEvent) override; 70 71 /** 72 * @brief Execution the KeyUp callback of the ability 73 * @param keyEvent Indicates the key-up event. 74 * 75 * @return Returns true if this event is handled and will not be passed further; returns false if this event is 76 * not handled and should be passed to other handlers. 77 * 78 */ 79 void DoKeyUp(const std::shared_ptr<MMI::KeyEvent>& keyEvent) override; 80 81 /** 82 * @brief Called when a touch event is dispatched to this ability. The default implementation of this callback 83 * does nothing and returns false. 84 * @param touchEvent Indicates information about the touch event. 85 * 86 * @return Returns true if the event is handled; returns false otherwise. 87 * 88 */ 89 void DoPointerEvent(std::shared_ptr<MMI::PointerEvent>& pointerEvent) override; 90 }; 91 } // namespace AppExecFwk 92 } // namespace OHOS 93 #endif // OHOS_ABILITY_RUNTIME_PAGE_ABILITY_IMPL_H 94