| OLD | NEW |
| (Empty) |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef UI_IOS_NSSTRING_CR_STRING_DRAWING_H_ | |
| 6 #define UI_IOS_NSSTRING_CR_STRING_DRAWING_H_ | |
| 7 | |
| 8 #import <UIKit/UIKit.h> | |
| 9 | |
| 10 @interface NSString (CrStringDrawing) | |
| 11 | |
| 12 // Calculates and returns the bounding rect for the receiver drawn using the | |
| 13 // given size and font. | |
| 14 // This method is implemented as a wrapper around | |
| 15 // |boundingRectWithSize:options:attributes:context:| using the following values | |
| 16 // for the parameters: | |
| 17 // - size: the provided |size| | |
| 18 // - options: NSStringDrawingUsesLineFragmentOrigin | |
| 19 // - attributes: a NSDictionary with the provided |font| | |
| 20 // - context: nil. | |
| 21 // | |
| 22 // Note that the rect returned may contain fractional values. | |
| 23 - (CGRect)cr_boundingRectWithSize:(CGSize)size | |
| 24 font:(UIFont*)font; | |
| 25 | |
| 26 // Convenience wrapper to just return the size of |boundingRectWithSize:font:|. | |
| 27 // | |
| 28 // Note that the size returned may contain fractional values. | |
| 29 - (CGSize)cr_boundingSizeWithSize:(CGSize)size | |
| 30 font:(UIFont*)font; | |
| 31 | |
| 32 // Returns the size of the string if it were to be rendered with the specified | |
| 33 // font on a single line. The width and height of the CGSize returned are | |
| 34 // pixel-aligned. | |
| 35 // | |
| 36 // This method is a convenience wrapper around sizeWithAttributes: to avoid | |
| 37 // boilerplate required to put |font| in a dictionary of attributes. Do not pass | |
| 38 // nil into this method. | |
| 39 - (CGSize)cr_pixelAlignedSizeWithFont:(UIFont*)font; | |
| 40 | |
| 41 // Deprecated: Use cr_pixelAlignedSizeWithFont: or sizeWithAttributes: | |
| 42 // Provides a drop-in replacement for sizeWithFont:, which was deprecated in iOS | |
| 43 // 7 in favor of -sizeWithAttributes:. Specifically, this method will return | |
| 44 // CGSizeZero if |font| is nil, and the width and height returned are rounded up | |
| 45 // to integer values. | |
| 46 // TODO(lliabraa): This method was added to ease the transition off of the | |
| 47 // deprecated sizeWithFont: method. New call sites should not be added and | |
| 48 // existing call sites should be audited to determine the correct behavior for | |
| 49 // nil |font| and rounding, then replaced with cr_pixelAlignedSizeWithFont: or | |
| 50 // sizeWithAttributes: (crbug.com/364419). | |
| 51 - (CGSize)cr_sizeWithFont:(UIFont*)font; | |
| 52 | |
| 53 @end | |
| 54 | |
| 55 #endif // UI_IOS_NSSTRING_CR_STRING_DRAWING_H_ | |
| OLD | NEW |