139 lines
5.3 KiB
Objective-C
139 lines
5.3 KiB
Objective-C
/*
|
|
Copyright 2011 Twitter, Inc.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this work except in compliance with the License.
|
|
You may obtain a copy of the License in the LICENSE file, or at:
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
#import "TUIResponder.h"
|
|
#import "CoreText+Additions.h"
|
|
|
|
@class NSFont;
|
|
@class TUIView;
|
|
@protocol ABActiveTextRange;
|
|
|
|
extern NSString *const TUITextRendererDidBecomeFirstResponder;
|
|
extern NSString *const TUITextRendererDidResignFirstResponder;
|
|
|
|
typedef enum {
|
|
TUITextSelectionAffinityCharacter = 0,
|
|
TUITextSelectionAffinityWord = 1,
|
|
TUITextSelectionAffinityLine = 2,
|
|
TUITextSelectionAffinityParagraph = 3,
|
|
} TUITextSelectionAffinity;
|
|
|
|
typedef enum {
|
|
TUITextVerticalAlignmentTop = 0,
|
|
// Note that TUITextVerticalAlignmentMiddle and TUITextVerticalAlignmentBottom both have a performance hit because they have to create the CTFrame twice: once to find its height and then again to shift it to match the alignment and height.
|
|
// Also note that text selection doesn't work properly with anything but TUITextVerticalAlignmentTop.
|
|
TUITextVerticalAlignmentMiddle,
|
|
TUITextVerticalAlignmentBottom,
|
|
} TUITextVerticalAlignment;
|
|
|
|
@protocol TUITextRendererDelegate;
|
|
|
|
@interface TUITextRenderer : TUIResponder {
|
|
NSAttributedString *attributedString;
|
|
CGRect frame;
|
|
TUIView *__unsafe_unretained view; // unsafe_unretained
|
|
|
|
CTFramesetterRef _ct_framesetter;
|
|
CGPathRef _ct_path;
|
|
CTFrameRef _ct_frame;
|
|
|
|
CFIndex _selectionStart;
|
|
CFIndex _selectionEnd;
|
|
TUITextSelectionAffinity _selectionAffinity;
|
|
|
|
__unsafe_unretained id<TUITextRendererDelegate> delegate;
|
|
id<ABActiveTextRange> hitRange;
|
|
|
|
CGSize shadowOffset;
|
|
CGFloat shadowBlur;
|
|
NSColor *shadowColor;
|
|
|
|
NSMutableDictionary *lineRects;
|
|
|
|
TUITextVerticalAlignment verticalAlignment;
|
|
|
|
struct {
|
|
unsigned int drawMaskDragSelection:1;
|
|
unsigned int backgroundDrawingEnabled:1;
|
|
unsigned int preDrawBlocksEnabled:1;
|
|
|
|
unsigned int delegateActiveRangesForTextRenderer:1;
|
|
unsigned int delegateWillBecomeFirstResponder:1;
|
|
unsigned int delegateDidBecomeFirstResponder:1;
|
|
unsigned int delegateWillResignFirstResponder:1;
|
|
unsigned int delegateDidResignFirstResponder:1;
|
|
} _flags;
|
|
}
|
|
|
|
@property (nonatomic, strong) NSAttributedString *attributedString;
|
|
@property (nonatomic, assign) CGRect frame;
|
|
@property (nonatomic, unsafe_unretained) TUIView *view; // unsafe_unretained, remember to set to nil before view goes away
|
|
|
|
@property (nonatomic, assign) CGSize shadowOffset;
|
|
@property (nonatomic, assign) CGFloat shadowBlur;
|
|
@property (nonatomic, strong) NSColor *shadowColor; // default = nil for no shadow
|
|
@property (nonatomic, strong) NSColor *selectionColor;
|
|
|
|
@property (nonatomic, assign) TUITextVerticalAlignment verticalAlignment;
|
|
|
|
// These are advanced features that carry with them a potential performance hit.
|
|
@property (nonatomic, assign) BOOL backgroundDrawingEnabled; // default = NO
|
|
@property (nonatomic, assign) BOOL preDrawBlocksEnabled; // default = NO
|
|
|
|
// Don't become first responder. This might be useful to you if
|
|
// you'd like to disable the ability to select text while using the
|
|
// text renderer. Allows the renderer to become "active" as a responder.
|
|
@property (nonatomic, assign) BOOL shouldRefuseFirstResponder;
|
|
|
|
- (void)draw;
|
|
- (void)drawInContext:(CGContextRef)context;
|
|
- (CGSize)size; // calculates vertical size based on frame width
|
|
- (CGSize)sizeConstrainedToWidth:(CGFloat)width;
|
|
- (CGSize)sizeConstrainedToWidth:(CGFloat)width numberOfLines:(NSUInteger)numberOfLines;
|
|
- (void)reset;
|
|
|
|
// The -drawingAttributedString method allows for direct access
|
|
// to the string being drawn to the screen. For example, if the
|
|
// text rendering control is secure, this string would then
|
|
// contain a string with the same length as the original string,
|
|
// but all characters replaced by large ellipses instead.
|
|
// This method may be expanded or removed in the future.
|
|
- (NSAttributedString *)drawingAttributedString;
|
|
|
|
- (NSRange)selectedRange;
|
|
- (void)setSelection:(NSRange)selection;
|
|
- (NSString *)selectedString;
|
|
|
|
- (CGRect)firstRectForCharacterRange:(CFRange)range;
|
|
- (NSArray *)rectsForCharacterRange:(CFRange)range;
|
|
- (NSArray *)rectsForCharacterRange:(CFRange)range aggregationType:(AB_CTLineRectAggregationType)aggregationType;
|
|
|
|
// Draw the selection for the given rects. You probably shouldn't ever call this directly but it is exposed to allow for overriding. This will only get called if the selection is not empty and the selected text isn't being dragged.
|
|
// Note that at the point at which this is called, the selection color has already been set.
|
|
//
|
|
// rects - an array of rects for the current selection
|
|
// count - the number of rects in the `rects` array
|
|
- (void)drawSelectionWithRects:(CGRect *)rects count:(CFIndex)count;
|
|
|
|
@property (nonatomic, strong) id<ABActiveTextRange> hitRange;
|
|
|
|
@end
|
|
|
|
#import "TUITextRenderer+Event.h"
|
|
|
|
NS_INLINE NSRange ABNSRangeFromCFRange(CFRange r) { return NSMakeRange(r.location, r.length); }
|
|
NS_INLINE CFRange ABCFRangeFromNSRange(NSRange r) { return CFRangeMake(r.location, r.length); }
|