DocumentsContract.Root.FlagLimitedFunctionalityWhenOffline Field
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.
Caution
This constant will be removed in the future version. Use Android.Provider.DocumentRootFlags enum directly instead of this field.
Flag indicating that this root has limited functionality when the device does not have an internet connection.
[Android.Runtime.Register("FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE", ApiSince=37)]
[System.Obsolete("This constant will be removed in the future version. Use Android.Provider.DocumentRootFlags enum directly instead of this field.", true)]
public const Android.Provider.DocumentRootFlags FlagLimitedFunctionalityWhenOffline = 2097152;[<Android.Runtime.Register("FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE", ApiSince=37)>]
[<System.Obsolete("This constant will be removed in the future version. Use Android.Provider.DocumentRootFlags enum directly instead of this field.", true)>]
val mutable FlagLimitedFunctionalityWhenOffline : Android.Provider.DocumentRootFlagsField Value
Value = 2097152- Attributes
Remarks
Flag indicating that this root has limited functionality when the device does not have an internet connection. This will affect how the system file picker and file manager presents files to the user when the device does not have internet connection. Operations such as open, copy and move, that require reading file contents, will be disabled on files that do not have content available locally. Specifically, the following conditions have to be met to disable these actions: the device does not have internet connection; Document.COLUMN_CONTENT_SYNC_STATE_FLAGS is non-null and Document.SYNC_STATE_FLAG_AVAILABLE_LOCALLY is not set; FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE is set; Document.FLAG_VIRTUAL_DOCUMENT is not set; Document.COLUMN_MIME_TYPE does not equal Document.MIME_TYPE_DIR Folder opens will be unaffected by the state of this flag to allow users to be able to still navigate around the file system. However, other operations that require reading file contents will be disabled on folders because they may contain files that don't have content available locally. Specifically, the following conditions have to be met to disable these actions:; the device does not have internet connection; FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE is set; Document.COLUMN_MIME_TYPE equals Document.MIME_TYPE_DIR Operations such as rename and delete, that don't require reading file contents, will be unaffected by the state of this flag. In addition, when this flag is set and the device if offline, the file picker and file manager will show a message to the user indicating that there is limited functionality when offline. Note that even if the device has an internet connection, the documents provider implementation may be limited or prevented from accessing it because of various system restrictions and battery saving features. There will be no UI change for this case.
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.