UserProfilePersonalizationSettings Classe

Définition

Espace de noms:

Windows.System.UserProfile

Fournit des propriétés et des méthodes pour gérer le papier peint du bureau et l’image d’arrière-plan de l’écran de verrouillage de l’utilisateur.

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

Héritage

Object Platform::Object IInspectable UserProfilePersonalizationSettings

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

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

Remarques

Pour obtenir une instance de cette classe, appelez la méthode Current.

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.

Propriétés

Current

Obtient la instance actuelle de UserProfilePersonalizationSettings.

Méthodes

IsSupported()	Obtient une valeur qui indique si la modification des images du bureau et de l’écran de verrouillage est prise en charge sur l’appareil actuel.
TrySetLockScreenImageAsync(StorageFile)	Tente de définir le fichier image spécifié comme image d’arrière-plan de l’écran de verrouillage.
TrySetWallpaperImageAsync(StorageFile)	Tente de définir le fichier image spécifié en tant qu’image de papier peint du bureau.