Overview

A bindings compatible NSControl subclass which draws a calendar much like the one sported by the iPhone. The project also includes AFWeekView designed to eliminate having to use checkboxes to represent days.

AFCalendarControl exposes five bindings:

• AFCurrentMonthBinding, the month to display

• NSContentBinding; an enumerable collection
• AFContentDatesBinding; bound to the model subpath for the date property, expects an NSDate object
• NSSelectedIndexBinding; the index of the selected object in the object returned by NSContentBinding
• AFDateHighlightedBinding; bound to the model subpath, expects a BOOL wrapped in an NSNumber. If set the control will draw an indicator below the date's day number.

Dependencies

• Mac OS X Leopard 10.5
• Objective-C 2.0
• Xcode 3.0

CalendarControl is dependent on a framework (AmberKitAdditions) contained inside another one of my projects Amber found at http://code.google.com/p/amber-framework which must be available at compile time.

Using the Control

The easiest way to use CalendarControl is to instead download Amber.framework which contains all my custom UI controls and the AppKit additions required to use them.

Otherwise you can download the code for this project alone using an svn:external property to pull the 'code' subdirectory, i.e. http://calendarcontrol.googlecode.com/svn/trunk/application/code, you could also pull the 'code' directory from a branch or tag.

Building the Control

If you checkout the entire project (see "Repository Structure" below) and are building it from source then the Xcode project must be able to find the Amber Xcode project file.

It expects to find the Amber working copy at the same level as it's own working directory. It must also be able to link the framework; the two projects should either share their build products directory, or you must set custom header search paths. See here http://lists.apple.com/archives/Xcode-users/2008/Sep/msg00268.html for more information.

Updated: 17/05/2009