mirror of
https://github.com/wu736139669/ManagerDemo.git
synced 2026-08-05 05:55:42 +00:00
add pods
This commit is contained in:
@@ -0,0 +1,364 @@
|
||||
//
|
||||
// DTAttributedTextContentView.h
|
||||
// DTCoreText
|
||||
//
|
||||
// Created by Oliver Drobnik on 1/9/11.
|
||||
// Copyright 2011 Drobnik.com. All rights reserved.
|
||||
//
|
||||
|
||||
#import "DTCoreTextLayoutFrame.h"
|
||||
#import "DTWeakSupport.h"
|
||||
|
||||
@class DTAttributedTextContentView;
|
||||
@class DTCoreTextLayoutFrame;
|
||||
@class DTTextBlock;
|
||||
@class DTCoreTextLayouter;
|
||||
@class DTTextAttachment;
|
||||
|
||||
/**
|
||||
notification that gets sent as soon as the receiver has done a layout pass
|
||||
*/
|
||||
extern NSString * const DTAttributedTextContentViewDidFinishLayoutNotification;
|
||||
|
||||
/**
|
||||
Protocol to provide custom views for elements in an DTAttributedTextContentView. Also the delegate gets notified once the text view has been drawn.
|
||||
*/
|
||||
@protocol DTAttributedTextContentViewDelegate <NSObject>
|
||||
|
||||
@optional
|
||||
|
||||
/**
|
||||
@name Notifications
|
||||
*/
|
||||
|
||||
/**
|
||||
Called before a layout frame or a part of it is drawn. The text delegate can draw contents that goes under the text in this method.
|
||||
|
||||
@param attributedTextContentView The content view that will be drawing a layout frame
|
||||
@param layoutFrame The layout frame that will be drawn for
|
||||
@param context The graphics context that will drawn into
|
||||
*/
|
||||
- (void)attributedTextContentView:(DTAttributedTextContentView *)attributedTextContentView willDrawLayoutFrame:(DTCoreTextLayoutFrame *)layoutFrame inContext:(CGContextRef)context;
|
||||
|
||||
|
||||
/**
|
||||
Called after a layout frame or a part of it is drawn. The text delegate can draw contents that goes over the text in this method.
|
||||
|
||||
@param attributedTextContentView The content view that drew a layout frame
|
||||
@param layoutFrame The layout frame that was drawn for
|
||||
@param context The graphics context that was drawn into
|
||||
*/
|
||||
- (void)attributedTextContentView:(DTAttributedTextContentView *)attributedTextContentView didDrawLayoutFrame:(DTCoreTextLayoutFrame *)layoutFrame inContext:(CGContextRef)context;
|
||||
|
||||
|
||||
/**
|
||||
Called before the text belonging to a text block is drawn.
|
||||
|
||||
This gives the developer an opportunity to draw a custom background below a text block.
|
||||
|
||||
@param attributedTextContentView The content view that drew a layout frame
|
||||
@param textBlock The text block
|
||||
@param frame The frame within the content view's coordinate system that will be drawn into
|
||||
@param context The graphics context that will be drawn into
|
||||
@param layoutFrame The layout frame that will be drawn for
|
||||
@returns `YES` is the standard fill of the text block should be drawn, `NO` if it should not
|
||||
*/
|
||||
- (BOOL)attributedTextContentView:(DTAttributedTextContentView *)attributedTextContentView shouldDrawBackgroundForTextBlock:(DTTextBlock *)textBlock frame:(CGRect)frame context:(CGContextRef)context forLayoutFrame:(DTCoreTextLayoutFrame *)layoutFrame;
|
||||
|
||||
/**
|
||||
@name Providing Custom Views for Content
|
||||
*/
|
||||
|
||||
|
||||
/**
|
||||
Provide custom view for an attachment, e.g. an imageView for images
|
||||
|
||||
@param attributedTextContentView The content view asking for a custom view
|
||||
@param attachment The <DTTextAttachment> that this view should represent
|
||||
@param frame The frame that the view should use to fit on top of the space reserved for the attachment
|
||||
@returns The view that should represent the given attachment
|
||||
*/
|
||||
- (UIView *)attributedTextContentView:(DTAttributedTextContentView *)attributedTextContentView viewForAttachment:(DTTextAttachment *)attachment frame:(CGRect)frame;
|
||||
|
||||
|
||||
/**
|
||||
Provide button to be placed over links, the identifier is used to link multiple parts of the same A tag
|
||||
|
||||
@param attributedTextContentView The content view asking for a custom view
|
||||
@param url The `NSURL` of the hyperlink
|
||||
@param identifier An identifier that uniquely identifies the hyperlink within the document
|
||||
@param frame The frame that the view should use to fit on top of the space reserved for the attachment
|
||||
@returns The view that should represent the given hyperlink
|
||||
*/
|
||||
- (UIView *)attributedTextContentView:(DTAttributedTextContentView *)attributedTextContentView viewForLink:(NSURL *)url identifier:(NSString *)identifier frame:(CGRect)frame;
|
||||
|
||||
|
||||
/**
|
||||
Provide generic views for all attachments.
|
||||
|
||||
This is only called if the more specific delegate methods are not implemented.
|
||||
|
||||
@param attributedTextContentView The content view asking for a custom view
|
||||
@param string The attributed sub-string containing this element
|
||||
@param frame The frame that the view should use to fit on top of the space reserved for the attachment
|
||||
@returns The view that should represent the given hyperlink or text attachment
|
||||
@see attributedTextContentView:viewForAttachment:frame: and attributedTextContentView:viewForAttachment:frame:
|
||||
*/
|
||||
- (UIView *)attributedTextContentView:(DTAttributedTextContentView *)attributedTextContentView viewForAttributedString:(NSAttributedString *)string frame:(CGRect)frame;
|
||||
|
||||
@end
|
||||
|
||||
|
||||
enum {
|
||||
DTAttributedTextContentViewRelayoutNever = 0,
|
||||
DTAttributedTextContentViewRelayoutOnWidthChanged = 1 << 0,
|
||||
DTAttributedTextContentViewRelayoutOnHeightChanged = 1 << 1,
|
||||
};
|
||||
typedef NSUInteger DTAttributedTextContentViewRelayoutMask;
|
||||
|
||||
|
||||
/**
|
||||
Attributed Text Content Views display attributed strings generated by DTHTMLAttributedStringBuilder. They can display images and hyperlinks inline or optionally place custom subviews (which get provided via the <delegate> in the appropriate places. By itself content views do not scroll, for that there is the `UIScrollView` subclass <DTAttributedTextView>.
|
||||
|
||||
Generally you have two options to providing content:
|
||||
|
||||
- set the attributed string
|
||||
- set a layout frame
|
||||
|
||||
The first you would normally use, the second you would use if you are layouting a larger text and then simply want to display individual parts (e.g. pages from an e-book) in a content view.
|
||||
|
||||
DTAttributedTextContentView is designed to be used as the content view inside a DTAttributedTextView and thus sizes its intrinsicContentSize always to be the same as the width of the set frame. Use DTAttributedLabel if you don't require scrolling behavior.
|
||||
*/
|
||||
|
||||
@interface DTAttributedTextContentView : UIView
|
||||
{
|
||||
NSAttributedString *_attributedString;
|
||||
DTCoreTextLayoutFrame *_layoutFrame;
|
||||
|
||||
UIEdgeInsets _edgeInsets;
|
||||
|
||||
NSMutableDictionary *customViewsForAttachmentsIndex;
|
||||
|
||||
BOOL _flexibleHeight;
|
||||
|
||||
// for layoutFrame
|
||||
NSInteger _numberOfLines;
|
||||
NSLineBreakMode _lineBreakMode;
|
||||
NSAttributedString *_truncationString;
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
@name Sizing
|
||||
*/
|
||||
|
||||
/**
|
||||
Calculates the suggested frame size that would fit the entire <attributedString> with a maximum width.
|
||||
|
||||
This does a full layout pass that is cached in <DTCoreTextLayouter>. If you specify a frame that fits the result from this method then the resulting layoutFrame is reused.
|
||||
|
||||
Since this obeys the <edgeInsets> you have to add these to the final frame size.
|
||||
|
||||
@param width The maximum width to layout for
|
||||
@returns The suggested frame size
|
||||
*/
|
||||
- (CGSize)suggestedFrameSizeToFitEntireStringConstraintedToWidth:(CGFloat)width; // obeys the edge insets
|
||||
|
||||
/**
|
||||
The size of contents of the receiver. This is possibly used by auto-layout, but also for example if you want to get the size of the receiver necessary for a scroll view
|
||||
|
||||
This method is defined as of iOS 6, but to support earlier OS versions
|
||||
*/
|
||||
- (CGSize)intrinsicContentSize;
|
||||
|
||||
/**
|
||||
Whether the receiver calculates layout limited to the view bounds.
|
||||
|
||||
If set to `YES` then the layout process calculates the layoutFrame with open ended height. If set to ´NO` then the current bounds of the receiver determine the height.
|
||||
*/
|
||||
@property (nonatomic, assign) BOOL layoutFrameHeightIsConstrainedByBounds;
|
||||
|
||||
|
||||
/**
|
||||
@name Layouting
|
||||
*/
|
||||
|
||||
/**
|
||||
Discards the current <layoutFrame> and creates a new one based on the <attributedString>.
|
||||
*/
|
||||
- (void)relayoutText;
|
||||
|
||||
|
||||
/**
|
||||
The layouter to use for the receiver. Created by default.
|
||||
|
||||
By default this is generated automatically for the current <attributedString>. You can also supply your own if you require special layouting behavior.
|
||||
*/
|
||||
@property (atomic, strong) DTCoreTextLayouter *layouter;
|
||||
|
||||
|
||||
/**
|
||||
The layout frame to use for the receiver. Created by default.
|
||||
|
||||
A layout frame is basically one rectangle, inset by the <edgeInsets>. By default this is automatically generated for the current <attributedString>. You can also create a <DTCoreTextLayoutFrame> seperately and set this property to display the layout frame. This is usedful for example if you layout entire e-book and then set the <layoutFrame> for displaying individual pages.
|
||||
*/
|
||||
@property (atomic, strong) DTCoreTextLayoutFrame *layoutFrame;
|
||||
|
||||
|
||||
/**
|
||||
@name Working with Custom Subviews
|
||||
*/
|
||||
|
||||
/**
|
||||
Removes all custom subviews (excluding views representing links) from the receiver.
|
||||
*/
|
||||
- (void)removeAllCustomViews;
|
||||
|
||||
|
||||
/**
|
||||
Removes all custom subviews representing links from the receiver
|
||||
*/
|
||||
- (void)removeAllCustomViewsForLinks;
|
||||
|
||||
|
||||
/**
|
||||
Removes invisible custom subviews and lays out subviews visible in the given rectangle
|
||||
@param rect The bounds of the visible area to layout custom subviews in.
|
||||
*/
|
||||
- (void)layoutSubviewsInRect:(CGRect)rect;
|
||||
|
||||
|
||||
/**
|
||||
@name Providing Content
|
||||
*/
|
||||
|
||||
/**
|
||||
The attributed string to display in the receiver
|
||||
*/
|
||||
@property (nonatomic, copy) NSAttributedString *attributedString;
|
||||
|
||||
|
||||
/**
|
||||
The delegate that is in charge of supplying custom behavior for the receiver. It must conform to <DTAttributedTextContentViewDelegate> and provide custom subviews, link buttons, etc.
|
||||
*/
|
||||
|
||||
@property (nonatomic, DT_WEAK_PROPERTY) IBOutlet id <DTAttributedTextContentViewDelegate> delegate;
|
||||
|
||||
/**
|
||||
@name Customizing Content Display
|
||||
*/
|
||||
|
||||
/**
|
||||
The insets to apply around the text content
|
||||
*/
|
||||
@property (nonatomic) UIEdgeInsets edgeInsets;
|
||||
|
||||
/**
|
||||
Specifies if the receiver should draw image text attachments.
|
||||
|
||||
Set to `NO` if you use the delegate methods to provide custom subviews to display images.
|
||||
*/
|
||||
@property (nonatomic) BOOL shouldDrawImages;
|
||||
|
||||
|
||||
/**
|
||||
Specified if the receiver should draw hyperlinks.
|
||||
|
||||
If set to `NO` then your custom subview/button for hyperlinks is responsible for displaying hyperlinks. You can use <DTLinkButton> to have links show a differently for normal and highlighted style
|
||||
*/
|
||||
@property (nonatomic) BOOL shouldDrawLinks;
|
||||
|
||||
|
||||
/**
|
||||
Specifies if the receiver should layout custom subviews in layoutSubviews.
|
||||
|
||||
If set to `YES` then all custom subviews will always be layouted. Set to `NO` to only layout visible subviews, e.g. in a scroll view. Defaults to `YES` if used stand-alone, `NO` inside a <DTAttributedTextView>.
|
||||
*/
|
||||
@property (nonatomic) BOOL shouldLayoutCustomSubviews;
|
||||
|
||||
|
||||
/**
|
||||
The amount by which all contents of the receiver will offset of display and subview layouting
|
||||
*/
|
||||
@property (nonatomic) CGPoint layoutOffset;
|
||||
|
||||
|
||||
/**
|
||||
The offset to apply for drawing the background.
|
||||
|
||||
If you set a pattern color as background color you can have the pattern phase be offset by this value.
|
||||
*/
|
||||
@property (nonatomic) CGSize backgroundOffset;
|
||||
|
||||
|
||||
/**
|
||||
An integer bit mask that determines how the receiver relayouts its contents when its bounds change.
|
||||
|
||||
When the view’s bounds change, that view automatically re-layouts its text according to the relayout mask. You specify the value of this mask by combining the constants described in DTAttributedTextContentViewRelayoutMask using the C bitwise OR operator. Combining these constants lets you specify which dimensions will cause a re-layout if modified. The default value of this property is DTAttributedTextContentViewRelayoutOnWidthChanged, which indicates that the text will be re-layouted if the width changes, but not if the height changes.
|
||||
*/
|
||||
@property (nonatomic) DTAttributedTextContentViewRelayoutMask relayoutMask;
|
||||
|
||||
@end
|
||||
|
||||
|
||||
/**
|
||||
You can globally customize the layer class to be used for new instances of <DTAttributedTextContentView>. By itself it makes most sense to go with the default `CALayer`. For larger bodies of text, i.e. if there is scrolling then you should use a `CATiledLayer` subclass instead.
|
||||
*/
|
||||
@interface DTAttributedTextContentView (Tiling)
|
||||
|
||||
/**
|
||||
Sets the layer class globally to use in new instances of content views. Defaults to `CALayer`.
|
||||
|
||||
While being fine for most use cases you should use a `CATiledLayer` subclass for anything larger than a screen full, e.g. in scroll views.
|
||||
@param layerClass The class to use, should be a `CALayer` subclass
|
||||
*/
|
||||
+ (void)setLayerClass:(Class)layerClass;
|
||||
|
||||
/**
|
||||
The current layer class that is used for new instances
|
||||
@returns The `CALayer` subclass that new instances are using
|
||||
*/
|
||||
+ (Class)layerClass;
|
||||
|
||||
@end
|
||||
|
||||
|
||||
/**
|
||||
Methods for drawing the content view
|
||||
*/
|
||||
@interface DTAttributedTextContentView (Drawing)
|
||||
|
||||
/**
|
||||
Creates an image from a part of the receiver's content view
|
||||
@param bounds The bounds of the content to draw
|
||||
@param options The drawing options to apply when drawing
|
||||
@see [DTCoreTextLayoutFrame drawInContext:options:] for a list of available drawing options
|
||||
@returns A `UIImage` with the specified content
|
||||
*/
|
||||
- (UIImage *)contentImageWithBounds:(CGRect)bounds options:(DTCoreTextLayoutFrameDrawingOptions)options;
|
||||
|
||||
@end
|
||||
|
||||
|
||||
/**
|
||||
Methods for getting cursor position and frame. Those are convenience methods that call through to the layoutFrame property which has the same coordinate system as the receiver.
|
||||
*/
|
||||
@interface DTAttributedTextContentView (Cursor)
|
||||
|
||||
/**
|
||||
Determines the closest string index to a point in the receiver's frame.
|
||||
|
||||
This can be used to find the cursor position to position an input caret at.
|
||||
@param point The point
|
||||
@returns The resulting string index
|
||||
*/
|
||||
- (NSInteger)closestCursorIndexToPoint:(CGPoint)point;
|
||||
|
||||
/**
|
||||
The rectangle to draw a caret for a given index
|
||||
@param index The string index for which to determine a cursor frame
|
||||
@returns The cursor rectangle
|
||||
*/
|
||||
- (CGRect)cursorRectAtIndex:(NSInteger)index;
|
||||
|
||||
@end
|
||||
Reference in New Issue
Block a user