CPTPlotSpace.h

Go to the documentation of this file.

#import "CPTDefinitions.h"
#import "CPTPlot.h"
#import "CPTResponder.h"
 
@class CPTLayer;
@class CPTPlotRange;
@class CPTGraph;
@class CPTPlotSpace;
 
typedef NSString *CPTPlotSpaceCoordinateMapping cpt_swift_struct;
 
typedef NSString *CPTPlotSpaceInfoKey cpt_swift_struct;
 
 
extern CPTPlotSpaceCoordinateMapping __nonnull const CPTPlotSpaceCoordinateMappingDidChangeNotification;
 
extern CPTPlotSpaceInfoKey __nonnull const CPTPlotSpaceCoordinateKey;
 
extern CPTPlotSpaceInfoKey __nonnull const CPTPlotSpaceScrollingKey;
 
extern CPTPlotSpaceInfoKey __nonnull const CPTPlotSpaceDisplacementKey;
 
 
@protocol CPTPlotSpaceDelegate<NSObject>
 
@optional
 
 
-(BOOL)plotSpace:(nonnull CPTPlotSpace *)space shouldScaleBy:(CGFloat)interactionScale aboutPoint:(CGPoint)interactionPoint;
 
 
 
-(CGPoint)plotSpace:(nonnull CPTPlotSpace *)space willDisplaceBy:(CGPoint)proposedDisplacementVector;
 
 
 
-(nullable CPTPlotRange *)plotSpace:(nonnull CPTPlotSpace *)space willChangePlotRangeTo:(nonnull CPTPlotRange *)newRange forCoordinate:(CPTCoordinate)coordinate;
 
-(void)plotSpace:(nonnull CPTPlotSpace *)space didChangePlotRangeForCoordinate:(CPTCoordinate)coordinate;
 
 
 
-(BOOL)plotSpace:(nonnull CPTPlotSpace *)space shouldHandlePointingDeviceDownEvent:(nonnull CPTNativeEvent *)event atPoint:(CGPoint)point;
 
-(BOOL)plotSpace:(nonnull CPTPlotSpace *)space shouldHandlePointingDeviceDraggedEvent:(nonnull CPTNativeEvent *)event atPoint:(CGPoint)point;
 
-(BOOL)plotSpace:(nonnull CPTPlotSpace *)space shouldHandlePointingDeviceCancelledEvent:(nonnull CPTNativeEvent *)event;
 
-(BOOL)plotSpace:(nonnull CPTPlotSpace *)space shouldHandlePointingDeviceUpEvent:(nonnull CPTNativeEvent *)event atPoint:(CGPoint)point;
 
#if TARGET_OS_SIMULATOR || TARGET_OS_IPHONE
#else
 
-(BOOL)plotSpace:(nonnull CPTPlotSpace *)space shouldHandleScrollWheelEvent:(nonnull CPTNativeEvent *)event fromPoint:(CGPoint)fromPoint toPoint:(CGPoint)toPoint;
#endif
 
 
@end
 
typedef NSArray<__kindof CPTPlotSpace *> CPTPlotSpaceArray;
 
typedef NSMutableArray<__kindof CPTPlotSpace *> CPTMutablePlotSpaceArray;
 
#pragma mark -
 
@interface CPTPlotSpace : NSObject<CPTResponder, NSCoding, NSSecureCoding>
 
@property (nonatomic, readwrite, copy, nullable) id<NSCopying, NSCoding, NSObject> identifier;
@property (nonatomic, readwrite) BOOL allowsUserInteraction;
@property (nonatomic, readonly) BOOL isDragging;
@property (nonatomic, readwrite, cpt_weak_property, nullable) CPTGraph *graph;
@property (nonatomic, readwrite, cpt_weak_property, nullable) id<CPTPlotSpaceDelegate> delegate;
 
@property (nonatomic, readonly) NSUInteger numberOfCoordinates;
 
-(void)addCategory:(nonnull NSString *)category forCoordinate:(CPTCoordinate)coordinate;
-(void)removeCategory:(nonnull NSString *)category forCoordinate:(CPTCoordinate)coordinate;
-(void)insertCategory:(nonnull NSString *)category forCoordinate:(CPTCoordinate)coordinate atIndex:(NSUInteger)idx;
-(void)setCategories:(nullable CPTStringArray *)newCategories forCoordinate:(CPTCoordinate)coordinate;
-(void)removeAllCategories;
 
-(nonnull CPTStringArray *)categoriesForCoordinate:(CPTCoordinate)coordinate;
-(nullable NSString *)categoryForCoordinate:(CPTCoordinate)coordinate atIndex:(NSUInteger)idx;
-(NSUInteger)indexOfCategory:(nonnull NSString *)category forCoordinate:(CPTCoordinate)coordinate;
 
-(nonnull instancetype)init NS_DESIGNATED_INITIALIZER;
-(nullable instancetype)initWithCoder:(nonnull NSCoder *)decoder NS_DESIGNATED_INITIALIZER;
 
@end
 
#pragma mark -
 
@interface CPTPlotSpace(AbstractMethods)
 
-(CGPoint)plotAreaViewPointForPlotPoint:(nonnull CPTNumberArray *)plotPoint;
-(CGPoint)plotAreaViewPointForPlotPoint:(nonnull NSDecimal *)plotPoint numberOfCoordinates:(NSUInteger)count;
-(CGPoint)plotAreaViewPointForDoublePrecisionPlotPoint:(nonnull double *)plotPoint numberOfCoordinates:(NSUInteger)count;
 
-(nullable CPTNumberArray *)plotPointForPlotAreaViewPoint:(CGPoint)point;
-(void)plotPoint:(nonnull NSDecimal *)plotPoint numberOfCoordinates:(NSUInteger)count forPlotAreaViewPoint:(CGPoint)point;
-(void)doublePrecisionPlotPoint:(nonnull double *)plotPoint numberOfCoordinates:(NSUInteger)count forPlotAreaViewPoint:(CGPoint)point;
 
-(CGPoint)plotAreaViewPointForEvent:(nonnull CPTNativeEvent *)event;
 
-(nullable CPTNumberArray *)plotPointForEvent:(nonnull CPTNativeEvent *)event;
-(void)plotPoint:(nonnull NSDecimal *)plotPoint numberOfCoordinates:(NSUInteger)count forEvent:(nonnull CPTNativeEvent *)event;
-(void)doublePrecisionPlotPoint:(nonnull double *)plotPoint numberOfCoordinates:(NSUInteger)count forEvent:(nonnull CPTNativeEvent *)event;
 
-(void)setPlotRange:(nonnull CPTPlotRange *)newRange forCoordinate:(CPTCoordinate)coordinate;
-(nullable CPTPlotRange *)plotRangeForCoordinate:(CPTCoordinate)coordinate;
 
-(void)setScaleType:(CPTScaleType)newType forCoordinate:(CPTCoordinate)coordinate;
-(CPTScaleType)scaleTypeForCoordinate:(CPTCoordinate)coordinate;
 
-(void)scaleToFitPlots:(nullable CPTPlotArray *)plots;
-(void)scaleToFitPlots:(nullable CPTPlotArray *)plots forCoordinate:(CPTCoordinate)coordinate;
-(void)scaleToFitEntirePlots:(nullable CPTPlotArray *)plots;
-(void)scaleToFitEntirePlots:(nullable CPTPlotArray *)plots forCoordinate:(CPTCoordinate)coordinate;
-(void)scaleBy:(CGFloat)interactionScale aboutPoint:(CGPoint)interactionPoint;
 
@end