MONITORENUMPROC 콜백 함수(winuser.h)
MonitorEnumProc 함수는 EnumDisplayMonitors 함수에 의해 호출되는 애플리케이션 정의 콜백 함수입니다.
MONITORENUMPROC 형식의 값은 MonitorEnumProc 함수에 대한 포인터입니다.
구문
MONITORENUMPROC Monitorenumproc;
BOOL Monitorenumproc(
HMONITOR unnamedParam1,
HDC unnamedParam2,
LPRECT unnamedParam3,
LPARAM unnamedParam4
)
{...}
매개 변수
unnamedParam1
디스플레이 모니터에 대한 핸들입니다. 이 값은 항상 NULL이 아닌 값입니다.
unnamedParam2
디바이스 컨텍스트에 대한 핸들입니다.
디바이스 컨텍스트에는 hMonitor로 식별된 디스플레이 모니터에 적합한 색 특성이 있습니다. 디바이스 컨텍스트의 클리핑 영역은 EnumDisplayMonitors의 hdc 매개 변수, EnumDisplayMonitors의 lprcClip 매개 변수가 가리키는 사각형 및 디스플레이 모니터 사각형으로 식별된 디바이스 컨텍스트의 표시 영역 교차로 설정됩니다.
EnumDisplayMonitors의 hdc 매개 변수가 NULL인 경우 이 값은 NULL입니다.
unnamedParam3
RECT 구조체에 대한 포인터입니다.
hdcMonitor가 NULL이 아닌 경우 이 사각형은 hdcMonitor 및 디스플레이 모니터 사각형으로 식별되는 디바이스 컨텍스트의 클리핑 영역의 교차점입니다. 사각형 좌표는 디바이스 컨텍스트 좌표입니다.
hdcMonitor가 NULL인 경우 이 사각형은 디스플레이 모니터 사각형입니다. 사각형 좌표는 가상 화면 좌표입니다.
unnamedParam4
EnumDisplayMonitors가 열거형 함수에 직접 전달하는 애플리케이션 정의 데이터입니다.
반환 값
열거형을 계속하려면 TRUE를 반환 합니다.
열거형을 중지하려면 FALSE를 반환합니다.
설명
EnumDisplayMonitors 함수를 사용하여 지정된 디바이스 컨텍스트의 표시 영역과 교차하는 디스플레이 모니터 집합과 선택적으로 클리핑 사각형을 열거할 수 있습니다. 이렇게 하려면 hdc 매개 변수를 NULL 이 아닌 값으로 설정하고 필요에 따라 lprcClip 매개 변수를 설정합니다.
EnumDisplayMonitors 함수를 사용하여 디바이스 컨텍스트를 제공하지 않고 데스크톱에서 하나 이상의 디스플레이 모니터를 열거할 수도 있습니다. 이렇게 하려면 EnumDisplayMonitors의 hdc 매개 변수를 NULL로 설정하고 필요에 따라 lprcClip 매개 변수를 설정합니다.
모든 경우에 EnumDisplayMonitors 는 계산된 열거형 집합의 각 디스플레이 모니터에 대해 지정된 MonitorEnumProc 함수를 한 번 호출합니다. MonitorEnumProc 함수는 항상 디스플레이 모니터에 대한 핸들을 받습니다.
EnumDisplayMonitors의 hdc 매개 변수가 NULL이 아닌 경우 MonitorEnumProc 함수는 디스플레이 모니터에 적합한 색 형식의 디바이스 컨텍스트에 대한 핸들도 받습니다. 그런 다음 디스플레이 모니터에 최적인 방식으로 디바이스 컨텍스트에 그릴 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h(Windows.h 포함) |