<!--
{
  "availability" : [
    "macCatalyst: -",
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreGraphics",
  "identifier" : "/documentation/CoreGraphics/CGWindowListOption",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Core Graphics"
    ],
    "preciseIdentifier" : "c:@E@CGWindowListOption"
  },
  "title" : "CGWindowListOption"
}
-->

# CGWindowListOption

The data type used to specify the options for gathering a list of windows.

```
struct CGWindowListOption
```

## Overview

This type is used in conjunction with the constants described in [Window List Option Constants](/documentation/CoreGraphics/window-list-option-constants).

## Topics

### Initializers

[`init(rawValue:)`](/documentation/CoreGraphics/CGWindowListOption/init(rawValue:))

### Type Properties

[`excludeDesktopElements`](/documentation/CoreGraphics/CGWindowListOption/excludeDesktopElements)

[`optionAll`](/documentation/CoreGraphics/CGWindowListOption/optionAll)

[`optionIncludingWindow`](/documentation/CoreGraphics/CGWindowListOption/optionIncludingWindow)

[`optionOnScreenAboveWindow`](/documentation/CoreGraphics/CGWindowListOption/optionOnScreenAboveWindow)

[`optionOnScreenBelowWindow`](/documentation/CoreGraphics/CGWindowListOption/optionOnScreenBelowWindow)

[`optionOnScreenOnly`](/documentation/CoreGraphics/CGWindowListOption/optionOnScreenOnly)


---

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)