| Inherits from | |
| Conforms to | |
| Framework | /System/Library/Frameworks/AppKit.framework |
| Availability | Available in Mac OS X v10.0 and later. |
| Declared in | NSImageCell.h |
| Companion guides | |
| Related sample code |
An NSImageCell object displays a single image (encapsulated in an NSImage object) 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 object must be an NSImage object, so if you use the setObjectValue: method of NSCell, be sure to supply an NSImage object as an argument. Because an NSImage object does not need to be converted for display, do not use the NSCell methods relating to formatters.
An NSImageCell object is usually associated with some kind of control object—an NSImageView, an NSMatrix, or an NSTableView.
Returns the alignment of the receiver’s image relative to its frame.
- (NSImageAlignment)imageAlignment
One of the image alignment constants. For a list of possible values, see NSImageAlignment. The default value is NSImageAlignCenter.
NSImageCell.hReturns the style of the frame that borders the image.
- (NSImageFrameStyle)imageFrameStyle
One of the frame style constants. For a list of frame styles, see NSImageFrameStyle. The default value is NSImageFrameNone.
NSImageCell.hReturns the scaling mode used to fit the receiver's image into the frame.
- (NSImageScaling)imageScaling
One of the image scaling constants. For a list of possible values, see NSImageScaling. The default value is NSImageScaleProportionallyDown.
NSImageCell.hSets the alignment of the image in its frame.
- (void)setImageAlignment:(NSImageAlignment)alignment
One of the image alignment constants. For a list of possible values, see NSImageAlignment.
NSImageCell.hSets the style of the frame that borders the image.
- (void)setImageFrameStyle:(NSImageFrameStyle)frameStyle
One of the frame style constants. For a list of frame styles, see NSImageFrameStyle.
NSImageCell.hSets the scaling mode used to fit the receiver's image into the frame.
- (void)setImageScaling:(NSImageScaling)scaling
One of the image scaling constants. For a list of possible values, see NSImageScaling.
NSImageCell.hThese constants allow you to specify the location of the image in the frame and are used by imageAlignment and setImageAlignment:.
typedef enum {
NSImageAlignCenter = 0,
NSImageAlignTop,
NSImageAlignTopLeft,
NSImageAlignTopRight,
NSImageAlignLeft,
NSImageAlignBottom,
NSImageAlignBottomLeft,
NSImageAlignBottomRight,
NSImageAlignRight
} NSImageAlignment;
NSImageAlignCenterCenter the image in the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignTopPosition the image along the top edge of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignTopLeftAlign the image with the top and left edges of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignTopRightAlign the image with the top and right edges of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignLeftAlign the image with the left edge of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignBottomAlign the image with the bottom edge of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignBottomLeftAlign the image with the bottom and left edges of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignBottomRightAlign the image with the bottom and right edges of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageAlignRightPosition the image along the right edge of the cell.
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageCell.hThese constants allow you to specify the kind of frame bordering the image and are used by imageFrameStyle and setImageFrameStyle:. These constants are obsolete, and are not compliant with the Apple Human Interface Guidelines:
typedef enum {
NSImageFrameNone = 0,
NSImageFramePhoto,
NSImageFrameGrayBezel,
NSImageFrameGroove,
NSImageFrameButton
} NSImageFrameStyle;
NSImageFrameNoneAn invisible frame
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageFramePhotoA thin black outline and a dropped shadow
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageFrameGrayBezelA gray, concave bezel that makes the image look sunken
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageFrameGrooveA thin groove that looks etched around the image
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageFrameButtonA convex bezel that makes the image stand out in relief, like a button
Available in Mac OS X v10.0 and later.
Declared in NSImageCell.h.
NSImageCell.hLast updated: 2009-01-06
Mac OS X Reference Library User Experience: Windows & Views NSImageCell Class Reference