Expand Minimize

DESKTOP_WALLPAPER_POSITION enumeration

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
} DESKTOP_WALLPAPER_POSITION;

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.h

IDL

Shobjidl.idl

See also

IDesktopWallpaper::GetPosition
IDesktopWallpaper::SetPosition

 

 

Community Additions

ADD
Show:
© 2015 Microsoft