MSGBOXPARAMSA 구조체(winuser.h)

아티클
03/15/2023

메시지 상자를 표시하는 데 사용되는 정보를 포함합니다. MessageBoxIndirect 함수는 이 구조를 사용합니다.

구문

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

멤버

cbSize

형식: UINT

구조체 크기(바이트)입니다.

hwndOwner

형식: HWND

소유자 창에 대한 핸들입니다. 이 멤버는 NULL일 수 있습니다.

hInstance

형식: HINSTANCE

lpszIcon 멤버로 식별된 아이콘 리소스와 lpszText 또는 lpszCaption 멤버로 식별된 문자열 리소스가 포함된 모듈에 대한 핸들입니다.

lpszText

형식: LPCTSTR

표시할 메시지를 포함하는 null로 끝나는 문자열 또는 문자열 리소스의 식별자입니다.

lpszCaption

형식: LPCTSTR

메시지 상자 제목을 포함하는 null로 끝나는 문자열 또는 문자열 리소스의 식별자입니다. 이 멤버가 NULL인 경우 기본 제목 Error 가 사용됩니다.

dwStyle

형식:DWORD

대화 상자의 내용 및 동작입니다. 이 멤버는 MessageBoxEx 함수의 uType 매개 변수에 대해 설명된 플래그의 조합일 수 있습니다.

또한 메시지 상자에 lpszIcon 멤버가 지정한 아이콘을 표시하려는 경우 MB_USERICON 플래그(0x00000080L)를 지정할 수 있습니다.

lpszIcon

형식: LPCTSTR

아이콘 리소스를 식별합니다. 이 매개 변수는 Null로 끝나는 문자열 또는 MAKEINTRESOURCE 매크로에 전달된 정수 리소스 식별자일 수 있습니다.

표준 시스템 정의 아이콘 중 하나를 로드하려면 hInstance 멤버를 NULL 로 설정하고 lpszIcon 을 LoadIcon 함수와 함께 나열된 값 중 하나로 설정합니다.

dwStyle 멤버가 MB_USERICON 플래그를 지정하지 않으면 이 멤버는 무시됩니다.

dwContextHelpId

형식: DWORD_PTR

도움말 컨텍스트를 식별합니다. 도움말 이벤트가 발생하는 경우 이 값은 메시지 상자가 소유자 창 또는 콜백 함수로 보내는 HELPINFO 구조에 지정됩니다.

lpfnMsgBoxCallback

형식: MSGBOXCALLBACK

메시지 상자에 대한 도움말 이벤트를 처리하는 콜백 함수에 대한 포인터입니다. 콜백 함수의 형식은 다음과 같습니다.

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

이 멤버가 NULL인 경우 메시지 상자는 도움말 이벤트가 발생할 때 소유자 창에 WM_HELP 메시지를 보냅니다.

dwLanguageId

형식:DWORD

미리 정의된 푸시 단추에 포함된 텍스트를 표시할 언어입니다. 이 값은 MAKELANGID 매크로에서 반환된 형식이어야 합니다.

지원되는 언어 식별자 목록은 언어 식별자를 참조하세요. Windows의 지역화된 각 릴리스에는 일반적으로 제한된 언어 집합에 대한 리소스만 포함됩니다. 따라서 예를 들어 미국 버전은 LANG_ENGLISH 제공하고, 프랑스어 버전은 LANG_FRENCH 제공하고, 독일어 버전은 LANG_GERMAN 제공하고, 일본어 버전은 LANG_JAPANESE 제공합니다. 각 버전은 LANG_NEUTRAL 제공합니다. 이렇게 하면 dwLanguageId 매개 변수와 함께 사용할 수 있는 값 집합이 제한됩니다. 언어 식별자를 지정하기 전에 시스템에 설치된 로캘을 열거해야 합니다.

설명

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	winuser.h(Windows.h 포함)