UserProfilePersonalizationSettings Clase

Definición

Espacio de nombres:

Windows.System.UserProfile

Proporciona propiedades y métodos para administrar el fondo de pantalla de escritorio del usuario y la imagen de fondo de pantalla de bloqueo.

public ref class UserProfilePersonalizationSettings sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UserProfilePersonalizationSettings final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class UserProfilePersonalizationSettings

Public NotInheritable Class UserProfilePersonalizationSettings

Herencia

Object Platform::Object IInspectable UserProfilePersonalizationSettings

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

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.TrySetLockScreenImageAsync(file);
    }
    return success;
} 

Comentarios

Para obtener una instancia de esta clase, llame al método Current .

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.

Propiedades

Current

Obtiene la instancia actual de UserProfilePersonalizationSettings.

Métodos

IsSupported()	Obtiene un valor que indica si se admiten cambios en las imágenes de pantalla de bloqueo y escritorio en el dispositivo actual.
TrySetLockScreenImageAsync(StorageFile)	Intenta establecer el archivo de imagen especificado como imagen de fondo de la pantalla de bloqueo.
TrySetWallpaperImageAsync(StorageFile)	Intenta establecer el archivo de imagen especificado como imagen de fondo de pantalla de escritorio.