<!--
{
  "availability" : [
    "macOS: 10.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSView/enterFullScreenMode(_:withOptions:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSView(im)enterFullScreenMode:withOptions:"
  },
  "title" : "enterFullScreenMode(_:withOptions:)"
}
-->

# enterFullScreenMode(_:withOptions:)

Sets the view to full screen mode.

```
func enterFullScreenMode(_ screen: NSScreen, withOptions options: [NSView.FullScreenModeOptionKey : Any]? = nil) -> Bool
```

## Parameters

`screen`

The screen the view should cover.

`options`

A dictionary of options for the mode. For possible keys, see `Full Screen Mode Options`.

## Return Value

<doc://com.apple.documentation/documentation/Swift/true> if the view was able to enter full screen mode, otherwise <doc://com.apple.documentation/documentation/Swift/false>.

## Discussion

When the [`fullScreenModeApplicationPresentationOptions`](/documentation/AppKit/NSView/FullScreenModeOptionKey/fullScreenModeApplicationPresentationOptions) is contained in the options dictionary, the presentation options that were in effect when this method is invoked are not altered, and no displays are captured.

If you do not wish to capture the screen when going to full screen mode, you can add [`fullScreenModeApplicationPresentationOptions`](/documentation/AppKit/NSView/FullScreenModeOptionKey/fullScreenModeApplicationPresentationOptions) to the options dictionary with the value returned by the [`presentationOptions`](/documentation/AppKit/NSApplication/presentationOptions-swift.property).

When the [`fullScreenModeApplicationPresentationOptions`](/documentation/AppKit/NSView/FullScreenModeOptionKey/fullScreenModeApplicationPresentationOptions) options is specified, exiting full screen mode using [`exitFullScreenMode(options:)`](/documentation/AppKit/NSView/exitFullScreenMode(options:)) will restore the previously active [`presentationOptions`](/documentation/AppKit/NSApplication/presentationOptions-swift.property).

### Special Considerations

In OS X v 10.5, invoking this method when the view was not in a window would cause an exception. In macOS 10.6 and later, you can now send this message to a view not in a window. For applications that must also run in OS X v 10.5, a simple workaround is to place the view in an offscreen window.

---

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)