툴 팁

　WTL에서는 공용 컨트롤의 툴 팁 컨트롤을CToolTipCtrlT 이라고 하는 템플릿 클래스에서 캡슐화하고 있습니다. 템플릿 인수에는 클래스를 지정합니다만,, 그 클래스는CToolTipCtrlT클래스의 base class로서 사용됩니다. atlctrls.h헤더에서는typedef에 의해 다음과 같이 선언되고 있습니다.

// atlctrls.h안

typedef CToolTipCtrlT<ATL::CWindow> CToolTipCtrl;

이것은 CToolTipCtrl클래스는CWindow클래스의 상속 클래스인 것을 의미합니다.

　WTL의CToolTipCtrl클래스는 MFC의 동명의 클래스와 동등의 기능을 갖추고 있는 것 외에 확장 기능도 갖추고 있습니다. 이하에 나타내는 것은 CToolTipCtrl클래스를 사용하는 예입니다. 표시하는 툴 팁을 정적으로 설정하는 방법과 동적으로 설정하는 방법을 나타냅니다.

정적인 툴 팁

　우선 , 툴 팁을 정적으로 설정하는 방법입니다. 이하의 예는 다이얼로그상의 에디트 컨트롤에 마우스 커서를 실으면 「edit control」이라고 하는 툴 팁을 표시합니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlctrls.h> // 컨트롤용 클래스를 사용하기 위해

// maindlg.h

class CMainDlg : public CDialogImpl<CMainDlg>

{

public:

enum { IDD = IDD_MAINDLG };

CEdit m_edit_tooltip; // 툴 팁 표시용

// 메세지 맵

BEGIN_MSG_MAP_EX(CMainDlg)

MSG_WM_INITDIALOG(OnInitDialog)

COMMAND_ID_HANDLER_EX(IDOK, OnOK)

COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)

END_MSG_MAP()

LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){

// 스크린의 중앙에 배치

CenterWindow();

// 큰 아이콘 설정

HICON hIcon = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,

::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));

SetIcon(hIcon, TRUE);

// 작은 아이콘 설정

HICON hIconSmall = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,

::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON));

SetIcon(hIconSmall, FALSE);

// 컨트롤 설정

m_edit_tooltip = GetDlgItem(IDC_EDIT_TOOLTIP);

// 툴 팁 컨트롤 작성

CToolTipCtrl tooltip;

tooltip.Create(m_hWnd);

tooltip.Activate(TRUE);

// 에디트 컨트롤의 툴 팁 정보를 툴 팁 컨트롤에 추가

CToolInfo tiEdit(TTF_SUBCLASS, m_edit_tooltip, 0, NULL, _T("edit control"));

tooltip.AddTool(tiEdit);

return TRUE;

}

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

EndDialog(nID);

}

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

EndDialog(nID);

}

};

// Control.cpp내

#include "stdafx.h"

#include "resource.h"

#include "maindlg.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: 어플리케이션 실행

{

CMainDlg dlgMain;

nRet = dlgMain.DoModal();

}

_Module.Term();

::CoUninitialize();

return nRet;

}

　우선, 자원을 작성합니다. 다이얼로그에 에디트 컨트롤을 배치해 자원ID를 다음과 같이 지정합니다. 덧붙여 에디트 컨트롤의[스타일]에서는 디폴트에 [수평 스크롤 바], [수직 스크롤 바],[수직 오토 스크롤],[개행을 허가]에 체크를 합니다.

컨트롤명	자원ID
에디트	IDC_EDIT_TOOLTIP

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

　다음에 CMainDlg클래스의 WM_INITDIALOG 메세지 핸들러로 에디트 컨트롤을 초기화하고 툴 팁 컨트롤을 작성합니다. 그 후 에디트 컨트롤에 대한 툴 팁 정보를 작성해 그것을 툴 팁 컨트롤에 추가합니다.

이것으로 에디트 컨트롤에 마우스 커서를 갖다 대면 툴 팁이 표시됩니다.

　덧붙여 표시하는 툴 팁 캐릭터 라인을 복수 행으로 할 수도 있습니다. 그러기 위해서는 CToolTipCtrl클래스의 멤버 함수인 SetMaxTipWidth()을 사용해 툴 팁의 폭을 설정할 필요가 있습니다. 이렇게 하는 것으로 폭보다 긴 캐릭터 라인은 자동적으로 복수 행으로 표시됩니다.

// OnInitDialog()

CToolTipCtrl tooltip;

tooltip.Create(m_hWnd);

tooltip.Activate(TRUE);

// 툴 팁폭을 설정

tooltip.SetMaxTipWidth(80);

CToolInfo tiEdit(TTF_SUBCLASS, m_edit_tooltip, 0, NULL, _T("복수행의 툴 팁"));

tooltip.AddTool(tiEdit);

그리고 캐릭터 라인의 임의의 장소에서 개행 하고 싶은 경우는 「\r\n」 으로 개행 할 수가 있습니다.

// OnInitDialog()

CToolTipCtrl tooltip;

tooltip.Create(m_hWnd);

tooltip.Activate(TRUE);

// 툴 팁폭을 설정

tooltip.SetMaxTipWidth(80);

CToolInfo tiEdit(TTF_SUBCLASS, m_edit_tooltip, 0, NULL, _T("복수행의\r\n툴 팁"));

tooltip.AddTool(tiEdit);

동적인 툴 팁

다음에 , 툴 팁을 동적으로 설정하는 방법을 나타냅니다. 이하에 나타내는 것은 다이얼로그상의 에디트 컨트롤에 마우스 커서를 갖다 대면 에디트 컨트롤의 현재의 행수를 툴 팁으로 표시하는 예 입니다. 덧붙여 앞의 정적인 툴 팁을 작성한 프로그램의 CMainDlg 클래스만을 변경합니다. // maindlg.h class CMainDlg : public CDialogImpl<CMainDlg> { public: enum { IDD = IDD_MAINDLG }; CEdit m_edit_tooltip; // 툴 팁 표시용 에디트 // 메세지 맵 BEGIN_MSG_MAP_EX(CMainDlg) MSG_WM_INITDIALOG(OnInitDialog) NOTIFY_CODE_HANDLER_EX(TTN_GETDISPINFO, OnTooltipGetDispInfo) COMMAND_ID_HANDLER_EX(IDOK, OnOK) COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel) END_MSG_MAP() LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){ // 스크린의 중앙에 배치 CenterWindow(); // 큰 아이콘 설정 HICON hIcon = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR, ::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON)); SetIcon(hIcon, TRUE); // 작은 아이콘 설정 HICON hIconSmall = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR, ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON)); SetIcon(hIconSmall, FALSE); // 컨트롤 설정 m_edit_tooltip = GetDlgItem(IDC_EDIT_TOOLTIP); // 툴 팁 컨트롤 작성 CToolTipCtrl tooltip; tooltip.Create(m_hWnd); tooltip.Activate(TRUE); // 에디트 컨트롤의 툴 팁 정보를 툴 팁 컨트롤에 추가 CToolInfo tiEdit(TTF_SUBCLASS, m_edit_tooltip); tooltip.AddTool(tiEdit); return TRUE; } LRESULT OnTooltipGetDispInfo(LPNMHDR pnmh){ LPNMTTDISPINFO pntdi = (LPNMTTDISPINFO)pnmh; if(pntdi->uFlags & TTF_IDISHWND){ int ID = ::GetDlgCtrlID((HWND)pntdi->hdr.idFrom); if(ID == IDC_EDIT_TOOLTIP){ CString strText; strText.Format(_T("%d행"), m_edit_tooltip.GetLineCount()); lstrcpy(pntdi->szText, strText); } } return 0; } void OnOK(UINT uNotifyCode, int nID, HWND hWndCtl){ EndDialog(nID); } void OnCancel(UINT uNotifyCode, int nID, HWND hWndCtl){ EndDialog(nID); } }; 　우선 WM_INITDIALOG 메세지 핸들러로 툴 팁 정보를 작성할 때 제3인수 이후를 생략 합니다. 이렇게 하면 제5인수에는 디폴트로LPSTR_TEXTCALLBACK가 지정되어 툴 팁을 표시하는 타이밍에 통지 코드가TTN_GETDISPINFO의 WM_NOTIFY메세지가 발생하게 됩니다. 　다음에 통지 코드가TTN_GETDISPINFO의 툴 팁 컨트롤용 통지 메세지 핸들러를 추가합니다. 그 핸들러에서는 에디트 컨트롤의 현재의 행수를 취득해 툴 팁으로 해서 표시하고 있습니다.