MiscCalendarView.rtf

This is MiscCalendarView.rtf in view mode; [Download] [Up]

MiscCalendarView

Inherits From: View : Object
Adopted Protocols: TextDelegate, Drag and Drop
Declared In: MiscKit/MiscCalendarView.h

Class Description

MiscCalendarView is a general calendar that supports the selection of days, months, and years. MiscCalendarView supports customizable header styles, colors, text delegation, and date delegation.

The palette view works fully under InterfaceBuilder. Its fully functional in test mode, and conforms to standard InterfaceBuilder usage. It also accepts drag-and-drop of color, just like textfield objects. Color can be dragged onto any of the displayed headers (month, year, inline month and year, or any of the day-of-the-week headers), and the text will change to that color. The day cells accept color as well. In the inspector panel you select which attribute you want to affect (cell background color, cell text color, cell background color when highlighted, cell text color when highlighted), and drag a color swatch onto any part of the matrix. You can also affect the color with the color well.

MiscCalendarView can use a custom date object for custom date behaviour. The date delegate can be set via IB, or programatically. MiscCalendarView uses a simple date object that works between the years of 1970 and 2037. Any custom date object must conform to the DateDelegate protocol, specified in the Protocols section.

MiscCalendarView can be set up as a text delegate. In turn, MiscCalendarView can be connected up to another object for text delegation. MiscCalendarView will pass through the text delegate messages, and on the textDidEnd:endChar: method, will update it's date.

MiscCalendarView can also be set up to accept drag-and-drop color when running in an application, so users can customize their colors if they wish.

External objects that respond to setStringValue: (such as textfields) can be attached to a MiscCalendarView. MiscCalendarView can display the month, year, and the full date in external objects. These connections can be made via IB, or programatically.

Library Dependencies
The MiscCalendarView depends on the MiscClockView library and palette.

<<More could be said here, but I'm not sure what... "Dammit Jim, I'm a programmer, not a technical writer!">>

Instance Variables

id monthField;
id yearField;
id dateField;
id dateDelegate;
id textDelegate;

monthField An external object that responds to setStringValue: for displaying the month.

yearField An external object that responds to setStringValue: for displaying the year.

dateField An external object that responds to setStringValue: for displaying the date.

dateDelegate An object that conforms to the DateDelegate protocol and provide date information.

textDelegate An object that can provide text delegation to any text fields connected to the calendar via text delegation.

Method Types

Creating and freeing instances ��initFrame:

Calendar properties - setHighlightMode:
- highlightMode
- forHeader:display:
- isHeaderDisplayed:
- cellAt::lock:
- forRow:lock:
- forColumn:lock:
- calendarMatrix

Working with color - preserveCellColors:
- cellColorsPreserved
- setColorOf:to:forCellAt::
- colorOf:forCellAt::
- setColorOf:to:
- colorOf:
- setColorTo:forDay:
- colorForDay:
- allowColorDragAndDrop:
- canDragAndDropColor

Working with dates - setDateDelegate:
- dateDelegate
- displayDate:
- updateDate:
- incrementMonth:
- decrementMonth:
- incrementYear:
- decrementYear:

Instance Methods

allowColorDragAndDrop:
� allowColorDragAndDrop:(BOOL)yn

Enables or disables the ability to drag and drop color into headers to set their color. Returns self.