IDesktopWallpaper ::Enable, méthode (shobjidl_core.h)
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 |
|---|---|
|
Le papier peint du bureau est déjà dans l’état que vous demandez par le biais de cet appel. |
|
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) |