CPDFListView.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369
  1. //
  2. // CPDFListView.h
  3. // ComPDFKit
  4. //
  5. // Copyright © 2014-2022 PDF Technologies, Inc. All Rights Reserved.
  6. //
  7. // THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW
  8. // AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE ComPDFKit LICENSE AGREEMENT.
  9. // UNAUTHORIZED REPRODUCTION OR DISTRIBUTION IS SUBJECT TO CIVIL AND CRIMINAL PENALTIES.
  10. // This notice may not be removed from this file.
  11. //
  12. #import <ComPDFKit/ComPDFKit.h>
  13. #import <Foundation/Foundation.h>
  14. #import <QuartzCore/QuartzCore.h>
  15. #import <KMDrawViewSDK_Mac/KMDrawViewSDK_Mac.h>
  16. #define SKAnnotationKey @"SKAnnotation"
  17. extern NSString *SKPasteboardTypeLineStyle;
  18. extern NSNotificationName const CPDFListViewSelectionChangedNotification;
  19. extern NSNotificationName const CPDFListViewToolModeChangeNotification;
  20. extern NSNotificationName const CPDFListViewAnnotationTypeChangeNotification;
  21. extern NSNotificationName const CPDFListViewMagnificationChangedNotification;
  22. extern NSNotificationName const CPDFListViewDidAddAnnotationNotification;
  23. extern NSNotificationName const CPDFListViewDidRemoveAnnotationNotification;
  24. extern NSNotificationName const CPDFListViewActiveAnnotationsChangeNotification;
  25. extern NSNotificationName const CPDFListViewAnnotationsAttributeHasChangeNotification;
  26. extern NSNotificationName const KMPDFViewTableAnnotationDidChangeNotification;
  27. extern NSNotificationName const CPDFListViewDisplayModeChangeNotification;
  28. typedef NS_ENUM(NSInteger, CPDFViewSidebarSpeedMode) {
  29. CPDFViewSidebarSpeedModeLeft = 0,
  30. CPDFViewSidebarSpeedModeRight
  31. };
  32. typedef NS_ENUM(NSInteger, CAnnotationType) {
  33. CAnnotationTypeUnkown = 0,
  34. CAnnotationTypeAnchored, //Note
  35. CAnnotationTypeLink,
  36. CAnnotationTypeFreeText,
  37. CAnnotationTypeLine,
  38. CAnnotationTypeArrow,
  39. CAnnotationTypeSquare,
  40. CAnnotationTypeCircle,
  41. CAnnotationTypePolyGon,
  42. CAnnotationTypePolyLine,
  43. CAnnotationTypeHighlight,
  44. CAnnotationTypeUnderline,
  45. CAnnotationTypeSquiggly,
  46. CAnnotationTypeStrikeOut,
  47. CAnnotationTypeStamp,
  48. CAnnotationTypeSignSignature,
  49. /*CAnnotationTypeCaret,*/
  50. CAnnotationTypeInk,
  51. /*CAnnotationTypePopUp,*/
  52. /*CAnnotationTypeFileattachment,*/
  53. /*CAnnotationTypeSound,*/
  54. /*CAnnotationTypeMovie,*/
  55. CAnnotationTypeRedact,
  56. CAnnotationTypeEraser,
  57. CAnnotationTypeEditTextImage,
  58. CAnnotationTypeAddText,
  59. CAnnotationTypeAddImage,
  60. CAnnotationTypeRadioButton = 100,
  61. CAnnotationTypeCheckBox,
  62. CAnnotationTypeTextField,
  63. CAnnotationTypeComboBox,
  64. CAnnotationTypeListMenu,
  65. CAnnotationTypeActionButton,
  66. CAnnotationTypeSignature,
  67. CAnnotationTypeSignText = 200,
  68. CAnnotationTypeSignFalse,
  69. CAnnotationTypeSignTure,
  70. CAnnotationTypeSignCircle,
  71. CAnnotationTypeSignLine,
  72. CAnnotationTypeSignDot,
  73. CAnnotationTypeSignConfig,
  74. CAnnotationTypeSignDate,
  75. CAnnotationTypeTable,
  76. };
  77. typedef NS_ENUM(NSInteger, CToolMode) {
  78. CTextToolMode = 0,
  79. CMoveToolMode,
  80. CMagnifyToolMode,
  81. CSelectToolMode,
  82. CNoteToolMode,
  83. CSelectZoomToolMode,
  84. CFormToolMode,
  85. CSelfSignMode,
  86. CRedactToolMode,
  87. CMeasureToolMode, //测量模式
  88. CRedactErasureToolMode,
  89. CEditPDFToolMode, //编辑模式
  90. };
  91. typedef NS_ENUM(NSUInteger, KMPDFActiveFormsAlignType) {
  92. KMPDFActiveFormsAlignType_Left = 0,
  93. KMPDFActiveFormsAlignType_Vertical,
  94. KMPDFActiveFormsAlignType_Right,
  95. KMPDFActiveFormsAlignType_Top,
  96. KMPDFActiveFormsAlignType_Horizontally,
  97. KMPDFActiveFormsAlignType_Bottom,
  98. KMPDFActiveFormsAlignType_DisHorizontally,
  99. KMPDFActiveFormsAlignType_DisVertical
  100. };
  101. typedef NS_ENUM(NSUInteger, KMPDFViewActiveFormsType) {
  102. KMPDFViewActiveFormsType_NotAllform = -1,//注释类型不全为form类型
  103. KMPDFViewActiveFormsType_Mix = 0,//包含多种类型的form(全为form)
  104. KMPDFViewActiveFormsType_Pure,//单纯只有一种form(全为form)
  105. KMPDFViewActiveFormsType_PureSingle,//单纯只有一种form(全为form),个数为1
  106. KMPDFViewActiveFormsType_Text,//单纯只有一种form,并且是text(全为form)
  107. KMPDFViewActiveFormsType_TextSingle,//单纯只有一种form,并且是text(全为form),个数为1
  108. KMPDFViewActiveFormsType_None
  109. };
  110. typedef NS_ENUM(NSUInteger, KMPDFViewMode) {
  111. KMPDFViewModeNormal = 0,
  112. KMPDFViewModeSoft,
  113. KMPDFViewModeNight,
  114. KMPDFViewModeGreen,
  115. KMPDFViewModeThemes1,
  116. KMPDFViewModeThemes2,
  117. KMPDFViewModeThemes3,
  118. KMPDFViewModeThemes4,
  119. KMPDFViewModeOther
  120. };
  121. typedef NS_ENUM(NSInteger, KMPDFViewSplitMode) {
  122. KMPDFViewSplitModeDisable = 0,
  123. KMPDFViewSplitModeHorizontal,
  124. KMPDFViewSplitModeVertical
  125. };
  126. enum {
  127. SKDragArea = 1 << 16,
  128. SKResizeUpDownArea = 1 << 17,
  129. SKResizeLeftRightArea = 1 << 18,
  130. SKResizeDiagonal45Area = 1 << 19,
  131. SKResizeDiagonal135Area = 1 << 20,
  132. SKReadingBarArea = 1 << 21,
  133. SKSpecialToolArea = 1 << 22
  134. };
  135. @protocol CPDFListViewDelegate;
  136. @class CStampSignatureObject,CPDFListStampAnnotation,CPDFListSignatureAnnotation, KMFormListMenuPopWindowController, KMTableCellData;
  137. @interface CPDFListView : CPDFView
  138. @property (nonatomic, weak) id<CPDFListViewDelegate>pdfListViewDelegate;
  139. // Methods for The currently selected Annotation.
  140. @property (nonatomic, readonly) NSMutableArray <CPDFAnnotation *>*activeAnnotations;
  141. // Methods for The currently selected Annotation.
  142. @property (nonatomic, readonly) CPDFAnnotation * activeAnnotation;
  143. // Methods for The annotation type currently selected.
  144. @property (nonatomic, assign) CAnnotationType annotationType;
  145. // Method of the currently selected annotation mode.
  146. @property (nonatomic, assign) CToolMode toolMode;
  147. // The magnification times when the current magnifying glass is in mode
  148. @property (nonatomic, readonly) CGFloat magnification;
  149. @property (nonatomic, assign) BOOL isSetLinkDestinationArea;
  150. // Show Annotation or not
  151. @property (nonatomic, assign) BOOL hideNotes;
  152. // Whether to display a Form comment hop number
  153. @property (nonatomic, assign) BOOL showHopnumber;
  154. // Whether to display the Form name
  155. @property (nonatomic, assign) BOOL showFormFieldName;
  156. // Auxiliary reference line
  157. @property (nonatomic, strong) CAShapeLayer *shapeLayerLeftV;
  158. @property (nonatomic, strong) CAShapeLayer *shapeLayerRightV;
  159. @property (nonatomic, strong) CAShapeLayer *shapeLayerTopH;
  160. @property (nonatomic, strong) CAShapeLayer *shapeLayerBottomH;
  161. @property (nonatomic, assign) NSPoint lastAddAnnotationPoint;
  162. @property (nonatomic, assign) BOOL isCreatAnnotation;
  163. @property (nonatomic, assign) NSInteger toolBarCreateAnnotationMenuItem;
  164. @property (nonatomic, assign) BOOL isTakeSnapeSelectConetent;
  165. @property (nonatomic, assign) KMPDFViewMode viewMode;
  166. @property (nonatomic, assign) KMPDFViewSplitMode viewSplitMode;
  167. @property (nonatomic, strong) KMFormListMenuPopWindowController *listWindowController;
  168. @property (nonatomic, strong) NSTrackingArea *trackingArea;
  169. @property (nonatomic, strong) NSImage *originImage;
  170. @property (nonatomic,retain) KMTableCellData *cellCopyData;
  171. @property (nonatomic,retain) NSTextField *tableTextField;
  172. @property (nonatomic, assign) NSPoint dragTablePoint;
  173. @property (nonatomic, assign) BOOL editAreaBoundUpdating;
  174. // Measurement attribute setting
  175. @property (nonatomic, retain) CPDFDistanceMeasureInfo *distanceMeasureInfo;
  176. @property (nonatomic, retain) CPDFPerimeterMeasureInfo *perimeterMeasureInfo;
  177. @property (nonatomic, retain) CPDFAreaMeasureInfo *polygonAreaMeasureInfo;
  178. @property (nonatomic, retain) CPDFAreaMeasureInfo *squareAreaMeasureInfo;
  179. @property (nonatomic, assign) BOOL isPresentationMode;
  180. @property (nonatomic, strong) KMDrawView *presentationDrawView;
  181. - (CPDFAnnotation *)addAnnotationWithType:(CAnnotationType)annotationType selection:(CPDFSelection *)selection page:(CPDFPage *)page bounds:(NSRect)bounds;
  182. - (void)addAnnotationWithAnnotation:(CPDFAnnotation *)annotation toPage:(CPDFPage *)page;
  183. // Add stamp Annotation, add directly after mouse click
  184. // a new parameter.
  185. // stampObject - stamp Object.
  186. // isToolModel - Whether it is a pattern
  187. - (void)setAddStampObject:(CStampSignatureObject *)stampObject keepToolModel:(BOOL)isToolModel;
  188. // Add an image Stamp note
  189. - (void)addAnnotationWithImage:(NSImage *)image page:(CPDFPage *)page point:(NSPoint)point;
  190. // Refresh the currently selected Annotation
  191. - (void)updateActiveAnnotations:(NSArray<CPDFAnnotation *> *)activeAnnotation;
  192. // Edit Annotation
  193. - (void)editAnnotation:(CPDFAnnotation *)annotation;
  194. // Rotate Stamp notes, angle 0-360 degrees,Rotation is supported only by the current addition
  195. - (void)rotateStampAnnotation:(CPDFListStampAnnotation *)annotation rotateAngle:(NSInteger)angle;
  196. // Rotate Signature notes, angle 0-360 degrees,Rotation is supported only by the current addition
  197. - (void)rotateSignatureAnnotation:(CPDFListSignatureAnnotation *)annotation rotateAngle:(NSInteger)angle;
  198. // When selecting a region mode, the selected region is obtained
  199. - (NSRect)currentSelectionRect;
  200. // Scale the page to the specified range
  201. - (void)zoomToRect:(NSRect)rect onPage:(CPDFPage *)page;
  202. // Remove Auxiliary reference line
  203. - (void)removeShapeLayer;
  204. // Determines whether the current annotation is consistent with the selected annotation mode
  205. - (BOOL)consistentTypeWithAnnotation:(CPDFAnnotation *)annotation;
  206. //修改对齐方式
  207. - (void)changeAnnotations:(NSArray<CPDFAnnotation *> *)annotations alignmentType:(KMPDFActiveFormsAlignType)type;
  208. - (void)addImageAnnotation:(NSImage *)image center:(NSPoint)center isRemoveBGColor:(BOOL)isRemoveBGColor;
  209. - (void)setPageBackgroundColorWithColor:(NSColor *)color viewMode:(KMPDFViewMode)viewMode;
  210. - (BOOL)writeSelectionToPasteboard:(NSPasteboard *)pboard types:(NSArray *)types;
  211. - (void)enterPresentationDrawMode;
  212. - (BOOL)isEnterPresentationDrawMode;
  213. - (void)changePresentationDrawModelColor:(NSColor *)color;
  214. - (void)resetPresentationDrawMode;
  215. - (void)exitPresentationDrawMode;
  216. - (KMDrawView *)CreatePresentationDrawView;
  217. @end
  218. @protocol CPDFListViewDelegate <NSObject>
  219. @optional
  220. - (void)PDFListViewChangedSelectionOrMagnification:(CPDFListView *)pdfListView;
  221. - (void)PDFListViewDidSelectionEnd:(CPDFListView *)pdfListView;
  222. - (void)PDFListViewChangedMagnification:(CPDFListView *)pdfListView;
  223. - (void)PDFListViewChangedToolMode:(CPDFListView *)pdfListView forToolMode:(CToolMode)toolMode;
  224. - (void)PDFListViewChangedAnnotationType:(CPDFListView *)pdfListView forAnnotationType:(CAnnotationType)annotationType;
  225. - (NSColor *)PDFListViewBackgroundColor;
  226. - (void)PDFListViewAddAnnotations:(CPDFListView *)pdfListView forAddAnnotations:(NSArray<CPDFAnnotation *> *)annotations inPage:(CPDFPage *)pdfPage;
  227. - (void)PDFListViewRemoveAnnotations:(CPDFListView *)pdfListView forRemoveAnnotations:(NSArray<CPDFAnnotation *> *)annotations inPage:(CPDFPage *)pdfPage;
  228. - (void)PDFListViewDeleteAnnotations:(CPDFListView *)pdfListView forDeleteAnnotations:(NSArray<CPDFAnnotation *> *)annotations inPage:(CPDFPage *)pdfPage;
  229. - (void)PDFListViewChangeatioActiveAnnotations:(CPDFListView *)pdfListView forActiveAnnotations:(NSArray<CPDFAnnotation *> *)annotations isRightMenu:(BOOL)isRightMenu;
  230. - (void)PDFListViewMenuForEvent:(CPDFListView *)pdfListView forEvent:(NSEvent *)theEvent clickMenu:(NSMenu **)menu isMoveSelectAnno:(BOOL)isMoveSelectAnno;
  231. - (BOOL)PDFListViewMenuValidate:(CPDFListView *)pdfListView menuItem:(NSMenuItem *)menuItem isTakesEffect:(BOOL *)isTakesEffect;
  232. - (void)PDFListViewEditAnnotation:(CPDFListView *)pdfListView forAnnotation:(CPDFAnnotation *)anotation;
  233. - (BOOL)PDFListViewKeyDownIsContinue:(CPDFListView *)pdfListView theEvent:(NSEvent *)theEvent;
  234. - (NSArray<NSMenuItem *> *)PDFListViewMenuItemsEditingAtPoint:(CGPoint)point forPage:(CPDFPage *)page menuItems:(NSArray <NSMenuItem *>*)menuItems;
  235. - (void)PDFListViewDidTextFontChanged:(CPDFListView *)pdfListView;
  236. - (void)PDFListViewDidTextColorChanged:(CPDFListView *)pdfListView withColor:(NSColor *)color;
  237. - (void)PDFListViewRedactErasure:(CPDFListView *)pdfListView;
  238. - (void)PDFListViewLinkDestinationStart:(CPDFListView *)pdfListView withActiveAnnotation:(CPDFAnnotation *)annotation;
  239. - (void)PDFListViewLinkDestinationEnd:(CPDFListView *)pdfListView withActiveAnnotation:(CPDFAnnotation *)annotation;
  240. - (void)PDFListViewKeyDowClosePanel:(CPDFViewSidebarSpeedMode)speedy event:(NSEvent *)theEvent;
  241. - (NSArray<NSColor *> *)PDFListViewEventMarkupColorWithAnnotation:(CPDFAnnotation *)annotation;
  242. - (BOOL)PDFListViewHaveDocumentAttribute;
  243. // 是否需要绘制注释 【文字、背景】
  244. - (BOOL)PDFListView:(CPDFListView *)pdfListView needDrawAnnotation:(CPDFAnnotation *)annotation;
  245. - (void)PDFListViewAnnotationAttributeHasChange:(CPDFListView *)pdfListView withAnnotation:(CPDFAnnotation *)annotation;
  246. - (void)PDFListView:(CPDFListView *)sender showSnapshotAtPageNumber:(NSInteger)pageNum forRect:(NSRect)rect scaleFactor:(CGFloat)scaleFactor autoFits:(BOOL)autoFits;
  247. - (void)PDFListView:(CPDFListView *)pdfView documentDataDidChanged:(id)docData withInfo:(NSDictionary *)info;
  248. - (void)PDFListViewAnnotationMeasureInfoChange:(CPDFListView *)pdfListView withAnnotation:(CPDFAnnotation *)annotation;
  249. - (void)PDFListViewMeasureCancel:(CPDFListView *)pdfListView;
  250. @end