Instance Method

hitTestRect:withImageDestinationRect:context:hints:flipped:

Returns whether the destination rectangle would intersect a non-transparent portion of the image.

Declaration

- (BOOL)hitTestRect:(NSRect)testRectDestSpace withImageDestinationRect:(NSRect)imageRectDestSpace context:(NSGraphicsContext *)context hints:(NSDictionary<NSImageHintKey, id> *)hints flipped:(BOOL)flipped;

Parameters

testRectDestSpace

The rectangle to hit test.

imageRectDestSpace

A rectangle representing the drawn size of the image.

referenceContext

A graphics context. This value can be nil.

hints

An optional dictionary of hints that provide more context for selecting or generating a CGImage, and may override properties of the referenceContext. See Image Hint Dictionary Keys for a summary of the possible key-value pairs.

flipped

YES if the image is flipped, otherwise NO.

Return Value

YES if the testRectDestSpace intersects with non-transparent content within the imageRectDestSpace, otherwise NO.

Discussion

This method simulates the results of hit-testing the test rectangle as if the image was drawn in the graphics context using the provided hints and respecting the specified flippedness.