IDesktopWallpaper::SetPosition method

Sets the display option for the desktop wallpaper image, determining whether the image should be centered, tiled, or stretched.

Syntax


HRESULT SetPosition(
  [in]  DESKTOP_WALLPAPER_POSITION position
);

Parameters

position [in]

One of the DESKTOP_WALLPAPER_POSITION enumeration values that specify how the image will be displayed on the system's monitors.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code, including the following.

Return codeDescription
S_FALSE

The desktop wallpaper is already displayed as asked for in position.

 

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
IDesktopWallpaper::GetPosition

 

 

Community Additions

ADD
Show:
© 2015 Microsoft