Service.StopForeground Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
StopForeground(StopForegroundFlags) |
Remove this service from foreground state, allowing it to be killed if more memory is needed. |
StopForeground(Boolean) |
Legacy version of |
StopForeground(StopForegroundFlags)
Remove this service from foreground state, allowing it to be killed if more memory is needed.
[Android.Runtime.Register("stopForeground", "(I)V", "", ApiSince=24)]
public void StopForeground (Android.App.StopForegroundFlags flags);
[<Android.Runtime.Register("stopForeground", "(I)V", "", ApiSince=24)>]
member this.StopForeground : Android.App.StopForegroundFlags -> unit
Parameters
- flags
- StopForegroundFlags
additional behavior options.
- Attributes
Remarks
Remove this service from foreground state, allowing it to be killed if more memory is needed. This does not stop the service from running (for that you use #stopSelf()
or related methods), just takes it out of the foreground state.
If #STOP_FOREGROUND_REMOVE
is supplied, the service's associated notification will be cancelled immediately.
If #STOP_FOREGROUND_DETACH
is supplied, the service's association with the notification will be severed. If the notification had not yet been shown, due to foreground-service notification deferral policy, it is immediately posted when stopForeground(STOP_FOREGROUND_DETACH)
is called. In all cases, the notification remains shown even after this service is stopped fully and destroyed.
If zero
is passed as the argument, the result will be the legacy behavior as defined prior to Android L: the notification will remain posted until the service is fully stopped, at which time it will automatically be cancelled.
Java documentation for android.app.Service.stopForeground(int)
.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
Applies to
StopForeground(Boolean)
Legacy version of #stopForeground(int)
.
[Android.Runtime.Register("stopForeground", "(Z)V", "")]
public void StopForeground (bool removeNotification);
[<Android.Runtime.Register("stopForeground", "(Z)V", "")>]
member this.StopForeground : bool -> unit
Parameters
- removeNotification
- Boolean
If true, the #STOP_FOREGROUND_REMOVE
selector will be passed to #stopForeground(int)
; otherwise
#STOP_FOREGROUND_LEGACY
will be passed.
- Attributes
Remarks
Legacy version of #stopForeground(int)
.
This member is deprecated. call #stopForeground(int)
and pass either #STOP_FOREGROUND_REMOVE
or #STOP_FOREGROUND_DETACH
explicitly instead.
Java documentation for android.app.Service.stopForeground(boolean)
.
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.
See also
- <xref:Android.App.Service.StartForeground(System.Int32%2c+Android.App.Notification)>