UserProfilePersonalizationSettings Klasse

Definition

Namespace:

Windows.System.UserProfile

Stellt Eigenschaften und Methoden bereit, um das Desktophintergrundbild und das Hintergrundbild des Sperrbildschirms des Benutzers zu verwalten.

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

Vererbung

Object Platform::Object IInspectable UserProfilePersonalizationSettings

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

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

Hinweise

Rufen Sie die Current-Methode auf, um eine instance dieser Klasse abzurufen.

Hinweis

Wenn Sie ein Image mehrmals festlegen, muss die neue Imagedatei einen anderen Namen als das zuvor festgelegte Image aufweisen. Wenn Sie ein neues Image mithilfe einer Datei mit dem gleichen Namen wie das vorherige Image festlegen, tritt ein Fehler auf.

Eigenschaften

Current

Ruft den aktuellen instance von UserProfilePersonalizationSettings ab.

Methoden

IsSupported()	Ruft einen Wert ab, der angibt, ob das Ändern der Desktop- und Sperrbildschirmbilder auf dem aktuellen Gerät unterstützt wird.
TrySetLockScreenImageAsync(StorageFile)	Versucht, die angegebene Bilddatei als Hintergrundbild des Sperrbildschirms festzulegen.
TrySetWallpaperImageAsync(StorageFile)	Versucht, die angegebene Bilddatei als Desktophintergrundbild festzulegen.