PATH
Mac OS X Documentation >
Application Kit Reference: Objective-C
[Previous] [Class List] [Next]
Inherits
from: NSCell : NSObject
Conforms to: NSCopying
NSCoding (from NSCell)
NSObject (from NSObject)
Declared in: AppKit/NSImageCell.h
Class Description
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.
Method Types
- Aligning and scaling
the image
- - imageAlignment
- - setImageAlignment:
- - imageScaling
- - setImageScaling:
- Choosing the frame
- - imageFrameStyle
- - setImageFrameStyle:
Constructors
Instance Methods
- (NSImageAlignment)imageAlignment
Returns the position of the
cell's image in the frame. For a list of possible alignments,
see setImageAlignment:.
- (NSImageFrameStyle)imageFrameStyle
Returns the style of frame
that appears around the image. For a list of frame styles,
see setImageFrameStyle:.
- (NSImageScaling)imageScaling
Returns the way the cell's
image alters to fit the frame. For a list of possible values,
see setImageScaling:.
- (void)setImageAlignment:(NSImageAlignment)alignment
Lets you specify the position
of the image in the frame. The possible alignments are:
- NSImageAlignLeft
- NSImageAlignRight
- NSImageAlignCenter
- NSImageAlignTop
- NSImageAlignBottom
- NSImageAlignTopLeft
- NSImageAlignTopRight
- NSImageAlignBottomLeft
- NSImageAlignBottomRight
The default
alignment is NSImageAlignCenter.
See
Also: - imageAlignment
- (void)setImageFrameStyle:(NSImageFrameStyle)frameStyle
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
The default
frameStyle is NSImageFrameNone.
See
Also: - imageFrameStyle
- (void)setImageScaling:(NSImageScaling)scaling
Lets you specify the way 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.
The
default scaling is NSScaleProportionally.
See
Also: - imageScaling
[Previous] [Next]