DESKTOP_WALLPAPER_POSITION enumeration

Specifies how the desktop wallpaper should be displayed.

Syntax

typedef enum DESKTOP_WALLPAPER_POSITION {
  DWPOS_CENTER,
  DWPOS_TILE,
  DWPOS_STRETCH,
  DWPOS_FIT,
  DWPOS_FILL,
  DWPOS_SPAN
} ;

Constants

DWPOS_CENTER Center the image; do not stretch. This is equivalent to the WPSTYLE_CENTER style in IActiveDesktop.
DWPOS_TILE Tile the image across all monitors. This is equivalent to the WPSTYLE_TILE style in IActiveDesktop.
DWPOS_STRETCH Stretch the image to exactly fit on the monitor. This is equivalent to the WPSTYLE_STRETCH style in IActiveDesktop.
DWPOS_FIT Stretch the image to exactly the height or width of the monitor without changing its aspect ratio or cropping the image. This can result in colored letterbox bars on either side or on above and below of the image. This is equivalent to the WPSTYLE_KEEPASPECT style in IActiveDesktop.
DWPOS_FILL Stretch the image to fill the screen, cropping the image as necessary to avoid letterbox bars. This is equivalent to the WPSTYLE_CROPTOFIT style in IActiveDesktop.
DWPOS_SPAN Spans a single image across all monitors attached to the system. This flag has no IActiveDesktop equivalent.

Requirements

   
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header shobjidl_core.h (include Shobjidl.h)

See also

IDesktopWallpaper::GetPosition

IDesktopWallpaper::SetPosition