https://docs.microsoft.com/en-us/windows/win32/learnwin32/learn-to-program-for-windows

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

---

📍 Windows Coding Conventions

📌 Typedefs

Integer types

데이터 형식	크기
BYTE	8비트
DWORD	32비트
INT32	32비트
INT64	64비트
LONG	32비트
LONGLONG	64비트
UINT32	32비트
UINT64	64비트
ULONG	32비트
ULONGLONG	64비트
WORD	16비트

Boolean Type

WinDef.h에는 BOOL과 함께 사용되는 두가지 값이 정의되어 있다.

#define FALSE 0
#define TRUE 1

그러나 BOOL 형식을 반환하는 대부분의 함수는 참일 경우 0은 아니지만 1도 아닌 값이 반환될 수 있다.

따라서 아래처럼 작성하면 안된다.

if (result == TRUE) // wrong !!
{
  ...
}

아래는 맞는 표현들이다.

if (SomeFunctionThatReturnsBoolean())
{
  ...
}

// or

if (SomeFunctionThatReturnsBoolean() != FALSE)
{
  ...
}

Pointer Types

Windows에서 포인터는 일반적으로 이름 앞에 P나 LP를 붙여서 표현한다. 예를 들어 LPRECT는 RECT에 대한 포인터이다.

RECT가 사각형을 설명하는 구조체라고 할 때 RECT의 포인터는 다음과 같다.

RECT* rect; // Pointer to a RECT structure
LPRECT rect; // The same 
PRECT rect; // Also the same

P는 포인터이고, LP는 long 포인터를 의미한다. LP는 16비트 코드를 32비트 Windows에 쓸 때 유용하게 사용되었으나 현재는 P와 LP는 구분되지 않으며 동일하게 쓰인다. 포인터를 나타낼 때 보통은 P를 쓴다.

Pointer Precision Types

• DWORD_PTR
• INT_PTR
• LONG_PTR
• ULONG_PTR
• UINT_PTR

위 포인터 정밀도 타입들은 32비트, 64비트 등의 환경에 맞게 정의되어 있다. 즉 32비트에서는 32비트 포인터, 64비트에서는 64비트 포인터가 된다.

따라서 이러한 형식은 정수를 포인터로 캐스팅하는 상황에서 사용된다. 포인터 산술이나, 루프로 전체 바이트 범위를 반복할 때 등에서도 사용된다. 또 32비트에서 64비트로 확장하는 경우도 가능하다. 이 경우에는 포인터의 크기는 여전히 4byte이다.

---

📍 Working with Strings

Windows는 기본적으로 UTF-16 인코딩을 사용하여 유니코드 문자를 나타내어 각 문자는 16비트로 인코딩된다.
UTF-8 문자를 8비트 ANSI 문자와 구별하기 위해 wide 문자라고 부른다.

• ASCII : 1960년대 미국에서 정의한 표준화한 부호체계
• ANSI : 8비트로 확장한 ASCII 코드
• UNICODE : ANSI로는 한국, 중국, 일본과 같은 문자 표현에 한계가 있어 용량을 크게 확장한 2바이트 기반의 코드
• UTF-8 : 유니코드를 8비트 숫자의 집합으로 나타낸 것

Visual C++ 컴파일러는 wide 문자에 대해 wchar_t를 지원하며 WinNT(헤더파일)에는 아래 typedef가 정의되어 있다.

typedef wchar_t WCHAR;

wide 문자, 문자열을 작성하려면 앞에 L을 붙이면 된다.

wchar_t a = L'a';
wchar_t *str = L"hello";

문자열 관련 typedef는 다음과 같다

Typedef	Definition
CHAR	char
PSTR or LPSTR	char*
PCSTR or LPCSTR	const char*
PWSTR or LPWSTR	wchar_t*
PCWSTR or LPCWSTR	const wchar_t*

📌 Unicode and ANSI Functions

Windows에 대한 유니코드 지원을 도입하는 경우 두 개의 병렬 API를 이용한다. (ANSI 문자열과 유니코드 문자열 용)

🔎 창 제목 표시줄의 텍스트를 설정하는 두 가지 함수

• Setwindowtexta : ANSI 문자열 사용
• Setwindowtextw : 유니코드 문자열 사용

내부적으로 ANSI 버전은 문자열을 유니코드로 전환한다.

또한 Windows 헤더는 아래와 같은 매크로를 지원한다.

#ifdef UNICODE
#define SetWindowText SetWindowTextW
#else 
#define SetWindowText SetWindowTextA
#endif

ANSI 문자열은 호환되지 않는 언어가 많기 때문에 유니코드 버전을 쓰는 것이 좋다. Windows의 최신 API에는 ANSI 버전이 없고 유니코드 버전만 있다.

📌 TCHARs

응용 프로그램이 여러 윈도우 버전을 모두 지원해야 하는 경우 대상 플랫폼에 따라 ANSI 또는 유니코드 문자열에 대해 동일한 코드를 컴파일 하는 것이 유용하다. 따라서 Windows SDK는 플랫폼에 따라 문자열을 유니코드나 ANSI로 매핑하는 매크로를 재공한다.

Macro	유니코드(Unicode)	ANSI
TCHAR	wchar_t	char
TEXT("x")	L"x"	"x"

예를 들어 아래 코드는

SetWindowText(TEXT("My Application"));

둘 중 하나가 된다.

SetWindowTextW(L"My Application"); // 유니코드
SetWindowTextA("My Application"); // ANSI

몇몇 헤더는 전처리기 기호 UNICODE를 이용하고 다른 것들은 _UNICODE 를 이용하기 때문에 둘다 define 해주어야 한다.

Visual C++ 에서는 default로 설정된다.

---

📍 What Is a Window?

창을 생각하면 보통 위와 같은 창을 떠올린다. 이러한 창을 application window 또는 main window 라고 한다. 일반적으로 제목 표시줄, 최소화, 최대화 버튼 및 기타 표준 UI 요소가 있는 프레임이 있다.

프레임은 운영 체제가 창의 해당 영역 부분을 관리하기 때문에 비 클라이언트 영역 (non-client area)라고 부른다.

프레임 내의 영역은 클라이언트 영역(client area)이다.

다른 유형의 창은 다음과 같다.

이러한 버튼과 같은 UI control도 창이다. control과 어플리케이션 창은 서로 통신할 수 있다.

창을 다음과 같이 생각하는 것이 좋다

• 화면의 특정 부분을 차지한다.
• 특정 시점에 표시될 수도, 표시되지 않을 수도 있다.
• 자신을 그리는 방법을 알고 있다.
• 사용자 또는 운영 체제의 이벤트에 응답한다.

📌 Parent Windows and Owner Windows

control 창은 어플리케이션 창의 자식이다.
또 modal 대화 상자가 표시될 때, 어플리케이션 창은 소유자(owner)창이고 대화 상자는 소유된(owned)창이다.

📌 Window Handles

window는 개체이며 코드와 데이터가 모두 있지만 C++ 클래스는 아니다. 대신 프로그램은 핸들(handle) 이라는 값을 사용하여 창을 참조한다. 핸들은 기본적으로 개체를 식별하는데 사용되는 숫자일 뿐이다.
Windows가 만든 모든 창이 담긴 큰 테이블이 있다고 간주하고, 이 테이블을 사용하여 핸들로 창을 조회한다. 창 핸들의 데이터 형식은 일반적으로 HWND이다. (aitch-wind로 발음) 창 핸들은 창을 만드는 함수 CreateWindow 및 CreateWindowEx에서 반환된다.

창에서 작업을 수행하려면 일반적으로 HWND 값을 매개 변수로 받는 일부 함수를 호출한다. 예를 들어 화면의 창 위치를 변경하려면 MoveWindow 함수를 호출한다.

BOOL MoveWindow(HWND hWnd, int X, int Y, int nWidth, int nHeight, BOOL bRepaint);

여기서 첫번째 매개변수 HWND hWnd가 이동하려는 창에 대한 핸들이다.

핸들은 포인터가 아니다.

📌 Screen and Window Coordinates

좌표는 디바이스에 독립적인 픽셀(device-independent pixels)로 측정된다.

작업에 따라 화면을 기준으로, 창(프레임 포함)을 기준으로 또는 창의 클라이언트 영역을 기준으로 좌표를 측정할 수 있다.

각 경우에 원점(0,0)은 항상 영역의 왼쪽 위 모퉁이이다.

---

📍 WinMain: The Application Entry Point

모든 Windows 프로그램에는 WinMain 또는 wWinMain 이라는 진입점 함수가 포함되어 있다.

int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PWSTR pCmdLine, int nCmdShow);

• hinstance : "인스턴스에 대한 핸들" 또는 "모듈에 대한 핸들"이라고 한다. 운영 체제는 이 값을 사용하여 메모리에 로드될 때 실행 파일(exe)를 식별한다. 인스턴스 핸들은 특정 Windows 함수(ex.아이콘 또는 비트맵 로드)에 필요하다.
• hPrevInstance : 16비트 Windows에서 사용되었으나 지금은 의미가 없다.
• pCmdLine : 명령줄 인수를 유니코드 문자열로 포함
• nCmdShow : 기본 어플리케이션 창이 최소화, 최대화 또는 정상적으로 표시되는지 여부를 표시하는 플래그

함수는 int 값을 반환하며 이 반환 값이 운영체제에서 사용되지는 않지만 반환 값을 사용하여 작성하는 다른 프로그램에 전달할 수 있다.

• WINAPI : 호출 규칙. 함수가 호출자로부터 매개 변수를 받는 방법을 정의. 예를 들어 스택에 매개 변수가 표시되는 순서를 정의한다.

WinMain 함수는 명령줄 인수가 ANSI 문자열로 전달된다는 점을 제외하고 wWinMain과 동일하다.

🔎 빈 WinMain 함수

INT WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
    PSTR lpCmdLine, INT nCmdShow)
{
    return 0;
}