Elide long emails in the wrench and profile menus.

ui/base/text/text_elider.h

 // 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.
 //
 // This file defines utility functions for eliding and formatting UI text.
 
 #ifndef UI_BASE_TEXT_TEXT_ELIDER_H_
 #define UI_BASE_TEXT_TEXT_ELIDER_H_
 #pragma once
 
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/string16.h"
 #include "ui/base/ui_export.h"
 #include "ui/gfx/font.h"
 #include "unicode/coll.h"
 #include "unicode/uchar.h"
 
 class FilePath;
 class GURL;
 
 namespace ui {
 
 UI_EXPORT extern const char kEllipsis[];
 
+// Elides an email address to fit into |available_pixel_width| using the
+// specified |font|.
+// This function guarantees that the string returned will contain at least one
+// character, other than the ellipsis-es, on either side of the '@'. If it is

[asvitkine_google, 2012/03/01 22:10:56]

ellipsis-es => ellipses

[gab, 2012/03/01 23:03:46]

Ya, saw this form around the web to indicate the potential singular/plural form
of "ellipsis", but I agree it's kind of ugly and not so necessary...

+// impossible to achieve these requirements: only an ellipsis will be returned.
+// If possible: this elides only the username portion of the |email|. Otherwise,
+// the domain is elided in the middle so that it splits the available width
+// equally with the elided username (should the username be short enough that it
+// doesn't need half the available width: the elided domain will occupy that
+// extra width).
+UI_EXPORT string16 ElideEmail(const string16& email,
+                              const gfx::Font& font,
+                              int available_pixel_width);
+
 // This function takes a GURL object and elides it. It returns a string
 // which composed of parts from subdomain, domain, path, filename and query.
 // A "..." is added automatically at the end if the elided string is bigger
-// than the available pixel width. For available pixel width = 0, empty
-// string is returned. |languages| is a comma separated list of ISO 639
-// language codes and is used to determine what characters are understood
-// by a user. It should come from |prefs::kAcceptLanguages|.
+// than the |available_pixel_width|. For |available_pixel_width| == 0, a
+// formatted, but un-elided, string is returned. |languages| is a comma
+// separated list of ISO 639 language codes and is used to determine what
+// characters are understood by a user. It should come from
+// |prefs::kAcceptLanguages|.
 //
 // Note: in RTL locales, if the URL returned by this function is going to be
 // displayed in the UI, then it is likely that the string needs to be marked
 // as an LTR string (using base::i18n::WrapStringWithLTRFormatting()) so that it
 // is displayed properly in an RTL context. Please refer to
 // http://crbug.com/6487 for more information.
 UI_EXPORT string16 ElideUrl(const GURL& url,
                             const gfx::Font& font,
                             int available_pixel_width,
                             const std::string& languages);
@@ skipping 124 matching lines @@
 // Truncates the string to length characters. This breaks the string at
 // the first word break before length, adding the horizontal ellipsis
 // character (unicode character 0x2026) to render ...
 // The supplied string is returned if the string has length characters or
 // less.
 UI_EXPORT string16 TruncateString(const string16& string, size_t length);
 
 }  // namespace ui
 
 #endif  // UI_BASE_TEXT_TEXT_ELIDER_H_