# Notification.BigPictureStyle

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# BigPictureStyle

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/app/Notification.BigPictureStyle "View this page in Java")  

```
open class BigPictureStyle : Notification.Style
```

|---|---|--------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                          |||
| ↳ | [android.app.Notification.Style](https://developer.android.com/reference/kotlin/android/app/Notification.Style)                         ||
|   | ↳ | [android.app.Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) |

Helper class for generating large-format notifications that include a large image attachment.

Here's how you'd set the`BigPictureStyle`on a notification:  

```kotlin
Notification notif = new Notification.Builder(mContext)
      .setContentTitle("New photo from " + sender.toString())
      .setContentText(subject)
      .setSmallIcon(R.drawable.new_post)
      .setLargeIcon(aBitmap)
      .setStyle(new Notification.BigPictureStyle()
          .bigPicture(aBigBitmap))
      .build();
  
```

## Summary

|                                                                                                                                       Public constructors                                                                                                                                       ||
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#BigPictureStyle())`()` <br />                                                                                                                                                      |
| [BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#BigPictureStyle(android.app.Notification.Builder))`(`builder:` `[Notification.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Builder)!`)` <br /> |

|                                                                                                                                                                                                                                                                                                                                                                                             Public methods                                                                                                                                                                                                                                                                                                                                                                                             ||
|------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [bigLargeIcon](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#bigLargeIcon(android.graphics.Bitmap))`(`b:` `[Bitmap](https://developer.android.com/reference/kotlin/android/graphics/Bitmap.html#)?`)` Override the large icon when the expanded notification is shown.                                                                                                                                                                                                                                                                                                                                                         |
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [bigLargeIcon](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#bigLargeIcon(android.graphics.drawable.Icon))`(`icon:` `[Icon](https://developer.android.com/reference/kotlin/android/graphics/drawable/Icon.html#)?`)` Override the large icon when the expanded notification is shown.                                                                                                                                                                                                                                                                                                                                          |
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [bigPicture](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap))`(`b:` `[Bitmap](https://developer.android.com/reference/kotlin/android/graphics/Bitmap.html#)?`)` Provide the bitmap to be used as the payload for the BigPicture notification.                                                                                                                                                                                                                                                                                                                                                |
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [bigPicture](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.drawable.Icon))`(`icon:` `[Icon](https://developer.android.com/reference/kotlin/android/graphics/drawable/Icon.html#)?`)` Provide the content Uri to be used as the payload for the BigPicture notification.                                                                                                                                                                                                                                                                                                                            |
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [setBigContentTitle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#setBigContentTitle(kotlin.CharSequence))`(`title:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?`)` Overrides ContentTitle in the expanded form of the template.                                                                                                                                                                                                                                                                                                                                          |
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [setContentDescription](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#setContentDescription(kotlin.CharSequence))`(`contentDescription:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?`)` Set the content description of the big picture.                                                                                                                                                                                                                                                                                                                                    |
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [setSummaryText](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#setSummaryText(kotlin.CharSequence))`(`cs:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?`)` Set the first line of text after the detail section in the expanded form of the template.                                                                                                                                                                                                                                                                                                                        |
| open[Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | [showBigPictureWhenCollapsed](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#showBigPictureWhenCollapsed(kotlin.Boolean))`(`show:` `[Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)`)` When set, the[big picture](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap))of this style will be promoted and shown in place of the[large icon](https://developer.android.com/reference/kotlin/android/app/Notification.Builder#setLargeIcon(android.graphics.drawable.Icon))in the collapsed state of this notification. |

| Inherited functions ||
|---|---|
| From class[Style](https://developer.android.com/reference/kotlin/android/app/Notification.Style) |-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Notification](https://developer.android.com/reference/kotlin/android/app/Notification)!        | [build](https://developer.android.com/reference/kotlin/android/app/Notification.Style#build())`()` <br /> Calls[android.app.Notification.Builder#build()](https://developer.android.com/reference/kotlin/android/app/Notification.Builder#build())on the Builder this Style is attached to. Note: Calling build() multiple times returns the same Notification instance, so reusing a builder to create multiple Notifications is discouraged. <br /> | | [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)                    | [checkBuilder](https://developer.android.com/reference/kotlin/android/app/Notification.Style#checkBuilder())`()` <br />                                                                                                                                                                                                                                                                                                                               | | [RemoteViews](https://developer.android.com/reference/kotlin/android/widget/RemoteViews.html#)! | [getStandardView](https://developer.android.com/reference/kotlin/android/app/Notification.Style#getStandardView(kotlin.Int))`(`layoutId:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` <br />                                                                                                                                                                                                                       | | [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)                    | [internalSetBigContentTitle](https://developer.android.com/reference/kotlin/android/app/Notification.Style#internalSetBigContentTitle(kotlin.CharSequence))`(`title:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`)` <br /> Overrides ContentTitle in the expanded form of the template. This defaults to the value passed to setContentTitle(). <br />                                           | | [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)                    | [internalSetSummaryText](https://developer.android.com/reference/kotlin/android/app/Notification.Style#internalSetSummaryText(kotlin.CharSequence))`(`cs:` `[CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)!`)` <br /> Set the first line of text after the detail section in the expanded form of the template. <br />                                                                                 | | [Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)                    | [setBuilder](https://developer.android.com/reference/kotlin/android/app/Notification.Style#setBuilder(android.app.Notification.Builder))`(`builder:` `[Notification.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Builder)!`)` <br />                                                                                                                                                                              | ||

| Inherited properties ||
|---|---|
| From class[Style](https://developer.android.com/reference/kotlin/android/app/Notification.Style) |----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------| | [Notification.Builder](https://developer.android.com/reference/kotlin/android/app/Notification.Builder)! | [mBuilder](https://developer.android.com/reference/kotlin/android/app/Notification.Style#mBuilder:android.app.Notification.Builder) <br /> | ||

## Public constructors

### BigPictureStyle

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
BigPictureStyle()
```  

### BigPictureStyle

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
BigPictureStyle(builder: Notification.Builder!)
```

**Deprecated:** *use`BigPictureStyle()`.*

## Public methods

### bigLargeIcon

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun bigLargeIcon(b: Bitmap?): Notification.BigPictureStyle
```

Override the large icon when the expanded notification is shown.

|                                                      Parameters                                                       ||
|-----|------------------------------------------------------------------------------------------------------------------|
| `b` | [Bitmap](https://developer.android.com/reference/kotlin/android/graphics/Bitmap.html#)?:This value may be`null`. |

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |

### bigLargeIcon

Added in[API level 23](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun bigLargeIcon(icon: Icon?): Notification.BigPictureStyle
```

Override the large icon when the expanded notification is shown.

|                                                          Parameters                                                           ||
|--------|-----------------------------------------------------------------------------------------------------------------------|
| `icon` | [Icon](https://developer.android.com/reference/kotlin/android/graphics/drawable/Icon.html#)?:This value may be`null`. |

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |

### bigPicture

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun bigPicture(b: Bitmap?): Notification.BigPictureStyle
```

Provide the bitmap to be used as the payload for the BigPicture notification.

|                                                      Parameters                                                       ||
|-----|------------------------------------------------------------------------------------------------------------------|
| `b` | [Bitmap](https://developer.android.com/reference/kotlin/android/graphics/Bitmap.html#)?:This value may be`null`. |

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |

### bigPicture

Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun bigPicture(icon: Icon?): Notification.BigPictureStyle
```

Provide the content Uri to be used as the payload for the BigPicture notification.

|                                                          Parameters                                                           ||
|--------|-----------------------------------------------------------------------------------------------------------------------|
| `icon` | [Icon](https://developer.android.com/reference/kotlin/android/graphics/drawable/Icon.html#)?:This value may be`null`. |

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |

### setBigContentTitle

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun setBigContentTitle(title: CharSequence?): Notification.BigPictureStyle
```

Overrides ContentTitle in the expanded form of the template. This defaults to the value passed to setContentTitle().

|                                                            Parameters                                                            ||
|---------|-------------------------------------------------------------------------------------------------------------------------|
| `title` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?:This value may be`null`. |

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |

### setContentDescription

Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun setContentDescription(contentDescription: CharSequence?): Notification.BigPictureStyle
```

Set the content description of the big picture.

|                                                                  Parameters                                                                   ||
|----------------------|-------------------------------------------------------------------------------------------------------------------------|
| `contentDescription` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?:This value may be`null`. |

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |

### setSummaryText

Added in[API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun setSummaryText(cs: CharSequence?): Notification.BigPictureStyle
```

Set the first line of text after the detail section in the expanded form of the template.

|                                                          Parameters                                                           ||
|------|-------------------------------------------------------------------------------------------------------------------------|
| `cs` | [CharSequence](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html)?:This value may be`null`. |

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |

### showBigPictureWhenCollapsed

Added in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun showBigPictureWhenCollapsed(show: Boolean): Notification.BigPictureStyle
```

When set, the[big picture](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#bigPicture(android.graphics.Bitmap))of this style will be promoted and shown in place of the[large icon](https://developer.android.com/reference/kotlin/android/app/Notification.Builder#setLargeIcon(android.graphics.drawable.Icon))in the collapsed state of this notification.

|                                                                        Return                                                                         ||
|--------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [Notification.BigPictureStyle](https://developer.android.com/reference/kotlin/android/app/Notification.BigPictureStyle#) | This value cannot be`null`. |