Funktionreferenz


_WinAPI_MonitorFromWindow

Beschreibung anzeigen in

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

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

Parameter

$hWnd Ein Handle zu einem Fenster.
$iFlag [optional] Das Flag, welches festlegt, was zurückgegeben werden soll, wenn das Fenster 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 Fensters enthält. Alternativ wird ein Wert abhängig von der $MONITOR_* Konstante zurückgegeben.

Bemerkungen

Falls das Fenster aktuell minimert ist, verwendet die Funktion das Rechteck vor der Minimierung.
Konstanten sind in APIGdiConstants.au3 definiert

Siehe auch

Suche nach MonitorFromWindow in der MSDN Bibliothek.

Beispiel

#include <WinAPIGdi.au3>

_Example()

Func _Example()
    Local $hWindow = WinGetHandle("[REGEXPTITLE:(?i)(.*" & @ScriptName & ".*SciTE.*?)]")
    Local $hMonitor = _WinAPI_MonitorFromWindow($hWindow, $MONITOR_DEFAULTTONULL)
    ConsoleWrite('@@ Debug(' & @ScriptLineNumber & ') : $hMonitor = ' & $hMonitor & @CRLF & '>Fehlercode: ' & @error & '    Erweiterer Code: 0x' & Hex(@extended) & @CRLF) ;### Debug Konsole

    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