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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
// 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.
#ifndef VIEWS_WIDGET_NATIVE_WIDGET_H_
#define VIEWS_WIDGET_NATIVE_WIDGET_H_
#pragma once
#include <set>
#include "ui/gfx/native_widget_types.h"
#include "views/widget/widget.h"
namespace gfx {
class Rect;
}
namespace ui {
class OSExchangeData;
}
namespace views {
class InputMethod;
class TooltipManager;
////////////////////////////////////////////////////////////////////////////////
// NativeWidget interface
//
// An interface implemented by an object that encapsulates rendering, event
// handling and widget management provided by an underlying native toolkit.
//
class NativeWidget {
public:
typedef std::set<NativeWidget*> NativeWidgets;
virtual ~NativeWidget() {}
// Creates an appropriate default NativeWidget implementation for the current
// OS/circumstance.
static NativeWidget* CreateNativeWidget(
internal::NativeWidgetDelegate* delegate);
// Retrieves the NativeWidget implementation associated with the given
// NativeView or Window, or NULL if the supplied handle has no associated
// NativeView.
static NativeWidget* GetNativeWidgetForNativeView(
gfx::NativeView native_view);
static NativeWidget* GetNativeWidgetForNativeWindow(
gfx::NativeWindow native_window);
// Retrieves the top NativeWidget in the hierarchy containing the given
// NativeView, or NULL if there is no NativeWidget that contains it.
static NativeWidget* GetTopLevelNativeWidget(gfx::NativeView native_view);
// Returns all NativeWidgets in |native_view|'s hierarchy, including itself if
// it is one.
static void GetAllNativeWidgets(gfx::NativeView native_view,
NativeWidgets* children);
// Reparent a NativeView and notify all NativeWidgets in
// |native_view|'s hierarchy of the change.
static void ReparentNativeView(gfx::NativeView native_view,
gfx::NativeView new_parent);
// Initializes the NativeWidget.
virtual void InitNativeWidget(const Widget::InitParams& params) = 0;
// Returns the Widget associated with this NativeWidget. This function is
// guaranteed to return non-NULL for the lifetime of the NativeWidget.
virtual Widget* GetWidget() = 0;
virtual const Widget* GetWidget() const = 0;
// Returns the NativeView/Window associated with this NativeWidget.
virtual gfx::NativeView GetNativeView() const = 0;
virtual gfx::NativeWindow GetNativeWindow() const = 0;
// Returns the enclosing Window, or NULL if there is no enclosing Window.
virtual Window* GetContainingWindow() = 0;
virtual const Window* GetContainingWindow() const = 0;
// Notifies the NativeWidget that a view was removed from the Widget's view
// hierarchy.
virtual void ViewRemoved(View* view) = 0;
// Sets/Gets a native window property on the underlying native window object.
// Returns NULL if the property does not exist. Setting the property value to
// NULL removes the property.
virtual void SetNativeWindowProperty(const char* name, void* value) = 0;
virtual void* GetNativeWindowProperty(const char* name) = 0;
// Returns the native widget's tooltip manager. Called from the View hierarchy
// to update tooltips.
virtual TooltipManager* GetTooltipManager() const = 0;
// Returns true if a system screen reader is active for the NativeWidget.
virtual bool IsScreenReaderActive() const = 0;
// Notify native Accessibility clients of an event.
virtual void SendNativeAccessibilityEvent(
View* view,
ui::AccessibilityTypes::Event event_type) = 0;
// Sets or releases event capturing for this native widget.
virtual void SetMouseCapture() = 0;
virtual void ReleaseMouseCapture() = 0;
// Returns true if this native widget is capturing all events.
virtual bool HasMouseCapture() const = 0;
// Returns true if any mouse button is currently pressed.
virtual bool IsMouseButtonDown() const = 0;
// Returns the InputMethod for this native widget.
// Note that all widgets in a widget hierarchy share the same input method.
// TODO(suzhe): rename to GetInputMethod() when NativeWidget implementation
// class doesn't inherit Widget anymore.
virtual InputMethod* GetInputMethodNative() = 0;
// Sets a different InputMethod instance to this native widget. The instance
// must not be initialized, the ownership will be assumed by the native
// widget. It's only for testing purpose.
virtual void ReplaceInputMethod(InputMethod* input_method) = 0;
protected:
friend class Widget;
friend class NativeWidgetViews;
// Returns a handle for the underlying native widget that can be used for
// accelerated drawing.
virtual gfx::AcceleratedWidget GetAcceleratedWidget() = 0;
// Widget pass-thrus, private to Views. --------------------------------------
// See method documentation in Widget.
virtual gfx::Rect GetWindowScreenBounds() const = 0;
virtual gfx::Rect GetClientAreaScreenBounds() const = 0;
virtual void SetBounds(const gfx::Rect& bounds) = 0;
virtual void SetSize(const gfx::Size& size) = 0;
virtual void MoveAbove(gfx::NativeView native_view) = 0;
virtual void SetShape(gfx::NativeRegion shape) = 0;
virtual void Close() = 0;
virtual void CloseNow() = 0;
virtual void Show() = 0;
virtual void Hide() = 0;
virtual bool IsVisible() const = 0;
virtual void Activate() = 0;
virtual void Deactivate() = 0;
virtual bool IsActive() const = 0;
virtual void SetAlwaysOnTop(bool always_on_top) = 0;
virtual void Maximize() = 0;
virtual void Minimize() = 0;
virtual bool IsMaximized() const = 0;
virtual bool IsMinimized() const = 0;
virtual void Restore() = 0;
virtual void SetOpacity(unsigned char opacity) = 0;
virtual bool IsAccessibleWidget() const = 0;
virtual bool ContainsNativeView(gfx::NativeView native_view) const = 0;
virtual void RunShellDrag(View* view,
const ui::OSExchangeData& data,
int operation) = 0;
virtual void SchedulePaintInRect(const gfx::Rect& rect) = 0;
virtual void SetCursor(gfx::NativeCursor cursor) = 0;
};
} // namespace views
#endif // VIEWS_WIDGET_NATIVE_WIDGET_H_
|
