/calloutview

A lightweight callout view class for iOS mimicking UICalloutView.

Primary LanguageObjective-CApache License 2.0Apache-2.0

Overview

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.

Usage

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.

More Info

You can read more info if you wish in the blog post.

Adjustable-Height Version

Check out the custom_drawn_bg branch for a version of SMCalloutView that draws its background dynamically and supports flexible heights. This will be unified with the master branch in the future, but in the meantime I'd love any feedback on it. Thanks to u10int for contributing this code!

ARC Support

This class requires LLVM 4.0 with Automatic Reference Counting (ARC), enabled by default in modern Xcode projects.