| // 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 "base/macros.h" |
| #include "ui/gfx/image/image_skia.h" |
| #include "ui/views/view.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: |
| // Internal class name. |
| static const char kViewClassName[]; |
| |
| enum Alignment { |
| LEADING = 0, |
| CENTER, |
| TRAILING |
| }; |
| |
| 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); |
| |
| // 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 the desired image size for the receiving ImageView. |
| void SetImageSize(const gfx::Size& image_size); |
| |
| // Returns the actual bounds of the visible image inside the view. |
| gfx::Rect GetImageBounds() const; |
| |
| // Reset the image size to the current image dimensions. |
| void ResetImageSize(); |
| |
| // 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 tooltip text. |
| void SetTooltipText(const base::string16& tooltip); |
| base::string16 GetTooltipText() const; |
| |
| // Overriden from View: |
| void OnPaint(gfx::Canvas* canvas) override; |
| void GetAccessibleNodeData(ui::AXNodeData* node_data) override; |
| const char* GetClassName() const override; |
| bool GetTooltipText(const gfx::Point& p, |
| base::string16* tooltip) const override; |
| gfx::Size CalculatePreferredSize() const override; |
| |
| private: |
| void OnPaintImage(gfx::Canvas* canvas); |
| |
| // 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; |
| |
| // Returns the size the image will be painted. |
| gfx::Size GetImageSize() const; |
| |
| // Compute the image origin given the desired size and the receiver alignment |
| // properties. |
| gfx::Point ComputeImageOrigin(const gfx::Size& image_size) const; |
| |
| // Whether the image size is set. |
| bool image_size_set_; |
| |
| // The actual image size. |
| gfx::Size image_size_; |
| |
| // The underlying image. |
| gfx::ImageSkia image_; |
| |
| // Horizontal alignment. |
| Alignment horiz_alignment_; |
| |
| // Vertical alignment. |
| Alignment vert_alignment_; |
| |
| // The current tooltip text. |
| base::string16 tooltip_text_; |
| |
| // Scale last painted at. |
| float last_paint_scale_; |
| |
| // Address of bytes we last painted. This is used only for comparison, so its |
| // safe to cache. |
| void* last_painted_bitmap_pixels_; |
| |
| DISALLOW_COPY_AND_ASSIGN(ImageView); |
| }; |
| |
| } // namespace views |
| |
| #endif // UI_VIEWS_CONTROLS_IMAGE_VIEW_H_ |