- Inherits from:
- NSCell : NSObject
- Conforms to:
- NSCopying
- NSCoding
- NSObject (NSObject)
Declared in:
- AppKit/NSImageCell.h
An NSImageCell displays a single NSImage in a frame. This class provides methods for choosing the frame, and for aligning and scaling the image to fit the frame.
The object value of an NSImageCell must be an NSImage, so if you use NSCell's setObjectValue: method, be sure to supply an NSImage as an argument. Because an NSImage doesn't need to be converted for display, you won't use the NSCell methods relating to formatters.
An NSImageCell is usually associated with some kind of NSControl-an NSImageView, an NSMatrix, or an NSTableView. For more information, see the specifications for those classes.
- Aligning and scaling the image
- - imageAlignment
- - setImageAlignment:
- - imageScaling
- - setImageScaling:
- Choosing the frame
- - imageFrameStyle
- - setImageFrameStyle:
- (NSImageAlignment)imageAlignment
- (NSImageFrameStyle)imageFrameStyle
- (NSImageScaling)imageScaling
- (void)setImageAlignment:(NSImageAlignment)alignment
NSImageAlignLeft
NSImageAlignRight
NSImageAlignCenter
NSImageAlignTop
NSImageAlignBottom
NSImageAlignTopLeft
NSImageAlignTopRight
NSImageAlignBottomLeft
NSImageAlignBottomRight
The
default alignment is NSImageAlignCenter
.
See Also: - imageAlignment
- (void)setImageFrameStyle:(NSImageFrameStyle)frameStyle
NSImageFrameNone
-an
invisible frameNSImageFramePhoto
-a thin
black outline and a dropped shadowNSImageFrameGrayBezel
-a gray,
concave bezel that makes the image look sunkenNSFrameImageGroove
-a thin
groove that looks etched around the imageNSImageFrameButton
-a convex
bezel that makes the image stand out in relief, like a buttonThe
default frameStyle is NSImageFrameNone
.
See Also: - imageFrameStyle
- (void)setImageScaling:(NSImageScaling)scaling
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.The
default scaling is NSScaleProportionally
.
See Also: - imageScaling