blob: 149e9ae71e6bd079d40ff001ed9ddd610c731a88 (
plain)
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
|
// Copyright (c) 2009 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_CONTROLS_NATIVE_NATIVE_VIEW_HOST_H_
#define VIEWS_CONTROLS_NATIVE_NATIVE_VIEW_HOST_H_
#include <string>
#include "gfx/native_widget_types.h"
#include "views/view.h"
namespace views {
class NativeViewHostWrapper;
// A View type that hosts a gfx::NativeView. The bounds of the native view are
// kept in sync with the bounds of this view as it is moved and sized.
// Under the hood, a platform-specific NativeViewHostWrapper implementation does
// the platform-specific work of manipulating the underlying OS widget type.
class NativeViewHost : public View {
public:
// The NativeViewHost's class name.
static const char kViewClassName[];
// Should views render the focus when on native controls?
static const bool kRenderNativeControlFocus;
NativeViewHost();
virtual ~NativeViewHost();
// Attach a gfx::NativeView to this View. Its bounds will be kept in sync
// with the bounds of this View until Detach is called.
//
// Because native views are positioned in the coordinates of their parent
// native view, this function should only be called after this View has been
// added to a View hierarchy hosted within a valid Widget.
void Attach(gfx::NativeView native_view);
// Detach the attached window handle. Its bounds and visibility will no longer
// be manipulated by this View.
void Detach();
// Sets a preferred size for the native view attached to this View.
void SetPreferredSize(const gfx::Size& size);
// A NativeViewHost has an associated focus View so that the focus of the
// native control and of the View are kept in sync. In simple cases where the
// NativeViewHost directly wraps a native window as is, the associated view
// is this View. In other cases where the NativeViewHost is part of another
// view (such as TextField), the actual View is not the NativeViewHost and
// this method must be called to set that.
// This method must be called before Attach().
void set_focus_view(View* view) { focus_view_ = view; }
View* focus_view() { return focus_view_; }
// Fast resizing will move the native view and clip its visible region, this
// will result in white areas and will not resize the content (so scrollbars
// will be all wrong and content will flow offscreen). Only use this
// when you're doing extremely quick, high-framerate vertical resizes
// and don't care about accuracy. Make sure you do a real resize at the
// end. USE WITH CAUTION.
void set_fast_resize(bool fast_resize) { fast_resize_ = fast_resize; }
bool fast_resize() const { return fast_resize_; }
// Accessor for |native_view_|.
gfx::NativeView native_view() const { return native_view_; }
void NativeViewDestroyed();
// Overridden from View:
virtual gfx::Size GetPreferredSize();
virtual void Layout();
virtual void Paint(gfx::Canvas* canvas);
virtual void VisibilityChanged(View* starting_from, bool is_visible);
virtual void Focus();
virtual bool ContainsNativeView(gfx::NativeView native_view) const;
protected:
virtual void VisibleBoundsInRootChanged();
virtual void ViewHierarchyChanged(bool is_add, View* parent, View* child);
virtual std::string GetClassName() const;
private:
// Detach the native view. |destroyed| is true if the native view is
// detached because it's being destroyed, or false otherwise.
void Detach(bool destroyed);
// The attached native view.
gfx::NativeView native_view_;
// A platform-specific wrapper that does the OS-level manipulation of the
// attached gfx::NativeView.
scoped_ptr<NativeViewHostWrapper> native_wrapper_;
// The preferred size of this View
gfx::Size preferred_size_;
// True if the native view is being resized using the fast method described
// in the setter/accessor above.
bool fast_resize_;
// The view that should be given focus when this NativeViewHost is focused.
View* focus_view_;
DISALLOW_COPY_AND_ASSIGN(NativeViewHost);
};
} // namespace views
#endif // VIEWS_CONTROLS_NATIVE_NATIVE_VIEW_HOST_H_
|