NSImageView

Inherits From:
NSControl: NSView: NSResponder: NSObject

Conforms To:
NSCoding (from NSResponder)
NSObject (from NSObject)

Declared In:
AppKit/NSImageView.h

Class Description

For an NSControl, NSImageView is quite limited in its ability to respond to user events: the only thing a user can do is drag in a new image. When it receives the new image, the NSImageView replaces its old image and sends its action message to its target. Even this low level of interactivity can be disabled: you can send the NSImageView the message setEditable:NO.

For more information, see the class specification for NSImageCell.

Choosing the image

- image

- setImage:

Choosing the frame

- imageFrameStyle

- setImageFrameStyle:

Aligning and scaling the image

- imageAlignment

- setImageAlignment:

- imageScaling

- setImageScaling:

Responding to user events

- isEditable

- setEditable:

Instance Methods

image

Returns the NSImage displayed by the NSImageView.

See also: - setImage:

imageAlignment

Returns the position of the cell's image in the frame. For a list of possible alignments, see setImageAlignment:.

imageFrameStyle

Returns the style of frame that appears around the image. For a list of frame styles, see setImageFrameStyle:.

imageScaling

Returns the way that the cell's image alters to fit the frame. For a list of possible values, see setImageScaling:.

isEditable

Returns whether the user can drag a new image into the frame. The default is YES.

See also: - setEditable:

setEditable:

Specifies whether the user can drag a new image into the frame.

See also: - isEditable

setImage:

Lets you specify the image that the NSImageView displays.

See also: - image

setImageAlignment:

Lets you specify the position of the image in the frame. The possible alignments are:

• NSImageAlignLeft
  
• NSImageAlignRight
  
• NSImageAlignCenter
  
• NSImageAlignTop
  
• NSImageAlignBottom
  
• NSImageAlignTopLeft
  
• NSImageAlignTopRight
  
• NSImageAlignBottomLeft
  
• NSImageAlignBottomRight
  

See also: - imageAlignment

setImageFrameStyle:

Lets you specify the kind of frame that borders the image . The possible styles are:

• NSImageFrameNone-an invisible frame
  
• NSImageFramePhoto-a thin black outline and a dropped shadow
  
• NSImageFrameGrayBezel-a gray, concave bezel that makes the image look sunken
  
• NSImageGroove-a thin groove that looks etched around the image
  
• NSImageFrameButton-a convex bezel that makes the image stand out in relief, like a button
  

See also: - imageFrameStyle

setImageScaling:

Lets you specify the way that the image alters to fit the frame. The possible values are:

• NSScaleProportionally. If the image is too large, it shrinks to fit inside the frame. If the image is too small, it expands. The proportions of the image are preserved.

• NSScaleToFit. The image shrinks or expands, and its proportions distort, until it exactly fits the frame.

• NSScaleNone. The size and proportions of the image don't change. If the frame is too small to display the whole image, the edges of the image are trimmed off.

See also: - imageScaling