---

NSTextAttachment

Overview

NSTextAttachment objects are used by the NSAttributedString class as the values for attachment attributes (stored in the attributed string under the key named AttachmentAttributeName). The objects you create with this class are referred to as text attachment objects, or when no confusion will result, as text attachments or merely attachments. See the NSAttributedString and NSTextView class specifications for general information on text attachments.

A text attachment object contains an NSFileWrapper, which in turn holds the contents of the attached file. It also uses a cell object conforming to the NSCellForTextAttachment interface to draw and handle mouse events. Most of the behavior of a text attachment is relegated to the file wrapper and the attachment cell. See the corresponding class and interface specifications for more information.

Tasks

Constructors

• NSTextAttachment

Setting the File Wrapper

• setFileWrapper
• fileWrapper

Setting the Attachment Cell

• setAttachmentCell
• attachmentCell

Instance Methods

attachmentCell

Returns the object used to draw the icon for the receiver and to handle mouse events.

public NSCellForTextAttachment attachmentCell()

Discussion

An NSTextAttachment by default uses an NSTextAttachmentCell that displays the attached file’s icon, or its contents if the file contains an image.

See Also

• fileWrapper
• image (NSCell)
• icon (NSFileWrapper)
• setAttachmentCell

fileWrapper

Returns the receiver’s file wrapper, which holds the contents of the attached file.

public NSFileWrapper fileWrapper()

See Also

• setFileWrapper

setAttachmentCell

Sets the object used to draw the icon for the receiver and to handle mouse events to aCell.

public void setAttachmentCell(NSCellForTextAttachment aCell)

See Also

• setFileWrapper
• setImage (NSCell)
• icon (NSFileWrapper)
• attachmentCell

setFileWrapper

Sets the receiver’s file wrapper, which holds the contents of the attached file, to aWrapper.

public void setFileWrapper(NSFileWrapper aWrapper)

See Also

• fileWrapper

Constants

The following constant is provided by NSTextAttachment:

---