Function

CFUserNotificationCancel

Cancels a user notification dialog.

Declaration

SInt32 CFUserNotificationCancel(CFUserNotificationRef userNotification);

Parameters

userNotification

The user notification to cancel.

Return Value

0 if the cancel was successful; a non-0 value otherwise.

Discussion

You must cancel a user notification if you want to remove its dialog from the screen before the user dismisses it. It is not sufficient to just release the object.

See Also

CFUserNotification Miscellaneous Functions

CFUserNotificationCheckBoxChecked

Returns a flag used to set or test a checkbox’s state.

CFUserNotificationCreate

Creates a CFUserNotification object and displays its notification dialog on screen.

CFUserNotificationCreateRunLoopSource

Creates a run loop source for a user notification.

CFUserNotificationDisplayAlert

Displays a user notification dialog and waits for a user response.

CFUserNotificationDisplayNotice

Displays a user notification dialog that does not need a user response.

CFUserNotificationGetResponseDictionary

Returns the dictionary containing all the text field values from a dismissed notification dialog.

CFUserNotificationGetResponseValue

Extracts the values of the text fields from a dismissed notification dialog.

CFUserNotificationGetTypeID

Returns the type identifier for the CFUserNotification opaque type.

CFUserNotificationPopUpSelection

Returns a flag used to set the selected element of a pop-up menu.

CFUserNotificationReceiveResponse

Waits for the user to respond to a notification or for the notification to time out.

CFUserNotificationSecureTextField

Returns a flag used to set the secure state of a text field.

CFUserNotificationUpdate

Updates a displayed user notification dialog with new user interface information.