---
title: CGEventTapOptions
framework: coregraphics
role: symbol
role_heading: Enumeration
path: coregraphics/cgeventtapoptions
---

# CGEventTapOptions

Constants that specify whether a new event tap is an active filter or a passive listener.

## Declaration

```swift
enum CGEventTapOptions
```

## Overview

Overview When you create an event tap, you indicate whether it is a passive listener or active event filter. A passive listener receives events but cannot modify or divert them. An active filter may pass an event through unmodified, modify an event, or discard an event.

## Topics

### Constants

- [CGEventTapOptions.defaultTap](coregraphics/cgeventtapoptions/defaulttap.md)
- [CGEventTapOptions.listenOnly](coregraphics/cgeventtapoptions/listenonly.md)

### Initializers

- [init(rawValue:)](coregraphics/cgeventtapoptions/init(rawvalue:).md)

## Relationships

### Conforms To

- [BitwiseCopyable](swift/bitwisecopyable.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [RawRepresentable](swift/rawrepresentable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Enumerations

- [CGCaptureOptions](coregraphics/cgcaptureoptions.md)
- [CGColorConversionInfoTransformType](coregraphics/cgcolorconversioninfotransformtype.md)
- [CGColorRenderingIntent](coregraphics/cgcolorrenderingintent.md)
- [CGConfigureOption](coregraphics/cgconfigureoption.md)
- [CGDisplayChangeSummaryFlags](coregraphics/cgdisplaychangesummaryflags.md)
- [CGDisplayStreamFrameStatus](coregraphics/cgdisplaystreamframestatus.md)
- [CGDisplayStreamUpdateRectType](coregraphics/cgdisplaystreamupdaterecttype.md)
- [CGError](coregraphics/cgerror.md)
- [CGEventField](coregraphics/cgeventfield.md)
- [CGEventFilterMask](coregraphics/cgeventfiltermask.md)
- [CGEventFlags](coregraphics/cgeventflags.md)
- [CGEventMouseSubtype](coregraphics/cgeventmousesubtype.md)
- [CGEventSourceStateID](coregraphics/cgeventsourcestateid.md)
- [CGEventSuppressionState](coregraphics/cgeventsuppressionstate.md)
- [CGEventTapLocation](coregraphics/cgeventtaplocation.md)