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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
// Copyright (c) 2012 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_VIEWS_CONTROLS_IMAGE_VIEW_H_
#define UI_VIEWS_CONTROLS_IMAGE_VIEW_H_
#include <memory>
#include <utility>
#include "base/macros.h"
#include "ui/gfx/image/image_skia.h"
#include "ui/views/metadata/metadata_header_macros.h"
#include "ui/views/metadata/view_factory.h"
#include "ui/views/view.h"
#include "ui/views/views_export.h"
namespace gfx {
class Canvas;
}
namespace views {
/////////////////////////////////////////////////////////////////////////////
//
// ImageView class.
//
// An ImageView can display an image from an ImageSkia. If a size is provided,
// the ImageView will resize the provided image to fit if it is too big or will
// center the image if smaller. Otherwise, the preferred size matches the
// provided image size.
//
/////////////////////////////////////////////////////////////////////////////
class VIEWS_EXPORT ImageView : public View {
public:
METADATA_HEADER(ImageView);
enum class Alignment { kLeading, kCenter, kTrailing };
ImageView();
~ImageView() override;
// Set the image that should be displayed.
void SetImage(const gfx::ImageSkia& img);
// Set the image that should be displayed from a pointer. Reset the image
// if the pointer is NULL. The pointer contents is copied in the receiver's
// image.
void SetImage(const gfx::ImageSkia* image_skia);
// Sets the desired size of the image to be displayed.
void SetImageSize(const gfx::Size& size);
// Reset the image size to the current image dimensions.
void ResetImageSize();
// Returns the actual bounds of the visible image inside the view.
gfx::Rect GetImageBounds() const;
// Returns the image currently displayed, which can be empty if not set.
// The returned image is still owned by the ImageView.
const gfx::ImageSkia& GetImage() const;
// Set / Get the horizontal alignment.
void SetHorizontalAlignment(Alignment ha);
Alignment GetHorizontalAlignment() const;
// Set / Get the vertical alignment.
void SetVerticalAlignment(Alignment va);
Alignment GetVerticalAlignment() const;
// Set / Get the accessible name text.
void SetAccessibleName(const base::string16& name);
const base::string16& GetAccessibleName() const;
// Set the tooltip text.
void SetTooltipText(const base::string16& tooltip);
const base::string16& GetTooltipText() const;
// Overridden from View:
void OnPaint(gfx::Canvas* canvas) override;
void GetAccessibleNodeData(ui::AXNodeData* node_data) override;
base::string16 GetTooltipText(const gfx::Point& p) const override;
gfx::Size CalculatePreferredSize() const override;
views::PaintInfo::ScaleType GetPaintScaleType() const override;
void OnBoundsChanged(const gfx::Rect& previous_bounds) override;
void PreferredSizeChanged() override;
private:
friend class ImageViewTest;
void OnPaintImage(gfx::Canvas* canvas);
// Gets an ImageSkia to paint that has proper rep for |scale|.
gfx::ImageSkia GetPaintImage(float scale);
// Returns true if |img| is the same as the last image we painted. This is
// intended to be a quick check, not exhaustive. In other words it's possible
// for this to return false even though the images are in fact equal.
bool IsImageEqual(const gfx::ImageSkia& img) const;
// Recomputes and updates the |image_origin_|.
void UpdateImageOrigin();
gfx::Size GetImageSize() const;
// The origin of the image.
gfx::Point image_origin_;
// The current tooltip text.
base::string16 tooltip_text_;
// The current accessible name text.
base::string16 accessible_name_;
// Horizontal alignment.
Alignment horizontal_alignment_ = Alignment::kCenter;
// Vertical alignment.
Alignment vertical_alignment_ = Alignment::kCenter;
// The underlying image.
gfx::ImageSkia image_;
// Caches the scaled image reps.
gfx::ImageSkia scaled_image_;
// Scale last painted at.
float last_paint_scale_ = 0.f;
// Address of bytes we last painted. This is used only for comparison, so its
// safe to cache.
void* last_painted_bitmap_pixels_ = nullptr;
// The requested image size.
base::Optional<gfx::Size> image_size_;
DISALLOW_COPY_AND_ASSIGN(ImageView);
};
BEGIN_VIEW_BUILDER(VIEWS_EXPORT, ImageView, View)
// Explicitly declare the overloaded SetImage methods in order to properly
// disambiguate between them.
BuilderT& SetImage(const gfx::ImageSkia& value) {
auto setter = std::make_unique<::views::internal::PropertySetter<
ViewClass_, gfx::ImageSkia,
decltype((static_cast<void (ViewClass_::*)(const gfx::ImageSkia&)>(
&ViewClass_::SetImage))),
&ViewClass_::SetImage>>(value);
::views::internal::ViewBuilderCore::AddPropertySetter(std::move(setter));
return *static_cast<BuilderT*>(this);
}
BuilderT& SetImage(const gfx::ImageSkia* value) {
auto setter = std::make_unique<::views::internal::PropertySetter<
ViewClass_, gfx::ImageSkia*,
decltype((static_cast<void (ViewClass_::*)(const gfx::ImageSkia*)>(
&ViewClass_::SetImage))),
&ViewClass_::SetImage>>(value);
::views::internal::ViewBuilderCore::AddPropertySetter(std::move(setter));
return *static_cast<BuilderT*>(this);
}
VIEW_BUILDER_PROPERTY(gfx::Size, ImageSize)
VIEW_BUILDER_PROPERTY(ImageView::Alignment, HorizontalAlignment)
VIEW_BUILDER_PROPERTY(ImageView::Alignment, VerticalAlignment)
VIEW_BUILDER_PROPERTY(base::string16, AccessibleName)
VIEW_BUILDER_PROPERTY(base::string16, TooltipText)
END_VIEW_BUILDER
} // namespace views
DEFINE_VIEW_BUILDER(VIEWS_EXPORT, ImageView)
#endif // UI_VIEWS_CONTROLS_IMAGE_VIEW_H_
|
