IActiveDesktop interface (shlobj_core.h)

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

Inheritance

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

Methods

The IActiveDesktop interface has these methods.

 
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.

Remarks

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

Requirements

Requirement Value
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