https://docs.microsoft.com/ko-kr/windows/win32/learnwin32/your-first-windows-program

위 내용을 참고하여 정리한 내용입니다.

---

모듈1. 첫 번째 Windows 프로그램

4) 창 그리기
5) 창 닫기
6) 어플리케이션 상태 관리

---

📍 Creating a Window

창을 처음 표시할 때나, 창의 일부를 다시 그려야 할 때 운영체제는 창에 WM_PAINT 메세지를 보낸다.

우리는 여기서 Client Area만 그리면 된다. 그리고 업데이트 영역이 남아있는 동안에는 다른 WM_PAINT 메세지를 보낼 필요가 없다는 것을 운영체제에게 알린다. 이 업데이트 영역은 클라이언트 영역 그리기를 완료한 후 지우면 된다.

다른 창으로 창의 일부를 가렸다가 다시 보이게 된 상황에서도 해당 부분이 업데이트 영역에 추가되고 창에 다른 WM_PAINT 메세지가 표시된다.

창을 늘이는 경우에도 마찬가지이다.

🔎 전체 클라이언트 영역 단색으로 채우기

switch (uMsg)
{
    case WM_PAINT:
    {
        PAINTSTRUCT ps;
        HDC hdc = BeginPaint(hwnd, &ps);

        // All painting occurs here, between BeginPaint and EndPaint.

        FillRect(hdc, &ps.rcPaint, (HBRUSH) (COLOR_WINDOW+1));

        EndPaint(hwnd, &ps);
    }
    return 0;
}

1) BeginPaint 함수를 호출하여 그리기 작업 시작
: PAINTSTRUCT 구조체를 요청에 대한 정보로 채우는 함수

2) 현재 업데이트 영역은 PAINTSTRUCT의 rcPaint 멤버에 저장
(업데이트 영역은 클라이언트 영역 기준)

3) FillRect로 시스템 정의 창 배경색을 이용하여 업데이트 영역을 단일 색으로 채우기

4) 그리기 작업이 완료되면 EndPaint 호출

🔎 FillRect

FillRect(hdc, &ps.rcPaint, (HBRUSH) (COLOR_WINDOW+1));

두번째 매개변수 : 채울 사각형의 좌표
여기서는 PAINTSTRUCT의 rcPaint 멤버이며 rcPaint에는 전체 클라이언트 영역이 포함된다.

---

📍 Closing the Window

사용자가 창을 닫으면 창에서 WM_CLOSE 메세지가 수신된다. WM_CLOSE 메세지는 창을 닫기 전에 사용자에게 메세지를 표시하며 창을 닫으려면 DestroyWindow 함수를 호출, 그렇지 않으면 운영 체제에서 메세지를 무시하고 창을 삭제하지 않는다(WM_CLOSE 메세지가 0을 반환)

🔎 프로그램이 WM_CLOSE를 처리하는 방법

case WM_CLOSE:
    if (MessageBox(hwnd, L"Really quit?", L"My application", MB_OKCANCEL) == IDOK)
    {
        DestroyWindow(hwnd);
    }
    // Else: User canceled. Do nothing.
    return 0;

이 경우 사용자가 확인(OK)을 클릭하면 프로그램에서 DestroyWindow를 호출하고, 그렇지 않고 취소(Cancle)을 클릭하면 호출을 건너뛰고 창이 열린 상태로 유지된다.

사용자에게 메세지를 표시하지 않고 창을 닫으려면 DefWindowProc을 이용할 수 있다. WM_CLOSE의 경우 DefWindowProc은 DestroyWindow를 자동으로 호출한다.

창이 제거될 때 WM_DESTROY 메세지를 받는다. 이 메세지는 소멸하기 전에 전송되며, 일반적으로 PostQuitMessage를 호출하여 WM_DESTOY에 응답한다.

case WM_DESTROY:
	PostQuitMessage(0);
    return 0; 

🔎 WM_CLOSE 및 WM_DESTROY 메세지를 처리하는 일반적인 방법

---

📍 Managing Application State

윈도우 프로시저는 상태가 저장되지 않기 때문에 한 함수 호출에서 다음 함수 호출로 어플리케이션의 상태를 추적하는 방법이 필요하다.

🔎 전역 변수에 모두 배치

소규모 프로그램에서 good.
대규모에서는 좋지않다. (윈도우 프로시저가 많다, 전역 변수 확산)

🔎 CreateWindowEx 함수

모든 데이터 구조를 창에 전달한는 방법을 제공한다. 이 함수가 호출되면 윈도우 프로시저에 다음 두 개의 메세지를 보낸다.

• WM_NCCREATE
• WM_CREATE

이 두 메세지는 창이 표시되기 전에 전송된다.

CreateWindowEx의 마지막 매개 변수는 void* 형식의 포인터이다.

이제 이 매개변수를 사용하여 어플리케이션 데이터를 창에 전달하는 방법을 알아보자.

1) 상태 정보를 보유하는 클래스 또는 구조체를 정의한다.

struct StateInfo { };

2) CreateWindowEx를 호출하는 경우 최종 void* 매개 변수에서 이 구조체에 대한 포인터를 전달

StateInfo *pState = new (std::nothrow) StateInfo;

if (pState == NULL)
{
    return 0;
}

// Initialize the structure members (not shown).

HWND hwnd = CreateWindowEx(
    0,                              // Optional window styles.
    CLASS_NAME,                     // Window class
    L"Learn to Program Windows",    // Window text
    WS_OVERLAPPEDWINDOW,            // Window style

    // Size and position
    CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,

    NULL,       // Parent window    
    NULL,       // Menu
    hInstance,  // Instance handle
    pState      // Additional application data
    );

WM_NCCREATE 및 WM_CREATE 각 메세지의 lParam 매개 변수는 CREATESTRUCT 구조체에 대한 포인터이다. 그리고 이 CREATETRUCT 구조체에는 CreateWindowEx에 전달한 포인터가 포함되어 있다.

🔎 데이터 구조에 대한 포인터 추출

1) lParam 매개 변수를 캐스팅하여 CREATESTRUCT 구조체 얻기

CREATESTRUCT *pCreate = reinterpret_cast<CREATESTRUCT*>(lParam);

2) lpCreateParams를 캐스팅하여 사용자 고유의 데이터 구조에 대한 포인터 얻기

pState = reinterpret_cast<StateInfo*>(pCreate->lpCreateParams);

3) SetWindowLongPtr 함수를 호출하고 포인터를 데이터 구조에 전달

SetWindowLongPtr(hwnd, GWLP_USERDATA, (LONG_PTR)pState);

: 이렇게 하면 항상 GetWindowLongPtr을 호출하여 창에서 포인터를 다시 얻을 수 있다.

LONG_PTR ptr = GetWindowLongPtr(hwnd, GWLP_USERDATA);
StateInfo *pState = reinterpret_cast<StateInfo*>(ptr);

이 방법은 클래스의 창을 2개 이상 만드는 경우에 유용하다. GetWindwoLongPtr의 호출을 작은 도우미 함수로 래핑하는 것이 편리하다.

inline StateInfo* GetAppState(HWND hwnd)
{
    LONG_PTR ptr = GetWindowLongPtr(hwnd, GWLP_USERDATA);
    StateInfo *pState = reinterpret_cast<StateInfo*>(ptr);
    return pState;
}

🔎 최종적으로 작성한 윈도우 프로시저

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    StateInfo *pState;
    if (uMsg == WM_CREATE)
    {
        CREATESTRUCT *pCreate = reinterpret_cast<CREATESTRUCT*>(lParam);
        pState = reinterpret_cast<StateInfo*>(pCreate->lpCreateParams);
        SetWindowLongPtr(hwnd, GWLP_USERDATA, (LONG_PTR)pState);
    }
    else
    {
        pState = GetAppState(hwnd);
    }

    switch (uMsg)
    {


    // Remainder of the window procedure not shown ...

    }
    return TRUE;
}