Function Reference


_WinAPI_MonitorFromPoint

Retrieves a handle to the display monitor that contains a specified point

#include <WinAPIGdi.au3>
_WinAPI_MonitorFromPoint ( $tPOINT [, $iFlag = 1] )

Parameters

$tPOINT $tagPOINT structure that specifies the point of interest in virtual-screen coordinates.
$iFlag [optional] The flag that specifies the function's return value if the point is not contained within any display
monitor. This parameter can be one of the following values.
$MONITOR_DEFAULTTONULL
$MONITOR_DEFAULTTONEAREST (Default)
$MONITOR_DEFAULTTOPRIMARY

Return Value

Success: A handle to the display monitor that contains a specified point, or the value depends on the
$MONITOR_* constant.
Failure: 0 and sets the @error flag to non-zero.

See Also

Search MonitorFromPoint in MSDN Library.

Example

#include <WinAPIGdi.au3>
#include <WinAPIMisc.au3>

Local $tPos = _WinAPI_GetMousePos()
DllStructSetData($tPos, 1, 12000)
Local $hMonitor = _WinAPI_MonitorFromPoint($tPos, 0)
ConsoleWrite('@@ Debug(' & @ScriptLineNumber & ') : $hMonitor = ' & $hMonitor & @CRLF & '>Error code: ' & @error & '    Extended code: 0x' & Hex(@extended) & @CRLF) ;### Debug Console

Local $aData = _WinAPI_GetMonitorInfo($hMonitor)
If IsArray($aData) Then
    ConsoleWrite('Handle:      ' & $hMonitor & @CRLF)
    ConsoleWrite('Rectangle:   ' & DllStructGetData($aData[0], 1) & ', ' & DllStructGetData($aData[0], 2) & ', ' & DllStructGetData($aData[0], 3) & ', ' & DllStructGetData($aData[0], 4) & @CRLF)
    ConsoleWrite('Work area:   ' & DllStructGetData($aData[1], 1) & ', ' & DllStructGetData($aData[1], 2) & ', ' & DllStructGetData($aData[1], 3) & ', ' & DllStructGetData($aData[1], 4) & @CRLF)
    ConsoleWrite('Primary:     ' & $aData[2] & @CRLF)
    ConsoleWrite('Device name: ' & $aData[3] & @CRLF)
EndIf