CPViewController Class Reference

#import <CPViewController.h>

Inheritance diagram for CPViewController:

Instance Methods
(BOOL)	- automaticallyNotifiesObserversOfIsViewLoaded
(CPBundle)	- cibBundle
(CPDictionary)	- cibExternalNameTable
(CPString)	- cibName
(void)	- encodeWithCoder:
(id)	- init
(id)	- initWithCibName:bundle:
(id)	- initWithCibName:bundle:externalNameTable:
(id)	- initWithCibName:bundle:owner:
(id)	- initWithCoder:
(BOOL)	- isViewLoaded
(void)	- loadView
(id)	- representedObject
(void)	- setRepresentedObject:
(void)	- setTitle:
(void)	- setView:
(CPString)	- title
(CPView)	- view
(void)	- viewDidLoad
Instance Methods inherited from CPResponder
(BOOL)	- acceptsFirstResponder
(BOOL)	- becomeFirstResponder
(void)	- doCommandBySelector:
(void)	- flagsChanged:
(void)	- insertBackTab:
(void)	- insertLineBreak:
(void)	- insertNewline:
(void)	- insertTab:
(void)	- insertText:
(void)	- interpretKeyEvents:
(void)	- keyDown:
(void)	- keyUp:
(CPMenu)	- menu
(void)	- mouseDown:
(void)	- mouseDragged:
(void)	- mouseEntered:
(void)	- mouseExited:
(void)	- mouseMoved:
(void)	- mouseUp:
(CPResponder)	- nextResponder
(void)	- noResponderFor:
(BOOL)	- performKeyEquivalent:
(BOOL)	- resignFirstResponder
(void)	- rightMouseDown:
(void)	- rightMouseUp:
(void)	- scrollWheel:
(void)	- setMenu:
(void)	- setNextResponder:
(BOOL)	- tryToPerform:with:
(CPUndoManager)	- undoManager
Instance Methods inherited from CPObject
(void)	- addObserver:forKeyPath:options:context:
(void)	- applyChange:toKeyPath:
(id)	- autorelease
(id)	- awakeAfterUsingCoder:
(void)	- awakeFromCib
(void)	- bind:toObject:withKeyPath:options:
(Class)	- classForCoder
(Class)	- classForKeyedArchiver
(CPString)	- className
(id)	- copy
(void)	- dealloc
(CPString)	- description
(CPDictionary)	- dictionaryWithValuesForKeys:
(void)	- didChange:valuesAtIndexes:forKey:
(void)	- didChangeValueForKey:
(void)	- didChangeValueForKey:withSetMutation:usingObjects:
(void)	- doesNotRecognizeSelector:
(CPArray)	- exposedBindings
(id)	- forwardingTargetForSelector:
(void)	- forwardInvocation:
(unsigned)	- hash
(BOOL)	- implementsSelector:
(CPDictionary)	- infoForBinding:
(BOOL)	- isEqual:
(BOOL)	- isKindOfClass:
(BOOL)	- isMemberOfClass:
(BOOL)	- isProxy
(IMP)	- methodForSelector:
(CPMethodSignature)	- methodSignatureForSelector:
(id)	- mutableArrayValueForKey:
(id)	- mutableArrayValueForKeyPath:
(id)	- mutableCopy
(id)	- mutableSetValueForKey:
(id)	- mutableSetValueForKeyPath:
(id)	- performSelector:
(id)	- performSelector:withObject:
(id)	- performSelector:withObject:withObject:
(id)	- performSelector:withObjects:
(void)	- release
(void)	- removeObserver:forKeyPath:
(id)	- replacementObjectForArchiver:
(id)	- replacementObjectForCoder:
(id)	- replacementObjectForKeyedArchiver:
(BOOL)	- respondsToSelector:
(id)	- retain
(id)	- self
(void)	- setValue:forKey:
(void)	- setValue:forKeyPath:
(void)	- setValue:forUndefinedKey:
(void)	- setValuesForKeysWithDictionary:
(CPString)	- UID
(void)	- unbind:
(Class)	- valueClassForBinding:
(id)	- valueForKey:
(id)	- valueForKeyPath:
(id)	- valueForUndefinedKey:
(void)	- willChange:valuesAtIndexes:forKey:
(void)	- willChangeValueForKey:
(void)	- willChangeValueForKey:withSetMutation:usingObjects:

Class Methods
(void)	+ initialize
Class Methods inherited from CPObject
(BOOL)	+ accessInstanceVariablesDirectly
(id)	+ alloc
(id)	+ allocWithCoder:
(BOOL)	+ automaticallyNotifiesObserversForKey:
(Class)	+ class
(void)	+ exposeBinding:
(IMP)	+ instanceMethodForSelector:
(BOOL)	+ instancesRespondToSelector:
(BOOL)	+ isSubclassOfClass:
(CPSet)	+ keyPathsForValuesAffectingValueForKey:
(void)	+ load
(id)	+ new
(void)	+ setVersion:
(Class)	+ superclass
(int)	+ version

Additional Inherited Members
Instance Variables inherited from CPObject
Class	isa

Detailed Description

The CPViewController class provides the fundamental view-management controller for Cappuccino applications. The basic view controller class supports the presentation of an associated view in addition to basic support for managing modal views and, in the future, animations. Subclasses such as CPNavigationController and CPTabBarController provide additional behavior for managing complex hierarchies of view controllers and views.

You use each instance of CPViewController to manage a single view (and hierarchy). For a simple view controller, this entails managing the view hierarchy responsible for presenting your application content. A typical view hierarchy consists of a root view, a reference to which is available in the view property of this class, and one or more subviews presenting the actual content. In the case of navigation and tab bar controllers, the view controller manages not only the high-level view hierarchy (which provides the navigation controls) but also one or more additional view controllers that handle the presentation of the application content.

Unlike UIViewController in Cocoa Touch, a CPViewController does not represent an entire screen of content. You will add your root view to an existing view or window's content view. You can manage many view controllers on screen at once. CPViewController is also the preferred way of working with Cibs.

Subclasses can override -loadView to create their custom view hierarchy, or specify a cib name to be loaded automatically. It has methods that are called when a view appears or disappears. This class is also a good place for delegate & datasource methods, and other controller stuff.

Definition at line 2 of file CPViewController.h.

Method Documentation

- (BOOL) automaticallyNotifiesObserversOfIsViewLoaded

implementation

Definition at line 261 of file CPViewController.j.

- (CPBundle) cibBundle

implementation

Synthesized accessor method.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 386 of file CPViewController.j.

- (CPDictionary) cibExternalNameTable

implementation

Synthesized accessor method.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 394 of file CPViewController.j.

- (CPString) cibName

implementation

Synthesized accessor method.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 378 of file CPViewController.j.

- (void) encodeWithCoder: (CPCoder)  aCoder

implementation

Archives the view controller to the provided coder.

Parameters

aCoder

the coder to which the view controller should be archived

Reimplemented from CPResponder.

Provided by category CPViewController(CPCoding).

Definition at line 305 of file CPViewController.j.

- (id) init

implementation

Convenience initializer calls -initWithCibName:bundle: with nil for both parameters.

Reimplemented from CPObject.

Definition at line 87 of file CPViewController.j.

+ (void) initialize

implementation

Reimplemented from CPObject.

Definition at line 76 of file CPViewController.j.

- (id) initWithCibName: (CPString)  aCibNameOrNil bundle: (CPBundle)  aCibBundleOrNil

implementation

Definition at line 92 of file CPViewController.j.

- (id) initWithCibName: (CPString)  aCibNameOrNil bundle: (CPBundle)  aCibBundleOrNil externalNameTable: (CPDictionary)  anExternalNameTable

implementation

The designated initializer. If you subclass CPViewController, you must call the super implementation of this method, even if you aren't using a Cib.

In the specified Cib, the File's Owner proxy should have its class set to your view controller subclass, with the view outlet connected to the main view. If you pass in a nil Cib name, then you must either call -setView: before -view is invoked, or override -loadView to set up your views.

Parameters

cibNameOrNil	The path to the cib to load for the root view or nil to programmatically create views.
cibBundleOrNil	The bundle that the cib is located in or nil for the main bundle.

Definition at line 115 of file CPViewController.j.

- (id) initWithCibName: (CPString)  aCibNameOrNil bundle: (CPBundle)  aCibBundleOrNil owner: (id)  anOwner

implementation

Definition at line 97 of file CPViewController.j.

- (id) initWithCoder: (CPCoder)  aCoder

implementation

Initializes the view controller by unarchiving data from a coder.

Parameters

aCoder

the coder from which the data will be unarchived

Returns

the initialized view controller

Reimplemented from CPResponder.

Provided by category CPViewController(CPCoding).

Definition at line 281 of file CPViewController.j.

- (BOOL) isViewLoaded

implementation

Synthesized accessor method.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 338 of file CPViewController.j.

- (void) loadView

implementation

Programmatically creates the view that the controller manages. You should never call this method directly. The view controller calls this method when the view property is requested but is nil.

If you create your views manually, you must override this method and use it to create your view and assign it to the view property. The default implementation for programmatic views is to create a plain, zero width & height view. You can invoke super to utilize this view.

If you use Interface Builder to create your views, and you initialize the controller using the initWithCibName:bundle: methods, then you MUST NOT override this method. The consequences risk shattering the space-time continuum.

Note: The cib loading system is currently synchronous.

Definition at line 149 of file CPViewController.j.

- (id) representedObject

implementation

Synthesized accessor method.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 346 of file CPViewController.j.

- (void) setRepresentedObject: (id)  aValue

implementation

Synthesized accessor method.

Reimplemented in CPCollectionViewItem.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 354 of file CPViewController.j.

- (void) setTitle: (CPString)  aValue

implementation

Synthesized accessor method.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 370 of file CPViewController.j.

- (void) setView: (CPView)  aView

implementation

Manually sets the view that the controller manages.

Setting to nil will cause -loadView to be called on all subsequent calls of -view.

Parameters

aView

The view this controller should represent.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 247 of file CPViewController.j.

- (CPString) title

implementation

Synthesized accessor method.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 362 of file CPViewController.j.

- (CPView) view

implementation

Returns the view that the controller manages.

If this property is nil, the controller sends loadView to itself to create the view that it manages. Subclasses should override the loadView method to create any custom views. The default value is nil.

Provided by category CPViewController(CPSynthesizedAccessors).

Definition at line 179 of file CPViewController.j.

- (void) viewDidLoad

implementation

This method is called after the view controller has loaded its associated views into memory.

This method is called regardless of whether the views were stored in a nib file or created programmatically in the loadView method, but NOT when setView is invoked. This method is most commonly used to perform additional initialization steps on views that are loaded from cib files.

Definition at line 233 of file CPViewController.j.

---

The documentation for this class was generated from the following files:

• AppKit/CPViewController.h
• AppKit/CPViewController.j