IActiveDesktop Flags

This section describes the flags used by IActiveDesktop interface methods.

AD_APPLY_ALL

Aggregate of the AD_APPLY_SAVE, AD_APPLY_HTMLGEN, and AD_APPLY_REFRESH values.

AD_APPLY_BUFFERED_REFRESH

Starts a timer and aggregates all the refresh requests made with this flag during that time interval into a single refresh. This interval is set at five seconds. At the end of the interval, or if a refresh is requested during the interval without an AD_APPLY_BUFFERED_REFRESH flag, the refresh is made and the timer is stopped. This flag must be combined with the AD_APPLY_REFRESH flag.

AD_APPLY_DYNAMICREFRESH

Version 5.0. Use dynamic HTML to refresh only those items that have changed since the last refresh, not the entire desktop.

AD_APPLY_FORCE

Force an Active Desktop change.

AD_APPLY_HTMLGEN

Regenerate the desktop HTML file.

AD_APPLY_REFRESH

Refresh the desktop item.

AD_APPLY_SAVE

Save the desktop item.

COMP_ELEM_ALL

Aggregate of the COMP_ELEM_* values.

COMP_ELEM_CHECKED

The item has been checked.

COMP_ELEM_CURITEMSTATE

The current state of the desktop item.

COMP_ELEM_FRIENDLYNAME

The friendly name of the item.

COMP_ELEM_NOSCROLL

The item is not scrollable.

COMP_ELEM_ORIGINAL_CSI

The original desktop item state information.

COMP_ELEM_POS_LEFT

The horizontal position of the item.

COMP_ELEM_POS_TOP

The vertical position of the item.

COMP_ELEM_POS_ZINDEX

The z-index of the item.

COMP_ELEM_RESTORED_CSI

The restored desktop item state information.

COMP_ELEM_SIZE_HEIGHT

The height of the item.

COMP_ELEM_SIZE_WIDTH

The width of the item.

COMP_ELEM_SOURCE

The original source of the item.

COMP_ELEM_TYPE

The item type.

COMP_TYPE_CFHTML

Compressed format HTML.

COMP_TYPE_CONTROL

The item is a control.

COMP_TYPE_HTMLDOC

The item is an HTML document. This flag should only be used when absolutely necessary. It causes an HTML document to be inserted verbatim into the Desktop.htt file used to control layout of the desktop. For most cases, you should use the COMP_TYPE_WEBSITE flag to add items to the desktop.

COMP_TYPE_MAX

The maximum value of a COMP_TYPE_* flag.

COMP_TYPE_PICTURE

The item is a picture.

COMP_TYPE_WEBSITE

The item is a website.

COMPONENT_TOP

A z-order value meaning the item is at the top.

WPSTYLE_CENTER

The wallpaper is centered.

WPSTYLE_MAX

The maximum value of a WPSTYLE_* flag.

WPSTYLE_STRETCH

The wallpaper is stretched to fit the entire screen.

WPSTYLE_TILE

The wallpaper is tiled.

WPSTYLE_SPAN

Windows 8 and later: The wallpaper spans multiple monitors.

Requirements