Metodo IDesktopWallpaper::Enable (shobjidl_core.h)

Abilita o disabilita lo sfondo del desktop.

Sintassi

HRESULT Enable(
  [in] BOOL enable
);

Parametri

[in] enable

TRUE per abilitare lo sfondo del desktop, FALSE per disabilitarlo.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT , incluso quanto segue.

Codice restituito	Descrizione
S_FALSE	Lo sfondo del desktop è già nello stato che stai chiedendo tramite questa chiamata.
E_FILE_NOT_FOUND	Lo sfondo del desktop che verrebbe usato quando lo sfondo è abilitato non è presente nella posizione prevista. Chiama SetWallpaper per specificare un nuovo sfondo.

Commenti

Questo metodo viene in genere chiamato per disabilitare lo sfondo del desktop per motivi di prestazioni.

Quando lo sfondo del desktop è disabilitato, viene visualizzato un colore a tinta unita al suo posto. Per ottenere o impostare il colore specifico, utilizzare i metodi GetBackgroundColor e SetBackgroundColor .

Nota Una chiamata ai metodi IDesktopWallpaper_SetWallpaper o IDesktopWallpaper_SetSlideshow abiliterà lo sfondo del desktop anche se è attualmente disabilitato tramite questo metodo.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

IDesktopWallpaper