Inherits from UIView
Declared in IGCalendarView.h

Overview

The IGCalendarView is a container that displays different views for navigating dates and display appointments. Within in this control you can view 3 different display types Year, Month, and Day.

Each display type knows how to animate smoothly between other display types to prvoide a seamless transition.

You can use this control to display your own calendars/appointments.

Tasks

  •   theme

    Sets the IGCalendarThemeDefinition that will control the styling of particular elements of the IGCalendarView.

    property
  •   delegate

    The object that acts as the delegate of the calendar view.

    property
  •   strings

    Sets the IGCalendarViewStringsDefinition that will control the default text values of particular elements of the IGCalendarView.

    property
  •   appointmentDataSources

    An array of objects that each provides differen’t calendar appointments to the IGCalendarView.

    property
  •   maxYear

    The maximum year the IGCalendarView should display. If the max year is hit, it will automatically loop around to the min year.

    property
  •   minYear

    The minimum year the IGCalendarView should display. If the min year is hit, it will automatically loop around to the max year.

    property
  •   displayBackButton

    Determines if the navigate back button on the titleBar is displayed.

    property
  •   displayTitleBar

    Determines if the title bar on the IGCalendarView displayed.

    property
  •   localeIdentifier

    Provies the locale used for the IGCalendarView.

    property
  •   rightTitleBarButton

    Provides access to the UIButton used for the title bar on the right side (readOnly)

    property
  •   currentDate

    Provides the currentDate of the IGCalendarView(readOnly)

    property
  •   calendarType

    Provides the current IGCalendarViewDisplayType (readOnly)

    property
  • – navigateToDate:forType:

    Navigates to the provided date in the specified view.

  • – navigateBack

    Navigates back to the next logical IGCalendarDisplayType

  • – invalidate

    Causes the IGCalendarView to completely invalidate itself and reload the theme and any appointments getting displayed.

Properties

appointmentDataSources

An array of objects that each provides differen’t calendar appointments to the IGCalendarView.

@property (nonatomic, retain) NSArray *appointmentDataSources

Discussion

Each dataSource in the array must implement the IGCalendarAppointmentDataSource protocol.

Declared In

IGCalendarView.h

calendarType

Provides the current IGCalendarViewDisplayType (readOnly)

@property (nonatomic, readonly) IGCalendarViewDisplayType calendarType

Discussion

To changed the displayType, use the navigateToDate:forType method.

Declared In

IGCalendarView.h

currentDate

Provides the currentDate of the IGCalendarView(readOnly)

@property (nonatomic, readonly) NSDate *currentDate

Discussion

IGCalendarDisplayTypeYear = 1/1/Year IGCalendarDisplayTypeMonth = Month/1/Year IGCalendarDisplayTypeDay = Month/Day/Year

To changed the date, use the navigateToDate:forType method.

Declared In

IGCalendarView.h

delegate

The object that acts as the delegate of the calendar view.

@property (nonatomic, weak) id<> delegate

Discussion

The delegate must adopt the IGCalendarViewDelegate protocol.

Declared In

IGCalendarView.h

displayBackButton

Determines if the navigate back button on the titleBar is displayed.

@property (nonatomic, assign) BOOL displayBackButton

Declared In

IGCalendarView.h

displayTitleBar

Determines if the title bar on the IGCalendarView displayed.

@property (nonatomic, assign) BOOL displayTitleBar

Declared In

IGCalendarView.h

localeIdentifier

Provies the locale used for the IGCalendarView.

@property (nonatomic, retain) NSString *localeIdentifier

Discussion

If not set the [NSCalendar current] is used.

Declared In

IGCalendarView.h

maxYear

The maximum year the IGCalendarView should display. If the max year is hit, it will automatically loop around to the min year.

@property (nonatomic, assign) int maxYear

Declared In

IGCalendarView.h

minYear

The minimum year the IGCalendarView should display. If the min year is hit, it will automatically loop around to the max year.

@property (nonatomic, assign) int minYear

Declared In

IGCalendarView.h

rightTitleBarButton

Provides access to the UIButton used for the title bar on the right side (readOnly)

@property (nonatomic, readonly) UIButton *rightTitleBarButton

Discussion

This is provided so that if you wanted to display a popup, you have a refrence/bounds of where to display the popup to.

Declared In

IGCalendarView.h

strings

Sets the IGCalendarViewStringsDefinition that will control the default text values of particular elements of the IGCalendarView.

@property (nonatomic, weak) id<> strings

Discussion

When setting this property, you should call the calendar’s invalidate method afterwards to ensure all elements are refreshed.

Declared In

IGCalendarView.h

theme

Sets the IGCalendarThemeDefinition that will control the styling of particular elements of the IGCalendarView.

@property (nonatomic, weak) id<> theme

Declared In

IGCalendarView.h

Instance Methods

invalidate

Causes the IGCalendarView to completely invalidate itself and reload the theme and any appointments getting displayed.

- (void)invalidate

Declared In

IGCalendarView.h

navigateBack

Navigates back to the next logical IGCalendarDisplayType

- (void)navigateBack

Discussion

If you’re on a Month it will go back to a Year If you’re on a Day it will go back to a Month If you’re on a Year it will do nothing.

Declared In

IGCalendarView.h

navigateToDate:forType:

Navigates to the provided date in the specified view.

- (void)navigateToDate:(NSDate *)date forType:(IGCalendarViewDisplayType)calendarType

Discussion

The navigation will animate if possible. If not, it will simply snap to that view.

For example if you go from YearView to MonthView, If the current month is in view of YearView it will animate to the month. However, if you went from a YearView to a DayView, it will just snap.

Declared In

IGCalendarView.h