OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 // | 4 // |
5 // This file defines utility functions for working with text in views. | 5 // This file defines utility functions for working with text in views. |
6 | 6 |
7 #ifndef VIEWS_VIEW_TEXT_UTILS_H_ | 7 #ifndef VIEWS_VIEW_TEXT_UTILS_H_ |
8 #define VIEWS_VIEW_TEXT_UTILS_H_ | 8 #define VIEWS_VIEW_TEXT_UTILS_H_ |
9 #pragma once | 9 #pragma once |
10 | 10 |
11 #include <string> | 11 #include "base/string16.h" |
12 | |
13 #include "ui/gfx/font.h" | |
14 #include "ui/gfx/rect.h" | |
15 #include "views/views_export.h" | 12 #include "views/views_export.h" |
16 | 13 |
17 namespace gfx { | 14 namespace gfx { |
18 class Canvas; | 15 class Canvas; |
| 16 class Font; |
| 17 class Rect; |
19 class Size; | 18 class Size; |
20 } | 19 } |
21 | 20 |
22 namespace views { | 21 namespace views { |
23 class Label; | 22 class Label; |
24 class Link; | 23 class Link; |
25 } | 24 } |
26 | 25 |
27 namespace view_text_utils { | 26 namespace view_text_utils { |
28 | 27 |
29 // Draws a string onto the canvas (wrapping if needed) while also keeping | 28 // Draws a string onto the canvas (wrapping if needed) while also keeping |
30 // track of where it ends so we can position a URL after the text. The | 29 // track of where it ends so we can position a URL after the text. The |
31 // parameter |bounds| represents the boundary we have to work with, |position| | 30 // parameter |bounds| represents the boundary we have to work with, |position| |
32 // specifies where to draw the string (relative to the top left corner of the | 31 // specifies where to draw the string (relative to the top left corner of the |
33 // |bounds| rectangle and |font| specifies the font to use when drawing. When | 32 // |bounds| rectangle and |font| specifies the font to use when drawing. When |
34 // the function returns, the parameter |rect| contains where to draw the URL | 33 // the function returns, the parameter |rect| contains where to draw the URL |
35 // (to the right of where we just drew the text) and |position| is updated to | 34 // (to the right of where we just drew the text) and |position| is updated to |
36 // reflect where to draw the next string after the URL. |label| is a dummy | 35 // reflect where to draw the next string after the URL. |label| is a dummy |
37 // label with the correct width and origin for the text to be written; it's | 36 // label with the correct width and origin for the text to be written; it's |
38 // used so that the x position can be correctly mirrored in RTL languages. | 37 // used so that the x position can be correctly mirrored in RTL languages. |
39 // |text_direction_is_rtl| is true if an RTL language is being used. | 38 // |text_direction_is_rtl| is true if an RTL language is being used. |
40 // NOTE: The reason why we need this function is because while Skia knows how | 39 // NOTE: The reason why we need this function is because while Skia knows how |
41 // to wrap text appropriately, it doesn't tell us where it drew the last | 40 // to wrap text appropriately, it doesn't tell us where it drew the last |
42 // character, which we need to position the URLs within the text. | 41 // character, which we need to position the URLs within the text. |
43 VIEWS_EXPORT void DrawTextAndPositionUrl(gfx::Canvas* canvas, | 42 VIEWS_EXPORT void DrawTextAndPositionUrl(gfx::Canvas* canvas, |
44 views::Label* label, | 43 views::Label* label, |
45 const std::wstring& text, | 44 const string16& text, |
46 views::Link* link, | 45 views::Link* link, |
47 gfx::Rect* rect, | 46 gfx::Rect* rect, |
48 gfx::Size* position, | 47 gfx::Size* position, |
49 bool text_direction_is_rtl, | 48 bool text_direction_is_rtl, |
50 const gfx::Rect& bounds, | 49 const gfx::Rect& bounds, |
51 const gfx::Font& font); | 50 const gfx::Font& font); |
52 | 51 |
53 // A helper function for DrawTextAndPositionUrl, which simply draws the text | 52 // A helper function for DrawTextAndPositionUrl, which simply draws the text |
54 // from a certain starting point |position| and wraps within bounds. | 53 // from a certain starting point |position| and wraps within bounds. |
55 // |word_for_word| specifies whether to draw the text word for word or whether | 54 // |word_for_word| specifies whether to draw the text word for word or whether |
56 // to treat the text as one blurb (similar to the way URL's are treated inside | 55 // to treat the text as one blurb (similar to the way URL's are treated inside |
57 // RTL text. For details on the other parameters, see DrawTextAndPositionUrl. | 56 // RTL text. For details on the other parameters, see DrawTextAndPositionUrl. |
58 void DrawTextStartingFrom(gfx::Canvas* canvas, | 57 void DrawTextStartingFrom(gfx::Canvas* canvas, |
59 views::Label* label, | 58 views::Label* label, |
60 const std::wstring& text, | 59 const string16& text, |
61 gfx::Size* position, | 60 gfx::Size* position, |
62 const gfx::Rect& bounds, | 61 const gfx::Rect& bounds, |
63 const gfx::Font& font, | 62 const gfx::Font& font, |
64 bool text_direction_is_rtl, | 63 bool text_direction_is_rtl, |
65 bool word_for_word); | 64 bool word_for_word); |
66 | 65 |
67 // A simply utility function that calculates whether a word of width | 66 // A simply utility function that calculates whether a word of width |
68 // |word_width| fits at position |position| within the |bounds| rectangle. If | 67 // |word_width| fits at position |position| within the |bounds| rectangle. If |
69 // not, |position| is updated to wrap to the beginning of the next line. | 68 // not, |position| is updated to wrap to the beginning of the next line. |
70 void WrapIfWordDoesntFit(int word_width, | 69 void WrapIfWordDoesntFit(int word_width, |
71 int font_height, | 70 int font_height, |
72 gfx::Size* position, | 71 gfx::Size* position, |
73 const gfx::Rect& bounds); | 72 const gfx::Rect& bounds); |
74 | 73 |
75 } // namespace view_text_utils | 74 } // namespace view_text_utils |
76 | 75 |
77 #endif // CHROME_BROWSER_VIEWS_VIEW_TEXT_UTILS_H_ | 76 #endif // CHROME_BROWSER_VIEWS_VIEW_TEXT_UTILS_H_ |
OLD | NEW |