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
|
// Copyright 2016 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 UI_AURA_WINDOW_PORT_H_
#define UI_AURA_WINDOW_PORT_H_
#include <stdint.h>
#include <memory>
#include <string>
#include "base/callback.h"
#include "base/observer_list.h"
#include "base/strings/string16.h"
#include "components/viz/common/surfaces/scoped_surface_id_allocator.h"
#include "components/viz/common/surfaces/surface_id.h"
#include "ui/aura/aura_export.h"
#include "ui/base/class_property.h"
namespace cc {
class LayerTreeFrameSink;
}
namespace gfx {
class Rect;
class Transform;
}
namespace aura {
class Window;
class WindowObserver;
// WindowPort defines an interface to enable Window to be used with or without
// mus. WindowPort is owned by Window and called at key points in Windows
// lifetime that enable Window to be used in both environments.
//
// If a Window is created without an explicit WindowPort then
// Env::CreateWindowPort() is used to create the WindowPort.
class AURA_EXPORT WindowPort {
public:
virtual ~WindowPort() {}
// Called from Window::Init().
virtual void OnPreInit(Window* window) = 0;
virtual void OnDeviceScaleFactorChanged(float old_device_scale_factor,
float new_device_scale_factor) = 0;
// Called when a window is being added as a child. |child| may already have
// a parent, but its parent is not the Window this WindowPort is associated
// with.
virtual void OnWillAddChild(Window* child) = 0;
virtual void OnWillRemoveChild(Window* child) = 0;
// Called to move the child at |current_index| to |dest_index|. |dest_index|
// is calculated assuming the window at |current_index| has been removed, e.g.
// Window* child = children_[current_index];
// children_.erase(children_.begin() + current_index);
// children_.insert(children_.begin() + dest_index, child);
virtual void OnWillMoveChild(size_t current_index, size_t dest_index) = 0;
virtual void OnVisibilityChanged(bool visible) = 0;
virtual void OnDidChangeBounds(const gfx::Rect& old_bounds,
const gfx::Rect& new_bounds) = 0;
virtual void OnDidChangeTransform(const gfx::Transform& old_transform,
const gfx::Transform& new_transform) = 0;
// Called before a property is changed. The return value from this is supplied
// into OnPropertyChanged() so that WindowPort may pass data between the two
// calls.
virtual std::unique_ptr<ui::PropertyData> OnWillChangeProperty(
const void* key) = 0;
// Called after a property changes, but before observers are notified. |data|
// is the return value from OnWillChangeProperty().
virtual void OnPropertyChanged(const void* key,
int64_t old_value,
std::unique_ptr<ui::PropertyData> data) = 0;
// Called for creating a cc::LayerTreeFrameSink for the window.
virtual std::unique_ptr<cc::LayerTreeFrameSink>
CreateLayerTreeFrameSink() = 0;
// Forces the window to allocate a new viz::LocalSurfaceId for the next
// CompositorFrame submission in anticipation of a synchronization operation
// that does not involve a resize or a device scale factor change.
virtual void AllocateLocalSurfaceId() = 0;
// When a child-allocated viz::LocalSurfaceId is being processed, this returns
// true.
virtual bool IsLocalSurfaceIdAllocationSuppressed() const = 0;
// When a ScopedSurfaceIdAllocator is alive, it prevents the
// allocator from actually allocating. Instead, it triggers its
// |allocation_task| upon destruction. This allows us to issue only one
// allocation during the lifetime. This is used to continue routing and
// processing when a child allocates its own LocalSurfaceId.
virtual viz::ScopedSurfaceIdAllocator GetSurfaceIdAllocator(
base::OnceCallback<void()> allocation_task) = 0;
// Gets the current viz::LocalSurfaceId. The viz::LocalSurfaceId is allocated
// lazily on call, and will be updated on changes to size or device scale
// factor.
virtual const viz::LocalSurfaceId& GetLocalSurfaceId() = 0;
virtual void OnEventTargetingPolicyChanged() = 0;
// See description of function with same name in transient_window_client.
virtual bool ShouldRestackTransientChildren() = 0;
protected:
// Returns the WindowPort associated with a Window.
static WindowPort* Get(Window* window);
// Returns the ObserverList of a Window.
static base::ObserverList<WindowObserver, true>* GetObservers(Window* window);
};
} // namespace aura
#endif // UI_AURA_WINDOW_PORT_H_
|
