DocumentRootFlags 列舉
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
列舉由多種類型回傳的值。
public enum DocumentRootFlagstype DocumentRootFlags = - 繼承
-
DocumentRootFlags
欄位
| 名稱 | 值 | Description |
|---|---|---|
| SupportsCreate | 1 | 標記表示至少有一個目錄在此根目錄下支援建立內容。 當應用程式與 Intent.ACTION_CREATE_DOCUMENT 互動時，會顯示帶有此旗標的根節點。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| LocalOnly | 2 | 標記表示這個根目錄提供的內容是裝置上嚴格本地的。 也就是說，網路上不會對內容提出任何請求。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| SupportsRecents | 4 | 標記表示此根節點可被查詢以提供最近修改的文件。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| SupportsSearch | 8 | 標記表示此根節點支援搜尋。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| SupportsIsChild | 16 | 標記表示此根節點支援測試父子關係。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| SupportsEject | 32 | 標記表示此根節點可被彈出。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| Empty | 64 | 標記表示此根目前為空。 這可用於開啟文件時隱藏根節點，但建立文件時仍會顯示根節點，且FLAG_SUPPORTS_CREATE也會被設定。 如果這個旗標的值改變，例如根節點變成非空，你必須發送內容變更通知給 DocumentsContract.buildRootsUri（String）。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| SupportsQueryTrash | 1048576 | 標記表示此根節點可被查詢以提供被刪除的文件。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
| LimitedFunctionalityWhenOffline | 2097152 | 標記表示當裝置沒有網路連線時，這個根功能有限。 這會影響當裝置沒有網路連線時，系統檔案選擇器和檔案管理員向使用者呈現檔案的方式。 像開啟、複製和移動這類需要讀取檔案內容的操作，對於本地沒有內容的檔案將會被停用。 具體來說，必須符合以下條件才能停用這些動作：裝置沒有網路連線;Document.COLUMN_CONTENT_SYNC_STATE_FLAGS 非空且 Document.SYNC_STATE_FLAG_AVAILABLE_LOCALLY 不被設定;FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE已定;Document.FLAG_VIRTUAL_DOCUMENT尚未設定;Document.COLUMN_MIME_TYPE不等於Document.MIME_TYPE_DIR資料夾開啟次數不會受到此旗標狀態的影響，讓使用者仍能在檔案系統中瀏覽。 然而，其他需要讀取檔案內容的操作會在資料夾中被停用，因為這些檔案可能包含本地無法取得的內容。 具體來說，必須符合以下條件才能停用這些動作：裝置沒有網路連線;FLAG_LIMITED_FUNCTIONALITY_WHEN_OFFLINE已定;Document.COLUMN_MIME_TYPE 等於 Document.MIME_TYPE_DIR 像是重命名和刪除等不需要讀取檔案內容的操作，將不受此旗標狀態的影響。 此外，當此標誌設定且裝置離線時，檔案選擇器與檔案管理員會向使用者顯示離線功能有限的訊息。 請注意，即使裝置有網路連線，文件提供者的實作也可能因各種系統限制及省電功能而受限或無法存取。 此案的使用者介面不會有變動。
Android 參考資料。 本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。 |
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。