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

설명

이 클래스의 instance 얻으려면 Current 메서드를 호출합니다.

참고

이미지를 두 번 이상 설정하면 새 이미지 파일의 이름이 이전에 설정한 이미지와 달라야 합니다. 이전 이미지와 이름이 같은 파일을 사용하여 새 이미지를 설정하면 실패합니다.

속성

Current

UserProfilePersonalizationSettings의 현재 instance 가져옵니다.

메서드

IsSupported()	데스크톱 및 잠금 화면 이미지 변경이 현재 디바이스에서 지원되는지 여부를 나타내는 값을 가져옵니다.
TrySetLockScreenImageAsync(StorageFile)	지정된 이미지 파일을 잠금 화면 배경 이미지로 설정하려고 시도합니다.
TrySetWallpaperImageAsync(StorageFile)	지정된 이미지 파일을 바탕 화면 배경 화면 이미지로 설정하려고 시도합니다.