DialogBoxIndirectParamA 함수(winuser.h)

아티클
03/04/2024

메모리의 대화 상자 템플릿에서 모달 대화 상자를 만듭니다. 대화 상자를 표시하기 전에 함수는 애플리케이션 정의 값을 대화 상자 프로시저에 WM_INITDIALOG 메시지의 lParam 매개 변수로 전달합니다. 애플리케이션은 이 값을 사용하여 대화 상자 컨트롤을 초기화할 수 있습니다.

구문

INT_PTR DialogBoxIndirectParamA(
  [in, optional] HINSTANCE       hInstance,
  [in]           LPCDLGTEMPLATEA hDialogTemplate,
  [in, optional] HWND            hWndParent,
  [in, optional] DLGPROC         lpDialogFunc,
  [in]           LPARAM          dwInitParam
);

매개 변수

[in, optional] hInstance

형식: HINSTANCE

대화 상자를 만드는 모듈에 대한 핸들입니다.

[in] hDialogTemplate

형식: LPCDLGTEMPLATE

DialogBoxIndirectParam이 대화 상자를 만드는 데 사용하는 템플릿입니다. 대화 상자 템플릿은 대화 상자를 설명하는 헤더와 대화 상자의 각 컨트롤을 설명하는 하나 이상의 추가 데이터 블록으로 구성됩니다. 템플릿은 표준 형식 또는 확장 형식을 사용할 수 있습니다.

대화 상자의 표준 템플릿에서 헤더는 DLGTEMPLATE 구조와 추가 가변 길이 배열입니다. 각 컨트롤에 대한 데이터는 DLGITEMTEMPLATE 구조와 추가 가변 길이 배열로 구성됩니다.

대화 상자의 확장 템플릿에서 헤더는 DLGTEMPLATEEX 형식을 사용하고 컨트롤 정의는 DLGITEMTEMPLATEEX 형식을 사용합니다.

[in, optional] hWndParent

형식: HWND

대화 상자를 소유하는 창에 대한 핸들입니다.

[in, optional] lpDialogFunc

형식: DLGPROC

대화 상자 프로시저에 대한 포인터입니다. 대화 상자 프로시저에 대한 자세한 내용은 DialogProc을 참조하세요.

[in] dwInitParam

형식: LPARAM

WM_INITDIALOG 메시지의 lParam 매개 변수에 있는 대화 상자에 전달할 값입니다.

반환 값

형식: INT_PTR

함수가 성공하면 반환 값은 대화 상자를 종료하는 데 사용된 EndDialog 함수 호출에 지정된 nResult 매개 변수입니다.

hWndParent 매개 변수가 잘못되어 함수가 실패하면 반환 값은 0입니다. 이 함수는 이전 버전의 Windows와의 호환성을 위해 이 경우 0을 반환합니다. 다른 이유로 인해 함수가 실패하면 반환 값은 –1입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

DialogBoxIndirectParam 함수는 CreateWindowEx 함수를 사용하여 대화 상자를 만듭니다. 그런 다음 DialogBoxIndirectParam 은 대화 상자 프로시저에 WM_INITDIALOG 메시지를 보냅니다. 템플릿이 DS_SETFONT 또는 DS_SHELLFONT 스타일을 지정하는 경우 함수는 대화 상자 프로시저에 WM_SETFONT 메시지를 보냅니다. 함수는 템플릿이 WS_VISIBLE 스타일을 지정하는지 여부에 관계없이 대화 상자를 표시하고, 소유자 창을 사용하지 않도록 설정하고, 대화 상자에 대한 메시지를 검색하고 디스패치하는 자체 메시지 루프를 시작합니다.

대화 상자 프로시저가 EndDialog 함수를 호출하면 DialogBoxIndirectParam은 대화 상자를 삭제하고, 메시지 루프를 종료하고, 소유자 창을 사용하도록 설정하고(이전에 사용하도록 설정한 경우) EndDialog를 호출할 때 대화 상자 프로시저에서 지정한 nResult 매개 변수를 반환합니다.

표준 대화 상자 템플릿에서 DLGTEMPLATE 구조체와 각 DLGITEMTEMPLATE 구조체는 DWORD 경계에 맞춰야 합니다. DLGITEMTEMPLATE 구조 뒤에 있는 생성 데이터 배열도 DWORD 경계에 맞춰야 합니다. 템플릿의 다른 모든 가변 길이 배열은 WORD 경계에 맞춰야 합니다.

확장 대화 상자 템플릿에서 DLGTEMPLATEEX 헤더와 각 DLGITEMTEMPLATEEX 컨트롤 정의는 DWORD 경계에 맞춰야 합니다. DLGITEMTEMPLATEEX 구조 뒤에 있는 생성 데이터 배열(있는 경우)도 DWORD 경계에 맞춰야 합니다. 템플릿의 다른 모든 가변 길이 배열은 WORD 경계에 맞춰야 합니다.

대화 상자 템플릿의 모든 문자열(예: 대화 상자 및 단추의 제목)은 유니코드 문자열이어야 합니다.

참고

winuser.h 헤더는 DIALOGBoxIndirectParam을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-dialogbox-l1-1-0(Windows 8 도입)