CreateWindowA 매크로(winuser.h)

겹치는 팝업 또는 자식 창을 만듭니다. 창 클래스, 창 제목, 창 스타일 및 창의 초기 위치 및 크기를 지정합니다(선택 사항). 또한 이 함수는 창의 부모 또는 소유자(있는 경우)와 창 메뉴를 지정합니다.

CreateWindow지원하는 스타일 외에도 확장 창 스타일을 사용하려면 CreateWindowEx 함수를 사용합니다.

통사론

HWND CreateWindowA(
  [in, optional] LPCSTR    lpClassName,
  [in, optional] LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       x,
  [in]           int       y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HMENU     hMenu,
  [in, optional] HINSTANCE hInstance,
  [in, optional] LPVOID    lpParam
);

매개 변수

[in, optional] lpClassName

형식: LPCSTR

null-terminated 문자열 또는 RegisterClass 또는 RegisterClassEx 함수에 대한 이전 호출에서 만든 클래스 원자입니다. 원자는 lpClassName;의 하위 단어여야 합니다. 상위 단어는 0이어야 합니다. lpClassName 문자열인 경우 창 클래스 이름을 지정합니다. 클래스 이름은 클래스를 등록하는 모듈이 창을 만드는 모듈이기도 한 경우 RegisterClass 또는 RegisterClassEx등록한 이름일 수 있습니다. 클래스 이름은 미리 정의된 시스템 클래스 이름일 수도 있습니다. 시스템 클래스 이름 목록은 주의 섹션을 참조하세요.

[in, optional] lpWindowName

형식: LPCSTR

창 이름입니다. 창 스타일에서 제목 표시줄을 지정하면 lpWindowName 가리키는 창 제목이 제목 표시줄에 표시됩니다. CreateWindow 사용하여 단추, 확인란 및 정적 컨트롤과 같은 컨트롤을 만드는 경우 lpWindowName 사용하여 컨트롤의 텍스트를 지정합니다. SS_ICON 스타일을 사용하여 정적 컨트롤을 만들 때 lpWindowName 사용하여 아이콘 이름 또는 식별자를 지정합니다. 식별자를 지정하려면 "#num" 구문을 사용합니다.

[in] dwStyle

형식: DWORD

생성되는 창의 스타일입니다. 이 매개 변수는창 스타일 값과 주의 섹션에 표시된 컨트롤 스타일의 조합일 수 있습니다.

[in] x

형식: int

창의 초기 가로 위치입니다. 겹치거나 팝업 창의 경우 x 매개 변수는 화면 좌표에서 창의 왼쪽 위 모서리에 있는 초기 x 좌표입니다. 자식 창의 경우 x 부모 창 클라이언트 영역의 왼쪽 위 모서리를 기준으로 창의 왼쪽 위 모퉁이의 x 좌표입니다. 이 매개 변수가 CW_USEDEFAULT설정되면 시스템은 창의 왼쪽 위 모서리에 대한 기본 위치를 선택하고 y 매개 변수를 무시합니다. CW_USEDEFAULT 겹치는 창에만 유효합니다. 팝업 또는 자식 창에 대해 지정되면 x 및 y 매개 변수가 0으로 설정됩니다.

[in] y

형식: int

창의 초기 세로 위치입니다. 겹치거나 팝업 창의 경우 y 매개 변수는 화면 좌표에서 창의 왼쪽 위 모서리에 있는 초기 y 좌표입니다. 자식 창의 경우 y 부모 창 클라이언트 영역의 왼쪽 위 모서리를 기준으로 자식 창의 왼쪽 위 모서리에 대한 초기 y 좌표입니다. 목록 상자의 경우 y 부모 창 클라이언트 영역의 왼쪽 위 모서리를 기준으로 목록 상자 클라이언트 영역의 왼쪽 위 모서리에 대한 초기 y 좌표입니다.

WS_VISIBLE 스타일 비트 집합을 사용하여 겹치는 창을 만들고 x 매개 변수를 CW_USEDEFAULT설정하면 y 매개 변수에 따라 창이 표시되는 방식이 결정됩니다. y 매개 변수가 CW_USEDEFAULT경우 창 관리자는 창이 만들어진 후 SW_SHOW 플래그를 사용하여 ShowWindow 호출합니다. y 매개 변수가 다른 값인 경우 창 관리자는 해당 값이 있는 ShowWindownCmdShow 매개 변수로 호출합니다.

[in] nWidth

형식: int

창의 너비(디바이스 단위)입니다. 겹치는 창의 경우 nWidth 창의 너비, 화면 좌표 또는 CW_USEDEFAULT. nWidthCW_USEDEFAULT경우 시스템에서 창의 기본 너비와 높이를 선택합니다. 기본 너비는 초기 x 좌표에서 화면의 오른쪽 가장자리까지 확장되며 기본 높이는 초기 y 좌표에서 아이콘 영역의 위쪽까지 확장됩니다. CW_USEDEFAULT 겹치는 창에만 유효합니다. 팝업 또는 자식 창에 대해 CW_USEDEFAULT 지정되면 nWidth nHeight 0으로 설정됩니다.

[in] nHeight

형식: int

창의 높이(디바이스 단위)입니다. 겹치는 창의 경우 nHeight 화면 좌표의 창 높이입니다. nWidthCW_USEDEFAULT설정되면 시스템은 nHeight무시합니다.

[in, optional] hWndParent

형식: HWND

생성되는 창의 부모 또는 소유자 창에 대한 핸들입니다. 자식 창 또는 소유 창을 만들려면 유효한 창 핸들을 제공합니다. 이 매개 변수는 팝업 창에 선택 사항입니다.

메시지 전용 창만들려면 기존 메시지 전용 창에 HWND_MESSAGE 또는 핸들을 제공합니다.

[in, optional] hMenu

형식: HMENU

메뉴에 대한 핸들이거나 창 스타일에 따라 자식 창 식별자를 지정합니다. 겹치거나 팝업 창의 경우 hMenu 창에 사용할 메뉴를 식별합니다. 클래스 메뉴를 사용할 경우 NULL 수 있습니다. 자식 창의 경우 hMenu 대화 상자 컨트롤에서 이벤트에 대해 부모에게 알리는 데 사용되는 정수 값인 자식 창 식별자를 지정합니다. 애플리케이션은 자식 창 식별자를 결정합니다. 부모 창이 같은 모든 자식 창에 대해 고유해야 합니다.

[in, optional] hInstance

형식: HINSTANCE

창과 연결할 모듈 인스턴스에 대한 핸들입니다.

[in, optional] lpParam

형식: LPVOID

WM_CREATE 메시지의 lParam 매개 변수가 가리키는 CREATESTRUCT 구조체(lpCreateParams 멤버)를 통해 창에 전달할 값에 대한 포인터입니다. 이 메시지는 반환되기 전에 이 함수가 만든 창으로 전송됩니다.

애플리케이션이 CreateWindow 호출하여 MDI 클라이언트 창을 만드는 경우 lpParamCLIENTCREATESTRUCT 구조를 가리킵니다. MDI 클라이언트 창에서 CreateWindow 호출하여 MDI 자식 창을 만드는 경우 lpParamMDICREATESTRUCT 구조를 가리킵니다. 추가 데이터가 필요하지 않은 경우 lpParam NULL 수 있습니다.

반환 값

형식: HWND

함수가 성공하면 반환 값은 새 창에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

반환하기 전에 CreateWindow 창 프로시저에 WM_CREATE 메시지를 보냅니다. 겹치는 팝업 및 자식 창의 경우 CreateWindowWM_CREATE, WM_GETMINMAXINFO및 WM_NCCREATE 메시지를 창으로 보냅니다. WM_CREATE 메시지의 lParam 매개 변수에는 CREATESTRUCT 구조체에 대한 포인터가 포함되어 있습니다. WS_VISIBLE 스타일을 지정하면 CreateWindow 창을 활성화하고 표시하는 데 필요한 모든 메시지를 창에 보냅니다.

만든 창이 자식 창인 경우 기본 위치는 Z 순서의 맨 아래에 있습니다. 만든 창이 최상위 창인 경우 기본 위치는 Z 순서의 맨 위에 있지만 만든 창 자체가 맨 위에 있지 않으면 맨 위 창 아래에 있습니다.

작업 표시줄에 만든 창에 대한 단추가 표시되는지 여부를 제어하는 방법에 대한 자세한 내용은 작업 표시줄 단추관리를 참조하세요.

창을 제거하는 방법에 대한 자세한 내용은 DestroyWindow 함수를 참조하세요.

다음 미리 정의된 시스템 클래스는 lpClassName 매개 변수에 지정할 수 있습니다. dwStyle 매개 변수에서 사용할 수 있는 해당 컨트롤 스타일을 확인합니다.

CreateWindow 아래와 같이 CreateWindowEx 함수에 대한 호출로 구현됩니다.

#define CreateWindowA(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExA(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#define CreateWindowW(lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)\
CreateWindowExW(0L, lpClassName, lpWindowName, dwStyle, x, y, nWidth, nHeight, hWndParent, hMenu, hInstance, lpParam)

#ifdef UNICODE
#define CreateWindow  CreateWindowW
#else
#define CreateWindow  CreateWindowA
#endif

예제

예제는 창 클래스 사용참조하세요.

요구 사항

참고 항목

여러 문서 인터페이스 대한

공용 제어 창 클래스

개념

CreateWindowEx

DestroyWindow

EnableWindow

기타 리소스

참조

RegisterClass

RegisterClassEx

ShowWindow

WM_COMMAND

WM_CREATE

WM_GETMINMAXINFO

WM_NCCREATE

WM_PAINT

windows