<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "tvOS: -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIControl/Event",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:@E@UIControlEvents"
  },
  "title" : "UIControl.Event"
}
-->

# UIControl.Event

Constants describing the types of events possible for controls.

```
struct Event
```

## Overview

You set up a control so that it sends an action message to a target object by associating both target and action with one or more control events. To do this, send [`addTarget(_:action:for:)`](/documentation/UIKit/UIControl/addTarget(_:action:for:)) to the control for each target-action pair you want to specify.

## Topics

### Constants

[`touchDown`](/documentation/UIKit/UIControl/Event/touchDown)

A touch-down event in the control.

[`touchDownRepeat`](/documentation/UIKit/UIControl/Event/touchDownRepeat)

A repeated touch-down event in the control; for this event the value of the UITouch `tapCount` method is greater than one.

[`touchDragInside`](/documentation/UIKit/UIControl/Event/touchDragInside)

An event where a finger is dragged inside the bounds of the control.

[`touchDragOutside`](/documentation/UIKit/UIControl/Event/touchDragOutside)

An event where a finger is dragged just outside the bounds of the control.

[`touchDragEnter`](/documentation/UIKit/UIControl/Event/touchDragEnter)

An event where a finger is dragged into the bounds of the control.

[`touchDragExit`](/documentation/UIKit/UIControl/Event/touchDragExit)

An event where a finger is dragged from within a control to outside its bounds.

[`touchUpInside`](/documentation/UIKit/UIControl/Event/touchUpInside)

A touch-up event in the control where the finger is inside the bounds of the control.

[`touchUpOutside`](/documentation/UIKit/UIControl/Event/touchUpOutside)

A touch-up event in the control where the finger is outside the bounds of the control.

[`touchCancel`](/documentation/UIKit/UIControl/Event/touchCancel)

A system event canceling the current touches for the control.

[`valueChanged`](/documentation/UIKit/UIControl/Event/valueChanged)

A touch dragging or otherwise manipulating a control, causing it to emit a series of different values.

[`menuActionTriggered`](/documentation/UIKit/UIControl/Event/menuActionTriggered)

A menu action has triggered prior to the menu being presented.

[`primaryActionTriggered`](/documentation/UIKit/UIControl/Event/primaryActionTriggered)

A semantic action triggered by buttons.

[`editingDidBegin`](/documentation/UIKit/UIControl/Event/editingDidBegin)

A touch initiating an editing session in a text field by entering its bounds.

[`editingChanged`](/documentation/UIKit/UIControl/Event/editingChanged)

A touch making an editing change in a text field.

[`editingDidEnd`](/documentation/UIKit/UIControl/Event/editingDidEnd)

A touch ending an editing session in a text field by leaving its bounds.

[`editingDidEndOnExit`](/documentation/UIKit/UIControl/Event/editingDidEndOnExit)

A touch ending an editing session in a text field.

[`allTouchEvents`](/documentation/UIKit/UIControl/Event/allTouchEvents)

All touch events.

[`allEditingEvents`](/documentation/UIKit/UIControl/Event/allEditingEvents)

All editing touches for text fields.

[`applicationReserved`](/documentation/UIKit/UIControl/Event/applicationReserved)

A range of control-event values available for app use.

[`systemReserved`](/documentation/UIKit/UIControl/Event/systemReserved)

A range of control-event values reserved for internal framework use.

[`allEvents`](/documentation/UIKit/UIControl/Event/allEvents)

All events, including system events.

### Initializers

[`init(rawValue:)`](/documentation/UIKit/UIControl/Event/init(rawValue:))

Creates a control event with the specified raw value.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)