API 0.9.5
CPViewController Class Reference

#import <CPViewController.h>

Inheritance diagram for CPViewController:

List of all members.

Instance Methods

(CPBundle- cibBundle
(CPDictionary- cibExternalNameTable
(CPString- cibName
(void) - encodeWithCoder:
(id) - init
(id) - initWithCibName:bundle:
(id) - initWithCibName:bundle:externalNameTable:
(id) - initWithCibName:bundle:owner:
(id) - initWithCoder:
(void) - loadView
(id) - representedObject
(void) - setRepresentedObject:
(void) - setTitle:
(void) - setView:
(CPString- title
(CPView- view
(void) - viewDidLoad

Class Methods

(void) + initialize

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

- (CPBundle) cibBundle

Synthesized accessor method.

Definition at line 347 of file CPViewController.j.

- (CPDictionary) cibExternalNameTable

Synthesized accessor method.

Definition at line 355 of file CPViewController.j.

- (CPString) cibName

Synthesized accessor method.

Definition at line 339 of file CPViewController.j.

- (void) encodeWithCoder: (CPCoder aCoder

Archives the view controller to the provided coder.

Parameters:
aCoderthe coder to which the view controller should be archived

Reimplemented from CPResponder.

Definition at line 274 of file CPViewController.j.

- (id) init

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

Definition at line 83 of file CPViewController.j.

+ (void) initialize

Definition at line 74 of file CPViewController.j.

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

Definition at line 88 of file CPViewController.j.

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

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:
cibNameOrNilThe path to the cib to load for the root view or nil to programmatically create views.
cibBundleOrNilThe bundle that the cib is located in or nil for the main bundle.

Definition at line 111 of file CPViewController.j.

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

Definition at line 93 of file CPViewController.j.

- (id) initWithCoder: (CPCoder aCoder

Initializes the view controller by unarchiving data from a coder.

Parameters:
aCoderthe coder from which the data will be unarchived
Returns:
the initialized view controller

Reimplemented from CPResponder.

Definition at line 251 of file CPViewController.j.

- (void) loadView

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 view. You can invoke super to utilize this view.

If you use Interface Builder to create your views, you initialize the view using the initWithCibName:bundle: method 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 144 of file CPViewController.j.

- (id) representedObject

Synthesized accessor method.

Definition at line 307 of file CPViewController.j.

- (void) setRepresentedObject: (id)  aValue

Synthesized accessor method.

Reimplemented in CPCollectionViewItem.

Definition at line 315 of file CPViewController.j.

- (void) setTitle: (CPString aValue

Synthesized accessor method.

Definition at line 331 of file CPViewController.j.

- (void) setView: (CPView aValue

Manually sets the view that the controller manages.

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

Parameters:
aViewThe view this controller should represent.

Synthesized accessor method.

Definition at line 225 of file CPViewController.j.

- (CPString) title

Synthesized accessor method.

Definition at line 323 of file CPViewController.j.

- (CPView) view

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.

Synthesized accessor method.

Definition at line 169 of file CPViewController.j.

- (void) viewDidLoad

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. This method is most commonly used to perform additional initialization steps on views that are loaded from cib files.

Definition at line 211 of file CPViewController.j.


The documentation for this class was generated from the following files:
 All Classes Files Functions Variables Defines