IDesktopWallpaper ::Enable, méthode (shobjidl_core.h)

Article
08/26/2023

Active ou désactive l’arrière-plan du bureau.

Syntaxe

HRESULT Enable(
  [in] BOOL enable
);

Paramètres

[in] enable

TRUE pour activer l’arrière-plan du bureau, FALSE pour le désactiver.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT , y compris ce qui suit.

Code de retour	Description
S_FALSE	Le papier peint du bureau est déjà dans l’état que vous demandez par le biais de cet appel.
E_FILE_NOT_FOUND	Le papier peint du bureau qui serait utilisé lorsque l’arrière-plan est activé est absent de son emplacement attendu. Appelez SetWallpaper pour spécifier un nouveau papier peint.

Remarques

Cette méthode est normalement appelée pour désactiver l’arrière-plan du bureau pour des raisons de performances.

Lorsque l’arrière-plan du bureau est désactivé, une couleur unie est affichée à sa place. Pour obtenir ou définir la couleur spécifique, utilisez les méthodes GetBackgroundColor et SetBackgroundColor .

Note Un appel aux méthodes IDesktopWallpaper_SetWallpaper ou IDesktopWallpaper_SetSlideshow active l’arrière-plan du Bureau même s’il est actuellement désactivé via cette méthode.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)

Voir aussi

IDesktopWallpaper

Partager via