Fragment.UserVisibleHint Property
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.
Set a hint to the system about whether this fragment's UI is currently visible to the user.
public virtual bool UserVisibleHint { [Android.Runtime.Register("getUserVisibleHint", "()Z", "GetGetUserVisibleHintHandler")] get; [Android.Runtime.Register("setUserVisibleHint", "(Z)V", "GetSetUserVisibleHint_ZHandler")] set; }
[<get: Android.Runtime.Register("getUserVisibleHint", "()Z", "GetGetUserVisibleHintHandler")>]
[<set: Android.Runtime.Register("setUserVisibleHint", "(Z)V", "GetSetUserVisibleHint_ZHandler")>]
member this.UserVisibleHint : bool with get, set
Property Value
The current value of the user-visible hint on this fragment.
- Attributes
Remarks
Property getter documentation:
Java documentation for android.app.Fragment.getUserVisibleHint()
.
Property setter documentation:
Set a hint to the system about whether this fragment's UI is currently visible to the user. This hint defaults to true and is persistent across fragment instance state save and restore.
An app may set this to false to indicate that the fragment's UI is scrolled out of visibility or is otherwise not directly visible to the user. This may be used by the system to prioritize operations such as fragment lifecycle updates or loader ordering behavior.
<strong>Note:</strong> This method may be called outside of the fragment lifecycle and thus has no ordering guarantees with regard to fragment lifecycle method calls.
<strong>Note:</strong> Prior to Android N there was a platform bug that could cause setUserVisibleHint
to bring a fragment up to the started state before its FragmentTransaction
had been committed. As some apps relied on this behavior, it is preserved for apps that declare a targetSdkVersion
of 23 or lower.
Java documentation for android.app.Fragment.setUserVisibleHint(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.