UserProfilePersonalizationSettings Kelas

Definisi

Ruang nama:

Windows.System.UserProfile

Menyediakan properti dan metode untuk mengelola wallpaper desktop pengguna dan mengunci gambar latar belakang layar.

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

Warisan

Object Platform::Object IInspectable UserProfilePersonalizationSettings

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

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

Keterangan

Untuk mendapatkan instans kelas ini, panggil metode Saat Ini .

Catatan

Saat Anda mengatur gambar lebih dari sekali, file gambar baru harus memiliki nama yang berbeda dari gambar yang ditetapkan sebelumnya. Jika Anda mengatur gambar baru menggunakan file dengan nama yang sama dengan gambar sebelumnya, gambar tersebut akan gagal.

Properti

Current

Mendapatkan instans UserProfilePersonalizationSettings saat ini.

Metode

IsSupported()	Mendapatkan nilai yang menunjukkan apakah mengubah gambar desktop dan layar kunci didukung pada perangkat saat ini.
TrySetLockScreenImageAsync(StorageFile)	Mencoba mengatur file gambar yang ditentukan sebagai gambar latar belakang layar kunci.
TrySetWallpaperImageAsync(StorageFile)	Mencoba menyetel file gambar yang ditentukan sebagai gambar wallpaper desktop.