dali/integration-api/events/key-event-integ.h

   1 #ifndef __DALI_INTEGRATION_KEY_EVENT_H__
   2 #define __DALI_INTEGRATION_KEY_EVENT_H__
   3
   4 /*
   5  * Copyright (c) 2018 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
  21 // EXTERNAL INCLUDES
  22 #include <string>
  23
  24 // INTERNAL INCLUDES
  25 #include <dali/integration-api/events/event.h>
  26 #include <dali/public-api/events/key-event.h>
  27
  28 namespace Dali
  29 {
  30
  31 namespace Integration
  32 {
  33
  34 /**
  35  * An instance of this class should be used by the adaptor to send a key event to
  36  * the Dali core.
  37  *
  38  */
  39 struct DALI_CORE_API KeyEvent : public Event
  40 {
  41   // Enumerations
  42   // Specifies the state of the key event.
  43   enum State
  44   {
  45     Down,        /**< Key down */
  46     Up,          /**< Key up */
  47
  48     Last
  49   };
  50
  51   /**
  52    * Default Constructor
  53    */
  54   KeyEvent();
  55
  56   /**
  57    * Constructor
  58    * @param[in]  keyName       The name of the key pressed or command from the IMF, if later then the some following parameters will be needed.
  59    * @param[in]  keyString     A string of input characters or key pressed
  60    * @param[in]  keyCode       The unique key code for the key pressed.
  61    * @param[in]  keyModifier   The key modifier for special keys like shift and alt
  62    * @param[in]  timeStamp     The time (in ms) that the key event occurred.
  63    * @param[in]  keyState      The state of the key event.
  64    * @param[in]  compose       The key compose
  65    * @param[in]  deviceName    Name of device KeyEvent originated from
  66    * @param[in]  deviceClass   Class of device KeyEvent originated from
  67    * @param[in]  deviceSubclass  Subclass of device KeyEvent originated from
  68    */
  69   KeyEvent(const std::string& keyName,
  70            const std::string& keyString,
  71            int keyCode,
  72            int keyModifier,
  73            unsigned long timeStamp,
  74            const State& keyState,
  75            const std::string& compose,
  76            const std::string& deviceName,
  77            const Device::Class::Type deviceClass,
  78            const Device::Subclass::Type deviceSubclass );
  79
  80   /*
  81    * Constructor, creates a Integration::KeyEvent from a Dali::KeyEvent
  82    * @param[in] event Dali::KeyEvent to convert from
  83    */
  84   explicit KeyEvent( const Dali::KeyEvent& event );
  85
  86   /**
  87    * Virtual destructor
  88    */
  89   virtual ~KeyEvent();
  90
  91   // Data
  92
  93   /**
  94    *@copydoc Dali::KeyEvent::keyPressedName
  95    */
  96   std::string keyName;
  97
  98   /**
  99    *@copydoc Dali::KeyEvent::keyPressed
 100    */
 101   std::string keyString;
 102
 103   /**
 104    * @copydoc Dali::KeyEvent::keyCode
 105    */
 106   int  keyCode;
 107
 108   /**
 109    *@copydoc Dali::KeyEvent::keyModifier
 110    */
 111   int  keyModifier;
 112
 113   /**
 114    *@copydoc Dali::KeyEvent::time
 115    */
 116   unsigned long time;
 117
 118   /**
 119    * State of the key event.
 120    * @see State
 121    */
 122   State state;
 123
 124   /**
 125    * A string if this keystroke has modified a string in the middle of being composed - this string replaces the previous one.
 126    */
 127   std::string compose;
 128
 129   /**
 130    * Name of device KeyEvent originated from
 131    */
 132   std::string deviceName;
 133
 134   /**
 135    * Class of device KeyEvent originated from
 136    */
 137   Device::Class::Type deviceClass;
 138
 139   /**
 140    * Subclass of device KeyEvent originated from
 141    */
 142   Device::Subclass::Type deviceSubclass;
 143 };
 144
 145 } // namespace Integration
 146
 147 } // namespace Dali
 148
 149 #endif // __DALI_INTEGRATION_KEY_EVENT_H__