UserProfilePersonalizationSettings 類別

定義

命名空間:

Windows.System.UserProfile

提供屬性和方法來管理使用者的桌面桌布和鎖定螢幕背景影像。

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

繼承

Object Platform::Object IInspectable UserProfilePersonalizationSettings

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

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

備註

若要取得這個類別的實例，請呼叫 Current 方法。

注意

當您多次設定映射時，新的影像檔必須具有與先前設定映射不同的名稱。 如果您使用與上一個映射同名的檔案來設定新映射，它將會失敗。

屬性

Current

取得 UserProfilePersonalizationSettings的目前實例。

方法

IsSupported()	取得值，這個值表示目前裝置是否支援變更桌面和鎖定畫面影像。
TrySetLockScreenImageAsync(StorageFile)	嘗試將指定的影像檔設定為鎖定畫面背景影像。
TrySetWallpaperImageAsync(StorageFile)	嘗試將指定的影像檔設定為桌面桌布影像。