---
title: QLPreviewPanel
framework: quicklookui
role: symbol
role_heading: Class
path: quicklookui/qlpreviewpanel
---

# QLPreviewPanel

A class that implements the Quick Look preview panel to display a preview of a list of items.

## Declaration

```swift
class QLPreviewPanel
```

## Overview

Overview Every application has a single shared instance of QLPreviewPanel accessible through shared(). The preview panel follows the responder chain and adapts to the first responder willing to control it. A preview panel controller provides the content through methods defined in the QLPreviewPanelDataSource protocol. You can’t subclass QLPreviewPanel; you can, however, customize its behavior using a delegate. See the QLPreviewPanelDelegate protocol for the methods to customize a preview panel’s behavior.

## Topics

### Accessing the Shared Panel

- [shared()](quicklookui/qlpreviewpanel/shared().md)
- [sharedPreviewPanelExists()](quicklookui/qlpreviewpanel/sharedpreviewpanelexists().md)

### Accessing the Preview Panel Controller

- [currentController](quicklookui/qlpreviewpanel/currentcontroller.md)
- [updateController()](quicklookui/qlpreviewpanel/updatecontroller().md)

### Managing the Preview Items

- [dataSource](quicklookui/qlpreviewpanel/datasource.md)
- [reloadData()](quicklookui/qlpreviewpanel/reloaddata().md)
- [refreshCurrentPreviewItem()](quicklookui/qlpreviewpanel/refreshcurrentpreviewitem().md)
- [currentPreviewItemIndex](quicklookui/qlpreviewpanel/currentpreviewitemindex.md)
- [currentPreviewItem](quicklookui/qlpreviewpanel/currentpreviewitem.md)
- [displayState](quicklookui/qlpreviewpanel/displaystate.md)

### The Panel’s Delegate

- [delegate](quicklookui/qlpreviewpanel/delegate.md)

### Managing Full Screen Mode

- [enterFullScreenMode(_:withOptions:)](quicklookui/qlpreviewpanel/enterfullscreenmode(_:withoptions:).md)
- [exitFullScreenMode(options:)](quicklookui/qlpreviewpanel/exitfullscreenmode(options:).md)
- [isInFullScreenMode](quicklookui/qlpreviewpanel/isinfullscreenmode.md)

## Relationships

### Inherits From

- [NSPanel](appkit/nspanel.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSAccessibilityElementProtocol](appkit/nsaccessibilityelementprotocol.md)
- [NSAccessibilityProtocol](appkit/nsaccessibilityprotocol.md)
- [NSAnimatablePropertyContainer](appkit/nsanimatablepropertycontainer.md)
- [NSAppearanceCustomization](appkit/nsappearancecustomization.md)
- [NSCoding](foundation/nscoding.md)
- [NSMenuItemValidation](appkit/nsmenuitemvalidation.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSStandardKeyBindingResponding](appkit/nsstandardkeybindingresponding.md)
- [NSTouchBarProvider](appkit/nstouchbarprovider.md)
- [NSUserActivityRestoring](appkit/nsuseractivityrestoring.md)
- [NSUserInterfaceItemIdentification](appkit/nsuserinterfaceitemidentification.md)
- [NSUserInterfaceValidations](appkit/nsuserinterfacevalidations.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Previews

- [QLPreviewView](quicklookui/qlpreviewview.md)
- [QLPreviewItem](quicklookui/qlpreviewitem.md)
- [QLPreviewPanelDataSource](quicklookui/qlpreviewpaneldatasource.md)
- [QLPreviewPanelDelegate](quicklookui/qlpreviewpaneldelegate.md)
- [QLPreviewItemLoadingBlock](quicklookui/qlpreviewitemloadingblock.md)