Export (0) Print
Expand All
Expand Minimize

SetMonitorDisplayAreaPosition function

Applies to: desktop apps only

Sets the horizontal or vertical position of a monitor's display area.

Increasing the horizontal position moves the display area toward the right side of the screen; decreasing it moves the display area toward the left. Increasing the vertical position moves the display area toward the top of the screen; decreasing it moves the display area toward the bottom.

Syntax

BOOL SetMonitorDisplayAreaPosition(
  __in  HANDLE hMonitor,
  __in  MC_POSITION_TYPE ptPositionType,
  __in  DWORD dwNewPosition
);

Parameters

hMonitor [in]

Handle to a physical monitor. To get the monitor handle, call GetPhysicalMonitorsFromHMONITOR or GetPhysicalMonitorsFromIDirect3DDevice9.

ptPositionType [in]

A member of the MC_POSITION_TYPE enumeration, specifying whether to set the horizontal position or the vertical position.

dwNewPosition [in]

Horizontal or vertical position. To get the minimum and maximum position, call GetMonitorDisplayAreaPosition.

Return value

If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. To get extended error information, call GetLastError.

Remarks

If this function is supported, the GetMonitorCapabilities function returns the MC_CAPS_DISPLAY_AREA_POSITION flag.

This function takes about 50 milliseconds to return.

The horizontal and vertical position are continuous monitor settings. For more information, see Using the High-Level Monitor Configuration Functions.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

HighLevelMonitorConfigurationAPI.h

Library

Dxva2.lib

DLL

Dxva2.dll

See also

Monitor Configuration Functions

 

 

Send comments about this topic to Microsoft

Build date: 2/3/2012

Community Additions

ADD
Show:
© 2014 Microsoft