Upstream Chrome on iOS source code [3/11].

ios/chrome/browser/ui/bookmarks/bookmark_collection_cells.h

+// Copyright 2014 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 IOS_CHROME_BROWSER_UI_BOOKMARKS_BOOKMARK_COLLECTION_CELLS_H_
+#define IOS_CHROME_BROWSER_UI_BOOKMARKS_BOOKMARK_COLLECTION_CELLS_H_
+
+#import <UIKit/UIKit.h>
+
+namespace bookmark_cell {
+// The types get cached, which means that their values must not change.
+typedef enum {
+  ButtonNone = 0,  // No button.
+  ButtonMenu,      // 3-vertical-dots button.
+} ButtonType;
+
+}  // bookmark_cell
+
+// Views that expect to display an image associated with a bookmark must
+// implement this protocol.
+// Since the image fetching API is asynchronous and uncancellable, views must
+// store some metadata associated with the image to ensure irrelevant callbacks
+// are discarded.
+@protocol BookmarkImageableView
+@property(nonatomic, assign) BOOL shouldAnimateImageChanges;
+// Sets the image on the view, animating the change if
+// shouldAnimateImageChanges is YES. Hides the overlay placeholder text.
+- (void)setImage:(UIImage*)image;
+// Sets the placeholder text that is displayed over the image view. Hides the
+// image.
+- (void)setPlaceholderText:(NSString*)text
+                 textColor:(UIColor*)textColor
+           backgroundColor:(UIColor*)backgroundColor;
+@end
+
+#pragma mark - Base Classes For Both Device Types
+
+// Abstract base class for cells in the bookmark collection view.
+// Most controllers that use this cell have an "edit" mode that allows users to
+// select multiple bookmarks. When a cell is selected, a translucent overlay
+// is layered on top to change the look of the view.
+// Subclasses should insert new views below the "highlightCover" property.
+// There is also an image and an optional menu button.
+@interface BookmarkCell : UICollectionViewCell<BookmarkImageableView>
+
+@property(nonatomic, retain, readonly) UILabel* titleLabel;
+
++ (NSString*)reuseIdentifier;
+
+// Sets the target/selector for the top-right corner button.
+// |action| must take exactly 2 arguments.
+// The first object passed to |action| will be of type BookmarkItemCell.
+// The second will be the view that was tapped on to trigger the action.
+- (void)setButtonTarget:(id)target action:(SEL)action;
+
+// Changes the appearance of the button.
+- (void)showButtonOfType:(bookmark_cell::ButtonType)buttonType
+                animated:(BOOL)animated;
+
+// The cell has been selected by the user in editing mode.
+- (void)setSelectedForEditing:(BOOL)selected animated:(BOOL)animated;
+
+// Sets the title.
+- (void)updateWithTitle:(NSString*)title;
+
+@end
+
+#pragma mark - Specialized Cells
+
+// Specialized cell for bookmark urls.
+// It is intended to show the title, domain, and parent folder of the bookmark.
+@interface BookmarkItemCell : BookmarkCell
+// Returns the icon size that is preferred for this cell. Icons are square, and
+// the returned value is the side of the square in points.
++ (CGFloat)preferredImageSize;
+@end
+
+// Specialized cell for bookmark folders. Uses a default folder image.
+@interface BookmarkFolderCell : BookmarkCell
+@end
+
+#pragma mark - Header Views
+
+// Standard header view for a section.
+@interface BookmarkHeaderView : UICollectionReusableView
++ (NSString*)reuseIdentifier;
++ (CGFloat)handsetHeight;
+- (void)setTitle:(NSString*)title;
+@end
+
+// Blank white header with thin separator line in the bottom.
+@interface BookmarkHeaderSeparatorView : UICollectionReusableView
++ (NSString*)reuseIdentifier;
++ (CGFloat)preferredHeight;
+@end
+
+#endif  // IOS_CHROME_BROWSER_UI_BOOKMARKS_BOOKMARK_COLLECTION_CELLS_H_