MAAnnotationView.h 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106
  1. //
  2. // MAAnnotationView.h
  3. // MAMapKit
  4. //
  5. // Created by AutoNavi.
  6. // Copyright (c) 2013年 AutoNavi. All rights reserved.
  7. //
  8. #import <UIKit/UIKit.h>
  9. typedef NS_ENUM(NSInteger, MAAnnotationViewDragState) {
  10. MAAnnotationViewDragStateNone = 0, ///< 静止状态
  11. MAAnnotationViewDragStateStarting, ///< 开始拖动
  12. MAAnnotationViewDragStateDragging, ///< 拖动中
  13. MAAnnotationViewDragStateCanceling, ///< 取消拖动
  14. MAAnnotationViewDragStateEnding ///< 拖动结束
  15. };
  16. @protocol MAAnnotation;
  17. /*!
  18. @brief 标注view
  19. */
  20. @interface MAAnnotationView : UIView
  21. /*!
  22. @brief 初始化并返回一个annotation view
  23. @param annotation 关联的annotation对象
  24. @param reuseIdentifier 如果要复用view,传入一个字符串,否则设为nil,建议重用view
  25. @return 初始化成功则返回annotation view,否则返回nil
  26. */
  27. - (id)initWithAnnotation:(id <MAAnnotation>)annotation reuseIdentifier:(NSString *)reuseIdentifier;
  28. /*!
  29. @brief 复用标识
  30. */
  31. @property (nonatomic, readonly) NSString *reuseIdentifier;
  32. /*!
  33. @brief 当从reuse队列里取出时被调用
  34. */
  35. - (void)prepareForReuse;
  36. /*!
  37. @brief 关联的annotation
  38. */
  39. @property (nonatomic, strong) id <MAAnnotation> annotation;
  40. /*!
  41. @brief 显示的image
  42. */
  43. @property (nonatomic, strong) UIImage *image;
  44. /*!
  45. @brief 默认情况下,annotation view的中心位于annotation的坐标位置,可以设置centerOffset改变view的位置,正的偏移使view朝右下方移动,负的朝左上方,单位是像素
  46. */
  47. @property (nonatomic) CGPoint centerOffset;
  48. /*!
  49. @brief 默认情况下,弹出的气泡位于view正中上方,可以设置calloutOffset改变view的位置,正的偏移使view朝右下方移动,负的朝左上方,单位是像素
  50. */
  51. @property (nonatomic) CGPoint calloutOffset;
  52. /*!
  53. @brief 默认为YES,当为NO时view忽略触摸事件
  54. */
  55. @property (nonatomic, getter=isEnabled) BOOL enabled;
  56. /*!
  57. @brief annotationView是否突出显示(一般不需要手动设置)
  58. */
  59. @property (nonatomic, getter=isHighlighted) BOOL highlighted;
  60. /*!
  61. @brief 设置是否处于选中状态
  62. */
  63. @property (nonatomic, getter=isSelected) BOOL selected;
  64. - (void)setSelected:(BOOL)selected animated:(BOOL)animated;
  65. /*!
  66. @brief 设置是否可以显示callout,默认为NO
  67. */
  68. @property (nonatomic) BOOL canShowCallout;
  69. /*!
  70. @brief 显示在气泡左侧的view
  71. */
  72. @property (retain, nonatomic) UIView *leftCalloutAccessoryView;
  73. /*!
  74. @brief 显示在气泡右侧的view
  75. */
  76. @property (retain, nonatomic) UIView *rightCalloutAccessoryView;
  77. /*!
  78. @brief 是否支持拖动,默认为NO
  79. */
  80. @property (nonatomic, getter=isDraggable) BOOL draggable;
  81. /*!
  82. @brief 当前view的拖动状态
  83. */
  84. @property (nonatomic) MAAnnotationViewDragState dragState;
  85. - (void)setDragState:(MAAnnotationViewDragState)newDragState animated:(BOOL)animated;
  86. @end