PATH  Documentation > Mac OS X > Application Kit Reference: Objective-C

Table of Contents

NSImageView


Inherits from:
NSControl : NSView : NSResponder : NSObject
Conforms to:
NSCoding
(NSResponder)
NSObject (NSObject)
Declared in:
AppKit/NSImageView.h




Class Description


An NSImageView displays a single NSImage in a frame. The NSImageView class provides methods for choosing the image, choosing the frame, and for aligning and scaling the image to fit the frame.

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: with an argument of NO.

For more information, see the class specification for NSImageCell.




Method Types


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

- (NSImage *)image

Returns the NSImage displayed by the NSImageView.

See Also: - setImage:



imageAlignment

- (NSImageAlignment)imageAlignment

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

imageFrameStyle

- (NSImageFrameStyle)imageFrameStyle

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

imageScaling

- (NSImageScaling)imageScaling

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

isEditable

- (BOOL)isEditable

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

See Also: - setEditable:



setEditable:

- (void)setEditable:(BOOL)flag

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

See Also: - isEditable



setImage:

- (void)setImage:(NSImage *)image

Lets you specify the image the NSImageView displays.

See Also: - image



setImageAlignment:

- (void)setImageAlignment:(NSImageAlignment)alignment

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

The default alignment is NSImageAlignCenter.

See Also: - imageAlignment



setImageFrameStyle:

- (void)setImageFrameStyle:(NSImageFrameStyle)frameStyle

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

The default frameStyle is NSImageFrameNone.

See Also: - imageFrameStyle



setImageScaling:

- (void)setImageScaling:(NSImageScaling)scaling

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

The default scaling is NSScaleProportionally.

See Also: - imageScaling




Table of Contents