UserProfilePersonalizationSettings Classe

Definição

Namespace:

Windows.System.UserProfile

Fornece propriedades e métodos para gerenciar o papel de parede da área de trabalho do usuário e a imagem de tela de fundo da tela de bloqueio.

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

Herança

Object Platform::Object IInspectable UserProfilePersonalizationSettings

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

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

Comentários

Para obter uma instância dessa classe, chame o método Current .

Observação

Quando você define uma imagem mais de uma vez, o novo arquivo de imagem deve ter um nome diferente da imagem definida anteriormente. Se você definir uma nova imagem usando um arquivo com o mesmo nome da imagem anterior, ela falhará.

Propriedades

Current

Obtém a instância atual de UserProfilePersonalizationSettings.

Métodos

IsSupported()	Obtém um valor que indica se há suporte para alterar as imagens de tela de bloqueio e área de trabalho no dispositivo atual.
TrySetLockScreenImageAsync(StorageFile)	Tenta definir o arquivo de imagem especificado como a imagem de tela de fundo da tela de bloqueio.
TrySetWallpaperImageAsync(StorageFile)	Tenta definir o arquivo de imagem especificado como a imagem de papel de parede da área de trabalho.