Added in [API level 16](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Inherited Fields](https://developer.android.com/reference/android/app/Notification.BigPictureStyle#inhfields) \| [Ctors](https://developer.android.com/reference/android/app/Notification.BigPictureStyle#pubctors) \| [Methods](https://developer.android.com/reference/android/app/Notification.BigPictureStyle#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/app/Notification.BigPictureStyle#inhmethods)

# Notification.BigPictureStyle

*** ** * ** ***


`
public
static


class
Notification.BigPictureStyle
`


`


`

`

extends https://developer.android.com/reference/android/app/Notification.Style


`

`


`

|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||
| ↳ | [android.app.Notification.Style](https://developer.android.com/reference/android/app/Notification.Style) ||
|   | ↳ | android.app.Notification.BigPictureStyle |

<br />

*** ** * ** ***

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

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

```
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();
```

<br />

**See also:**

- `https://developer.android.com/reference/android/app/Notification#bigContentView`

## Summary

### Inherited fields

From class `https://developer.android.com/reference/android/app/Notification.Style` `
protected


https://developer.android.com/reference/android/app/Notification.Builder` `https://developer.android.com/reference/android/app/Notification.Style#mBuilder`


| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/app/Notification.BigPictureStyle#BigPictureStyle()() ` |
| ` https://developer.android.com/reference/android/app/Notification.BigPictureStyle#BigPictureStyle(android.app.Notification.Builder)(https://developer.android.com/reference/android/app/Notification.Builder builder) ` *This constructor is deprecated. use `BigPictureStyle()`.* |

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

### Inherited methods

From class `

https://developer.android.com/reference/android/app/Notification.Style

` `


https://developer.android.com/reference/android/app/Notification` `
https://developer.android.com/reference/android/app/Notification.Style#build()()
`

Calls `https://developer.android.com/reference/android/app/Notification.Builder#build()` on the Builder this Style is
attached to.


`


void` `
https://developer.android.com/reference/android/app/Notification.Style#checkBuilder()()
` `


https://developer.android.com/reference/android/widget/RemoteViews` `
https://developer.android.com/reference/android/app/Notification.Style#getStandardView(int)(int layoutId)
` `


void` `
https://developer.android.com/reference/android/app/Notification.Style#internalSetBigContentTitle(java.lang.CharSequence)(https://developer.android.com/reference/java/lang/CharSequence title)
`

Overrides ContentTitle in the expanded form of the template.


`


void` `
https://developer.android.com/reference/android/app/Notification.Style#internalSetSummaryText(java.lang.CharSequence)(https://developer.android.com/reference/java/lang/CharSequence cs)
`

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


`


void` `
https://developer.android.com/reference/android/app/Notification.Style#setBuilder(android.app.Notification.Builder)(https://developer.android.com/reference/android/app/Notification.Builder builder)
` From class `

https://developer.android.com/reference/java/lang/Object

` `


https://developer.android.com/reference/java/lang/Object` `
https://developer.android.com/reference/java/lang/Object#clone()()
`

Creates and returns a copy of this object.


`


boolean` `
https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj)
`

Indicates whether some other object is "equal to" this one.


`


void` `
https://developer.android.com/reference/java/lang/Object#finalize()()
`

Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.


`


final

https://developer.android.com/reference/java/lang/Class<?>` `
https://developer.android.com/reference/java/lang/Object#getClass()()
`

Returns the runtime class of this `Object`.


`


int` `
https://developer.android.com/reference/java/lang/Object#hashCode()()
`

Returns a hash code value for the object.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#notify()()
`

Wakes up a single thread that is waiting on this object's
monitor.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#notifyAll()()
`

Wakes up all threads that are waiting on this object's monitor.


`


https://developer.android.com/reference/java/lang/String` `
https://developer.android.com/reference/java/lang/Object#toString()()
`

Returns a string representation of the object.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos)
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis)
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*, or until a
certain amount of real time has elapsed.


`


final

void` `
https://developer.android.com/reference/java/lang/Object#wait()()
`

Causes the current thread to wait until it is awakened, typically
by being *notified* or *interrupted*.


## Public constructors

### BigPictureStyle

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

```
public BigPictureStyle ()
```

<br />

<br />

### BigPictureStyle

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

```
public BigPictureStyle (Notification.Builder builder)
```


**This constructor is deprecated.**   

use `BigPictureStyle()`.

<br />

<br />

| Parameters ||
|---|---|
| `builder` | `Notification.Builder` <br /> |

## Public methods

### bigLargeIcon

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

```
public Notification.BigPictureStyle bigLargeIcon (Bitmap b)
```

Override the large icon when the expanded notification is shown.

<br />

| Parameters ||
|---|---|
| `b` | `Bitmap`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |

### bigLargeIcon

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

```
public Notification.BigPictureStyle bigLargeIcon (Icon icon)
```

Override the large icon when the expanded notification is shown.

<br />

| Parameters ||
|---|---|
| `icon` | `Icon`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |

### bigPicture

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

```
public Notification.BigPictureStyle bigPicture (Bitmap b)
```

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

<br />

| Parameters ||
|---|---|
| `b` | `Bitmap`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |

### bigPicture

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

```
public Notification.BigPictureStyle bigPicture (Icon icon)
```

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

<br />

| Parameters ||
|---|---|
| `icon` | `Icon`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |

### setBigContentTitle

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

```
public Notification.BigPictureStyle setBigContentTitle (CharSequence title)
```

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

<br />

| Parameters ||
|---|---|
| `title` | `CharSequence`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |

### setContentDescription

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

```
public Notification.BigPictureStyle setContentDescription (CharSequence contentDescription)
```

Set the content description of the big picture.

<br />

| Parameters ||
|---|---|
| `contentDescription` | `CharSequence`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |

### setSummaryText

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

```
public Notification.BigPictureStyle setSummaryText (CharSequence cs)
```

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

<br />

| Parameters ||
|---|---|
| `cs` | `CharSequence`: This value may be `null`. <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |

### showBigPictureWhenCollapsed

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

```
public Notification.BigPictureStyle showBigPictureWhenCollapsed (boolean show)
```

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

<br />

| Parameters ||
|---|---|
| `show` | `boolean` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/app/Notification.BigPictureStyle` | This value cannot be `null`. <br /> |