UserProfilePersonalizationSettings.TrySetWallpaperImageAsync 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.
Tente de définir le fichier image spécifié en tant qu’image de papier peint du bureau.
public:
virtual IAsyncOperation<bool> ^ TrySetWallpaperImageAsync(StorageFile ^ imageFile) = TrySetWallpaperImageAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<bool> TrySetWallpaperImageAsync(StorageFile const& imageFile);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<bool> TrySetWallpaperImageAsync(StorageFile imageFile);function trySetWallpaperImageAsync(imageFile)Public Function TrySetWallpaperImageAsync (imageFile As StorageFile) As IAsyncOperation(Of Boolean)Paramètres
- imageFile
- StorageFile
Image à définir comme arrière-plan du bureau.
Retours
Résultat de l’opération asynchrone. true si l’image d’arrière-plan a été correctement définie ; sinon, false.
- Attributs
Exemples
using Windows.System.UserProfile;
// Pass in a relative path to a file inside the local appdata folder
async Task<bool> SetWallpaperAsync(string localAppDataFileName)
{
bool success = false;
if (UserProfilePersonalizationSettings.IsSupported())
{
var uri = new Uri("ms-appx:///Local/" + localAppDataFileName);
StorageFile file = await StorageFile.GetFileFromApplicationUriAsync(uri);
UserProfilePersonalizationSettings profileSettings = UserProfilePersonalizationSettings.Current;
success = await profileSettings.TrySetWallpaperImageAsync(file);
}
}
Remarques
Notes
Lorsque vous définissez une image plusieurs fois, le nouveau fichier image doit avoir un nom différent de l’image précédemment définie. Si vous définissez une nouvelle image à l’aide d’un fichier portant le même nom que l’image précédente, elle échoue.