MonitorEnumProc

Wartość typu MONITORENUMPROC jest wskaźnikiem do funkcji MonitorEnumProc.

Składnia

Argumenty

Argument	Opis
hMonitor	Uchwyt do wyświetlacza monitora. Ta wartość nie powinna nigdy wynosić NULL.
hdcMonitor	Uchwyt do kontekstu urządzenia, w którym znajdują się atrybuty kolorów dla danego wyświetlacza monitora w argumencie hMonitor. Fragment obszaru kontekstu urządzenia jest ustawiony pomiędzy widzialnym obszarem kontekstu urządzenia oznaczonym przez argumenty hdc i lprcClip funkcji » WinAPI ♦ EnumDisplayMonitors oraz prostokąt wyświetlacza monitora. Wartość tego argumentu wynosi NULL, jeśli argument hdc funkcji » WinAPI ♦ EnumDisplayMonitors jest równy NULL.
lprcMonitor	Wskaźnik do struktury RECT. Jeśli argument hdcMonitor ma wartość inną, niż NULL, ten prostokąt jest ustawiony pomiędzy wyznaczonym obszarem kontekstu urządzenia określonym przez argument hdcMonitor i prostokątem wyświetlacza monitora. Współrzędne prostokąta są takie same, jak współrzędne kontekstu urządzenia. Jeśli wartość argumentu hdcMonitor wynosi NULL, ten prostokąt jest taki sam, jak prostokąt wyświetlacza monitora. Współrzędne prostokąta są takie same, jak współrzędne ekranu wirtualnego.
dwData	Zdefiniowane przez programistę dane, które funkcja » WinAPI ♦ EnumDisplayMonitors przekazuje bezpośrednio do funkcji wyliczeniowej.

Zwracana wartość

Jeśli funkcja ma kontynuować wyliczenie, zwraca TRUE, inaczej zwraca FALSE.

Dodatkowe informacje

Można użyć funkcji _{» WinAPI ♦} EnumDisplayMonitors do wyliczania wyświetlaczy monitorów ustawionych pomiędzy widocznym obszarem określonego kontekstu urządzenia lub (opcjonalnie) fragmentu prostokąta. Aby to zrobić, należy wywołać funkcję _{» WinAPI ♦} EnumDisplayMonitors z argumentem hdc o wartości innej, niż NULL. Można również użyć funkcji _{» WinAPI ♦} EnumDisplayMonitors do wyliczenia jednego lub więcej wyświetlaczy monitorów na pulpicie, przed dostarczeniem kontekstu urządzenia. Aby to zrobić, wywołaj funkcję _{» WinAPI ♦} EnumDisplayMonitors z argumentem hdc równym NULL. We wszystkich przypadkach, funkcja _{» WinAPI ♦} EnumDisplayMonitors wywołuje zdefiniowaną przez programistę funkcję MonitorEnumProc dla wszystkich wyświetlaczy monitorów. Funkcja MonitorEnumProc zawsze pobiera uchwyt do wyświetlacza monitora. Jeśli funkcja _{» WinAPI ♦} EnumDisplayMonitors zostanie wywołana z argumentem hdc o wartości innej, niż NULL, to funkcja MonitorEnumProc zwróci również uchwyt do kontekstu urządzenia ze schematem kolorów wyświetlacza monitora. Następnie można rysować na tym kontekście urządzenia w sposób optymalny dla wyświetlacza monitora.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional (tylko aplikacje biurowe)
Minimalny obsługiwany serwer	Windows 2000 Server (tylko aplikacje biurowe)
Nagłówek	Winuser.h (wewnątrz Windows.h)

Zagadnienia powiązane

EnumDisplayMonitors	Wylicza wyświetlacze monitorów, które mają wspólny obszar utworzony przez połączenie ograniczającego prostokąta z widocznym obszarem kontekstu urządzenia. (funkcja)

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/dd145061%28v=VS.85%29.aspx