Adds ui_test_utils::SendAndWaitForKeyPress and converts callers (where

chrome/browser/automation/ui_controls.h

 // Copyright (c) 2010 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_BROWSER_AUTOMATION_UI_CONTROLS_H_
 #define CHROME_BROWSER_AUTOMATION_UI_CONTROLS_H_
 #pragma once
 
 #include "build/build_config.h"
 
 #if defined(OS_WIN)
 #include <wtypes.h>
 #endif
 
+#include "base/keyboard_codes.h"
 #include "gfx/native_widget_types.h"
 #include "gfx/point.h"
-#include "base/keyboard_codes.h"
 
 #if defined(TOOLKIT_VIEWS)
 namespace views {
 class View;
 }
 #endif
 
 class Task;
 
 namespace ui_controls {
 
 // Many of the functions in this class include a variant that takes a Task.
 // The version that takes a Task waits until the generated event is processed.
 // Once the generated event is processed the Task is Run (and deleted). Note
 // that this is a somewhat fragile process in that any event of the correct
 // type (key down, mouse click, etc.) will trigger the Task to be run. Hence
 // a usage such as
 //
 //   SendKeyPress(...);
 //   SendKeyPressNotifyWhenDone(..., task);
 //
 // might trigger |task| early.
 //
 // Note: Windows does not currently do anything with the |window| argument for
 // these functions, so passing NULL is ok.
 
 // Send a key press with/without modifier keys.
+//
+// If you're writing a test chances are you want the variant in ui_test_utils.
+// See it for details.
 bool SendKeyPress(gfx::NativeWindow window,
                   base::KeyboardCode key,
                   bool control,
                   bool shift,
                   bool alt,
                   bool command);
 bool SendKeyPressNotifyWhenDone(gfx::NativeWindow window,
                                 base::KeyboardCode key,
                                 bool control,
                                 bool shift,
@@ skipping 35 matching lines @@
 #elif defined(OS_MACOSX)
     NSView* view,
 #endif
     MouseButton button,
     int state,
     Task* task);
 
 }  // ui_controls
 
 #endif  // CHROME_BROWSER_AUTOMATION_UI_CONTROLS_H_