다음을 통해 공유


UserProfilePersonalizationSettings 클래스

정의

사용자의 바탕 화면 배경 화면 및 잠금 화면 배경 이미지를 관리하는 속성과 방법을 제공합니다.

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
특성

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)

지정된 이미지 파일을 바탕 화면 배경 화면 이미지로 설정하려고 시도합니다.

적용 대상