File: link.h

package info (click to toggle)
chromium 138.0.7204.183-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,908 kB
  • sloc: cpp: 34,937,088; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (122 lines) | stat: -rw-r--r-- 4,024 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
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
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef UI_VIEWS_CONTROLS_LINK_H_
#define UI_VIEWS_CONTROLS_LINK_H_

#include <memory>
#include <optional>
#include <string>
#include <string_view>
#include <utility>

#include "base/functional/callback.h"
#include "third_party/skia/include/core/SkColor.h"
#include "ui/color/color_variant.h"
#include "ui/gfx/color_palette.h"
#include "ui/views/controls/label.h"
#include "ui/views/metadata/view_factory.h"
#include "ui/views/style/typography.h"

namespace views {

////////////////////////////////////////////////////////////////////////////////
//
// Link class
//
// A Link is a label subclass that looks like an HTML link. It has a
// controller which is notified when a click occurs.
//
////////////////////////////////////////////////////////////////////////////////
class VIEWS_EXPORT Link : public Label {
  METADATA_HEADER(Link, Label)

 public:
  // A callback to be called when the link is clicked.  Closures are also
  // accepted; see below.
  using ClickedCallback = base::RepeatingCallback<void(const ui::Event& event)>;

  explicit Link(const std::u16string& title = std::u16string(),
                int text_context = style::CONTEXT_LABEL,
                int text_style = style::STYLE_LINK);

  Link(const Link&) = delete;
  Link& operator=(const Link&) = delete;

  ~Link() override;

  // Allow providing callbacks that expect either zero or one args, since many
  // callers don't care about the argument and can avoid adapter functions this
  // way.
  void SetCallback(base::RepeatingClosure callback) {
    // Adapt this closure to a ClickedCallback by discarding the extra arg.
    callback_ =
        base::BindRepeating([](base::RepeatingClosure closure,
                               const ui::Event& event) { closure.Run(); },
                            std::move(callback));
  }
  void SetCallback(ClickedCallback callback) {
    callback_ = std::move(callback);
  }

  SkColor GetColor() const;

  void SetForceUnderline(bool force_underline);
  bool GetForceUnderline() const;

  // Label:
  ui::Cursor GetCursor(const ui::MouseEvent& event) override;
  bool GetCanProcessEventsWithinSubtree() const override;
  void OnMouseEntered(const ui::MouseEvent& event) override;
  void OnMouseExited(const ui::MouseEvent& event) override;
  bool OnMousePressed(const ui::MouseEvent& event) override;
  bool OnMouseDragged(const ui::MouseEvent& event) override;
  void OnMouseReleased(const ui::MouseEvent& event) override;
  void OnMouseCaptureLost() override;
  bool OnKeyPressed(const ui::KeyEvent& event) override;
  void OnGestureEvent(ui::GestureEvent* event) override;
  bool SkipDefaultKeyEventProcessing(const ui::KeyEvent& event) override;
  void OnFocus() override;
  void OnBlur() override;
  void SetFontList(const gfx::FontList& font_list) override;
  void SetText(std::u16string_view text) override;
  void OnThemeChanged() override;
  void SetEnabledColor(ui::ColorVariant color) override;
  bool IsSelectionSupported() const override;

 private:
  virtual void RecalculateFont();

  void SetPressed(bool pressed);

  void OnClick(const ui::Event& event);

  void ConfigureFocus();

  ClickedCallback callback_;

  // Whether the link is currently pressed.
  bool pressed_ = false;

  // The color when the link is neither pressed nor disabled.
  std::optional<SkColor> requested_enabled_color_;

  base::CallbackListSubscription enabled_changed_subscription_;

  // Whether the link text should use underline style regardless of enabled or
  // focused state.
  bool force_underline_ = true;
};

BEGIN_VIEW_BUILDER(VIEWS_EXPORT, Link, Label)
VIEW_BUILDER_OVERLOAD_METHOD(SetCallback, base::RepeatingClosure)
VIEW_BUILDER_OVERLOAD_METHOD(SetCallback, Link::ClickedCallback)
VIEW_BUILDER_PROPERTY(bool, ForceUnderline)
END_VIEW_BUILDER

}  // namespace views

DEFINE_VIEW_BUILDER(VIEWS_EXPORT, Link)

#endif  // UI_VIEWS_CONTROLS_LINK_H_