UserProfilePersonalizationSettings.TrySetWallpaperImageAsync Método

Definición

Espacio de nombres:

Windows.System.UserProfile

Intenta establecer el archivo de imagen especificado como imagen de fondo de pantalla de escritorio.

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)

Parámetros

imageFile

StorageFile

Imagen que se va a establecer como fondo del escritorio.

Devoluciones

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Resultado de la operación asincrónica. true si la imagen de fondo se estableció correctamente; de lo contrario, false.

Atributos

RemoteAsyncAttribute

Ejemplos

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

Comentarios

Nota:

Cuando se establece una imagen más de una vez, el nuevo archivo de imagen debe tener un nombre diferente al de la imagen establecida anteriormente. Si establece una nueva imagen con un archivo con el mismo nombre que la imagen anterior, se producirá un error.