[AiS] changing mac omnibox suggestions form NSMatrix to NSTableView

chrome/browser/ui/cocoa/omnibox/omnibox_popup_cell.h

 // Copyright 2013 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 CHROME_BROWSER_UI_COCOA_OMNIBOX_OMNIBOX_POPUP_CELL_H_
 #define CHROME_BROWSER_UI_COCOA_OMNIBOX_OMNIBOX_POPUP_CELL_H_
 
 #import <Cocoa/Cocoa.h>
 
 #include "base/mac/scoped_nsobject.h"
 #include "components/omnibox/autocomplete_match.h"
 
 class OmniboxPopupViewMac;
 
-// OmniboxPopupCell overrides how backgrounds are displayed to
-// handle hover versus selected.  So long as we're in there, it also
-// provides some default initialization.
-@interface OmniboxPopupCell : NSButtonCell {
+@interface OmniboxPopupCellData : NSObject<NSCopying> {
  @private
-  // The match which will be rendered for this row in omnibox dropdown.
-  AutocompleteMatch match_;
+  // NSAttributedString instances for various match components.

[Scott Hess - ex-Googler, 2015/06/12 22:21:59]

The comment telling us that the NSAttributedString instances are
NSAttributedString instances is redundant.  You're moving it, you get to own it
:-).  Or delete it.

That said, I suspect that documenting what the two images mean might make sense.

[dschuyler, 2015/06/12 23:07:54]

Done.

+  NSAttributedString* contents_;
+  NSAttributedString* description_;
 
-  // NSAttributedString instances for various match components.
-  base::scoped_nsobject<NSAttributedString> separator_;
-  base::scoped_nsobject<NSAttributedString> description_;
-
-  base::scoped_nsobject<NSImage> answerImage_;
+  NSImage* answerImage_;
 
   // NOTE: While |prefix_| is used only for postfix suggestions, it still needs
   // to be a member of the class. This allows the |NSAttributedString| instance
   // to stay alive between the call to |drawTitle| and the actual paint event
   // which accesses the |NSAttributedString| instance.
-  base::scoped_nsobject<NSAttributedString> prefix_;
+  NSAttributedString* prefix_;
 
-  // The width of widest match contents in a set of infinite suggestions.
-  CGFloat maxMatchContentsWidth_;
+  NSImage* image_;
 
   // The offset at which the infinite suggestion contents should be displayed.
   CGFloat contentsOffset_;
+
+  BOOL isContentsRTL_;
+  AutocompleteMatch::Type matchType_;
 }
 
-- (void)setAnswerImage:(NSImage*)image;
+@property(readonly, retain, nonatomic) NSAttributedString* contents;
+@property(readonly, retain, nonatomic) NSAttributedString* description;
+@property(readonly, retain, nonatomic) NSAttributedString* prefix;
+@property(readonly, retain, nonatomic) NSImage* image;
+@property(readonly, retain, nonatomic) NSImage* answerImage;
+@property(readonly, nonatomic) CGFloat contentsOffset;
+@property(readonly, nonatomic) BOOL isContentsRTL;
+@property(readonly, nonatomic) AutocompleteMatch::Type matchType;
 
-- (void)setMatch:(const AutocompleteMatch&)match;
+- (instancetype)initWithMatch:(const AutocompleteMatch&)match
+               contentsOffset:(CGFloat)contentsOffset
+                        image:(NSImage*)image
+                  answerImage:(NSImage*)answerImage;
 
-- (NSAttributedString*)description;
-
-- (void)setMaxMatchContentsWidth:(CGFloat)maxMatchContentsWidth;
-
-- (void)setContentsOffset:(CGFloat)contentsOffset;
+// Each row is allowed to have a different value.
+- (CGFloat)rowHeight;
 
 // Returns the width of the match contents.
 - (CGFloat)getMatchContentsWidth;
 
+@end
+
+// OmniboxPopupCell overrides how cells are displayed.  The OmniboxPopupCell
+// uses information from OmniboxPopupCellData to draw suggestion results.

[Scott Hess - ex-Googler, 2015/06/12 22:21:59]

I'd also remove the talking-about-myself-by-given-name here, too.  Since this
comment documents OmniboxPopupCell, it doesn't need to refer to
OmniboxPopupCell.

[dschuyler, 2015/06/12 23:07:53]

Done.

+@interface OmniboxPopupCell : NSCell
+
+- (void)drawMatchWithFrame:(NSRect)cellFrame inView:(NSView*)controlView;
+
 // Returns the offset of the start of the contents in the input text for the
 // given match. It is costly to compute this offset, so it is computed once and
 // shared by all OmniboxPopupCell instances through OmniboxPopupViewMac parent.
 + (CGFloat)computeContentsOffset:(const AutocompleteMatch&)match;
 
++ (NSAttributedString*)createSeparatorString;
+
 @end
 
 #endif  // CHROME_BROWSER_UI_COCOA_OMNIBOX_OMNIBOX_POPUP_CELL_H_