IDesktopWallpaper::Enable-Methode (shobjidl_core.h)
Aktiviert oder deaktiviert den Desktophintergrund.
Syntax
HRESULT Enable(
[in] BOOL enable
);
Parameter
[in] enable
TRUE , um den Desktophintergrund zu aktivieren, FALSE , um ihn zu deaktivieren.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben, einschließlich des folgenden.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Desktophintergrundbild befindet sich bereits in dem Zustand, den Sie über diesen Aufruf anfordern. |
|
Das Desktophintergrundbild, das verwendet wird, wenn der Hintergrund aktiviert ist, fehlt an der erwarteten Position. Rufen Sie SetWallpaper auf, um ein neues Hintergrundbild anzugeben. |
Hinweise
Diese Methode wird normalerweise aufgerufen, um den Desktophintergrund aus Leistungsgründen zu deaktivieren.
Wenn der Desktophintergrund deaktiviert ist, wird an ihrer Stelle eine Volltonfarbe angezeigt. Verwenden Sie zum Abrufen oder Festlegen der spezifischen Farbe die Methoden GetBackgroundColor und SetBackgroundColor .
Hinweis Ein Aufruf der methoden IDesktopWallpaper_SetWallpaper oder IDesktopWallpaper_SetSlideshow aktiviert den Desktophintergrund, auch wenn er derzeit über diese Methode deaktiviert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (einschließlich Shobjidl.h) |