---
title: CPMessageListItemLeadingConfiguration
framework: carplay
role: symbol
role_heading: Class
path: carplay/cpmessagelistitemleadingconfiguration
---

# CPMessageListItemLeadingConfiguration

An object that describes the appearance of a message list item’s leading region.

## Declaration

```swift
class CPMessageListItemLeadingConfiguration
```

## Overview

Overview Use a leading configuration to describe the visual elements that a message list item’s leading region contains. The region can show a CPMessageLeadingItem, an image, and an unread indicator. Configurations are immutable. To modify the list item’s leading configuration, update its leadingConfiguration property with a new configuration. CarPlay detects the change and redraws the message list item.

## Topics

### Creating a Configuration

- [init(leadingItem:leadingImage:unread:)](carplay/cpmessagelistitemleadingconfiguration/init(leadingitem:leadingimage:unread:).md)
- [CPMaximumMessageItemImageSize](carplay/cpmaximummessageitemimagesize.md)

### Getting the Leading Item

- [leadingItem](carplay/cpmessagelistitemleadingconfiguration/leadingitem.md)
- [CPMessageLeadingItem](carplay/cpmessageleadingitem.md)

### Getting the Configuration’s State

- [leadingImage](carplay/cpmessagelistitemleadingconfiguration/leadingimage.md)
- [isUnread](carplay/cpmessagelistitemleadingconfiguration/isunread.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Managing Leading and Trailing Configurations

- [leadingConfiguration](carplay/cpmessagelistitem/leadingconfiguration.md)
- [trailingConfiguration](carplay/cpmessagelistitem/trailingconfiguration.md)
- [CPMessageListItemTrailingConfiguration](carplay/cpmessagelistitemtrailingconfiguration.md)