Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |