DLGPROC 콜백 함수(winuser.h)

아티클
08/27/2023

CreateDialog 및 DialogBox 함수 패밀리와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 모달 또는 모덜리스 대화 상자로 전송된 메시지를 처리합니다. DLGPROC 형식은 이 콜백 함수에 대한 포인터를 정의합니다. DialogProc 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

DLGPROC Dlgproc;

INT_PTR Dlgproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

매개 변수

unnamedParam1

형식: HWND

대화 상자에 대한 핸들입니다.

unnamedParam2

형식: UINT

메시지입니다.

unnamedParam3

형식: WPARAM

추가 메시지 관련 정보입니다.

unnamedParam4

형식: LPARAM

추가 메시지 관련 정보입니다.

형식: INT_PTR

일반적으로 대화 상자 프로시저는 메시지를 처리한 경우 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환해야 합니다. 대화 상자 프로시저가 FALSE를 반환하면 대화 관리자가 메시지에 대한 응답으로 기본 대화 상자 작업을 수행합니다.

대화 상자 프로시저에서 특정 반환 값이 필요한 메시지를 처리하는 경우 대화 상자 프로시저는 TRUE를 반환하기 직전에 SetWindowLong(hwndDlg, DWL_MSGRESULT, lResult)을 호출하여 원하는 반환 값을 설정해야 합니다. TRUE를 반환하기 전에 SetWindowLong을 즉시 호출해야 합니다. 이전에 수행하면 중첩된 대화 상자 메시지로 DWL_MSGRESULT 값을 덮어쓸 수 있습니다.

다음 메시지는 위에 명시된 일반 규칙에 대한 예외입니다. 반환 값의 의미 체계에 대한 자세한 내용은 특정 메시지에 대한 설명서를 참조하세요.

반환 값

없음

설명

대화 상자에 대화 상자 클래스를 사용하는 경우에만 대화 상자 프로시저를 사용해야 합니다. 기본 클래스이며 대화 상자 템플릿에 명시적 클래스가 지정되지 않은 경우에 사용됩니다. 대화 상자 프로시저는 창 프로시저와 유사하지만 원치 않는 메시지를 처리하기 위해 DefWindowProc 함수를 호출해서는 안 됩니다. 원치 않는 메시지는 대화 상자 창 프로시저에 의해 내부적으로 처리됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)