DocumentRootFlags 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
枚举多个类型返回的值。
public enum DocumentRootFlags
type DocumentRootFlags =
- 继承
-
DocumentRootFlags
字段
| 名称 | 值 | 说明 |
|---|---|---|
| SupportsCreate | 1 | 指示此根目录下至少有一个目录支持创建内容的标志。 当应用程序与Intent.ACTION_CREATE_DOCUMENT交互时,将显示具有此标志的根。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| LocalOnly | 2 | 指示此根目录在设备上提供严格本地的内容的标志。 也就是说,不会对内容发出任何网络请求。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| SupportsRecents | 4 | 指示可以查询此根目录以提供最近修改的文档的标志。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| SupportsSearch | 8 | 指示此根支持搜索的标志。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| SupportsIsChild | 16 | 指示此根支持测试父子关系的标志。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| SupportsEject | 32 | 指示可以弹出此根的标志。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| Empty | 64 | 指示此根目录当前为空的标志。 这可用于在打开文档时隐藏根,但在创建文档和FLAG_SUPPORTS_CREATE时仍会显示根。 如果此标志的值发生更改(例如,当根变为非空时),则必须发送 DocumentsContract.buildRootsUri(String)的内容更改通知。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| SupportsQueryTrash | 1048576 | 指示可以查询此根目录以提供已回收的文档的标志。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| LimitedFunctionalityWhenOffline | 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 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
注解
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。