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

Возвращает текущий экземпляр UserProfilePersonalizationSettings.

Методы

IsSupported()	Возвращает значение, указывающее, поддерживается ли изменение изображений рабочего стола и экрана блокировки на текущем устройстве.
TrySetLockScreenImageAsync(StorageFile)	Пытается задать указанный файл изображения в качестве фонового изображения экрана блокировки.
TrySetWallpaperImageAsync(StorageFile)	Пытается задать указанный файл изображения в качестве фонового изображения рабочего стола.

Применяется к

Поделиться через