DESKTOP_WALLPAPER_POSITION enumeration (shobjidl_core.h)

Specifies how the desktop wallpaper should be displayed.

Syntax

typedef enum DESKTOP_WALLPAPER_POSITION {
  DWPOS_CENTER = 0,
  DWPOS_TILE = 1,
  DWPOS_STRETCH = 2,
  DWPOS_FIT = 3,
  DWPOS_FILL = 4,
  DWPOS_SPAN = 5
} ;

Constants

DWPOS_CENTER Value: 0 Center the image; do not stretch. This is equivalent to the WPSTYLE_CENTER style in IActiveDesktop.
DWPOS_TILE Value: 1 Tile the image across all monitors. This is equivalent to the WPSTYLE_TILE style in IActiveDesktop.
DWPOS_STRETCH Value: 2 Stretch the image to exactly fit on the monitor. This is equivalent to the WPSTYLE_STRETCH style in IActiveDesktop.
DWPOS_FIT Value: 3 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 Value: 4 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 Value: 5 Spans a single image across all monitors attached to the system. This flag has no IActiveDesktop equivalent.

Requirements

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