| Inherits from | |
| Conforms to | |
| Framework | System/Library/Frameworks/Quartz.framework/ImageKit.framework |
| Availability | Available in Mac OS X v10.5 and later. |
| Declared in | IKImageView.h |
The IKImageView class provides an efficient way to display images in a view while at the same time supporting a number of image editing operations such as rotating, zooming, and cropping. It supports drag and drop, so that the user can drag an image to the view. If possible, image rendering uses hardware acceleration to achieve optimal performance. The IKImageView class is implemented as a subclass of NSView. Similar to NSImageView, the IKImageView class is used to display a single image.
You can provide an images for the view in any of these formats:
Image (CGImageRef or CIImage)
Providing a file reference is the preferred way to set the the image for a view because in addition to the actual image data, IKImageView also handles the image metadata embedded in the file. The image view automatically fetches the metadata from a file reference, whereas for the other sources (except for a CGImageSourceRef source), it cannot. For images set from other sources, you need to set the metadata separately.
IKImageView supports multi-frame images (TIFF, GIF, and so forth) and animated images.
delegate property
zoomFactor property
rotationAngle property
currentToolMode property
autoresizes property
hasHorizontalScroller property
hasVerticalScroller property
autohidesScrollers property
supportsDragAndDrop property
editable property
doubleClickOpensImageEditPanel property
imageCorrection property
backgroundColor property
– imageSize
– imageProperties
– setRotationAngle:centerPoint:
– setImageZoomFactor:centerPoint:
– zoomImageToFit:
– zoomImageToActualSize:
– zoomImageToRect:
– zoomIn:
– zoomOut:
– crop:
– flipImageHorizontal:
– flipImageVertical:
– rotateImageLeft:
– rotateImageRight:
For more about Objective-C properties, see “Properties” in The Objective-C Programming Language.
Specifies the automatic-hiding scroll bar state for the image view.
@property BOOL autohidesScrollers
IKImageView.hSpecifies the automatic resizing state for the image view.
@property BOOL autoresizes
IKImageView.hSpecifies the background color for the image view.
@property(assign) NSColor *backgroundColor
IKImageView.hSpecifies the current tool mode for the image view.
@property(copy) NSString *currentToolMode
See “Tool Modes” for possible values.
IKImageView.hSpecifies the delegate object of the receiver.
@property(assign) id delegate
An IKImageView object’s delegate is inserted in the responder chain after the image view itself and is informed of various actions by the image view through delegation messages.
IKImageView.hSpecifies the image-opening state of the editing pane in the image view.
@property BOOL doubleClickOpensImageEditPanel
IKImageView.hSpecifies the editable state for the image view.
@property BOOL editable
IKImageView.hSpecifies the horizontal scroll bar state for the image view.
@property BOOL hasHorizontalScroller
IKImageView.hSpecifies the vertical scroll bar state for the image view.
@property BOOL hasVerticalScroller
IKImageView.hSpecifies a Core Image filter for image correction.
@property(assign) CIFilter *imageCorrection
IKImageView.hSpecifies the rotation angle for the image view.
@property CGFloat rotationAngle
IKImageView.hSpecifies the drag-and-drop support state for the image view.
@property BOOL supportsDragAndDrop
IKImageView.hSpecifies the zoom factor for the image view.
@property CGFloat zoomFactor
IKImageView.hConverts an image coordinate to an image view coordinate.
- (NSPoint)convertImagePointToViewPoint:(NSPoint)imagePoint
A point specified in coordinates relative to the image.
A point specified in coordinates relative to the image view.
IKImageView.hConverts an image rectangle to an image view rectangle.
- (NSRect)convertImageRectToViewRect:(NSRect)imageRect
An rectangle specified in coordinates relative to the image.
An rectangle specified in coordinates relative to the image view.
IKImageView.hConverts an image view coordinate to an image coordinate.
- (NSPoint)convertViewPointToImagePoint:(NSPoint)viewPoint
A point specified in coordinates relative to the image view.
The point specified in coordinates relative to the image.
IKImageView.hConverts an image view rectangle to an image rectangle.
- (NSRect)convertViewRectToImageRect:(NSRect)viewRect
An rectangle specified in coordinates relative to the image view.
The rectangle specified in coordinates relative to the image.
IKImageView.hCrops the image using the current selection.
- (void)crop:(id)sender
Typically the object that invoked this method.
IKImageView.hFlips an image along the horizontal axis.
- (void)flipImageHorizontal:(id)sender
The object initiating the action.
IKImageView.hFlips an image along the vertical axis.
- (void)flipImageVertical:(id)sender
The object initiating the action.
IKImageView.hReturns the image associated with the view, after any image corrections.
- (CGImageRef)image
The image.
IKImageView.hReturns the metadata for the image in the view.
- (NSDictionary *)imageProperties
A dictionary of metadata that specifies the image properties.
IKImageView.hReturns the size of the image in the image view.
- (NSSize)imageSize
The size of the image.
The image size changes whenever an image is rotates or cropped.
IKImageView.hReturns the Core Animation layer associated with a layer type.
- (CALayer *)overlayForType:(NSString *)layerType
A layer type. See “Overlay Types”.
The Core Animation layer.
IKImageView.hRotates the image left (counter-clockwise).
- (void)rotateImageLeft:(id)sender
Typically the object that invoked this method.
IKImageView.hRotates the image right (clockwise).
- (void)rotateImageRight:(id)sender
Typically the object that invoked this method.
IKImageView.hScrolls the view to the specified point.
- (void)scrollToPoint:(NSPoint)point
The point to scroll to.
IKImageView.hScrolls the view so that it includes the provided rectangular area.
- (void)scrollToRect:(NSRect)rect
The rectangular area to include in the view.
IKImageView.hSets the image to display in an image view.
- (void)setImage:(CGImageRef)image imageProperties:(NSDictionary *)metaData
The image to set.
A dictionary that contains metadata that describes the image.
IKImageView.hInitializes an image view with the image specified by a URL.
- (void)setImageWithURL:(NSURL *)url
The URL that specifies the location of the image.
This method is the preferred initializer for RAW images. If you use this method for a TIFF file that contains multiple images, only the first image is displayed.
IKImageView.hSets the zoom factor at the provided origin.
- (void)setImageZoomFactor:(CGFloat)zoomFactor centerPoint:(NSPoint)centerPoint
The zoom factor to apply to the image.
The point that specifies the origin of the zoom factor.
IKImageView.hSets an overlay type for a Core Animation layer.
- (void)setOverlay:(CALayer *)layer forType:(NSString *)layerType
A Core Animation layer object.
A layer type. See “Overlay Types”.
IKImageView.hSets the rotation angle at the provided origin.
- (void)setRotationAngle:(CGFloat)rotationAngle centerPoint:(NSPoint)centerPoint
The rotation angle to apply to the image.
The point that specifies the origin of the rotation angle.
IKImageView.hZooms the image so that it is displayed using its true size.
- (void)zoomImageToActualSize:(id)sender
The object initiating the action.
IKImageView.hZooms the image so that it fits in the image view.
- (void)zoomImageToFit:(id)sender
The object initiating the action.
IKImageView.hZooms the image so that it fits in the specified rectangle.
- (void)zoomImageToRect:(NSRect)rect
The rectangle to fit the image in.
IKImageView.hImage Kit tools modes referenced by the currentToolMode property.
NSString *const IKToolModeNone; NSString *const IKToolModeMove; NSString *const IKToolModeSelect; NSString *const IKToolModeSelectRect; NSString *const IKToolModeSelectEllipse; NSString *const IKToolModeSelectLasso; NSString *const IKToolModeCrop; NSString *const IKToolModeRotate; NSString *const IKToolModeAnnotate;
IKToolModeNoneNo tool is set.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKToolModeMoveThe move tool.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKToolModeSelectThe selection tool.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKToolModeSelectRectSame as IKToolModeSelect.
Available in Mac OS X v10.6 and later.
Declared in IKImageView.h.
IKToolModeSelectEllipseThe selection ellipse.
Available in Mac OS X v10.6 and later.
Declared in IKImageView.h.
IKToolModeSelectLassoThe selection lasso.
Available in Mac OS X v10.6 and later.
Declared in IKImageView.h.
IKToolModeCropThe crop tool.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKToolModeRotateThe rotation tool.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKToolModeAnnotateThe annotation tool.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKImageView.hA layer level.
NSString *const IKOverlayTypeBackground; NSString *const IKOverlayTypeImage;
IKOverlayTypeBackgroundA background.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKOverlayTypeImageAn image.
Available in Mac OS X v10.5 and later.
Declared in IKImageView.h.
IKImageView.hLast updated: 2010-05-25