Last part of change for bug 49747....

app/text_elider.h

 // Copyright (c) 2010 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 APP_TEXT_ELIDER_H_
 #define APP_TEXT_ELIDER_H_
 #pragma once
 
 #include <unicode/coll.h>
 #include <unicode/uchar.h>
@@ skipping 70 matching lines @@
 
   // Host name minus 'www.'. Used by Compare.
   string16 sort_host_;
 
   // End of the prefix (spec and separator) in display_url_.
   size_t prefix_end_;
 
   string16 display_url_;
 };
 
-// Function to elide strings when the font information is unknown.  As
-// opposed to the above functions, the ElideString() function operates
-// in terms of character units, not pixels.
+// Functions to elide strings when the font information is unknown.  As
+// opposed to the above functions, the ElideString() and
+// ElideRectangleString() functions operate in terms of character units,
+// not pixels.
+
 // If the size of |input| is more than |max_len|, this function returns
 // true and |input| is shortened into |output| by removing chars in the
 // middle (they are replaced with up to 3 dots, as size permits).
 // Ex: ElideString(L"Hello", 10, &str) puts Hello in str and returns false.
 // ElideString(L"Hello my name is Tom", 10, &str) puts "Hell...Tom" in str
 // and returns true.
 // TODO(tsepez): Doesn't handle UTF-16 surrogate pairs properly.
 // TODO(tsepez): Doesn't handle bidi properly
 bool ElideString(const std::wstring& input, int max_len, std::wstring* output);
 
+// Reformat |input| into |output| so that it fits into a |max_rows| by
+// |max_cols| rectangle of characters.  Input newlines are respected, but
+// lines that are too long are broken into pieces, first at naturally
+// occuring whitespace boundaries, and then intra-word (respecting UTF-16
+// surrogate pairs) as necssary. Truncation (indicated by an added 3 dots)
+// occurs if the result is still too long.  Returns true if the input had
+// to be truncated (and not just reformatted).
+bool ElideRectangleString(const string16& input, size_t max_rows,
+                          size_t max_cols, string16* output);
+
+
 } // namespace gfx.
 
 #endif  // APP_TEXT_ELIDER_H_