---
title: "mouseEvent(with:location:modifierFlags:timestamp:windowNumber:context:eventNumber:clickCount:pressure:)"
framework: appkit
role: symbol
role_heading: Type Method
path: "appkit/nsevent/mouseevent(with:location:modifierflags:timestamp:windownumber:context:eventnumber:clickcount:pressure:)"
---

# mouseEvent(with:location:modifierFlags:timestamp:windowNumber:context:eventNumber:clickCount:pressure:)

Creates and returns a new event object that describes a mouse-down, -up, -moved, or -dragged event.

## Declaration

```swift
class func mouseEvent(with type: NSEvent.EventType, location: NSPoint, modifierFlags flags: NSEvent.ModifierFlags, timestamp time: TimeInterval, windowNumber wNum: Int, context unusedPassNil: NSGraphicsContext?, eventNumber eNum: Int, clickCount cNum: Int, pressure: Float) -> NSEvent?
```

## Parameters

- `type`: One of the modifier key masks described in doc://com.apple.appkit/documentation/AppKit/NSEvent/EventType, or an NSInternalInconsistencyException is raised.
- `location`: The cursor location in the base coordinate system of the window specified by windowNum.
- `flags`: An integer bit field containing any of the modifier key masks described in Getting Unicode Values, combined using the C bitwise OR operator.
- `time`: The time the event occurred in seconds since system startup.
- `wNum`: An integer that identifies the window device associated with the event, which is associated with the NSWindow that will receive the event.
- `unusedPassNil`: The display graphics context of the event. Pass nil for this parameter.
- `eNum`: An identifier for the new event. It’s normally taken from a counter for mouse events, which continually increases as the application runs.
- `cNum`: The number of mouse clicks associated with the mouse event.
- `pressure`: A value from 0.0 to 1.0 indicating the pressure applied to the input device on a mouse event, used for an appropriate device such as a graphics tablet. For devices that aren’t pressure-sensitive, the value should be either 0.0 or 1.0.

## Return Value

Return Value The created NSEvent instance or nil if the instance could not be created.

## See Also

### Related Documentation

- [clickCount](appkit/nsevent/clickcount.md)
- [eventNumber](appkit/nsevent/eventnumber.md)
- [systemUptime](foundation/processinfo/systemuptime.md)
- [pressure](appkit/nsevent/pressure.md)

### Creating an event object

- [keyEvent(with:location:modifierFlags:timestamp:windowNumber:context:characters:charactersIgnoringModifiers:isARepeat:keyCode:)](appkit/nsevent/keyevent(with:location:modifierflags:timestamp:windownumber:context:characters:charactersignoringmodifiers:isarepeat:keycode:).md)
- [enterExitEvent(with:location:modifierFlags:timestamp:windowNumber:context:eventNumber:trackingNumber:userData:)](appkit/nsevent/enterexitevent(with:location:modifierflags:timestamp:windownumber:context:eventnumber:trackingnumber:userdata:).md)
- [otherEvent(with:location:modifierFlags:timestamp:windowNumber:context:subtype:data1:data2:)](appkit/nsevent/otherevent(with:location:modifierflags:timestamp:windownumber:context:subtype:data1:data2:).md)
- [init(eventRef:)](appkit/nsevent/init(eventref:).md)
- [init(cgEvent:)](appkit/nsevent/init(cgevent:)-4igjn.md)