<!--
{
  "availability" : [
    "iOS: 12.0.0 -",
    "iPadOS: 12.0.0 -",
    "macCatalyst: 13.1.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CarPlay",
  "identifier" : "/documentation/CarPlay/CPWindow",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "CarPlay"
    ],
    "preciseIdentifier" : "c:objc(cs)CPWindow"
  },
  "title" : "CPWindow"
}
-->

# CPWindow

A window that displays its content on the CarPlay screen.

```
class CPWindow
```

## Overview

Navigation apps use a window to render their maps, and CarPlay provides one via the scene delegate’s [`templateApplicationScene(_:didConnect:to:)`](/documentation/CarPlay/CPTemplateApplicationSceneDelegate/templateApplicationScene(_:didConnect:to:)) method. For all other categories of apps, you use templates exclusively to draw your user interface, and your scene delegate must implement [`templateApplicationScene(_:didConnect:)`](/documentation/CarPlay/CPTemplateApplicationSceneDelegate/templateApplicationScene(_:didConnect:)) instead.

When CarPlay launches your navigation app, instantiate your map-drawing view controller and assign it to the window’s <doc://com.apple.documentation/documentation/UIKit/UIWindow/rootViewController> property. This becomes the base CarPlay view and is for drawing maps exclusively. You use templates for all other user interface elements.

The base view of a navigation app does not receive tap or drag events.

## Topics

### Accessing the Scene

[`templateApplicationScene`](/documentation/CarPlay/CPWindow/templateApplicationScene)

The application scene that contains the window.

### Layout

[`mapButtonSafeAreaLayoutGuide`](/documentation/CarPlay/CPWindow/mapButtonSafeAreaLayoutGuide)

The layout guide that represents the portion of the map template that map buttons don’t obscure.

## Relationships

### Conforms To

[`CMBodyIdentifiable`](/documentation/CoreMotion/CMBodyIdentifiable)

[`UICoordinateSpace`](/documentation/UIKit/UICoordinateSpace)

[`UIFocusItemContainer`](/documentation/UIKit/UIFocusItemContainer)

[`Sendable`](/documentation/Swift/Sendable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`UIPasteConfigurationSupporting`](/documentation/UIKit/UIPasteConfigurationSupporting)

[`UIFocusEnvironment`](/documentation/UIKit/UIFocusEnvironment)

[`UIAppearanceContainer`](/documentation/UIKit/UIAppearanceContainer)

[`CVarArg`](/documentation/Swift/CVarArg)

[`UIResponderStandardEditActions`](/documentation/UIKit/UIResponderStandardEditActions)

[`UIFocusItem`](/documentation/UIKit/UIFocusItem)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`UIAppearance`](/documentation/UIKit/UIAppearance)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`UITraitChangeObservable-67e94`](/documentation/UIKit/UITraitChangeObservable-67e94)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`UIPopoverPresentationControllerSourceItem`](/documentation/UIKit/UIPopoverPresentationControllerSourceItem)

[`UIAccessibilityIdentification`](/documentation/UIKit/UIAccessibilityIdentification)

[`UIUserActivityRestoring`](/documentation/UIKit/UIUserActivityRestoring)

[`Equatable`](/documentation/Swift/Equatable)

[`NSTouchBarProvider`](/documentation/AppKit/NSTouchBarProvider)

[`UILargeContentViewerItem`](/documentation/UIKit/UILargeContentViewerItem)

[`UIActivityItemsConfigurationProviding`](/documentation/UIKit/UIActivityItemsConfigurationProviding)

[`CLBodyIdentifiable`](/documentation/CoreLocation/CLBodyIdentifiable)

[`UIDynamicItem`](/documentation/UIKit/UIDynamicItem)

[`UITraitEnvironment`](/documentation/UIKit/UITraitEnvironment)

[`CALayerDelegate`](/documentation/QuartzCore/CALayerDelegate)

### Inherits From

[`UIWindow`](/documentation/UIKit/UIWindow)

---

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)