CREATESTRUCTA 구조체(winuser.h)

아티클
08/28/2023

애플리케이션의 창 프로시저에 전달되는 초기화 매개 변수를 정의합니다. 이러한 멤버는 CreateWindowEx 함수의 매개 변수와 동일합니다.

구문

typedef struct tagCREATESTRUCTA {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCSTR    lpszName;
  LPCSTR    lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCTA, *LPCREATESTRUCTA;

멤버

lpCreateParams

형식: LPVOID

창을 만드는 데 사용할 수 있는 추가 데이터를 포함합니다. CreateWindow 또는 CreateWindowEx 함수에 대한 호출의 결과로 창이 만들어 지는 경우 이 멤버는 함수 호출에 지정된 lpParam 매개 변수의 값을 포함합니다.

생성되는 창이 MDI 클라이언트 창인 경우 이 멤버는 CLIENTCREATESTRUCT 구조체에 대한 포인터를 포함합니다. 생성되는 창이 MDI 자식 창인 경우 이 멤버는 MDICREATESTRUCT 구조체에 대한 포인터를 포함합니다.

대화 상자 템플릿에서 창을 만드는 경우 이 멤버는 창 만들기 데이터의 크기(바이트)를 지정하는 SHORT 값의 주소입니다. 값 바로 뒤에 생성 데이터가 표시됩니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

hInstance

형식: HINSTANCE

새 창을 소유하는 모듈에 대한 핸들입니다.

hMenu

형식: HMENU

새 창에서 사용할 메뉴에 대한 핸들입니다.

hwndParent

형식: HWND

창이 자식 창인 경우 부모 창에 대한 핸들입니다. 창이 소유된 경우 이 멤버는 소유자 창을 식별합니다. 창이 자식 또는 소유 창이 아닌 경우 이 멤버는 NULL입니다.

cy

형식: int

새 창의 높이(픽셀)입니다.

cx

형식: int

새 창의 너비(픽셀)입니다.

y

형식: int

새 창의 왼쪽 위 모서리에 대한 y 좌표입니다. 새 창이 자식 창인 경우 좌표는 부모 창을 기준으로 합니다. 그렇지 않으면 좌표가 화면 원점과 상대적입니다.

x

형식: int

새 창의 왼쪽 위 모서리에 대한 x 좌표입니다. 새 창이 자식 창인 경우 좌표는 부모 창을 기준으로 합니다. 그렇지 않으면 좌표가 화면 원점과 상대적입니다.

style

형식: LONG

새 창의 스타일입니다. 가능한 값 목록은 창 스타일을 참조하세요.

lpszName

형식: LPCTSTR

새 창의 이름입니다.

lpszClass

형식: LPCTSTR

null로 끝나는 문자열 또는 새 창의 클래스 이름을 지정하는 원자에 대한 포인터입니다.

dwExStyle

형식:DWORD

새 창의 확장 창 스타일입니다. 가능한 값 목록은 확장 창 스타일을 참조하세요.

설명

lpszClass 멤버는 로컬(따라서 액세스할 수 없는) 원자에 대한 포인터를 포함할 수 있으므로 이 멤버를 사용하여 클래스 이름을 가져오지 않습니다. 대신 GetClassName 함수를 사용합니다.

포인터가 DWORD 정렬되지 않을 수 있으므로 UNALIGNED 형식을 사용하여 선언된 포인터를 사용하여 lpCreateParams 멤버가 나타내는 데이터에 액세스해야 합니다. 다음 예제에서 설명합니다.

typedef struct tagMyData 
{
    // Define creation data here. 
} MYDATA; 
 
typedef struct tagMyDlgData 
{ 
    SHORT   cbExtra; 
    MYDATA  myData; 
} MYDLGDATA, UNALIGNED *PMYDLGDATA; 
 
PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams);

참고

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

요구 사항


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