---
title: "hitTestOSC(atMousePositionX:mousePositionY:activePart:at:)"
framework: Professional Video Applications
role: symbol
role_heading: Instance Method
platforms: [fxplug 4.0+]
path: "professional_video_applications/fxonscreencontrol_v4/hittestosc(atmousepositionx:mousepositiony:activepart:at:)"
---

# hitTestOSC(atMousePositionX:mousePositionY:activePart:at:)

Figures out which part of the onscreen control was hit.

## Declaration

```swift
func hitTestOSC(atMousePositionX mousePositionX: Double, mousePositionY: Double, activePart: UnsafeMutablePointer<Int>!, at time: CMTime)
```

## Parameters

- `mousePositionX`: The x position of the mouse
- `mousePositionY`: The y position of the mouse
- `activePart`: The part that was hit - set to 0 if no part was hit
- `time`: The time at which we are checking for a hit

## Discussion

Discussion This method is called by the host to determine which part of your controls were hit by the mouse. Return a constant that represents a part number for your onscreen control in the activePart parameter. It will be sent to you in the -draw, -mouse, and -key methods so you can handle those events properly.

## See Also

### Instance Methods

- [drawOSC(withWidth:height:activePart:destinationImage:at:)](professional_video_applications/fxonscreencontrol_v4/drawosc(withwidth:height:activepart:destinationimage:at:).md)
- [drawingCoordinates()](professional_video_applications/fxonscreencontrol_v4/drawingcoordinates().md)
- [keyDown(atPositionX:positionY:keyPressed:modifiers:forceUpdate:didHandle:at:)](professional_video_applications/fxonscreencontrol_v4/keydown(atpositionx:positiony:keypressed:modifiers:forceupdate:didhandle:at:).md)
- [keyUp(atPositionX:positionY:keyPressed:modifiers:forceUpdate:didHandle:at:)](professional_video_applications/fxonscreencontrol_v4/keyup(atpositionx:positiony:keypressed:modifiers:forceupdate:didhandle:at:).md)
- [mouseDown(atPositionX:positionY:activePart:modifiers:forceUpdate:at:)](professional_video_applications/fxonscreencontrol_v4/mousedown(atpositionx:positiony:activepart:modifiers:forceupdate:at:).md)
- [mouseDragged(atPositionX:positionY:activePart:modifiers:forceUpdate:at:)](professional_video_applications/fxonscreencontrol_v4/mousedragged(atpositionx:positiony:activepart:modifiers:forceupdate:at:).md)
- [mouseEntered(atPositionX:positionY:modifiers:forceUpdate:at:)](professional_video_applications/fxonscreencontrol_v4/mouseentered(atpositionx:positiony:modifiers:forceupdate:at:).md)
- [mouseExited(atPositionX:positionY:modifiers:forceUpdate:at:)](professional_video_applications/fxonscreencontrol_v4/mouseexited(atpositionx:positiony:modifiers:forceupdate:at:).md)
- [mouseMoved(atPositionX:positionY:activePart:modifiers:forceUpdate:at:)](professional_video_applications/fxonscreencontrol_v4/mousemoved(atpositionx:positiony:activepart:modifiers:forceupdate:at:).md)
- [mouseUp(atPositionX:positionY:activePart:modifiers:forceUpdate:at:)](professional_video_applications/fxonscreencontrol_v4/mouseup(atpositionx:positiony:activepart:modifiers:forceupdate:at:).md)
