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_
|