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.

• + (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.

• - (NSView *)accessoryView Returns the NSDataLinkPanel's custom accessory view.
• - (void)setAccessoryView:(NSView *)aView Adds aView to the NSDataLinkPanel's view hierarchy.

• - (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.