File: surface_observer.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (76 lines) | stat: -rw-r--r-- 2,396 bytes parent folder | download | duplicates (6)
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
// Copyright 2015 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_EXO_SURFACE_OBSERVER_H_
#define COMPONENTS_EXO_SURFACE_OBSERVER_H_

#include <cstdint>
#include <string>
#include <string_view>

namespace gfx {
class Rect;
}

namespace exo {
class Surface;
enum class OverlayPriority;

// Observers can listen to various events on the Surfaces.
class SurfaceObserver {
 public:
  // Called at the top of the surface's destructor, to give observers a
  // chance to remove themselves.
  virtual void OnSurfaceDestroying(Surface* surface) = 0;

  virtual void OnScaleFactorChanged(Surface* surface,
                                    float old_scale_factor,
                                    float new_scale_factor) {}

  // Called when the occlusion of the aura window corresponding to |surface|
  // changes.
  virtual void OnWindowOcclusionChanged(Surface* surface) {}

  // Called when frame is locked to normal state or unlocked from
  // previously locked state.
  virtual void OnFrameLockingChanged(Surface* surface, bool lock) {}

  // Called on each commit.
  virtual void OnCommit(Surface* surface) {}

  // Called when desk state of the window changes.
  // |state| is the index of the desk which the window moved to,
  // or -1 for a window assigned to all desks.
  virtual void OnDeskChanged(Surface* surface, int state) {}

  // Called when the display of this surface has changed. Only called after
  // successfully updating sub-surfaces.
  virtual void OnDisplayChanged(Surface* surface,
                                int64_t old_display,
                                int64_t new_display) {}

  // Starts or ends throttling.
  virtual void ThrottleFrameRate(bool on) {}

  // Called when tooltip is shown.
  // `bounds` is relative to `surface`.
  virtual void OnTooltipShown(Surface* surface,
                              std::u16string_view text,
                              const gfx::Rect& bounds) {}

  // Called when tooltip is hidden.
  virtual void OnTooltipHidden(Surface* surface) {}

  virtual void OnFullscreenStateChanged(bool fullscreen) {}

  virtual void OnOverlayPriorityHintChanged(
      OverlayPriority overlay_priority_hint) {}

 protected:
  virtual ~SurfaceObserver() = default;
};

}  // namespace exo

#endif  // COMPONENTS_EXO_SURFACE_OBSERVER_H_