语言

DocumentsContract.Root.FlagLimitedFunctionalityWhenOffline 字段

定义

注意

This constant will be removed in the future version. Use Android.Provider.DocumentRootFlags enum directly instead of this field.

指示当设备没有 Internet 连接时,此根具有有限功能的标志。

[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.DocumentRootFlags

字段值

Value = 2097152
特性

注解

指示当设备没有 Internet 连接时,此根具有有限功能的标志。 这会影响当设备没有 Internet 连接时系统文件选取器和文件管理器向用户显示文件的方式。 对于本地没有可用内容的文件,将禁用打开、复制和移动等需要读取文件内容的操作。 具体而言,必须满足以下条件才能禁用这些操作:

  • 设备没有 Internet 连接:
  • Document.COLUMN_CONTENT_SYNC_STATE_FLAGS为非 null 且未设置Document.SYNC_STATE_FLAG_AVAILABLE_LOCALLY:
  • 已设置FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE:
  • 未设置Document.FLAG_VIRTUAL_DOCUMENT:
  • Document.COLUMN_MIME_TYPE不等于Document.MIME_TYPE_DIR:

打开的文件夹不受此标志的状态影响,以允许用户仍然在文件系统周围导航。 但是,需要读取文件内容的其他操作将在文件夹中被禁用,因为它们可能包含本地没有可用内容的文件。 具体而言,必须满足以下条件才能禁用这些操作:

  • 设备没有 Internet 连接:
  • 已设置FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE:
  • Document.COLUMN_MIME_TYPE等于Document.MIME_TYPE_DIR:

重命名和删除等不需要读取文件内容的操作将不受此标志状态影响。 此外,当设置此标志并且设备处于脱机状态时,文件选取器和文件管理器将向用户显示一条消息,指示脱机时功能有限。 请注意,即使设备具有 Internet 连接,文档提供程序实现也可能受到限制或由于各种系统限制和节电功能而无法访问它。 在这种情况下,不会有任何 UI 更改。

Android 参考。android.provider.DocumentsContract.Root.FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于