Type Property

willDeactivateNotification

A notification indicating that the scene is about to resign the active state and stop responding to user events.

Declaration

class let willDeactivateNotification: NSNotification.Name

Discussion

UIKit posts this notification for temporary interruptions, such as when displaying system alerts. It also posts this notification before transitioning your app to the background state. UIKit places the scene object in the object property of the notification.

Use this notification to quiet your interface and prepare it to stop interacting with the user. Specifically, pause ongoing tasks, disable timers, and decrease frame rates or stop updating your interface altogether. Games should use this notification to pause the game. By the time your handler method returns, your app should be doing minimal work while it waits to transition to the background or to the foreground again.

If your scene has unsaved user data, save that data here to ensure that it isn't lost. However, never save data solely from your notification handler. Instead, save it at appropriate points from your view controllers, usually in response to user actions. For example, save data when the user dismisses a data-entry screen. Do not rely on specific app transitions to save all of your app's critical data.

UIKit also calls the sceneWillResignActive(_:) method of your scene delegate object.

For more information about what to do when your app resigns the active state, see Preparing Your UI to Run in the Background.

See Also

Responding to Life Cycle Notifications

class let willConnectNotification: NSNotification.Name

A notification indicating that UIKit added a scene to your app.

Beta
class let didDisconnectNotification: NSNotification.Name

A notification indicating that UIKit removed a scene from your app.

Beta
class let willEnterForegroundNotification: NSNotification.Name

A notification indicating that a scene is about to begin running in the foreground and become visible to the user.

Beta
class let didActivateNotification: NSNotification.Name

A notification indicating that the scene is now onscreen and responding to user events.

Beta
class let didEnterBackgroundNotification: NSNotification.Name

A notification indicating that the scene is running in the background and is no longer onscreen.

Beta

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