Edit

DESKTOP_WALLPAPER_POSITION enumeration (shobjidl_core.h)

  • Article

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