Instance Method

registerUserNotificationSettings:

Registers your preferred options for notifying the user.

Declaration

- (void)registerUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings;

Parameters

notificationSettings

The types of notifications that your app wants to use. You also use this object to specify custom actions that can be initiated by the user from an alert displayed in response to a local or remote notification.

Discussion

If your app displays alerts, play sounds, or badges its icon, you must call this method during your launch cycle to request permission to alert the user in these ways. (You must also make this request if you want to set the applicationIconBadgeNumber property directly.) Typically, you make this request if your app uses local or remote notifications to alert the user to new information involving your app. The first time your app launches and calls this method, the system asks the user whether your app should be allowed to deliver notifications and stores the response. Thereafter, the system uses the stored response to determine the actual types of notifications you may use.

After calling this method, the app calls the application:didRegisterUserNotificationSettings: method of its app delegate to report the results. You can use that method to determine if your request was granted or denied by the user.

It is recommended that you call this method before you schedule any local notifications or register with the push notification service. Apps that support custom actions must include all of their supported actions in the notificationSettings object.

See Also

Deprecated Symbols

- setMinimumBackgroundFetchInterval:

Specifies the minimum amount of time that must elapse between background fetch operations.

Deprecated
statusBarOrientationAnimationDuration

The animation duration in seconds for the status bar during a 90 degree orientation change.

Deprecated
UIApplicationDidChangeStatusBarFrameNotification

Posted when the frame of the status bar changes.

Deprecated
UIApplicationDidChangeStatusBarOrientationNotification

Posted when the orientation of the app’s user interface changes.

Deprecated
UIApplicationWillChangeStatusBarOrientationNotification

Posted when the app is about to change the orientation of its interface.

Deprecated
UIApplicationWillChangeStatusBarFrameNotification

Posted when the app is about to change the frame of the status bar.

Deprecated
UIApplicationStatusBarOrientationUserInfoKey

A key whose value is an NSNumber object that encapsulates a UIInterfaceOrientation value indicating the current orientation (see UIInterfaceOrientation). This key is used with UIApplicationDidChangeStatusBarOrientationNotification and UIApplicationWillChangeStatusBarOrientationNotification notifications.

Deprecated
UIApplicationStatusBarFrameUserInfoKey

A key whose value is an NSValue object that encapsulates a CGRect structure expressing the location and size of the new status bar frame. This key is used with UIApplicationDidChangeStatusBarFrameNotification and UIApplicationWillChangeStatusBarFrameNotification notifications.

Deprecated
statusBarFrame

The frame rectangle defining the area of the status bar.

Deprecated
networkActivityIndicatorVisible

A Boolean value that turns an indicator of network activity on or off.

Deprecated
UIMinimumKeepAliveTimeout

The minimum amount of time (measured in seconds) an app may run a critical background task in the background.

Deprecated
currentUserNotificationSettings

Returns the user notification settings for the app.

Deprecated
UIRemoteNotificationType

Constants indicating the types of notifications the app may display to the user.

Deprecated
- openURL:

Attempts to open the resource at the specified URL.

Deprecated
- scheduleLocalNotification:

Schedules a local notification for delivery at its encapsulated date and time.

Deprecated
- presentLocalNotificationNow:

Presents a local notification immediately.

Deprecated
- cancelLocalNotification:

Cancels the delivery of the specified scheduled local notification.

Deprecated
- cancelAllLocalNotifications

Cancels the delivery of all scheduled local notifications.

Deprecated
scheduledLocalNotifications

All currently scheduled local notifications.

Deprecated
- setNewsstandIconImage:

Sets the icon of a Newsstand app to an image depicting the current issue of a publication.

Deprecated
- setKeepAliveTimeout:handler:

Configures a periodic handler for VoIP apps in older versions of iOS.

Deprecated
- clearKeepAliveTimeout

Removes a previously installed periodic handler block.

Deprecated
- setStatusBarHidden:withAnimation:

Hides or shows the status bar, optionally animating the transition.

Deprecated
statusBarHidden

A Boolean value that determines whether the status bar is hidden.

Deprecated
- setStatusBarStyle:animated:

Sets the style of the status bar, optionally animating the transition to the new style.

Deprecated
statusBarStyle

The current style of the status bar.

Deprecated
- setStatusBarOrientation:animated:

Sets the app's status bar to the specified orientation, optionally animating the transition.

Deprecated
statusBarOrientation

The current orientation of the app's status bar.

Deprecated
- registerForRemoteNotificationTypes:

Register to receive remote notifications of the specified types via Apple Push Notification service.

Deprecated
- enabledRemoteNotificationTypes

Returns the types of notifications the app accepts.

Deprecated
proximitySensingEnabled

A Boolean value that determines whether proximity sensing is enabled.

Deprecated
- setStatusBarHidden:animated:

Hides or shows the status bar, optionally animating the transition.

Deprecated

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software