UserProfilePersonalizationSettings Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.System.UserProfile

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce proprietà e metodi per gestire lo sfondo desktop dell'utente e l'immagine di sfondo dello schermo di blocco.

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

Ereditarietà: Object Platform::Object IInspectable UserProfilePersonalizationSettings

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

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

Commenti

Per ottenere un'istanza di questa classe, chiamare il metodo Current .

Nota

Quando si imposta un'immagine più di una volta, il nuovo file di immagine deve avere un nome diverso rispetto all'immagine impostata in precedenza. Se si imposta una nuova immagine usando un file con lo stesso nome dell'immagine precedente, avrà esito negativo.

Proprietà

Current

Ottiene l'istanza corrente di UserProfilePersonalizationSettings.

Metodi

IsSupported()	Ottiene un valore che indica se la modifica delle immagini dello schermo desktop e blocco è supportata nel dispositivo corrente.
TrySetLockScreenImageAsync(StorageFile)	Tenta di impostare il file di immagine specificato come immagine di sfondo dello schermo di blocco.
TrySetWallpaperImageAsync(StorageFile)	Tenta di impostare il file di immagine specificato come immagine dello sfondo desktop.

Si applica a

Condividi tramite