---
title: NSImageView
framework: appkit
role: symbol
role_heading: Class
path: appkit/nsimageview
---

# NSImageView

A display of image data in a frame.

## Declaration

```swift
class NSImageView
```

## Overview

Overview Image views can be static or editable. A static image view only displays the image that you specify. An editable image view object lets the user change the displayed image. You can also configure an image view to allow copying, pasting, deleting, and dragging of the image. note: An image view calls its action method only when the user drags an image into the image view’s bounds, and the image view must be editable to receive dragged images. If you want to display an image and respond to clicks in the image, use an NSButton object instead.

## Topics

### Creating the view

- [init(image:)](appkit/nsimageview/init(image:).md)

### Configuring the cell

- [NSImageCell](appkit/nsimagecell.md)

### Specifying the image

- [symbolConfiguration](appkit/nsimageview/symbolconfiguration.md)
- [image](appkit/nsimageview/image.md)

### Specifying the visual characteristics

- [imageFrameStyle](appkit/nsimageview/imageframestyle.md)
- [imageAlignment](appkit/nsimageview/imagealignment.md)
- [imageScaling](appkit/nsimageview/imagescaling.md)
- [animates](appkit/nsimageview/animates.md)
- [contentTintColor](appkit/nsimageview/contenttintcolor.md)

### Specifying the dynamic range

- [imageDynamicRange](appkit/nsimageview/imagedynamicrange.md)
- [preferredImageDynamicRange](appkit/nsimageview/preferredimagedynamicrange.md)
- [defaultPreferredImageDynamicRange](appkit/nsimageview/defaultpreferredimagedynamicrange.md)

### Responding to user events

- [isEditable](appkit/nsimageview/iseditable.md)
- [allowsCutCopyPaste](appkit/nsimageview/allowscutcopypaste.md)

### Configuring symbol effects

- [addSymbolEffect(_:options:animated:)](appkit/nsimageview/addsymboleffect(_:options:animated:)-4kete.md)
- [addSymbolEffect(_:options:animated:)](appkit/nsimageview/addsymboleffect(_:options:animated:)-4p7p7.md)
- [addSymbolEffect(_:options:animated:)](appkit/nsimageview/addsymboleffect(_:options:animated:)-66ckm.md)
- [setSymbolImage(_:contentTransition:options:)](appkit/nsimageview/setsymbolimage(_:contenttransition:options:).md)
- [removeSymbolEffect(ofType:options:animated:)](appkit/nsimageview/removesymboleffect(oftype:options:animated:)-8bszd.md)
- [removeSymbolEffect(ofType:options:animated:)](appkit/nsimageview/removesymboleffect(oftype:options:animated:)-4c6vq.md)
- [removeSymbolEffect(ofType:options:animated:)](appkit/nsimageview/removesymboleffect(oftype:options:animated:)-8tk6g.md)
- [removeAllSymbolEffects(options:animated:)](appkit/nsimageview/removeallsymboleffects(options:animated:).md)

## Relationships

### Inherits From

- [NSControl](appkit/nscontrol.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSAccessibilityElementProtocol](appkit/nsaccessibilityelementprotocol.md)
- [NSAccessibilityImage](appkit/nsaccessibilityimage.md)
- [NSAccessibilityProtocol](appkit/nsaccessibilityprotocol.md)
- [NSAnimatablePropertyContainer](appkit/nsanimatablepropertycontainer.md)
- [NSAppearanceCustomization](appkit/nsappearancecustomization.md)
- [NSCoding](foundation/nscoding.md)
- [NSDraggingDestination](appkit/nsdraggingdestination.md)
- [NSMenuItemValidation](appkit/nsmenuitemvalidation.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSStandardKeyBindingResponding](appkit/nsstandardkeybindingresponding.md)
- [NSTouchBarProvider](appkit/nstouchbarprovider.md)
- [NSUserActivityRestoring](appkit/nsuseractivityrestoring.md)
- [NSUserInterfaceItemIdentification](appkit/nsuserinterfaceitemidentification.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Controls

- [Responding to control-based events using target-action](uikit/responding-to-control-based-events-using-target-action.md)
- [NSButton](appkit/nsbutton.md)
- [NSColorWell](appkit/nscolorwell.md)
- [Combo Box](appkit/combo-box.md)
- [NSComboButton](appkit/nscombobutton.md)
- [Date Picker](appkit/date-picker.md)
- [NSLevelIndicator](appkit/nslevelindicator.md)
- [Path Control](appkit/path-control.md)
- [NSPopUpButton](appkit/nspopupbutton.md)
- [NSProgressIndicator](appkit/nsprogressindicator.md)
- [NSRuleEditor](appkit/nsruleeditor.md)
- [NSPredicateEditor](appkit/nspredicateeditor.md)
- [Search Field](appkit/search-field.md)
- [NSSegmentedControl](appkit/nssegmentedcontrol.md)
- [Slider](appkit/slider.md)