Instance Method

drawInRect:

Draws the image, scaling it (as needed) to fit the specified rectangle.

Declaration

- (BOOL)drawInRect:(NSRect)rect;

Parameters

rect

The rectangle in the current coordinate system in which to draw the image.

Return Value

YES if the image was successfully drawn; otherwise, NO. If the size of the image has not yet been set, this method returns NO immediately.

Discussion

This method sets the origin of the current coordinate system to the origin of the specified rectangle before invoking the receiver's draw method. If the rectangle size is different from the image's native size, this method adjusts the coordinate transform, causing the image to be scaled appropriately. After the draw method returns, the coordinate system changes are undone, restoring the original graphics state.

See Also

Drawing the Image

- draw

Implemented by subclasses to draw the image in the current coordinate system.

- drawAtPoint:

Draws the receiver's image data at the specified point in the current coordinate system.

- drawInRect:fromRect:operation:fraction:respectFlipped:hints:

Draws all or part of the image in the specified rectangle in the current coordinate system.

NSImageHintKey

Constants for the keys to include in a hints dictionary when drawing the image.