mirror of https://github.com/moparisthebest/k-9
39 lines
1.3 KiB
Java
39 lines
1.3 KiB
Java
package com.fsck.k9.activity.misc;
|
|
|
|
import android.app.Activity;
|
|
|
|
|
|
public interface NonConfigurationInstance {
|
|
/**
|
|
* Decide whether to retain this {@code NonConfigurationInstance} and clean up resources if
|
|
* necessary.
|
|
*
|
|
* <p>
|
|
* This needs to be called when the current activity is being destroyed during an activity
|
|
* restart due to a configuration change.<br>
|
|
* Implementations should make sure that references to the {@code Activity} instance that is
|
|
* about to be destroyed are cleared to avoid memory leaks. This includes all UI elements that
|
|
* are bound to an activity (e.g. dialogs). They can be re-created in
|
|
* {@link #restore(Activity)}.
|
|
* </p>
|
|
*
|
|
* @return {@code true} if this instance should be retained; {@code false} otherwise.
|
|
*
|
|
* @see Activity#onRetainNonConfigurationInstance()
|
|
*/
|
|
public boolean retain();
|
|
|
|
/**
|
|
* Connect this retained {@code NonConfigurationInstance} to the new {@link Activity} instance
|
|
* after the activity was restarted due to a configuration change.
|
|
*
|
|
* <p>
|
|
* This also creates a new progress dialog that is bound to the new activity.
|
|
* </p>
|
|
*
|
|
* @param activity
|
|
* The new {@code Activity} instance. Never {@code null}.
|
|
*/
|
|
public void restore(Activity activity);
|
|
}
|