IDesktopWallpaper interface (shobjidl_core.h)
Provides methods for managing the desktop wallpaper.
Inheritance
The IDesktopWallpaper interface inherits from the IUnknown interface. IDesktopWallpaper also has these types of members:
Methods
The IDesktopWallpaper interface has these methods.
| IDesktopWallpaper::AdvanceSlideshow Switches the wallpaper on a specified monitor to the next image in the slideshow. |
| IDesktopWallpaper::Enable Enables or disables the desktop background. |
| IDesktopWallpaper::GetBackgroundColor Retrieves the color that is visible on the desktop when no image is displayed or when the desktop background has been disabled. This color is also used as a border when the desktop wallpaper does not fill the entire screen. |
| IDesktopWallpaper::GetMonitorDevicePathAt Retrieves the unique ID of one of the system's monitors. |
| IDesktopWallpaper::GetMonitorDevicePathCount Retrieves the number of monitors that are associated with the system. |
| IDesktopWallpaper::GetMonitorRECT Retrieves the display rectangle of the specified monitor. |
| IDesktopWallpaper::GetPosition Retrieves the current display value for the desktop background image. |
| IDesktopWallpaper::GetSlideshow Gets the path to the directory where the slideshow images are stored. |
| IDesktopWallpaper::GetSlideshowOptions Gets the current desktop wallpaper slideshow settings for shuffle and timing. |
| IDesktopWallpaper::GetStatus Gets the current status of the slideshow. |
| IDesktopWallpaper::GetWallpaper Gets the current desktop wallpaper. |
| IDesktopWallpaper::SetBackgroundColor Sets the color that is visible on the desktop when no image is displayed or when the desktop background has been disabled. This color is also used as a border when the desktop wallpaper does not fill the entire screen. |
| IDesktopWallpaper::SetPosition Sets the display option for the desktop wallpaper image, determining whether the image should be centered, tiled, or stretched. |
| IDesktopWallpaper::SetSlideshow Specifies the images to use for the desktop wallpaper slideshow. |
| IDesktopWallpaper::SetSlideshowOptions Sets the desktop wallpaper slideshow settings for shuffle and timing. |
| IDesktopWallpaper::SetWallpaper Sets the desktop wallpaper. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Target Platform | Windows |
| Header | shobjidl_core.h (include Shobjidl.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for