WallpaperManager.GetWallpaperFile(WallpaperManagerFlags) Metodo

Definizione

Spazio dei nomi:: Android.App

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

<nota importante forte> : </strong><ul><li>Fino ad Android 12, questo metodo richiede l'autorizzazione android.Manifest.permission#READ_EXTERNAL_STORAGE .

[Android.Runtime.Register("getWallpaperFile", "(I)Landroid/os/ParcelFileDescriptor;", "GetGetWallpaperFile_IHandler", ApiSince=24)]
public virtual Android.OS.ParcelFileDescriptor? GetWallpaperFile(Android.App.WallpaperManagerFlags which);

[<Android.Runtime.Register("getWallpaperFile", "(I)Landroid/os/ParcelFileDescriptor;", "GetGetWallpaperFile_IHandler", ApiSince=24)>]
abstract member GetWallpaperFile : Android.App.WallpaperManagerFlags -> Android.OS.ParcelFileDescriptor
override this.GetWallpaperFile : Android.App.WallpaperManagerFlags -> Android.OS.ParcelFileDescriptor

Parametri

which: WallpaperManagerFlags

Sfondo il cui file di immagine deve essere recuperato. Deve essere un singolo tipo definito di sfondo, #FLAG_SYSTEM o #FLAG_LOCK.

Valori restituiti

ParcelFileDescriptor

Descrittore di file aperto e leggibile per il file di immagine dello sfondo richiesto; o null se tale sfondo non è configurato o se l'app chiamante non dispone dell'autorizzazione per leggere lo sfondo corrente.

Attributi: RegisterAttribute

Commenti

<nota importante forte>: </strong><ul><li>Fino ad Android 12, questo metodo richiede l'autorizzazioneandroid.Manifest.permission#READ_EXTERNAL_STORAGE.</li><li>A partire da Android 13, l'accesso diretto allo sfondo non è più possibile, invece viene restituito lo sfondo del sistema predefinito (alcune versioni di Android 13 potrebbero generare un ).SecurityException</li><li>Da Android 14, questo metodo non deve essere usato e genererà sempre un'eccezione SecurityException.</li li><> Apps con android.Manifest.permission#MANAGE_EXTERNAL_STORAGE può comunque accedere allo sfondo reale su tutte le versioni. </li></ul><br>

Ottenere un descrittore di file aperto e leggibile nel file di immagine dello sfondo specificato. Il chiamante è responsabile della chiusura del descrittore di file al termine dell'inserimento del file.

Se non è stato configurato uno sfondo specifico del blocco per l'utente specificato, questo metodo restituirà null quando si richiede #FLAG_LOCK anziché restituire il file di immagine dello sfondo del sistema.

per android.app.WallpaperManager.getWallpaperFile(int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a