WallpaperManager.GetWallpaperFile(WallpaperManagerFlags) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
<
> note importante forte : </strong><ul><li li>jusqu’à Android 12, cette méthode nécessite l’autorisationandroid.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
Paramètres
- which
- WallpaperManagerFlags
Papier peint dont le fichier image doit être récupéré. Doit être un type défini unique de papier peint, soit #FLAG_SYSTEM#FLAG_LOCK.
Retours
Descripteur de fichier ouvert et lisible dans le fichier image de papier peint demandé ; ou null si aucun papier peint n’est configuré ou si l’application appelante n’est pas autorisée à lire le papier peint actuel.
- Attributs
Remarques
<
> note importante forte : </strong><ul><li li>jusqu’à Android 12, cette méthode nécessite l’autorisation.<android.Manifest.permission#READ_EXTERNAL_STORAGE/li li>><À partir d’Android 13, l’accès direct au papier peint n’est plus possible, au lieu de cela, le papier peint système par défaut est retourné (certaines versions d’Android 13 peuvent lever un ).<SecurityException/li li>><À partir d’Android 14, cette méthode ne doit pas être utilisée et lève toujours un .<SecurityException/li><li> Apps avec android.Manifest.permission#MANAGE_EXTERNAL_STORAGE peut toujours accéder au papier peint réel sur toutes les versions.
</li></ul><br>
Obtenez un descripteur de fichier ouvert et lisible dans le fichier image de papier peint donné. L’appelant est responsable de la fermeture du descripteur de fichier lors de l’ingestion du fichier.
Si aucun papier peint spécifique au verrou n’a été configuré pour l’utilisateur donné, cette méthode retourne null lors de la demande #FLAG_LOCK plutôt que de renvoyer le fichier image du papier peint système.
Java documentation pour android.app.WallpaperManager.getWallpaperFile(int).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.