CPDocument Class Reference

#import <CPDocument.h>

Inheritance diagram for CPDocument:

Instance Methods
(void)	- addViewController:forWindowController:
(void)	- addWindowController:
(void)	- alertDidEnd:returnCode:
(void)	- canCloseDocumentWithDelegate:shouldCloseSelector:contextInfo:
(void)	- close
(void)	- connection:didFailWithError:
(void)	- connection:didReceiveData:
(void)	- connection:didReceiveResponse:
(void)	- connectionDidFinishLoading:
(CPData)	- dataOfType:error:
(CPString)	- displayName
(CPString)	- fileType
(CPURL)	- fileURL
(CPWindowController)	- firstEligibleExistingWindowController
(BOOL)	- hasUndoManager
(id)	- init
(id)	- initForURL:withContentsOfURL:ofType:delegate:didReadSelector:contextInfo:
(id)	- initWithContentsOfURL:ofType:delegate:didReadSelector:contextInfo:
(id)	- initWithType:error:
(BOOL)	- isDocumentEdited
(void)	- makeViewAndWindowControllers
(void)	- makeWindowControllers
(void)	- readFromData:ofType:error:
(void)	- readFromURL:ofType:delegate:didReadSelector:contextInfo:
(void)	- removeViewController:
(void)	- removeWindowController:
(void)	- saveDocument:
(void)	- saveDocumentAs:
(void)	- saveDocumentWithDelegate:didSaveSelector:contextInfo:
(void)	- saveToURL:ofType:forSaveOperation:delegate:didSaveSelector:contextInfo:
(void)	- setFileType:
(void)	- setFileURL:
(void)	- setHasUndoManager:
(void)	- setUndoManager:
(void)	- shouldCloseWindowController:delegate:shouldCloseSelector:contextInfo:
(void)	- showWindows
(CPUndoManager)	- undoManager
(void)	- updateChangeCount:
(CPView)	- view
(CPString)	- viewCibName
(void)	- viewControllerDidLoadCib:
(CPViewController)	- viewControllerForWindowController:
(CPArray)	- viewControllers
(void)	- viewControllerWillLoadCib:
(CPString)	- windowCibName
(void)	- windowControllerDidLoadCib:
(CPArray)	- windowControllers
(void)	- windowControllerWillLoadCib:
(CPUndoManager)	- windowWillReturnUndoManager:
Instance Methods inherited from CPResponder
(BOOL)	- acceptsFirstResponder
(BOOL)	- becomeFirstResponder
(void)	- doCommandBySelector:
(void)	- encodeWithCoder:
(void)	- flagsChanged:
(id)	- initWithCoder:
(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:
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:

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

Detailed Description

CPDocument is used to represent a document/file in a Cappuccino application. In a document-based application, generally multiple documents are open simultaneously (multiple text documents, slide presentations, spreadsheets, etc.), and multiple CPDocuments should be used to represent this.

Definition at line 2 of file CPDocument.h.

Method Documentation

- (void) addViewController: (CPViewController)  aViewController forWindowController: (CPWindowController)  aWindowController

implementation

Definition at line 342 of file CPDocument.j.

- (void) addWindowController: (CPWindowController)  aWindowController

implementation

Add a controller to the document's list of controllers. This should be called after making a new window controller.

Parameters

aWindowController

the controller to add

Definition at line 310 of file CPDocument.j.

- (void) alertDidEnd: (CPAlert)  alert returnCode: (int)  returnCode

implementation

Provided by category CPDocument(ClosingDocuments).

Definition at line 896 of file CPDocument.j.

- (void) canCloseDocumentWithDelegate: (id)  aDelegate shouldCloseSelector: (SEL)  aSelector contextInfo: (Object)  context

implementation

Provided by category CPDocument(ClosingDocuments).

Definition at line 875 of file CPDocument.j.

- (void) close

implementation

Provided by category CPDocument(ClosingDocuments).

Definition at line 852 of file CPDocument.j.

- (void) connection: (CPURLConnection)  aConnection didFailWithError: (CPError)  anError

implementation

Definition at line 584 of file CPDocument.j.

- (void) connection: (CPURLConnection)  aConnection didReceiveData: (CPString)  aData

implementation

Definition at line 557 of file CPDocument.j.

- (void) connection: (CPURLConnection)  aConnection didReceiveResponse: (CPURLResponse)  aResponse

implementation

Definition at line 501 of file CPDocument.j.

- (void) connectionDidFinishLoading: (CPURLConnection)  aConnection

implementation

Definition at line 612 of file CPDocument.j.

- (CPData) dataOfType: (CPString)  aType error: ({CPError})  anError

implementation

Returns the receiver's data in a specified type. The default implementation just throws an exception.

Parameters

aType	the format of the data
anError	not used

Exceptions

CPUnsupportedMethodException

if this method hasn't been overridden by the subclass

Returns

the document data

Definition at line 207 of file CPDocument.j.

- (CPString) displayName

implementation

Returns the name of the document as displayed in the title bar.

Definition at line 374 of file CPDocument.j.

- (CPString) fileType

implementation

Returns the document's file type

Definition at line 659 of file CPDocument.j.

- (CPURL) fileURL

implementation

Returns the path to the document's file.

Definition at line 439 of file CPDocument.j.

- (CPWindowController) firstEligibleExistingWindowController

implementation

Definition at line 236 of file CPDocument.j.

- (BOOL) hasUndoManager

implementation

Returns YES if the document has a CPUndoManager.

Definition at line 669 of file CPDocument.j.

- (id) init

implementation

Initializes an empty document.

Returns

the initialized document

Reimplemented from CPObject.

Definition at line 114 of file CPDocument.j.

- (id) initForURL: (CPURL)  anAbsoluteURL withContentsOfURL: (CPURL)  absoluteContentsURL ofType: (CPString)  aType delegate: (id)  aDelegate didReadSelector: (SEL)  aDidReadSelector contextInfo: (id)  aContextInfo

implementation

Initializes the document from a URL.

Parameters

anAbsoluteURL	the document location
absoluteContentsURL	the location of the document's contents
aType	the type of the contents
aDelegate	this object will receive a callback after the document's contents are loaded
aDidReadSelector	the message selector that will be sent to aDelegate
aContextInfo	passed as the argument to the message sent to the aDelegate

Returns

the initialized document

Definition at line 184 of file CPDocument.j.

- (id) initWithContentsOfURL: (CPURL)  anAbsoluteURL ofType: (CPString)  aType delegate: (id)  aDelegate didReadSelector: (SEL)  aDidReadSelector contextInfo: (id)  aContextInfo

implementation

Initializes a document of a specific type located at a URL. Notifies the provided delegate after initialization.

Parameters

anAbsoluteURL	the url of the document content
aType	the type of document located at the URL
aDelegate	the delegate to notify
aDidReadSelector	the selector used to notify the delegate
aContextInfo	context information passed to the delegate after initialization

Returns

the initialized document

Definition at line 159 of file CPDocument.j.

- (id) initWithType: (CPString)  aType error: ({CPError})  anError

implementation

Initializes the document with a specific data type.

Parameters

aType	the type of document to initialize
anError	not used

Returns

the initialized document

Definition at line 138 of file CPDocument.j.

- (BOOL) isDocumentEdited

implementation

Returns YES if there are any unsaved changes.

Definition at line 622 of file CPDocument.j.

- (void) makeViewAndWindowControllers

implementation

Definition at line 250 of file CPDocument.j.

- (void) makeWindowControllers

implementation

Creates the window controller for this document.

Definition at line 245 of file CPDocument.j.

- (void) readFromData: (CPData)  aData ofType: (CPString)  aType error: (CPError)  anError

implementation

Sets the content of the document by reading the provided data. The default implementation just throws an exception.

Parameters

aData	the document's data
aType	the document type
anError	not used

Exceptions

CPUnsupportedMethodException

if this method hasn't been overridden by the subclass

Definition at line 222 of file CPDocument.j.

- (void) readFromURL: (CPURL)  anAbsoluteURL ofType: (CPString)  aType delegate: (id)  aDelegate didReadSelector: (SEL)  aDidReadSelector contextInfo: (id)  aContextInfo

implementation

Set the document's data from a URL. Notifies the provided delegate afterwards.

Parameters

anAbsoluteURL	the URL to the document's content
aType	the document type
aDelegate	delegate to notify after reading the data
aDidReadSelector	message that will be sent to the delegate
aContextInfo	context information that gets sent to the delegate

Definition at line 426 of file CPDocument.j.

- (void) removeViewController: (CPViewController)  aViewController

implementation

Definition at line 351 of file CPDocument.j.

- (void) removeWindowController: (CPWindowController)  aWindowController

implementation

Remove a controller to the document's list of controllers. This should be called after closing the controller's window.

Parameters

aWindowController

the controller to remove

Definition at line 323 of file CPDocument.j.

- (void) saveDocument: (id)  aSender

implementation

Saves the document. If the document does not have a file path to save to (fileURL) then -saveDocumentAs: will be called.

Parameters

aSender

the object requesting the save

Definition at line 788 of file CPDocument.j.

- (void) saveDocumentAs: (id)  aSender

implementation

Saves the document to a user specified path.

Parameters

aSender

the object requesting the operation

Definition at line 811 of file CPDocument.j.

- (void) saveDocumentWithDelegate: (id)  delegate didSaveSelector: (SEL)  didSaveSelector contextInfo: (Object)  contextInfo

implementation

Definition at line 793 of file CPDocument.j.

- (void) saveToURL: (CPURL)  anAbsoluteURL ofType: (CPString)  aTypeName forSaveOperation: (CPSaveOperationType)  aSaveOperation delegate: (id)  aDelegate didSaveSelector: (SEL)  aDidSaveSelector contextInfo: (id)  aContextInfo

implementation

Saves the document to the specified URL. Notifies the provided delegate with the provided selector and context info afterwards.

Parameters

anAbsoluteURL	the url to write the document data to
aTypeName	the document type
aSaveOperation	the type of save operation
aDelegate	the delegate to notify after saving
aDidSaveSelector	the selector to send the delegate
aContextInfo	context info that gets passed to the delegate

Definition at line 468 of file CPDocument.j.

- (void) setFileType: (CPString)  aType

implementation

Sets the document's file type

Parameters

aType

the document's type

Definition at line 651 of file CPDocument.j.

- (void) setFileURL: (CPURL)  aFileURL

implementation

Sets the path to the document's file.

Parameters

aFileURL

the path to the document's file

Definition at line 448 of file CPDocument.j.

- (void) setHasUndoManager: (BOOL)  aFlag

implementation

Sets whether the document should have a CPUndoManager.

Parameters

aFlag

YES makes the document have an undo manager

Definition at line 678 of file CPDocument.j.

- (void) setUndoManager: (CPUndoManager)  anUndoManager

implementation

Definition at line 717 of file CPDocument.j.

- (void) shouldCloseWindowController: (CPWindowController)  controller delegate: (id)  delegate shouldCloseSelector: (SEL)  selector contextInfo: (Object)  info

implementation

Provided by category CPDocument(ClosingDocuments).

Definition at line 858 of file CPDocument.j.

- (void) showWindows

implementation

Shows all the document's windows.

Definition at line 365 of file CPDocument.j.

- (CPUndoManager) undoManager

implementation

Returns the document's undo manager. If the document should have one, but the manager is nil, it will be created and then returned.

Returns

the document's undo manager

Reimplemented from CPResponder.

Definition at line 764 of file CPDocument.j.

- (void) updateChangeCount: (CPDocumentChangeType)  aChangeType

implementation

Updates the number of unsaved changes to the document.

Parameters

aChangeType

a new document change to apply

Definition at line 631 of file CPDocument.j.

- (CPView) view

implementation

Definition at line 332 of file CPDocument.j.

- (CPString) viewCibName

implementation

Definition at line 388 of file CPDocument.j.

- (void) viewControllerDidLoadCib: (CPViewController)  aViewController

implementation

Definition at line 232 of file CPDocument.j.

- (CPViewController) viewControllerForWindowController: (CPWindowController)  aWindowController

implementation

Definition at line 356 of file CPDocument.j.

- (CPArray) viewControllers

implementation

Definition at line 337 of file CPDocument.j.

- (void) viewControllerWillLoadCib: (CPViewController)  aViewController

implementation

Definition at line 228 of file CPDocument.j.

- (CPString) windowCibName

implementation

Returns the document's Cib name

Definition at line 396 of file CPDocument.j.

- (void) windowControllerDidLoadCib: (CPWindowController)  aWindowController

implementation

Called after aWindowController loads the document's Nib file.

Parameters

aWindowController

the controller that loaded the Nib file

Definition at line 405 of file CPDocument.j.

- (CPArray) windowControllers

implementation

Returns the document's window controllers

Definition at line 300 of file CPDocument.j.

- (void) windowControllerWillLoadCib: (CPWindowController)  aWindowController

implementation

Called before aWindowController will load the document's Nib file.

Parameters

aWindowController

the controller that will load the Nib file

Definition at line 413 of file CPDocument.j.

- (CPUndoManager) windowWillReturnUndoManager: (CPWindow)  aWindow

implementation

Definition at line 776 of file CPDocument.j.

---

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

• AppKit/CPDocument.h
• AppKit/CPDocument.j