Funktionreferenz


_WinAPI_MonitorFromRect

Beschreibung anzeigen in

Ermittelt ein Handle zu der Monitornummer welcher den größten Anteil eines festgelegten Rechtecks enthält

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

Parameter

$tRECT $tagRECT Struktur, welche das Rechteck der virtuellen Koordinaten enthält.
$iFlag [optional] Das Flag, welches festlegt, was zurückgegeben werden soll, wenn das Rechteck in keinem Monitor zu sehen ist.
Dieser Parameter kann einer der folgenden Werte sein.
$MONITOR_DEFAULTTONULL
$MONITOR_DEFAULTTONEAREST (Standard)
$MONITOR_DEFAULTTOPRIMARY

Rückgabewert

Gibt ein Handle zu der Monitornummer zurück, welcher den größten Anteil eines festgelegten Rechtecks enthält. Alternativ wird ein Wert abhängig von der $MONITOR_* Konstante zurückgegeben.

Bemerkungen

Konstanten sind in APIGdiConstants.au3 definiert

Siehe auch

Suche nach MonitorFromRect in der MSDN Bibliothek.

Beispiel

#include <WinAPIGdi.au3>
#include <WinAPISysWin.au3>

_Example()

Func _Example()
    Local $hWindow = WinGetHandle("[REGEXPTITLE:(?i)(.*" & @ScriptName & ".*SciTE.*?)]")
    Local $tagRECT = _WinAPI_GetWindowRect($hWindow)
    Local $hMonitor = _WinAPI_MonitorFromRect($tagRECT, $MONITOR_DEFAULTTONEAREST)

    ConsoleWrite('@@ Debug(' & @ScriptLineNumber & ') : $hMonitor = ' & $hMonitor & @CRLF & '>Fehlercode: ' & @error & '    Erweiterer Code: 0x' & Hex(@extended) & @CRLF) ;### Debug Console

    Local $aData = _WinAPI_GetMonitorInfo($hMonitor)
    If Not @error Then
        ConsoleWrite('Handle:         ' & $hMonitor & @CRLF)
        ConsoleWrite('Rechteck:       ' & DllStructGetData($aData[0], 1) & ', ' & DllStructGetData($aData[0], 2) & ', ' & DllStructGetData($aData[0], 3) & ', ' & DllStructGetData($aData[0], 4) & @CRLF)
        ConsoleWrite('Arbeitsbereich: ' & DllStructGetData($aData[1], 1) & ', ' & DllStructGetData($aData[1], 2) & ', ' & DllStructGetData($aData[1], 3) & ', ' & DllStructGetData($aData[1], 4) & @CRLF)
        ConsoleWrite('Primär:         ' & $aData[2] & @CRLF)
        ConsoleWrite('Gerätename:     ' & $aData[3] & @CRLF)
    EndIf
EndFunc   ;==>_Example