Win32 API 입문 강좌

메뉴는 윈도우즈용 프로그램이 제공하는 가장 표준적인 사용자 인터페이스이며 프로그램의 전체 기능을 총괄적으로 제공해주는 중요한 기능을 가지고 있다. 메뉴의 구조와 기능, 그리고 내부적인 운용 방법은 사실 간단한 것은 아니지만 프로그래밍하기에는 비교적 쉬운 편에 속한다.

5-2-가. 리소스 작성

여기서는 메뉴를 가진 프로그램을 작성하면서 리소스를 만드는 절차와 만들어진 리소스를 프로그램에서 사용하는 방법에 대해서 알아본다. 비주얼 C++을 사용하여 다음 절차를 따라 메뉴 리소스를 사용하는 Menu.dsw를 만들어 보도록 하자.

1File/New 명령을 사용하여 Menu.dsw 프로젝트를 먼저 만든다. 그리고 새 텍스트 파일을 만든 후 ApiStart.txt 파일을 복사해 붙이고 lpszClass 문자열을 "Menu"로 변경한다. 이 파일을 Menu.cpp로 저장하고 프로젝트에 포함시키면 프로젝트가 만들어졌다. 아직 메뉴는 붙이지 않았다.

2이제 메뉴 리소스를 만들어 붙인다. 아직 이 프로그램에는 사용하는 리소스가 하나도 없으므로 새로운 리소스 스크립트 파일을 만들어야 한다. Insert/Resource 메뉴 항목을 선택하면 다음과 같은 대화상자를 보여줄 것이다.

어떤 종류의 리소스를 만들 것인가를 물어오는 대화상자이다. 이 대화상자에서 Menu를 더블클릭하여 선택해 보자. 그러면 Script1이라는 새로운 리소스 스크립트(RC파일)를 만들어 주며 RC파일 안에 메뉴 리소스를 생성해 준다. 그리고 메뉴를 편집할 수 있는 메뉴 편집기를 열어준다. 다음과 같은 두개의 윈도우가 동시에 열릴 것이다.

왼쪽이 RC파일의 모양을 보여주는 스크립트 윈도우이다. RC파일은 텍스트 파일이지만 비주얼 C++은 RC파일의 내용을 텍스트로 보여주지 않고 등록된 리소스 종류별로 계층적으로 보여주며 편집 또한 텍스트를 직접 편집하는 것이 아니라 비주얼 편집 방식을 사용한다. 리소스 스크립트 윈도우를 보면 IDR_MENU1이라는 메뉴가 생성되어 있을 것이다. 메뉴 편집기의 작업영역에는 빈칸만 하나 있다. 이 빈칸에 메뉴 이름을 써 넣으면 메뉴 항목이 만들어진다. &File이라고 입력하면 File이라는 메뉴 항목이 생길 것이며 속성 편집 윈도우가 열린다.

속성 편집 윈도우를 사용하여 개별적인 메뉴 항목에 대해 속성을 설정한다. File메뉴를 만들고 난 후의 메뉴 편집기는 다음과 같다.

File메뉴가 만들어졌고 오른쪽과 아래쪽으로 빈칸이 두 개 생겼다. 이 빈칸에 새로운 메뉴 항목을 만들어 나가되 아래쪽으로 메뉴 항목을 만드려면 아래쪽의 빈칸을 사용하고 오른쪽으로 메뉴 항목을 만들어 나가려면 오른쪽 빈칸을 사용한다. 이번에는 아래쪽에 Menu1이라는 메뉴 항목을 만들어 보자. 아래쪽의 빈칸을 더블 클릭하면 속성 편집 윈도우가 열린다. 이 윈도우에 다음과 같이 ID와 Caption을 입력한다.

Caption은 사용자에게 보여질 메뉴의 이름이며 메뉴 리스트에 그대로 나타난다. 문자열일 뿐이므로 기호나 숫자, 한글까지 사용할 수 있다. ID는 프로그램에서 이 메뉴 항목을 지칭하는 이름이다. 변수나 함수의 이름과 같은 자격을 가지는 명칭(Identifier)이므로 명칭을 만드는 규칙에 맞게 작성해야 한다. 즉 첫문자를 숫자로 쓸 수 없고 한글을 써서도 안되며 메뉴 항목끼리 이름이 중복되어서도 안된다. 관습적으로 메뉴 항목의 이름은 "ID_상위메뉴_캡션"의 형식을 따라 만들면 된다. Caption에 Menu1, ID에 ID_FILE_MENU1이라고 설정하고 나머지 속성은 그대로 두도록 하자.

계속해서 Menu2, Exit 메뉴 항목을 만들고 각각 ID를 ID_FILE_MENU2, ID_FILE_EXIT로 준다. 여기까지 메뉴를 만들면 메뉴 편집기는 다음과 같아질 것이다.

이제 메뉴 리소스가 다 만들어졌다. 메뉴의 편집 방식이 비주얼 방식이기 때문에 아주 쉽게 작성할 수 있도록 되어 있다.

3이렇게 만들어진 리소스 스크립트를 일단 디스크에 저장한다. 현재 이름이 Script1으로 되어 있는데 File/Save 항목을 선택하고 파일 이름을 Menu로 주면 자동으로 확장자 RC가 붙어 Menu.rc라는 이름으로 디스크에 저장된다. 리소스의 이름도 가급적이면 프로젝트와 같은 이름을 주는 것이 좋다. 다음은 RC파일을 프로젝트에 포함시켜 프로젝트에서 메뉴 리소스를 사용할 수 있게 해 주어야 한다. 리소스를 작성하기는 했지만 아직 프로젝트와 논리적인 연관은 없으므로 이대로는 프로젝트에서 리소스를 사용할 수 없다. Project/Add to Project/Files 메뉴 항목을 선택하여 Menu.rc 파일을 프로젝트에 포함시킨다. 워크 스페이스의 리소스 뷰에 다음과 같이 현재까지 작성된 리소스가 나타날 것이다.

이후부터 리소스를 편집하려면 리소스 뷰에서 원하는 리소스를 더블클릭하면 된다. IDR_MENU1을 더블클릭하면 메뉴 편집기가 다시 열린다. 또한 이 리소스 뷰의 팝업 메뉴를 통해 새로운 리소스를 작성하거나 다른 프로젝트에 있는 리소스를 임포트하는 등의 전반적인 리소스 관리를 할 수 있다.

4만들어진 리소스를 프로젝트에서 사용하도록 코드를 수정한다. Menu.cpp를 열어서 다음과 같이 수정 또는 추가해 준다.

#include <windows.h>
#include "resource.h"

LRESULT CALLBACK WndProc(HWND,UINT,WPARAM,LPARAM);
HINSTANCE g_hInst;
LPSTR lpszClass="Menu";

int APIENTRY WinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance
		  ,LPSTR lpszCmdParam,int nCmdShow)
{
	HWND hWnd;
	MSG Message;
	WNDCLASS WndClass;
	g_hInst=hInstance;
	
	WndClass.cbClsExtra=0;
	WndClass.cbWndExtra=0;
	WndClass.hbrBackground=GetStockObject(WHITE_BRUSH);
	WndClass.hCursor=LoadCursor(NULL,IDC_ARROW);
	WndClass.hIcon=LoadIcon(NULL,IDI_APPLICATION);
	WndClass.hInstance=hInstance;
	WndClass.lpfnWndProc=(WNDPROC)WndProc;
	WndClass.lpszClassName=lpszClass;
	WndClass.lpszMenuName=MAKEINTRESOURCE(IDR_MENU1);
	WndClass.style=CS_HREDRAW | CS_VREDRAW;
	RegisterClass(&WndClass);

우선 resource.h라는 헤더 파일을 먼저 포함시켜 주어야 하는데 이 파일에는 다음과 같이 우리가 만든 메뉴 항목의 ID가 정의되어 있다. 이 파일은 리소스 편집기가 리소스 편집시에 작성해 주며 리소스를 편집하면 자동으로 같이 편집되므로 우리가 직접 편집할 필요는 없다.

//{{NO_DEPENDENCIES}}
// Microsoft Developer Studio generated include file.
// Used by Menu.rc
//
#define IDR_MENU1                       101
#define ID_FILE_MENU1                   40001
#define ID_FILE_MENU2                   40002
#define ID_FILE_EXIT                    40003

메뉴 항목의 ID는 정수로 정의되어야 하되 사람이 일일이 정수값을 기억하기가 곤란하므로 매크로 상수를 사용하여 ID를 정의하고 메뉴 편집기는 사용자가 입력한 ID를 정수 매크로로 정의하여 resource.h에 작성해 준다. 그래서 우리는 메뉴의 ID를 문자열 형태의 매크로 상수로 정의해 주고 resource.h만 인클루드해 주면 된다.

다음으로 WndClass의 lpszMenuName 멤버에 우리가 작성한 메뉴 이름인 IDR_MENU1을 대입해 준다. 이때 숫자로 정의된 메뉴 이름을 문자열로 바꾸어 주기 위해 MAKEINTRESOURCE 매크로를 사용하였다. 윈도우에서 사용할 메뉴에 관한 정보를 가지는 lpszMenuName은 문자열 변수이되 우리가 작성한 메뉴의 ID는 정수로 되어 있기 때문이다.

여기까지 작성하고 다시 컴파일해 보면 리소스로 정의한 메뉴가 타이틀 바 아래쪽에 나타날 것이다. 그러나 아직 메뉴에 대한 코드가 작성되지 않았기 때문에 메뉴만 나타날 뿐 메뉴를 선택해도 아무런 반응이 없다. 이제 메뉴가 선택되었을 때의 프로그램 동작을 정의해 준다. Menu.cpp를 열어서 WndProc를 다음과 같이 수정한다.

long FAR PASCAL WndProc(HWND hWnd,UINT iMessage,WPARAM wParam,LPARAM lParam)
{
	switch(iMessage) {
	case WM_COMMAND:
		switch(LOWORD(wParam)) {
		case ID_FILE_MENU1:
			MessageBox(hWnd,"첫번째 메뉴를 선택했습니다.","Menu Demo",MB_OK);
			break;
		case ID_FILE_MENU2:
			MessageBox(hWnd,"두번째 메뉴를 선택했습니다.","Menu Demo",MB_OK);
			break;
		case ID_FILE_EXIT:
			PostQuitMessage(0);
			break;
		}
		return 0;
	case WM_DESTROY:
		PostQuitMessage(0);
		return 0;
	default:
		return(DefWindowProc(hWnd,iMessage,wParam,lParam));
	}
}

이 코드를 보면 감이 잡히겠지만 메뉴 항목을 선택할 경우 WM_COMMAND라는 메시지가 전달된다. 코드를 작성한 후 컴파일, 실행시켜보자. 타이틀 바 바로 아래에 메뉴가 나타나며 메뉴를 선택할 경우 메시지 박스가 화면 중앙에 나타날 것이다.

어디까지나 예제이므로 메뉴 항목 선택시 메시지 박스만 열어 보였는데 실제 프로그램을 작성할 때는 선택한 메뉴 항목에 맞는 코드를 작성해 주면 될 것이다.

처음으로 리소스를 사용하는 예제를 작성해 봤는데 리소스를 만들고 프로젝트에 포함시키는 과정을 다시 한번 정리해 보자. 좀 복잡해 보일지도 모르겠지만 익숙해지면 별것도 아니다.

일단 이 과정을 거쳐 리소스 스크립트가 프로젝트에 포함되면 프로젝트 워크 스페이스에 리소스 뷰가 나타난다. 리소스 뷰는 프로젝트에 포함된 리소스를 종류별로 보여주며 관리하는 역할을 한다. 이후부터 리소스를 열거나 삭제하거나 새로 추가하는 작업은 리소스 뷰의 팝업 메뉴를 사용하면 된다.

팝업 메뉴를 보면 Open, Insert 등의 메뉴가 있는데 영어뜻 그대로이므로 Open이 열기이고 Insert가 새 리소스 삽입이라는 설명은 하지 않아도 될 것 같다.

목록 보기 다음 강좌 written by http://www.winapi.co.kr