SMCalloutView aims to be an exact replica of the private UICalloutView system control.
We all love those "bubbles" you get when clicking pins in MKMapView. But sadly, it's impossible to present this bubble-style "Callout" UI anywhere outside MKMapView. Phooey! So this class painstakingly recreates this handy control for your pleasure.
To use SMCalloutView in your own projects, simply copy the files SMCalloutView.h
and SMCalloutView.m
.
The comments in SMCalloutView.h
do a lot of explaining on how to use the class, but the main function you'll need is presentCalloutFromRect:
. You'll specify the view you'd like to add the callout to, as well as the rect defining the "target" that the popup should point at. The target rect should be in the coordinate system of the target view (just like the similarly-named UIPopover
method). Most likely this will be target.frame
if you're adding the callout view as a sibling of the target view, or it would be target.bounds
if you're adding the callout view to the target itself.
You can study the included project's AppDelegate.m
for a working example.
If you use only the title/titleView/subtitle/subtitleView
properties, the callout will always be the "system standard" height. If you assign the contentView
property however, then the callout will size to fit the contentView
and the other properties are ignored.
Yes, the callout background is an instance of SMCalloutBackgroundView
. You can set your own custom View
subclass to be the background, or you can use one of the built-in subclasses:
SMCalloutImageBackgroundView
lets you specify each of the image "fragments" that make up a horizontally-stretchable background.SMCalloutDrawnBackgroundView
draws the background at any size using CoreGraphics methods. You can copy the-drawRect
method and change the parameters to suit your needs.
Check out ryanmaxwell's demo project for an example of one way to do this. (More discussion on this topic)
Nope, but other intrepid coders have!
-
For an awesome replacement of the pulsing blue "Current Location" dot, check out Sam Vermette's SVPulsingAnnotationView.
-
And for the outdoor map data and tiles themselves, check out MapBox's iOS SDK, a complete open-source solution for custom maps. They even use
SMCalloutView
out of the box!
You can read more info if you wish in the blog post.
This class requires LLVM 4.0 with Automatic Reference Counting (ARC), enabled by default in modern Xcode projects.