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
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.
How do I change the height of the callout?
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.
Can I customize the background graphics?
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:
SMCalloutImageBackgroundViewlets you specify each of the image "fragments" that make up a horizontally-stretchable background.
SMCalloutDrawnBackgroundViewdraws the background at any size using CoreGraphics methods. You can copy the
-drawRectmethod and change the parameters to suit your needs.
Can I use the callout with the Google Maps iOS SDK?
Have you recreated more of MapKit?
Nope, but you might be interested in MapBox's iOS SDK, which uses
SMCalloutView as part of its custom open-source variation of MapKit.
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.