MONITORENUMPROC 콜백 함수(winuser.h)

EnumDisplayMonitors 함수와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. MONITORENUMPROC 형식은 이 콜백 함수에 대한 포인터를 정의합니다. MonitorEnumProc 는 애플리케이션 정의 함수 이름의 자리 표시자입니다.

Syntax

MONITORENUMPROC Monitorenumproc;

BOOL Monitorenumproc(
  HMONITOR unnamedParam1,
  HDC unnamedParam2,
  LPRECT unnamedParam3,
  LPARAM unnamedParam4
)
{...}

매개 변수

unnamedParam1

형식: HMONITOR

디스플레이 모니터에 대한 핸들입니다. 이 값은 항상 NULL이 아닌 값입니다. 이 매개 변수의 이름은 일반적으로 hMonitor입니다.

unnamedParam2

형식: HDC

디바이스 컨텍스트에 대한 핸들입니다. 이 매개 변수의 이름은 일반적으로 hdcMonitor입니다.

디바이스 컨텍스트에는 hMonitor로 식별되는 디스플레이 모니터에 적합한 색 특성이 있습니다. 디바이스 컨텍스트의 클리핑 영역은 EnumDisplayMonitors의 hdc 매개 변수, EnumDisplayMonitors의 lprcClip 매개 변수가 가리키는 사각형 및 디스플레이 모니터 사각형으로 식별되는 디바이스 컨텍스트의 표시 영역 교차로 설정됩니다.

EnumDisplayMonitors의 hdc 매개 변수가 NULL인 경우 이 값은 NULL입니다.

unnamedParam3

형식: LPRECT

RECT 구조체에 대한 포인터입니다. 이 매개 변수의 이름은 일반적으로 lprcMonitor입니다.

hdcMonitor가 NULL이 아닌 경우 이 사각형은 hdcMonitor 및 디스플레이 모니터 사각형으로 식별되는 디바이스 컨텍스트의 클리핑 영역의 교집합입니다. 사각형 좌표는 디바이스 컨텍스트 좌표입니다.

hdcMonitor가 NULL이면 이 사각형은 디스플레이 모니터 사각형입니다. 사각형 좌표는 가상 화면 좌표입니다.

unnamedParam4

형식: LPARAM

EnumDisplayMonitors가 열거형 함수에 직접 전달하는 애플리케이션 정의 데이터입니다. 이 매개 변수의 이름은 일반적으로 dwData입니다.

반환 값

형식: BOOL

열거형을 계속하려면 TRUE를 반환 합니다.

열거를 중지하려면 FALSE를 반환합니다.

비고

EnumDisplayMonitors 함수를 사용하여 지정된 디바이스 컨텍스트의 표시 영역과 교차하는 디스플레이 모니터 집합을 열거하고 선택적으로 클리핑 사각형을 열거할 수 있습니다. 이렇게 하려면 hdc 매개 변수를 NULL 이 아닌 값으로 설정하고 필요에 따라 lprcClip 매개 변수를 설정합니다.

EnumDisplayMonitors 함수를 사용하여 디바이스 컨텍스트를 제공하지 않고 데스크톱에서 하나 이상의 디스플레이 모니터를 열거할 수도 있습니다. 이렇게 하려면 EnumDisplayMonitors의 hdc 매개 변수를 NULL로 설정하고 필요에 따라 lprcClip 매개 변수를 설정합니다.

모든 경우에 EnumDisplayMonitors 는 계산된 열거형 집합의 각 디스플레이 모니터에 대해 지정된 MonitorEnumProc 함수를 한 번 호출합니다. MonitorEnumProc 함수는 항상 디스플레이 모니터에 대한 핸들을 받습니다.

EnumDisplayMonitors의 hdc 매개 변수가 NULL이 아닌 경우 MonitorEnumProc 함수는 디스플레이 모니터에 적합한 색 형식의 디바이스 컨텍스트에 대한 핸들도 받습니다. 그런 다음 디스플레이 모니터에 최적인 방식으로 디바이스 컨텍스트에 그릴 수 있습니다.

요구 사항

참고하십시오

EnumDisplayMonitors

여러 디스플레이 모니터 함수

여러 디스플레이 모니터 개요