Class

# NotificationResponseCategory

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

## Description

A group of buttons/and or textfields that allow the user a way to respond to a notification directly without having to bring the app to the foreground.

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                                                                                  | Type                                                                                       | Read-Only | Shared |
|---------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|-----------|--------|
| `Actions()<notificationresponsecategory.actions()>`                                   | `NotificationResponseAction</api/user_interface/notifications/notificationresponseaction>` |           |        |
| `AllowAnnouncement<notificationresponsecategory.allowannouncement>`                   | `Boolean</api/data_types/boolean>`                                                         |           |        |
| `AllowInCarPlay<notificationresponsecategory.allowincarplay>`                         | `Boolean</api/data_types/boolean>`                                                         |           |        |
| `CustomDismiss<notificationresponsecategory.customdismiss>`                           | `Boolean</api/data_types/boolean>`                                                         |           |        |
| `HiddenPreviewsBody<notificationresponsecategory.hiddenpreviewsbody>`                 | `String</api/data_types/string>`                                                           |           |        |
| `HiddenPreviewShowsSubtitle<notificationresponsecategory.hiddenpreviewshowssubtitle>` | `Boolean</api/data_types/boolean>`                                                         |           |        |
| `HiddenPreviewShowsTitle<notificationresponsecategory.hiddenpreviewshowstitle>`       | `Boolean</api/data_types/boolean>`                                                         |           |        |
| `Identifier<notificationresponsecategory.identifier>`                                 | `String</api/data_types/string>`                                                           |           |        |

## Methods

<div class="rst-class">

table-centered_column_4

</div>

| Name                                                     | Parameters                                     | Returns | Shared |
|----------------------------------------------------------|------------------------------------------------|---------|--------|
| `Constructor<notificationresponsecategory.constructor0>` | identifier As `String</api/data_types/string>` |         |        |

## Property descriptions

<div id="notificationresponsecategory.actions()">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.Actions()

**Actions()** As `NotificationResponseAction</api/user_interface/notifications/notificationresponseaction>`

> The list of actions the user can take in response to the notification.
>
> The list of actions your app provides will be truncated by iOS if there's insufficient space in which to display them all. Thus, place the most important actions first.
>
> Create a <span class="title-ref">NotificationResponseCategory</span> then add a button to it:
>
> ``` xojo
> Var pizzaCategory As New NotificationResponseCategory("pizzaSale")
> Var orderButton As New NotificationResponseButton("Order Now!", "order")
> pizzaCategory.Actions.Add(orderButton)
> ```

<div id="notificationresponsecategory.allowannouncement">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.AllowAnnouncement

**AllowAnnouncement** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, notifications will automatically be read by Siri when the user is using AirPods.

<div id="notificationresponsecategory.allowincarplay">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.AllowInCarPlay

**AllowInCarPlay** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, notifications using this object will be displayed in CarPlay.

<div id="notificationresponsecategory.customdismiss">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.CustomDismiss

**CustomDismiss** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, send dismiss actions to the `NotificationCenter.UserResponded<mobilenotifications.userresponded>` event for handling.

<div id="notificationresponsecategory.hiddenpreviewsbody">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.HiddenPreviewsBody

**HiddenPreviewsBody** As `String</api/data_types/string>`

> Placeholder text to be shown even if the user has disabled notification previews for the app.

<div id="notificationresponsecategory.hiddenpreviewshowssubtitle">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.HiddenPreviewShowsSubtitle

**HiddenPreviewShowsSubtitle** As `Boolean</api/data_types/boolean>`

> Shows the notification's subtitle even if the user has disabled notification previews for the app.

<div id="notificationresponsecategory.hiddenpreviewshowstitle">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.HiddenPreviewShowsTitle

**HiddenPreviewShowsTitle** As `Boolean</api/data_types/boolean>`

> Shows the notification's title even if the user has disabled notification previews for the app.

<div id="notificationresponsecategory.identifier">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.Identifier

**Identifier** As `String</api/data_types/string>`

> The unique set of characters assigned to the category.

## Method descriptions

<div id="notificationresponsecategory.constructor0">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

NotificationResponseCategory.Constructor

**Constructor**(identifier As `String</api/data_types/string>`)

> <div class="note">
>
> <div class="title">
>
> Note
>
> </div>
>
> `Constructors</api/language/constructor>` are special methods called when you create an object with the `New</api/language/new>` keyword and pass in the parameters above.
>
> </div>
>
> Creates a new <span class="title-ref">NotificationResponseCategory</span> with the *identifier* passed.
>
> ``` xojo
> Var pizzaCategory = New NotificationResponseCategory("pizzaSale")
> ```

## Notes

The list of actions your app provides will be truncated by iOS if there's insufficient space in which to display them all. Thus, place the most important actions first.

## Compatibility

|                       |        |
|-----------------------|--------|
| **Project Types**     | Mobile |
| **Operating Systems** | iOS    |

<div class="seealso">

`Object</api/data_types/additional_types/object>` parent class; `MobileNotifications.AddResponseCategory<mobilenotifications.addresponsecategory>` and `MobileNotifications.RemoveAllResponseCategories<mobilenotifications.removeallresponsecategories>` methods.

</div>