---
title: preferredPencilDoubleTapAction
framework: swiftui
role: symbol
role_heading: Instance Property
path: swiftui/environmentvalues/preferredpencildoubletapaction
---

# preferredPencilDoubleTapAction

The action that the user prefers to perform after double-tapping their Apple Pencil, as selected in the Settings app.

## Declaration

```swift
var preferredPencilDoubleTapAction: PencilPreferredAction { get }
```

## Discussion

Discussion You can read this value by creating a property with the Environment property wrapper and using it inside the action closure of the onPencilDoubleTap(perform:) view modifier as an indication of what to do after the user double-taps their Apple Pencil: @Environment(\.preferredPencilDoubleTapAction) private var preferredAction

var body: some View {     MyDrawingCanvas()         .onPencilDoubleTap { value in             switch preferredAction {                 ...             }         } } In macOS, this value cannot be changed by users and is always set to switchEraser.

## See Also

### Recognizing Apple Pencil gestures

- [onPencilDoubleTap(perform:)](swiftui/view/onpencildoubletap(perform:).md)
- [onPencilSqueeze(perform:)](swiftui/view/onpencilsqueeze(perform:).md)
- [preferredPencilSqueezeAction](swiftui/environmentvalues/preferredpencilsqueezeaction.md)
- [PencilPreferredAction](swiftui/pencilpreferredaction.md)
- [PencilDoubleTapGestureValue](swiftui/pencildoubletapgesturevalue.md)
- [PencilSqueezeGestureValue](swiftui/pencilsqueezegesturevalue.md)
- [PencilSqueezeGesturePhase](swiftui/pencilsqueezegesturephase.md)
- [PencilHoverPose](swiftui/pencilhoverpose.md)