CreateWindowEx(A)

CreateWindowEx(A)

새로운 윈도우를 작성합니다.

HWND CreateWindowExA(
    DWORD  dwExStyle,     // 확장 윈도우 스타일
    PCTSTR pszClassName,  // 윈도우 클래스명
    PCTSTR pszWindowName, // 윈도우명
    DWORD  dwStyle,       // 윈도우 스타일
    int    x,             // x좌표
    int    y,             // y좌표
    int    nWidth,        // x사이즈
    int    nHeight,       // y사이즈
    HWND   hWndParent,    // 친윈도우의 핸들
    HMENU  hMenu,         // 메뉴 핸들 또는 아이 윈도우ID
    HINSTANCE hInstance,  // 인스턴스 핸들
    PVOID  pParam         // 윈도우 작성 데이터
);

USER32.DLL

인수

dwExStyle

윈도우의 확장 스타일(을)를 지정합니다.

pszClassName

윈도우 클래스의 이름을 나타내는 문자열에의 포인터를 지정합니다.윈도우 클래스의 이름은, RegisterClass 함수로 등록한 클래스명인가, 정의가 끝난 컨트롤의 클래스명이 됩니다.클래스명의 대문자·소문자는 구별되지 않습니다.정의가 끝난 컨트롤의 클래스명은, 이하의 것이 있습니다.

클래스명	작성되는 윈도우
"BUTTON"	버튼 컨트롤
"COMBOBOX"	combobox
"EDIT"	에디트 박스
"LISTBOX"	리스트 박스
"MDICLIENT"	MDI클라이언트 윈도우
"SCROLLBAR"	스크롤 바
"STATIC"	스태틱 컨트롤
(이하 코먼 컨트롤)
"SysAnimate32" (ANIMATE_CLASS)	애니메이션 컨트롤
"msctls_hotkey32" (HOTKEY_CLASS)	hot key 컨트롤
"msctls_progress32" (PROGRESS_CLASS)	progress bar
"msctls_statusbar32" (STATUSCLASSNAME)	상태 바
"ToolbarWindow32" (TOOLBARCLASSNAME)	툴바
"tooltips_class32" (TOOLTIPS_CLASS)	툴 팁 컨트롤
"msctls_trackbar32" (TRACKBAR_CLASS)	트럭 바
"msctls_updown32" (UPDOWN_CLASS)	업다운 컨트롤
"ComboBoxEx32" (WC_COMBOBOXEX)	확장 combobox
"SysHeader32" (WC_HEADER)	헤더 컨트롤
"SysListView32" (WC_LISTVIEW)	리스트뷰
"SysTabControl32" (WC_TABCONTROL)	탭 콘트롤
"SysTreeView32" (WC_TREEVIEW)	트리뷰
"SysDateTimePick32" (DATETIMEPICK_CLASS)	Comctl32.dll Version 4.70 이후： DTP 컨트롤
"SysMonthCal32" (MONTHCAL_CLASS)	Comctl32.dll Version 4.70 이후： 월간 예정표 컨트롤
"ReBarWindow32" (REBARCLASSNAME)	Comctl32.dll Version 4.70 이후： 레버 컨트롤
"SysIPAddress32" (WC_IPADDRESS)	Comctl32.dll Version 4.71 이후： IP주소 컨트롤
"SysPager" (WC_PAGESCROLLER)	Comctl32.dll Version 4.71 이후： pager 컨트롤

pszWindowName

윈도우명을 나타내는 문자열의 주소를 지정합니다.

dwStyle

작성된다 윈도우 스타일(을)를 지정합니다.

각각의 정의가 끝난 컨트롤은, 독자적인 스타일을 가지는 것이 있습니다.

코먼 컨트롤 이외의 정의가 끝난 컨트롤을 작성하는 경우는, 상기의 스타일 외에 컨트롤 고유의 스타일(을)를 조합해 지정할 수 있습니다.

코먼 컨트롤을 작성하는 경우는, 상기의 스타일 외에 코먼 컨트롤 고유의 스타일(을)를 조합해 지정할 수 있습니다.

x, y

작성하는 윈도우의 좌표를 지정합니다.오버랩 윈도우나 팝업 윈도우를 작성할 때는 화면 좌표로, 아이 윈도우를 작성할 때는 클라이언트 좌표로 지정합니다.

오버랩 윈도우를 작성할 때에 0x80000000 (CW_USEDEFAULT) (을)를 지정하면, 디폴트의 위치에 윈도우를 작성합니다.그 외의 윈도우를 작성할 때에 0x80000000 (CW_USEDEFAULT) (을)를 지정하면 0 (으)로 설정됩니다.

nWidth, nHeight

작성하는 윈도우의 사이즈를 지정합니다.

오버랩 윈도우를 작성할 때에 0x80000000 (CW_USEDEFAULT) (을)를 지정하면, 디폴트의 위치에 윈도우를 작성합니다.그 외의 윈도우의 경우는 0 (으)로 설정됩니다.

hWndParent

작성되는 윈도우의 친윈도우의 핸들을 지정합니다.친윈도우를 가지지 않는 경우는 0 (NULL) (을)를 지정합니다. dwStyle 파라미터가 WS_CHILD 스타일을 포함할 때는 유효한 핸들을 지정하지 않으면 안됩니다.

hMenu

오버랩 윈도우나 팝업 윈도우를 작성하는 경우는 메뉴의 핸들을 지정합니다.

아이 윈도우(컨트롤)를 작성하는 경우는 아이 윈도우 ID (컨트롤 ID )(을)를 지정합니다.아이 윈도우 ID (이)란, 컨트롤이 그 친윈도우에 이벤트를 통지할 때의 윈도우 식별치입니다.같은 친윈도우를 가지는 모든 아이 윈도우는, 각각 고유의 ID (을)를 가질 필요가 있습니다.

hInstance

윈도우에 관련지을 수 있었던 모듈의 인스턴스 핸들을 지정합니다.

pParam

WM_CREATE 메세지의 lParam 파라미터로서 건네받는,CREATESTRUCT 구조체의 주소를 지정합니다. MDI 클라이언트 윈도우를 작성하는 경우는, CLIENTCREATESTRUCT 구조체에의 포인터를 지정합니다.불필요한 경우는 0 (NULL) (을)를 지정합니다.

반환값

성공하면, 작성된 윈도우의 핸들이 돌아갑니다.

실패하면 0 (NULL) 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후