< 커맨드 바 >

커맨드 바란 InternetExplorer의 도구 모음과 같은 그립이 붙어 있어 이동 가능한 바입니다. WTL은 커맨드 바를 작성하기 위해서 CCommandBarCtrl클래스를 준비해 있습니다. CCommandBarCtrl클래스를 사용하면 메뉴 리소스를 준비하는 것 만으로 간단하게 커맨드 바를 작성할 수가 있습니다. 그리고 화상 리소스를 준비하면 메뉴 아이템에 화상을 관련 지을 수가 있습니다. (덧붙여 화상은 CCommandBarCtrl클래스의 멤버 함수인 SetImagesVisible(false)을 호출하는 것에 의해 비 표시로 할 수도 있습니다. )

게다가 커맨드 바의 표시 폭이 부족한 경우에서도 자동적으로 셰브론(>>마크) 이 유효하게 됩니다.

물론 보통 도구 모음과 같이 상태 바에 플라이바 텍스트 (메뉴 아이템상에 커서를 두었을 때에 상태 바에 표시되는 텍스트) 를 표시할 수가 있습니다.

CCommandBarCtrl 클래스는 CToolBarCtrl클래스의 상속 클래스입니다. WTL에서 도구모음 으로 가장한 툴바를 리버의 밴드에 추가하는 것에 의해 커맨드 바를 작성합니다.

　이하에 나타내는 것은 CCommandBarCtrl클래스를 사용하는 예입니다. 프레임 윈도우를 작성해 커맨드 바를 추가합니다. 덧붙여 설명의 형편상 툴바와 상태 바도 추가해 툴바는 표시/비표시를 변환되도록 합니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlctrls.h>

#include <atlctrlw.h> // CCommandBarCtrl클래스를 사용하기 위해

#include <atlframe.h>

// mainfrm.h

class CMainFrame : public CFrameWindowImpl<CMainFrame>,

public CUpdateUI<CMainFrame>, public CMessageFilter, public CIdleHandler

{

public:

DECLARE_FRAME_WND_CLASS(NULL, IDR_MAINFRAME)

CCommandBarCtrl m_wndCmdBar;

virtual BOOL PreTranslateMessage(MSG* pMsg){

return CFrameWindowImpl<CMainFrame>::PreTranslateMessage(pMsg);

}

virtual BOOL OnIdle(){

UIUpdateToolBar();

UIUpdateStatusBar();

return FALSE;

}

BEGIN_UPDATE_UI_MAP(CMainFrame)

UPDATE_ELEMENT(ID_MENUITEM_TOOLBAR, UPDUI_MENUPOPUP)

END_UPDATE_UI_MAP()

BEGIN_MSG_MAP_EX(CMainFrame)

MSG_WM_CREATE(OnCreate)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_TOOLBAR, OnMenuToolbar)

COMMAND_ID_HANDLER_EX(ID_APP_EXIT, OnMenuExit)

CHAIN_MSG_MAP(CUpdateUI<CMainFrame>)

CHAIN_MSG_MAP(CFrameWindowImpl<CMainFrame>)

END_MSG_MAP()

LRESULT OnCreate(LPCREATESTRUCT lpcs){

// 코맨드 바를 작성

HWND hWndCmdBar = m_wndCmdBar.Create(m_hWnd,

rcDefault, NULL, ATL_SIMPLE_CMDBAR_PANE_STYLE);

// 기존의 도구모음을 아탓치

m_wndCmdBar.AttachMenu(GetMenu());

// 메뉴 아이템에 관련지을 수 있었던 툴바의 화상을 로드

m_wndCmdBar.LoadImages(IDR_MAINFRAME);

// 기존의 도구모음을 삭제

SetMenu(NULL);

// 툴바를 작성

HWND hWndToolBar = CreateSimpleToolBarCtrl(m_hWnd,

IDR_MAINFRAME, FALSE, ATL_SIMPLE_TOOLBAR_PANE_STYLE);

UIAddToolBar(hWndToolBar);

// 리버를 작성해 , 코맨드 바와 툴바를 밴드에 추가

CreateSimpleReBar(ATL_SIMPLE_REBAR_NOBORDER_STYLE);

AddSimpleReBarBand(hWndCmdBar);

AddSimpleReBarBand(hWndToolBar, NULL, TRUE);

// 상태 바를 작성

CreateSimpleStatusBar();

UIAddStatusBar(m_hWndStatusBar);

UISetCheck(ID_MENUITEM_TOOLBAR, true);

// 메시지 루프에 메세지 필터와 아이돌 핸들러를 추가

CMessageLoop* pLoop = _Module.GetMessageLoop();

pLoop->AddMessageFilter(this);

pLoop->AddIdleHandler(this);

return 0;

}

void OnMenuToolbar(UINT uNotifyCode, int nID, HWND hWndCtl){

static BOOL bVisible = TRUE;

bVisible = !bVisible;

CReBarCtrl rebar = m_hWndToolBar;

int nBandIndex = rebar.IdToIndex(ATL_IDW_BAND_FIRST + 1);

rebar.ShowBand(nBandIndex, bVisible);

UISetCheck(ID_MENUITEM_TOOLBAR, bVisible);

UpdateLayout();

}

void OnMenuExit(UINT uNotifyCode, int nID, HWND hWndCtl){

PostMessage(WM_CLOSE);

}

};

// app.cpp

#include "stdafx.h"

#include "resource.h"

#include "mainfrm.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE, LPTSTR lpCmdLine, int nCmdShow)

{

HRESULT hRes = ::CoInitialize(NULL);

ATLASSERT(SUCCEEDED(hRes));

::DefWindowProc(NULL, 0, 0, 0L);

AtlInitCommonControls(ICC_COOL_CLASSES | ICC_WIN95_CLASSES);

hRes = _Module.Init(NULL, hInstance);

ATLASSERT(SUCCEEDED(hRes));

int nRet = 0;

// BLOCK: 어플리케이션 실행

{

CMessageLoop theLoop;

_Module.AddMessageLoop(&theLoop);

CMainFrame wnd;

wnd.CreateEx();

wnd.ShowWindow(nCmdShow);

wnd.UpdateWindow();

nRet = theLoop.Run();

_Module.RemoveMessageLoop();

}

_Module.Term();

::CoUninitialize();

return nRet;

}

　우선 도구 모음 자원의 톱 레벨에 [표시]를 작성해 그 아래에 [툴바] 메뉴 아이템을 추가합니다. 이 [툴바]에는ID_MENUITEM_TOOLBAR 이라고 하는ID을 설정합니다.



　다음에 stdafx.h 에서는 CCommandBarCtrl클래스를 사용하기 위해서 atlctrlw.h 헤더를 포함 합니다.

　CMainFrame 클래스에서는 일반적인 프레임 윈도우를 작성합니다. CMainFrame클래스의 멤버 변수로서 CCommandBarCtrl 클래스의 인스턴스를 선언해 WM_CREATE 메세지 핸들러로 Create() 를 호출하는 것에 의해 커맨드 바를 작성합니다. 이Create()의 인수의 의미는 CWindowImpl::Create()과 같아 여기에서는 윈도우 스타일에 ATL_SIMPLE_CMDBAR_PANE_STYLE를 지정해 있습니다. 이 스타일은 atlctrlw.h 헤더 내에서 다음과 같이 정의되고 있습니다. 덧붙여 표시상의 사정으로 개행 위치등을 변경하고 있습니다.

// atlctrlw.h

// Window Styles:

#define CBRWS_TOP CCS_TOP

#define CBRWS_BOTTOM CCS_BOTTOM

#define CBRWS_NORESIZE CCS_NORESIZE

#define CBRWS_NOPARENTALIGN CCS_NOPARENTALIGN

#define CBRWS_NODIVIDER CCS_NODIVIDER

// standard command bar styles

#define ATL_SIMPLE_CMDBAR_PANE_STYLE \

(WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | \

CBRWS_NODIVIDER | CBRWS_NORESIZE | CBRWS_NOPARENTALIGN)

커맨드 바를 작성한 후는 커맨드 바에 메뉴 아이템을 추가합니다. 위의 예에서는AttachMenu()을 호출하는 것에 의해 프레임 윈도우의 도구 모음으로부터 메뉴 아이템을 읽어들이고 있습니다만 LoadMenu()을 호출해 메뉴 리소스로부터 직접 아이템을 로드할 수도 있습니다.

// 코맨드 바를 작성

HWND hWndCmdBar = m_wndCmdBar.Create(m_hWnd,

rcDefault, NULL, ATL_SIMPLE_CMDBAR_PANE_STYLE);

// 메뉴 자원을 로드

m_wndCmdBar.LoadMenu(IDR_MAINFRAME);

다음에 LoadImages()를 호출하는 것에 의해 툴바의 화상을 로드하고 있습니다. 이것에 의해 ID가 동일한 메뉴 아이템과 툴바의 화상을 관련지을 수 있어 메뉴 아이템의 옆에 화상이 표시되게 됩니다. 덧붙여 메뉴 아이템의 옆에 화상을 표시하기 위해서는 AddBitmap()이나AddIcon()를 사용할 수도 있습니다.

다음으로 툴바와 리버를 작성해 밴드에 커맨드 바와 툴바를 추가합니다. 툴바는 커맨드 바 아래에 추가하기 때문에 AddSimpleReBarBand의 제3인수에는TRUE를 지정합니다.

　마지막으로 메뉴 아이템 [툴바](ID：ID_MENUITEM_TOOLBAR) 용의 커멘드 메세지 핸들러를 추가합니다. 이 핸들러에서는 정적 변수 bVisible에 의해 툴바의 가시 상태를 보관 유지해 CReBarCtrl클래스의 멤버 함수인 ShowBand()으로 가시 상태를 새로 바꾸고 있습니다. 덧붙여 이 핸들러의 코드는 ATL/WTL AppWizard 이 출력하는 것과 거의 같습니다.

커맨드 바 스타일의 pop-up menu

통상의 메뉴가 CMenu::TrackPopupMenu()를 호출하는 것에 의해 pop-up 할 수 있도록 커맨드 바 스타일의 메뉴도 CCommandBarCtrl::TrackPopupMenu()를 호출하는 것에 의해 pop-up 할 수 있습니다. 이하에 나타내는 것은 커맨드 바 스타일의 pop-up menu를 표시하는 코드의 예입니다. 전제의 프로그램에 이하의 코드를 추가하는 것으로써 클라이언트 영역을 오른쪽 클릭했을 때에 인덱스 0 의 커맨드 바 메뉴 아이템( [파일] 이하 ) 이 pop-up menu로서 표시됩니다. // mainfrm.h BEGIN_MSG_MAP_EX(CMainFrame) MSG_WM_CONTEXTMENU(OnContextMenu) ... ... END_MSG_MAP() void OnContextMenu(HWND hWnd, CPoint pt){ // [Shift]+[F10]키가 밀렸을 경우는 좌표를 클라이언트 영역의 좌상으로 설정 if(pt.x == -1 && pt.y == -1){ pt.SetPoint(0, 0); ClientToScreen(&pt); } // 좌표가 클라이언트 영역내의 경우만 pop-up menu를 표시 CRect rc; GetClientRect(&rc); ClientToScreen(&rc); if(rc.PtInRect(pt)){ // 코맨드 바의 메뉴 핸들을 취득 CMenuHandle menu = m_wndCmdBar.GetMenu(); // 인덱스0의 메뉴 아이템을 pop-up menu로서 표시 m_wndCmdBar.TrackPopupMenu(menu.GetSubMenu(0), TPM_LEFTALIGN | TPM_TOPALIGN | TPM_LEFTBUTTON, pt.x, pt.y, NULL); }else{ SetMsgHandled(false); } } 이와 같이 pop-up menu를 커맨드 바 스타일로 표시하기 위해서는 CCommandBarCtrl::TrackPopupMenu()의 제1인수에 표시하는 메뉴의 핸들을 지정합니다.