<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "tvOS: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UITextLoupeSession/begin(at:fromSelectionWidgetView:in:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UITextLoupeSession(cm)beginLoupeSessionAtPoint:fromSelectionWidgetView:inView:"
  },
  "title" : "begin(at:fromSelectionWidgetView:in:)"
}
-->

# begin(at:fromSelectionWidgetView:in:)

Creates a new loupe session and displays the loupe at the specified location in your view.

```
class func begin(at point: CGPoint, fromSelectionWidgetView selectionWidget: UIView?, in interactionView: UIView) -> Self?
```

## Parameters

`point`

The point in your view’s coordinate system that you want to magnify using the loupe. When creating the loupe with a gesture recognizer, specify the location of the gesture.

`selectionWidget`

The view associated with the insertion point. When using a [`UITextSelectionDisplayInteraction`](/documentation/UIKit/UITextSelectionDisplayInteraction) object to display selections in your view, specify the view in the interaction object’s [`cursorView`](/documentation/UIKit/UITextSelectionDisplayInteraction/cursorView) property for this parameter.

`interactionView`

The view in which to display the loupe. Specify all coordinate values relative to this view.

## Return Value

A new loupe session for the specified view. The method returns `nil` if showing the loupe is inappropriate in the current context.

## Discussion

Call this method to animate the appearance of the loupe at the specified `point` in `interactionView`.  Store a strong reference to this returned session and use it to update the position of the loupe. To hide the loupe again, call [`invalidate()`](/documentation/UIKit/UITextLoupeSession/invalidate()) and then remove your reference to the session.

---

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)