UserProfilePersonalizationSettings.TrySetWallpaperImageAsync Metodo

Definizione

Tenta di impostare il file di immagine specificato come immagine dello sfondo desktop.

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)

Parametri

imageFile
StorageFile

Immagine da impostare come sfondo desktop.

Restituisce

Risultato dell'operazione asincrona. true se l'immagine di sfondo è stata impostata correttamente; in caso contrario, false.

Attributi

Esempio

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);
   }
}

Commenti

Nota

Quando si imposta un'immagine più di una volta, il nuovo file di immagine deve avere un nome diverso rispetto all'immagine impostata in precedenza. Se si imposta una nuova immagine usando un file con lo stesso nome dell'immagine precedente, avrà esito negativo.

Si applica a