Adds a destination link at the specified
selection. Registers a new data
link as a destination within this manager.
The link will be positioned at the given
selection and the manager will monitor it
for updates. Triggers startTrackingLink delegate
callback.
Adds a link as a marker at the specified
selection. Adds a data link
that serves only as a position marker. Marker links
don't transfer data but can be useful for UI
purposes.
Recreates a link that was previously at another
location. Used when moving or copying links
between documents. Attempts to restore a link from
pasteboard data.
Adds a source link to this manager.
Registers a new data link as a source
within this manager. The manager will monitor the
source for changes and can provide data to
destination links. Triggers startTrackingLink
delegate callback.
Returns whether link outlines are currently
visible. Link outlines provide visual feedback
about data link locations. Returns YES
if outlines are drawn, NO if they are
hidden.
Breaks all links managed by this manager.
Permanently breaks all source and destination
links. Each link will be broken individually and
delegate callbacks will be triggered for each one.
Manually checks all destination links for needed
updates. Iterates through all destination links
and consults the delegate via isUpdateNeededForLink to
determine which links need updating. Performs
updates for links that need them.
Returns whether the delegate verifies links before
processing. When YES, the delegate
will be asked to verify each link operation. This
provides additional control over link management.
Returns an enumerator for all destination links in
this document. Destination links are data links that
receive updates from source links. Use this to
iterate through all incoming data connections.
Returns the destination link that contains the
specified selection. Searches through destination
links to find one matching the selection. Returns
nil if no destination link matches the
selection.
Returns the filename of the document managed by
this instance. This is the file path used for link
resolution and document identification. Returns
nil if no filename is set.
Initializes a link manager with a delegate.
Creates a new NSDataLinkManager with the specified
delegate. The delegate will receive callbacks for
link management events.
Initializes a link manager with a delegate and
associates it with a file. Creates a new
NSDataLinkManager with the specified
delegate and associates it with a particular file.
This is typically used when the manager represents
links within a specific document.
Returns whether the manager interacts with users
during operations. When YES, the
manager may display dialogs or request user input.
When NO, operations proceed automatically
without user interaction.
Returns whether the managed document has been
edited. This flag tracks modification state for
proper link updating. Used to determine when links
need timestamp updates.
Notifies the manager that its document is closing.
Call this when the document associated with this
manager is being closed. Triggers the
dataLinkManagerCloseDocument
delegate callback.
Notifies the manager that its document has been
edited. Call this when the document has been
modified. Triggers the
dataLinkManagerDidEditLinks
delegate callback.
Notifies the manager that its document has been
reverted. Call this when the document has been
reverted to a saved state. Triggers the
dataLinkManagerDidEditLinks
delegate callback.
Notifies the manager that its document has been
saved. Updates timestamps for all source links and
triggers update checking for destination links.
This ensures links stay synchronized with saved
document state.
Notifies the manager that its document has been
saved with a new name. Updates the internal filename
reference and performs standard save processing.
This maintains link integrity when documents are
renamed.
Notifies the manager that its document has been
saved to a different location. Updates source link
filenames when applicable for "Save As"
operations. This ensures links continue to
reference the correct files.
Manually triggers redrawing of link outlines.
Calls the dataLinkManagerRedrawLinkOutlines delegate
method to request that visual link indicators be
refreshed.
Removes a specific link from this
manager. Removes the specified link
from both source and destination collections. Triggers
stopTrackingLink delegate callback for
proper cleanup.
Sets whether the delegate verifies links before
processing. Pass YES to enable
delegate verification of link operations. Pass
NO to allow automatic processing
without delegate verification.
Sets whether the manager interacts with users during
operations. Pass YES to enable
user interaction dialogs and prompts. Pass
NO to operate silently without user
interruption.
Sets whether link outlines are visible in the
document. Pass YES to show visual
outlines around data links. Pass NO
to hide link outlines for cleaner display.
Returns an enumerator for all source links in this
document. Source links are data links that
provide data to other documents. Use this to
iterate through all outgoing data connections.
Returns whether links are tracked individually.
Queries the delegate via
dataLinkManagerTracksLinksIndividually
to determine the current tracking mode.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Warning the underscore at the start of the
name of this instance variable indicates that, even
though it is not technically private, it is
intended for internal use within the package, and
you should not use the variable in other code.
Called to copy data to the pasteboard.
The delegate should copy the data at the specified
selection to the pasteboard.
Used during link operations and copy/paste.
Called to determine if a link needs
updating. The delegate should return
YES if the link's destination should be
updated with current source data. This is called
during file monitoring and manual update checks.
Called when the manager starts tracking a new
link. Notifies the delegate that a new
link has been added and the manager is now
monitoring it for changes.
Called when the manager stops tracking a
link. Notifies the delegate that a
link has been removed and is no longer
being monitored. Use this for cleanup operations.
Called when the document associated with the manager
is closing. Gives the delegate a chance to perform
cleanup operations before the document is closed.
Called to determine the link tracking mode. The
delegate should return YES if links
should be tracked individually, or NO
for batch tracking operations.
Called to import a file at the specified
selection. The delegate should import the
contents of the specified file into the document
at the given selection location.
Called to paste data from the pasteboard.
The delegate should paste the data from the
pasteboard into the document at the
specified selection location.