e4752912da
Long unit style isn’t intended to be spelled out, so the clock and coordinate direction formatters now use numerals for long unit style, differing from medium unit style in less drastic ways. The locale no longer needs to be exposed, since it’ll always match the overall string’s locale. Added support to the coordinate formatter for different unit styles. Made minutes and seconds of arc optional. Maintain strings for darwin/ formatter classes in a separate Foundation strings table that can be shared between the iOS and OS X SDKs. Added an English .stringsdict override that correctly pluralizes units. Capitalize osxapp window titles, now that they spell out the directions.
46 lines
1.4 KiB
Objective-C
46 lines
1.4 KiB
Objective-C
#import <Foundation/Foundation.h>
|
||
#import <CoreLocation/CoreLocation.h>
|
||
|
||
#import "MGLTypes.h"
|
||
|
||
NS_ASSUME_NONNULL_BEGIN
|
||
|
||
/**
|
||
The `MGLClockDirectionFormatter` class provides properly formatted descriptions
|
||
of headings relative to the user, known as <i>clock positions</i>. For
|
||
example, a value of `90` may be formatted as “3 o’clock”, depending on the
|
||
locale.
|
||
|
||
Use this class to create localized heading strings when displaying directions
|
||
relative to the user’s current location and heading. To format a direction
|
||
irrespective of the user’s orientation, use `MGLCompassDirectionFormatter`
|
||
instead.
|
||
*/
|
||
@interface MGLClockDirectionFormatter : NSFormatter
|
||
|
||
/**
|
||
The unit style used by this formatter.
|
||
|
||
This property defaults to `NSFormattingUnitStyleMedium`.
|
||
*/
|
||
@property (nonatomic) NSFormattingUnitStyle unitStyle;
|
||
|
||
/**
|
||
Returns a clock position string for the provided value.
|
||
|
||
@param direction The heading, measured in degrees, where 0° means “straight
|
||
ahead” and 90° means “directly to your right”.
|
||
@return The clock position string appropriately formatted for the receiver’s
|
||
locale.
|
||
*/
|
||
- (NSString *)stringFromDirection:(CLLocationDirection)direction;
|
||
|
||
/**
|
||
This method is not supported for the `MGLDirectionFormatter` class.
|
||
*/
|
||
- (BOOL)getObjectValue:(out id __nullable * __nullable)obj forString:(NSString *)string errorDescription:(out NSString * __nullable * __nullable)error;
|
||
|
||
@end
|
||
|
||
NS_ASSUME_NONNULL_END
|