MSGBOXPARAMSA 구조체(winuser.h)

메시지 상자를 표시하는 데 사용되는 정보를 포함합니다. 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경우 오류 기본 제목이 사용됩니다.

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 포함)

참고 항목

개념

대화 상자

HELPINFO

LoadIcon

메이킨트레소스

MAKELANGID

MessageBoxEx

messageBoxIndirect

기타 리소스

참조

WM_HELP