1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
// Copyright (c) 2006-2008 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_TEST_AUTOMATION_WINDOW_PROXY_H__
#define CHROME_TEST_AUTOMATION_WINDOW_PROXY_H__
#include "build/build_config.h"
#if defined(OS_WIN)
#include <windows.h>
#endif
#include <string>
#include "base/string16.h"
#include "base/thread.h"
#include "chrome/test/automation/automation_handle_tracker.h"
class BrowserProxy;
class WindowProxy;
namespace gfx {
class Point;
class Rect;
}
// This class presents the interface to actions that can be performed on a given
// window. Note that this object can be invalidated at any time if the
// corresponding window in the app is closed. In that case, any subsequent
// calls will return false immediately.
class WindowProxy : public AutomationResourceProxy {
public:
WindowProxy(AutomationMessageSender* sender,
AutomationHandleTracker* tracker,
int handle)
: AutomationResourceProxy(tracker, sender, handle) {}
#if defined(OS_WIN)
// TODO(port): Use portable replacements for windowsisms.
// Gets the outermost HWND that corresponds to the given window.
// Returns true if the call was successful.
bool GetHWND(HWND* handle) const;
#endif // defined(OS_WIN)
// Simulates a click at the OS level. |click| is in the window's coordinates
// and |flags| specifies which buttons are pressed (as defined in
// chrome/views/event.h). Note that this is equivalent to the user moving
// the mouse and pressing the button. So if there is a window on top of this
// window, the top window is clicked.
bool SimulateOSClick(const gfx::Point& click, int flags);
// Get the title of the top level window.
bool GetWindowTitle(string16* text);
// Simulates a key press at the OS level. |key| is the key pressed and
// |flags| specifies which modifiers keys are also pressed (as defined in
// chrome/views/event.h). Note that this actually sends the event to the
// window that has focus.
bool SimulateOSKeyPress(wchar_t key, int flags);
// Shows/hides the window and as a result makes it active/inactive.
// Returns true if the call was successful.
bool SetVisible(bool visible);
// Sets |active| to true if this view is currently the active window.
// Returns true if the call was successful.
bool IsActive(bool* active);
// Make this window the active window.
// Returns true if the call was successful.
bool Activate();
// Gets the bounds (in window coordinates) that correspond to the view with
// the given ID in this window. Returns true if bounds could be obtained.
// If |screen_coordinates| is true, the bounds are returned in the coordinates
// of the screen, if false in the coordinates of the browser.
bool GetViewBounds(int view_id, gfx::Rect* bounds, bool screen_coordinates);
// Like GetViewBounds except returns false if timeout occurs before view
// bounds are obtained, and sets is_timeout accordingly.
bool GetViewBoundsWithTimeout(int view_id, gfx::Rect* bounds,
bool screen_coordinates, uint32 timeout_ms,
bool* is_timeout);
// Sets the position and size of the window. Returns true if setting the
// bounds was successful.
bool SetBounds(const gfx::Rect& bounds);
// Gets the id of the view that currently has focus. Returns true if the id
// was retrieved.
bool GetFocusedViewID(int* view_id);
// Returns the browser this window corresponds to, or NULL if this window
// is not a browser. The caller owns the returned BrowserProxy.
scoped_refptr<BrowserProxy> GetBrowser();
// Same as GetWindow except return NULL if response isn't received
// before the specified timeout.
scoped_refptr<BrowserProxy> GetBrowserWithTimeout(uint32 timeout_ms,
bool* is_timeout);
protected:
virtual ~WindowProxy() {}
private:
DISALLOW_COPY_AND_ASSIGN(WindowProxy);
};
#endif // CHROME_TEST_AUTOMATION_WINDOW_PROXY_H__
|