IActiveDesktop interface

Allows a client program to manage the desktop items and wallpaper on a local computer.


The IActiveDesktop interface inherits from the IUnknown interface. IActiveDesktop also has these types of members:


The IActiveDesktop interface has these methods.

Method Description
IActiveDesktop::AddDesktopItem Adds a desktop item.
IActiveDesktop::AddDesktopItemWithUI Adds a desktop item to the Active Desktop after displaying user interfaces that confirm the addition of the desktop item, verifying security zone permissions, and asking if the user wants to create a subscription.
IActiveDesktop::AddUrl Adds the desktop item associated with the specified URL.
IActiveDesktop::ApplyChanges Applies changes to the Active Desktop and saves them in the registry.
IActiveDesktop::GenerateDesktopItemHtml Generates a generic HTML page containing the given desktop item.
IActiveDesktop::GetDesktopItem Gets the specified desktop item.
IActiveDesktop::GetDesktopItemByID Gets the desktop item that matches the given identification.
IActiveDesktop::GetDesktopItemBySource Gets a desktop item using its source URL.
IActiveDesktop::GetDesktopItemCount Gets a count of the desktop items.
IActiveDesktop::GetDesktopItemOptions Gets the options for the desktop item.
IActiveDesktop::GetPattern Gets the current pattern.
IActiveDesktop::GetWallpaper Gets the current wallpaper.
IActiveDesktop::GetWallpaperOptions Gets the wallpaper options.
IActiveDesktop::ModifyDesktopItem Modifies the desktop item.
IActiveDesktop::RemoveDesktopItem Removes the specified desktop item from the desktop.
IActiveDesktop::SetDesktopItemOptions Sets the item's options.
IActiveDesktop::SetPattern Sets the Active Desktop pattern.
IActiveDesktop::SetWallpaper Sets the wallpaper for the Active Desktop.
IActiveDesktop::SetWallpaperOptions Sets the wallpaper options.


Your code must include Wininet.h before it includes Shlobj.h. Failure to do so will result in a compiler error.


Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj_core.h

See also

Using the Active Desktop Object