Instant API: tell page whether the browser is capturing key strokes.

chrome/common/instant_types.h

 // Copyright 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.
 
 #ifndef CHROME_COMMON_INSTANT_TYPES_H_
 #define CHROME_COMMON_INSTANT_TYPES_H_
 
 #include <string>
 
 #include "base/string16.h"
@@ skipping 125 matching lines @@
   ThemeBackgroundImageAlignment image_vertical_alignment;
 
   // The theme background image tiling is only valid if |theme_id| is valid.
   ThemeBackgroundImageTiling image_tiling;
 
   // The theme background image height.
   // Value is only valid if |theme_id| is valid.
   uint16 image_height;
 };
 
+// Omnibox focus state as tracked by InstantController.
+enum OmniboxFocusState {
+  FOCUS_NONE,  // Not focused.
+  FOCUS_VISIBLE,  // Visibily focused.
+  FOCUS_INVISIBLE,  // Invisibly focused, i.e. focused with with a hidden caret.
+};
+
+// Reason why focus state could change.
+enum OmniboxFocusChangeReason {
+  // Includes any explicit changes to focus. (e.g. user clicking to change
+  // focus, user tabbing to change focus, any explicit calls to SetFocus etc.)
+  FOCUS_CHANGE_EXPLICIT,

[sreeram, 2012/12/05 19:48:24]

Add line breaks for clarity (a la InstantShownReason).

[samarth, 2012/12/08 00:55:47]

Done.

+  // Focus changed to restore state from a tab the user swtched to.

[sreeram, 2012/12/05 19:48:24]

Nit: swtched -> switched

[samarth, 2012/12/08 00:55:47]

Done.

+  FOCUS_CHANGE_TAB_SWITCH,
+  // Focus changed because user started typing. This only happens when focus
+  // state is INVISIBLE (and this results in a change to VISIBLE).
+  FOCUS_CHANGE_TYPING,
+};
+
 #endif  // CHROME_COMMON_INSTANT_TYPES_H_