Condividi tramite

Metodo IDesktopWallpaper::Enable (shobjidl_core.h)

  • Articolo

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