Platforms to show: All Mac Windows Linux Cross-Platform

Back to NSUserNotificationMBS class.

NSUserNotificationMBS.actionButtonTitle as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies the title of the action button displayed in the notification.

This value should localized as it will be presented to the user. The string will be truncated to a length appropriate for display and the property will be modified to reflect the truncation.

Available in OS X v10.8 and later.
(Read and Write property)

Some examples using this property:

NSUserNotificationMBS.activationType as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies what caused a user notification to occur.

This property specifies why the user notification was sent to to the NSUserNotificationCenterDelegateMBS didActivateNotification event. The supported values are described in constants.

Available in OS X v10.8 and later.
(Read only property)

Some examples using this property:

NSUserNotificationMBS.actualDeliveryDate as date

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
The date this notification was actually delivered.

The notification center will set this value if a notification is put in the scheduled list and the delivery time arrives.

If the notification is delivered directly using the deliverNotification: method of the NSUserNotificationCenterMBS class, this value will be set to the deliveryDate value. If the deliveryDate value nil this value is set to the current date.

This value is used to sort the list of notifications in the user interface.

Available in OS X v10.8 and later.
(Read only property)

NSUserNotificationMBS.actualDeliveryDateTime as DateTime

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 20.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
The date this notification was actually delivered.

The notification center will set this value if a notification is put in the scheduled list and the delivery time arrives.

If the notification is delivered directly using the deliverNotification: method of the NSUserNotificationCenterMBS class, this value will be set to the deliveryDate value. If the deliveryDate value nil this value is set to the current date.

This value is used to sort the list of notifications in the user interface.

Available in OS X v10.8 and later.
(Read only property)

NSUserNotificationMBS.additionalActivationAction as NSUserNotificationActionMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 14.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Queries which additional action was selected.

For Mac OS X 10.10 and newer. Will not cause exception if called on older versions, but always return nil.

When a user selects an additional action that action will be set on the notification's additionalActivationAction property when passed into the delegate event didActivateNotification.
(Read only property)

NSUserNotificationMBS.contentImage as NSImageMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 13.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Image shown in the content of the notification.

(Read and Write property)

NSUserNotificationMBS.deliveryDate as date

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies when the notification should be delivered.

The delivery date is specified in an absolute time.
After a notification is delivered, it may be presented to the user.
Available in OS X v10.8 and later.
(Read and Write property)

Some examples using this property:

NSUserNotificationMBS.deliveryDateTime as DateTime

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 20.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies when the notification should be delivered.

The delivery date is specified in an absolute time.
After a notification is delivered, it may be presented to the user.
Available in OS X v10.8 and later.
(Read and Write property)

NSUserNotificationMBS.deliveryRepeatInterval as NSDateComponentsMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies the date components that control how often a user notification is repeated.

This value may be nil if the notification should not repeat.

The date component values are relative to the date the notification was delivered.

If the calendar value of the deliveryRepeatInterval is nil, the current calendar will be used to calculate the repeat interval. For example, if a notification should repeat every hour, set the hour property of the deliveryRepeatInterval to 1.

This value is ignored unless the user notification is scheduled with the NSUserNotificationCenterMBS object.
Available in OS X v10.8 and later.
(Read and Write property)

NSUserNotificationMBS.deliveryTimeZone as NSTimeZoneMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specify the time zone to interpret the delivery date in.

If this value is nil and the user switches time zones, the notification center will adjust the time of presentation to account for the time zone change.

If a notification should be delivered at a time in a specific time zone (regardless of whether the user switches time zones), set this value to the specific time zone, for example the current time zone.

Available in OS X v10.8 and later.
(Read and Write property)

NSUserNotificationMBS.description as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Description of notification object for debugging.

(Read only property)

NSUserNotificationMBS.Handle as Integer

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
The internal object reference.

(Read and Write property)

NSUserNotificationMBS.hasActionButton as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies whether the notification displays an action button.

Set to false if the notification has no action button. This will be the case for notifications that are purely for informational purposes and have no user action.

The default value is true.

Available in OS X v10.8 and later.
(Read and Write property)

Some examples using this property:

NSUserNotificationMBS.hasReplyButton as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 13.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Set to true if the notification has a reply button.

The default value is false. If both this and hasActionButton are true, the reply button will be shown.
(Read and Write property)

NSUserNotificationMBS.identifier as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 13.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
This identifier is used to uniquely identify a notification.

A notification delivered with the same identifier as an existing notification will replace that notification, rather then display a new one.

Available in OS X 10.9 and newer.
(Read and Write property)

NSUserNotificationMBS.informativeText as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
The body text of the notification.

This value should localized as it will be presented to the user. The string will be truncated to a length appropriate for display and the property will be modified to reflect the truncation.
Available in OS X v10.8 and later.
(Read and Write property)

NSUserNotificationMBS.otherButtonTitle as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies a custom title for the close button in an alert-style notification.

This value should localized as it will be presented to the user. The string will be truncated to a length appropriate for display and the property will be modified to reflect the truncation.

An empty string will cause the default localized text to be used.

Available in OS X v10.8 and later.
(Read and Write property)

Some examples using this property:

NSUserNotificationMBS.Presented as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies whether the user notification has been presented.

In some cases, for example when your application is frontmost, the notification center may decide not to actually present a delivered notification. In that case, the value of this property will be false. It will be set to true if the notification was presented according to user preferences.

Available in OS X v10.8 and later.
(Read only property)

NSUserNotificationMBS.remote as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies whether the remote was generated by a push notification.

If this property is true then the user notification was generated by a push notification (that is, remotely); if false it was generated locally.
Available in OS X v10.8 and later.
(Read only property)

NSUserNotificationMBS.response as NSAttributedStringMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 13.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
The response text.

When a notification has been responded to, the NSUserNotificationCenter event didActivateNotification will be called with the notification with the activationType set to NSUserNotificationActivationTypeReplied and the response set on the response property.
(Read only property)

NSUserNotificationMBS.responsePlaceholder as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 13.5 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Optional placeholder for inline reply field.

(Read and Write property)

NSUserNotificationMBS.soundName as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies the name of the sound to play when the notification is delivered.

Passing the NSUserNotificationDefaultSoundName constant causes the default notification center sound to be played.
A value of nil means no sound is played.
Available in OS X v10.8 and later.
(Read and Write property)

NSUserNotificationMBS.subtitle as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies the subtitle of the notification.

This value should localized as it will be presented to the user. The string will be truncated to a length appropriate for display and the property will be modified to reflect the truncation.
Available in OS X v10.8 and later.
(Read and Write property)

NSUserNotificationMBS.title as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Specifies the title of the notification.

This value should localized as it will be presented to the user. The string will be truncated to a length appropriate for display and the property will be modified to reflect the truncation.
Available in OS X v10.8 and later.
(Read and Write property)

NSUserNotificationMBS.userInfo as dictionary

Type Topic Plugin Version macOS Windows Linux iOS Targets
property User Notifications MBS MacFrameworks Plugin 12.3 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Application-specific user info that can be attached to the notification.
Example
dim u as new NSUserNotificationMBS
dim d as new dictionary
d.value("Key") = "Value"
u.userinfo = d

All items must be property list types or an exception will be thrown.
The userInfo content must be of reasonable serialized size (less than 1k) or an exception will be thrown.
Available in OS X v10.8 and later.
(Read and Write property)

The items on this page are in the following plugins: MBS MacFrameworks Plugin.


The biggest plugin in space...