dali/devel-api/adaptor-framework/proxy-accessible.h

   1 #ifndef DALI_ADAPTOR_PROXY_ACCESSIBLE_H
   2 #define DALI_ADAPTOR_PROXY_ACCESSIBLE_H
   3
   4 /*
   5  * Copyright (c) 2021 Samsung Electronics Co., Ltd.
   6  *
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  * http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  */
  19
  20 // EXTERNAL INCLUDES
  21 #include <string>
  22 #include <vector>
  23
  24 // INTERNAL INCLUDES
  25 #include <dali/devel-api/adaptor-framework/accessibility.h>
  26 #include <dali/devel-api/atspi-interfaces/accessible.h>
  27
  28 namespace Dali::Accessibility
  29 {
  30 /**
  31  * @brief The minimalistic, always empty Accessible object with settable address.
  32  *
  33  * To be used as a proxy object, in those situations where you want to return an address in
  34  * a different bridge (embedding for example), but the object itself isn't planned to be used
  35  * otherwise. This object has no parent, no children, an empty name and so on.
  36  */
  37 class DALI_ADAPTOR_API ProxyAccessible : public virtual Accessible
  38 {
  39 public:
  40   ProxyAccessible() = default;
  41
  42   ProxyAccessible(Address address)
  43   : mAddress(std::move(address))
  44   {
  45   }
  46
  47   void SetAddress(Address address)
  48   {
  49     this->mAddress = std::move(address);
  50   }
  51
  52   std::string GetName() const override
  53   {
  54     return "";
  55   }
  56
  57   std::string GetDescription() const override
  58   {
  59     return "";
  60   }
  61
  62   Accessible* GetParent() override
  63   {
  64     return nullptr;
  65   }
  66
  67   size_t GetChildCount() const override
  68   {
  69     return 0;
  70   }
  71
  72   std::vector<Accessible*> GetChildren() override
  73   {
  74     return {};
  75   }
  76
  77   Accessible* GetChildAtIndex(size_t index) override
  78   {
  79     throw std::domain_error{"out of bounds index (" + std::to_string(index) + ") - no children"};
  80   }
  81
  82   size_t GetIndexInParent() override
  83   {
  84     return static_cast<size_t>(-1);
  85   }
  86
  87   Role GetRole() const override
  88   {
  89     return {};
  90   }
  91
  92   std::string GetRoleName() const override
  93   {
  94     return {};
  95   }
  96
  97   States GetStates() override
  98   {
  99     return {};
 100   }
 101
 102   Attributes GetAttributes() const override
 103   {
 104     return {};
 105   }
 106
 107   bool IsProxy() const override
 108   {
 109     return true;
 110   }
 111
 112   Address GetAddress() const override
 113   {
 114     return mAddress;
 115   }
 116
 117   bool DoGesture(const GestureInfo& gestureInfo) override
 118   {
 119     return false;
 120   }
 121
 122   std::vector<Relation> GetRelationSet() override
 123   {
 124     return {};
 125   }
 126
 127   Dali::Actor GetInternalActor() override
 128   {
 129     return Dali::Actor{};
 130   }
 131
 132 private:
 133   Address mAddress;
 134 };
 135
 136 } // namespace Dali::Accessibility
 137
 138 #endif // DALI_ADAPTOR_PROXY_ACCESSIBLE_H