Add GetCharacter() and GetUnmodifiedCharacter() methods to views::Event.

views/events/event.cc

 // Copyright (c) 2011 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 "views/events/event.h"
 
 #include "views/view.h"
 #include "views/widget/root_view.h"
 
 namespace views {
@@ skipping 51 matching lines @@
 ////////////////////////////////////////////////////////////////////////////////
 // KeyEvent, public:
 
 KeyEvent::KeyEvent(ui::EventType type, ui::KeyboardCode key_code,
                    int event_flags)
     : Event(type, event_flags),
       key_code_(key_code) {
 }
 
 ////////////////////////////////////////////////////////////////////////////////
+// KeyEvent, private:
+
+// static
+uint16 KeyEvent::GetCharacterFromKeyCode(ui::KeyboardCode key_code, int flags) {
+  const bool ctrl = (flags & ui::EF_CONTROL_DOWN) != 0;
+  const bool shift = (flags & ui::EF_SHIFT_DOWN) != 0;
+  const bool upper = shift ^ ((flags & ui::EF_CAPS_LOCK_DOWN) != 0);
+
+  // Following Windows behavior to map ctrl-z ~ ctrl-z to \x01 ~ \x1A.

[Yusuke Sato, 2011/03/18 12:07:41]

the first ctrl-z should be ctrl-a?

[James Su, 2011/03/18 15:54:09]

Done.

+  if (key_code >= ui::VKEY_A && key_code <= ui::VKEY_Z)
+    return key_code - ui::VKEY_A + (ctrl ? 1 : (upper ? 'A' : 'a'));
+
+  // Other ctrl characters
+  if (ctrl) {
+    if (shift) {
+      // following graphics chars require shift key to input.
+      switch (key_code) {
+        // ctrl-@ maps to \x00 (Null byte)
+        case ui::VKEY_2:
+          return 0;
+        // ctrl-^ maps to \x1E (Record separator, Information separator two)
+        case ui::VKEY_6:
+          return 0x1E;
+        // ctrl-_ maps to \x1F (Unit separator, Information separator one)
+        case ui::VKEY_OEM_MINUS:
+          return 0x1F;
+        // Returns 0 for all other keys to avoid inputting unexpected chars.
+        default:
+          return 0;
+      }
+    } else {
+      switch (key_code) {
+        // ctrl-[ maps to \x1B (Escape)
+        case ui::VKEY_OEM_4:
+          return 0x1B;
+        // ctrl-\ maps to \x1C (File separator, Information separator four)
+        case ui::VKEY_OEM_5:
+          return 0x1C;
+        // ctrl-] maps to \x1D (Group separator, Information separator three)
+        case ui::VKEY_OEM_6:
+          return 0x1D;
+        // ctrl-Enter maps to \x0A (Line feed)
+        case ui::VKEY_RETURN:
+          return 0x0A;
+        // Returns 0 for all other keys to avoid inputting unexpected chars.
+        default:
+          return 0;
+      }
+    }
+  }
+
+  // Normal characters
+  if (key_code >= ui::VKEY_0 && key_code <= ui::VKEY_9)
+    return shift ? ")!@#$%^&*("[key_code - ui::VKEY_0] : key_code;

[Yusuke Sato, 2011/03/18 12:07:41]

It seems that the US keyboard layout is assumed here. Is it okay? If it's okay,
please add a comment that explains why we can safely assume the US layout here.

[James Su, 2011/03/18 15:54:09]

Updated the comment in the header file.

+  else if (key_code >= ui::VKEY_NUMPAD0 && key_code <= ui::VKEY_NUMPAD9)
+    return key_code - ui::VKEY_NUMPAD0 + '0';
+
+  switch (key_code) {
+    case ui::VKEY_TAB:
+      return '\t';
+    case ui::VKEY_RETURN:
+      return '\r';
+    case ui::VKEY_MULTIPLY:
+      return '*';
+    case ui::VKEY_ADD:
+      return '+';
+    case ui::VKEY_SUBTRACT:
+      return '-';
+    case ui::VKEY_DECIMAL:
+      return '.';
+    case ui::VKEY_DIVIDE:
+      return '/';
+    case ui::VKEY_SPACE:
+      return ' ';
+    case ui::VKEY_OEM_1:
+      return shift ? ':' : ';';
+    case ui::VKEY_OEM_PLUS:
+      return shift ? '+' : '=';
+    case ui::VKEY_OEM_COMMA:
+      return shift ? '<' : ',';
+    case ui::VKEY_OEM_MINUS:
+      return shift ? '_' : '-';
+    case ui::VKEY_OEM_PERIOD:
+      return shift ? '>' : '.';
+    case ui::VKEY_OEM_2:
+      return shift ? '?' : '/';
+    case ui::VKEY_OEM_3:
+      return shift ? '~' : '`';
+    case ui::VKEY_OEM_4:
+      return shift ? '{' : '[';
+    case ui::VKEY_OEM_5:
+      return shift ? '|' : '\\';
+    case ui::VKEY_OEM_6:
+      return shift ? '}' : ']';
+    case ui::VKEY_OEM_7:
+      return shift ? '"' : '\'';
+    default:
+      return 0;
+  }
+}
+
+////////////////////////////////////////////////////////////////////////////////
 // MouseEvent, public:
 
 // TODO(msw): Kill this legacy constructor when we update uses.
 MouseEvent::MouseEvent(ui::EventType type,
                        View* source,
                        View* target,
                        const gfx::Point &l,
                        int flags)
     : LocatedEvent(MouseEvent(type, l.x(), l.y(), flags), source, target) {
 }
@@ skipping 31 matching lines @@
 #endif
 
 ////////////////////////////////////////////////////////////////////////////////
 // MouseWheelEvent, public:
 
 // This value matches windows WHEEL_DELTA.
 // static
 const int MouseWheelEvent::kWheelDelta = 120;
 
 }  // namespace views