Microsoft MVP성태의 닷넷 이야기
Windows: 247. Win32 C/C++ - CS_GLOBALCLASS 설명 [링크 복사], [링크+제목 복사]
조회: 2781
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

(시리즈 글이 21개 있습니다.)
Windows: 226. Win32 C/C++ - Dialog에서 값을 반환하는 방법
; https://www.sysnet.pe.kr/2/0/13284

Windows: 227. Win32 C/C++ - Dialog Procedure를 재정의하는 방법
; https://www.sysnet.pe.kr/2/0/13285

Windows: 228. Win32 - 리소스에 포함된 대화창 Template의 2진 코드 해석 방법
; https://www.sysnet.pe.kr/2/0/13286

Windows: 229. Win32 - 대화창 템플릿의 2진 리소스를 읽어들여 윈도우를 직접 띄우는 방법
; https://www.sysnet.pe.kr/2/0/13287

Windows: 230. Win32 - 대화창의 DLU 단위를 pixel로 변경하는 방법
; https://www.sysnet.pe.kr/2/0/13288

Windows: 231. Win32 - 대화창 템플릿의 2진 리소스를 읽어들여 자식 윈도우를 생성하는 방법
; https://www.sysnet.pe.kr/2/0/13289

Windows: 232. C/C++ - 일반 창에도 사용 가능한 IsDialogMessage
; https://www.sysnet.pe.kr/2/0/13292

Windows: 233.  Win32 - modeless 대화창을 modal처럼 동작하게 만드는 방법
; https://www.sysnet.pe.kr/2/0/13295

Windows: 234. IsDialogMessage와 협업하는 WM_GETDLGCODE Win32 메시지
; https://www.sysnet.pe.kr/2/0/13296

Windows: 235. Win32 - Code Modal과 UI Modal
; https://www.sysnet.pe.kr/2/0/13297

Windows: 237. Win32 - 모든 메시지 루프를 탈출하는 WM_QUIT 메시지
; https://www.sysnet.pe.kr/2/0/13299

Windows: 238. Win32 - Modal UI 창에 올바른 Owner(HWND)를 설정해야 하는 이유
; https://www.sysnet.pe.kr/2/0/13300

Windows: 242. Win32 - 시간 만료를 갖는 MessageBox 대화창 구현 (쉬운 버전)
; https://www.sysnet.pe.kr/2/0/13305

Windows: 243. Win32 - 윈도우(cbWndExtra) 및 윈도우 클래스(cbClsExtra) 저장소 사용 방법
; https://www.sysnet.pe.kr/2/0/13306

Windows: 244. Win32 - 시간 만료를 갖는 MessageBox 대화창 구현 (개선된 버전)
; https://www.sysnet.pe.kr/2/0/13312

Windows: 245. Win32 - 시간 만료를 갖는 컨텍스트 메뉴와 윈도우 메시지의 영역별 정의
; https://www.sysnet.pe.kr/2/0/13315

Windows: 246. Win32 C/C++ - 직접 띄운 대화창 템플릿을 위한 Modal 메시지 루프 생성
; https://www.sysnet.pe.kr/2/0/13329

Windows: 247. Win32 C/C++ - CS_GLOBALCLASS 설명
; https://www.sysnet.pe.kr/2/0/13330

Windows: 248. Win32 C/C++ - 대화창을 위한 메시지 루프 사용자 정의
; https://www.sysnet.pe.kr/2/0/13332

Windows: 249. Win32 C/C++ - 대화창 템플릿을 런타임에 코딩해서 사용
; https://www.sysnet.pe.kr/2/0/13333

Windows: 250. Win32 C/C++ - Modal 메시지 루프 내에서 SetWindowsHookEx를 이용한 Thread 메시지 처리 방법
; https://www.sysnet.pe.kr/2/0/13334




Win32 C/C++ - CS_GLOBALCLASS 설명

보통은 윈도우 응용 프로그램을 만들 때 RegisterClass는 기본 코드 그대로 사용하기 마련입니다.

BOOL InitApp(HINSTANCE hInstance)
{
    WNDCLASS wc;
    wc.style = CS_DBLCLKS | CS_SAVEBITS | CS_BYTEALIGNWINDOW;
    wc.lpfnWndProc = WLWndProc;
    wc.cbClsExtra = 0;
    wc.cbWndExtra = DLGWINDOWEXTRA + sizeof(WLDLGPROC);
    wc.hInstance = hInstance;
    wc.hIcon = NULL;
    wc.hCursor = LoadCursor(NULL, IDC_ARROW);
    wc.hbrBackground = NULL;
    wc.lpszMenuName = NULL;
    wc.lpszClassName = TEXT("WLDialog");
    if (!RegisterClass(&wc)) return FALSE;
    return TRUE;
}

oldnewthing 글에서는,

When should I use CS_GLOBALCLASS?
; https://devblogs.microsoft.com/oldnewthing/20230310-00/?p=107926

About Window Classes
; https://learn.microsoft.com/en-us/windows/win32/winmsg/about-window-classes

위의 코드 중 style 필드에 설정할 수 있는 CS_GLOBALCLASS에 대해 자세하게 설명하고 있습니다.

RegisterClass 호출 시 "lpszClassName" 필드에 클래스를 식별할 수 있는 이름을 전달하는데요, 실제로는 또 다른 식별자가 하나 더 있습니다. 바로 "hInstance" 필드입니다.

wc.hInstance = hInstance;
wc.lpszClassName = TEXT("WLDialog");

즉, 해당 클래스를 HINSTANCE+CLASSNAME 쌍으로 식별하게 되는 것입니다. 그래서 CreateWindow 호출 시,

HWND hWnd = CreateWindowW(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
    CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, nullptr, nullptr, hInstance, nullptr);

클래스 이름뿐만 아니라 HINSTANCE 값도 함께 넘기는 것입니다. 실제로 (기본 생성된 C/C++ Window 프로젝트에서) CreateWindow를 호출하는 코드를 다음과 같이 바꿔보면,

BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
{
   hInst = hInstance; // Store instance handle in our global variable

   HINSTANCE hInst2 = (HINSTANCE)::GetModuleHandle(L"kernel32.dll");

   HWND hWnd = CreateWindowW(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
      CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, nullptr, nullptr, hInst2, nullptr);

   if (!hWnd)
   {
      return FALSE;
   }

   ShowWindow(hWnd, nCmdShow);
   UpdateWindow(hWnd);

   return TRUE;
}

hWnd 값은 0이 나오고, 이때의 오류 코드는 "0x0000057F (Cannot find window class.)"가 됩니다. 그런데, 일반적으로 윈도우가 미리 제공하는 Button과 같은 경우에는 HINSTANCE를 그 Button을 구현한 모듈이 아닌 현재의 모듈을 전달해도 잘 동작합니다.

HWND hwndChild =
    CreateWindow(
        TEXT("button"),                 /* Class Name */
        TEXT("Button &1"),              /* Title */
        WS_CHILD | WS_VISIBLE | WS_TABSTOP |
        BS_DEFPUSHBUTTON | BS_TEXT,     /* Style */
        0, 0, 100, 100,                 /* Position and size */
        hWnd,                           /* Parent */
        (HMENU)100,                     /* Child ID */
        hInst,                        /* Instance */
        0);                             /* No special parameters */

왜냐하면, 바로 저 Button 클래스는 RegisterClass를 호출했을 때 style에 CS_GLOBALCLASS 옵션을 줬기 때문입니다. 즉, 이 옵션으로 설정된 클래스 이름은 그것을 식별하기 위한 조건에서 HINSTANCE가 무시되는 것입니다.




사실, 대부분의 경우에 CS_GLOBALCLASS 옵션을 쓸 필요는 없습니다. 혹시나 자신만의 윈도우 클래스를 만들어 DLL로 분리했을 때에도 그 DLL의 HINSTANCE(Module Handle) 값을 구해 넘겨주면 그만입니다.

하지만, 유일하게 신경 써야 할 때가 있는데요, 바로 대화창의 Template으로 특정 윈도우를 등록하는 경우입니다.

이전에 설명했던,

Win32 - 대화창 템플릿의 2진 리소스를 읽어들여 자식 윈도우를 생성하는 방법
; https://www.sysnet.pe.kr/2/0/13289

글에서 아래와 같은 형식의 리소스 템플릿을 읽어들여 윈도우를 직접 생성하고 있는데요,

BEGIN
    ICON            IDR_MAINFRAME,IDC_STATIC,14,14,21,20
    LTEXT           "Project1, Version 1.0",IDC_STATIC,42,14,114,8,SS_NOPREFIX
    LTEXT           "Copyright (c) 2023",IDC_STATIC,42,26,114,8
    DEFPUSHBUTTON   "OK",IDOK,113,41,50,14,WS_GROUP
END

보시면 저 정보에 HINSTANCE에 대한 필드가 없습니다. 어쩌면 기본 컨트롤에 대해서는 고정적으로 user32.dll의 모듈 핸들을 넘겨주도록 처리했어도 되었을 것입니다, 하지만 그런 경우 저런 식으로 기본 컨트롤만으로 구성된 예제는 상관없지만 이후 나온 (Comctl32.dll에 구현된) Common Controls나, 한때 유행했던 Internet Explorer ActiveX의 경우에는 CS_GLOBALCLASS 옵션이 없었다면 대화창의 template으로 처리할 수 없어, 아마도 불편하게 WM_INITDIALOG에서 코드로 생성해야만 했을 것입니다.

이런 거 보면... 정말 Win32 시스템을 설계한 사람들이 공을 참 많이 들였구나... 하는 생각이 듭니다. ^^




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 4/26/2023]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13444정성태11/15/20231863닷넷: 2160. C# 12 - Experimental 특성 지원
13443정성태11/14/20231841개발 환경 구성: 687. OpenSSL로 생성한 사용자 인증서를 ASP.NET Core 웹 사이트에 적용하는 방법
13442정성태11/13/20231753개발 환경 구성: 686. 비주얼 스튜디오로 실행한 ASP.NET Core 사이트를 WSL 2 인스턴스에서 https로 접속하는 방법
13441정성태11/12/20231960닷넷: 2159. C# - ASP.NET Core 프로젝트에서 서버 Socket을 직접 생성하는 방법파일 다운로드1
13440정성태11/11/20231712Windows: 253. 소켓 Listen 시 방화벽의 Public/Private 제어 기능이 비활성화된 경우
13439정성태11/10/20232068닷넷: 2158. C# - 소켓 포트를 미리 시스템에 등록/예약해 사용하는 방법(Port Exclusion Ranges)파일 다운로드1
13438정성태11/9/20231820닷넷: 2157. C# - WinRT 기능을 이용해 윈도우에서 실행 중인 Media App 제어
13437정성태11/8/20231979닷넷: 2156. .NET 7 이상의 콘솔 프로그램을 (dockerfile 없이) 로컬 docker에 배포하는 방법
13436정성태11/7/20232222닷넷: 2155. C# - .NET 8 런타임부터 (Reflection 없이) 특성을 이용해 public이 아닌 멤버 호출 가능
13435정성태11/6/20232209닷넷: 2154. C# - 네이티브 자원을 포함한 관리 개체(예: 스레드)의 GC 정리
13434정성태11/1/20232013스크립트: 62. 파이썬 - class의 정적 함수를 동적으로 교체
13433정성태11/1/20231756스크립트: 61. 파이썬 - 함수 오버로딩 미지원
13432정성태10/31/20231743오류 유형: 878. 탐색기의 WSL 디렉터리 접근 시 "Attempt to access invalid address." 오류 발생
13431정성태10/31/20232011스크립트: 60. 파이썬 - 비동기 FastAPI 앱을 gunicorn으로 호스팅
13430정성태10/30/20231975닷넷: 2153. C# - 사용자가 빌드한 ICU dll 파일을 사용하는 방법
13429정성태10/27/20232190닷넷: 2152. Win32 Interop - C/C++ DLL로부터 이중 포인터 버퍼를 C#으로 받는 예제파일 다운로드1
13428정성태10/25/20232239닷넷: 2151. C# 12 - ref readonly 매개변수
13427정성태10/18/20232430닷넷: 2150. C# 12 - 정적 문맥에서 인스턴스 멤버에 대한 nameof 접근 허용(Allow nameof to always access instance members from static context)
13426정성태10/13/20232490스크립트: 59. 파이썬 - 비동기 호출 함수(run_until_complete, run_in_executor, create_task, run_in_threadpool)
13425정성태10/11/20232422닷넷: 2149. C# - PLinq의 Partitioner<T>를 이용한 사용자 정의 분할파일 다운로드1
13423정성태10/6/20232426스크립트: 58. 파이썬 - async/await 기본 사용법
13422정성태10/5/20232600닷넷: 2148. C# - async 유무에 따른 awaitable 메서드의 병렬 및 예외 처리
13421정성태10/4/20232610닷넷: 2147. C# - 비동기 메서드의 async 예약어 유무에 따른 차이
13420정성태9/26/20233721스크립트: 57. 파이썬 - UnboundLocalError: cannot access local variable '...' where it is not associated with a value
13419정성태9/25/20232470스크립트: 56. 파이썬 - RuntimeError: dictionary changed size during iteration
13418정성태9/25/20233020닷넷: 2146. C# - ConcurrentDictionary 자료 구조의 동기화 방식
1  2  3  4  5  [6]  7  8  9  10  11  12  13  14  15  ...