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


ash / display / display_alignment_indicator.h [blame]

// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef ASH_DISPLAY_DISPLAY_ALIGNMENT_INDICATOR_H_
#define ASH_DISPLAY_DISPLAY_ALIGNMENT_INDICATOR_H_

#include <memory>

#include "ash/ash_export.h"
#include "base/memory/raw_ptr.h"
#include "ui/gfx/geometry/rect.h"
#include "ui/views/widget/widget.h"

namespace display {
class Display;
}  // namespace display

namespace ash {

class IndicatorHighlightView;
class IndicatorPillView;

// DisplayAlignmentIndicator is a container for indicator highlighting a shared
// edge between two displays and a pill that contains an arrow and target
// display's name.
class ASH_EXPORT DisplayAlignmentIndicator {
 public:
  // Construct and show indicator highlight without a pill.
  // |src_display| is the display that the indicator is shown in.
  // |bounds| is the position and size of the 1px thick shared edge between
  // |src_display| and target display.
  static std::unique_ptr<DisplayAlignmentIndicator> Create(
      const display::Display& src_display,
      const gfx::Rect& bounds);

  // Construct and show indicator highlight with a pill.
  // |src_display| is the display that the indicator is shown in.
  // |bounds| is the position and size of the 1px thick shared edge between
  // |src_display| and target display. |target_name| is the name of the adjacent
  // display that is displayed in the pill.
  static std::unique_ptr<DisplayAlignmentIndicator> CreateWithPill(
      const display::Display& src_display,
      const gfx::Rect& bounds,
      const std::string& target_name);

  DisplayAlignmentIndicator(const DisplayAlignmentIndicator&) = delete;
  DisplayAlignmentIndicator& operator=(const DisplayAlignmentIndicator&) =
      delete;
  ~DisplayAlignmentIndicator();

  int64_t display_id() const { return display_id_; }

  // Shows/Hides the indicator.
  void Show();
  void Hide();

  // Updates the position of the indicator according to |bounds|. Used to move
  // around preview indicators during dragging. The indicator must NOT have a
  // pill.
  void Update(const display::Display& display, gfx::Rect bounds);

 private:
  friend class DisplayAlignmentIndicatorTest;
  friend class DisplayAlignmentControllerTest;

  // Pill does not render if |target_name| is an empty string.
  DisplayAlignmentIndicator(const display::Display& src_display,
                            const gfx::Rect& bounds,
                            const std::string& target_name);

  // The ID of the display that the indicator is shown on.
  const int64_t display_id_;

  // View and Widget for showing the blue indicator highlights on the edge of
  // the display.
  raw_ptr<IndicatorHighlightView, DanglingUntriaged> indicator_view_ =
      nullptr;  // NOT OWNED
  views::Widget indicator_widget_;

  // View and Widget for showing a pill with name of the neighboring display and
  // an arrow pointing towards it. May not be initialized if ctor without
  // |target_name| is used (for preview indicator).
  raw_ptr<IndicatorPillView, DanglingUntriaged> pill_view_ =
      nullptr;  // NOT OWNED
  std::unique_ptr<views::Widget> pill_widget_;
};

}  // namespace ash

#endif  // ASH_DISPLAY_DISPLAY_ALIGNMENT_INDICATOR_H_