Copyright ã1994 by NeXT Computer, Inc.  All Rights Reserved.

NSDataLinkPanel

Inherits From:	NSPanel : NSWindow : NSResponder : NSObject

Conforms To:	NSCoding (NSResponder)
NSObject (NSObject)

Declared In:	AppKit/NSDataLinkPanel.h

Class Description

An NSDataLinkPanel is an NSPanel that allows the user to inspect data links. The NSDataLinkPanel functions primarily by sending messages to the current data link manager (representing the current document) and to the current link (representing the current selection if it's based on a data link). Thus, the panel should be informed, by a setLink:manager:isMultiple: message, any time the selection changes or a document is created or activated. Since the selection may need to be tracked even before the panel is created, this message can be sent to either the NSDataLinkPanel class or the shared instance.

The NSDataLinkPanel is generally displayed using NSApplication's orderFrontDataLinkPanel: method. An application's sole instance of NSDataLinkPanel can be accessed with the sharedDataLinkPanel method. 

Initializing

+ (NSDataLinkPanel *)sharedDataLinkPanel	Initializes and returns the shared NSDataLinkPanel object.

Keeping the Panel Up to Date

+ (void)getLink:(NSDataLink **)link	Gets information about the NSDataLinkPanel's currently
manager:(NSDataLinkManager **)linkManager		selected link; returns the link in link, the link manager
isMultiple:(BOOL *)flag		in linkManager, and the multiple selection status in flag.

+ (void)setLink:(NSDataLink *)link	Informs the receiver of the current document and selection
manager:(NSDataLinkManager *)linkManager		using link as the currently selected link and
isMultiple:(BOOL)flag		linkManager as the current link manager. flag is YES if the panel will indicate that more than one link is selected. Returns self.	

- (void)getLink:(NSDataLink **)link	Gets information about the NSDataLinkPanel's currently
manager:(NSDataLinkManager **)linkManager		selected link; returns the link in link, the link manager
isMultiple:(BOOL *)flag		in linkManager, and the multiple selection status in flag.

- (void)setLink:(NSDataLink *)link	Informs the receiver of the current document and selection
manager:(NSDataLinkManager *)linkManager		using link as the currently selected link and
isMultiple:(BOOL)flag		linkManager as the current link manager. flag is YES if the panel will indicate that more than one link is selected. Returns self.	

Customizing the Panel

- (NSView *)accessoryView	Returns the NSDataLinkPanel's custom accessory view.

- (void)setAccessoryView:(NSView *)aView	Adds aView to the NSDataLinkPanel's view hierarchy.

Responding to User Input

- (void)pickedBreakAllLinks:(id)sender	Invoked when the user clicks the Break All Links button; puts up an attention panel to confirm the user's action, and then sends a breakAllLinks message to the current link manager.

- (void)pickedBreakLink:(id)sender	Invoked when the user clicks the Break Link button; puts up an attention panel to confirm the user's action, and then sends a break message to the current link.

- (void)pickedOpenSource:(id)sender	Invoked when the user clicks the Open Source button; sends an openSource message to the current link.

- (void)pickedUpdateDestination:(id)sender	Invoked when the user clicks Update from Source button; sends a message to the current link to verify and update the data source and then update the destination data. Returns self.

- (void)pickedUpdateMode:(id)sender	Invoked when the user selects the update mode; sends a setUpdateMode: message to the current link.