[KeyboardEvent] Add embedder APIs to translate between Dom |key| enum and strings

ui/events/event.cc

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #include "ui/events/event.h"
 
 #if defined(USE_X11)
 #include <X11/extensions/XInput2.h>
 #include <X11/keysym.h>
 #include <X11/Xlib.h>
@@ skipping 764 matching lines @@
   // Therefore, perform only the fallback action.
   GetMeaningFromKeyCode(key_code_, flags(), &key_, &character_);
 #elif defined(USE_X11)
   // When a control key is held, prefer ASCII characters to non ASCII
   // characters in order to use it for shortcut keys.  GetCharacterFromKeyCode
   // returns 'a' for VKEY_A even if the key is actually bound to 'à' in X11.
   // GetCharacterFromXEvent returns 'à' in that case.
   character_ = (IsControlDown() || !native_event()) ?
       GetCharacterFromKeyCode(key_code_, flags()) :
       GetCharacterFromXEvent(native_event());
-  // TODO(kpschoedel): set key_ field for X11.
+  GetMeaningFromKeyCode(key_code_, flags(), &key_, &character_);

[Wez, 2015/02/20 00:00:30]

GetMeaningFromKeyCode currently assumes a US English layout, hence the TODO that
Kevin put for the usage in the #else clause; suggest copying that TODO to this
call as well.

Since this code only works for US English layouts currently, we need to get it
working for general layouts before we make the |key| attribute available to JS,
really (or perhaps only make it available if we detect a US layout is in
effect?)

[Habib Virji, 2015/02/23 10:10:05]

I have started looking into enabling |key| attribute to other layout. Kevin has
forwarded me his current work and I am looking into it. 

Will prefer holding it enabled for all other layout before landing this. 

 #elif defined(USE_OZONE)
   KeyboardCode key_code;
   if (!KeyboardLayoutEngineManager::GetKeyboardLayoutEngine()->Lookup(
       code_, flags(), &key_, &character_, &key_code, &platform_keycode_)) {
     GetMeaningFromKeyCode(key_code_, flags(), &key_, &character_);
   }
 #else
   if (native_event()) {
     DCHECK(EventTypeFromNative(native_event()) == ET_KEY_PRESSED ||
            EventTypeFromNative(native_event()) == ET_KEY_RELEASED);
@@ skipping 180 matching lines @@
                    gfx::PointF(x, y),
                    time_stamp,
                    flags | EF_FROM_TOUCH),
       details_(details) {
 }
 
 GestureEvent::~GestureEvent() {
 }
 
 }  // namespace ui