It is relatively easy to place a toolbar in a dialog box, but I had a hard time making
the tooltips appear since none of the TTN_xxxx message handlers are present in a CDialog
derived class. This article describes a simple technique for getting tooltips when you
have a toolbar in a dialog. It also gives a brief overview of the steps involved in adding
a toolbar to a dialog box.
Step 1
In the dialog’s header file you must add a CToolBar instance and an entry in the
message map to handle the tooltip messages.
protected:
CToolBar cToolBar;
at the bottom of the wizard generated message map entries add:
//}}AFX_MSG
afx_msg BOOL OnToolTipText(UINT nID, NMHDR* pNMHDR, LRESULT* pResult);
DECLARE_MESSAGE_MAP()
Step 2
In dialog’s implementation file add the following to the end of OnInitDialog to
show the toolbar.
//add the tool bar to the dialog
cToolBar.Create(this);
cToolBar.LoadToolBar(IDR_TOOLBAR);
cToolBar.ShowWindow(SW_SHOW);
cToolBar.SetBarStyle(CBRS_ALIGN_TOP | CBRS_TOOLTIPS | CBRS_FLYBY);
RepositionBars(AFX_IDW_CONTROLBAR_FIRST, AFX_IDW_CONTROLBAR_LAST, 0);
At the bottom of the message map add the following:
FX_MSG_MAP
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTW, 0, 0xFFFF, OnToolTipText)
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTA, 0, 0xFFFF, OnToolTipText)
END_MESSAGE_MAP()
Finally add the message handler method as entered in the message map:
BOOL CToolBarTipTestDialog::OnToolTipText(UINT, NMHDR*
pNMHDR, LRESULT* pResult)
{
ASSERT(pNMHDR->code == TTN_NEEDTEXTA || pNMHDR->code
== TTN_NEEDTEXTW);
// if there is a top level routing frame then let it handle
the message
if (GetRoutingFrame() != NULL) return FALSE;
// to be thorough we will need to handle UNICODE versions of
the message also !!
TOOLTIPTEXTA* pTTTA = (TOOLTIPTEXTA*)pNMHDR;
TOOLTIPTEXTW* pTTTW = (TOOLTIPTEXTW*)pNMHDR;
TCHAR szFullText[512];
CString strTipText;
UINT nID = pNMHDR->idFrom;
if (pNMHDR->code == TTN_NEEDTEXTA &&
(pTTTA->uFlags & TTF_IDISHWND) ||
pNMHDR->code == TTN_NEEDTEXTW
&& (pTTTW->uFlags & TTF_IDISHWND))
{
// idFrom is actually the HWND
of the tool
nID =
::GetDlgCtrlID((HWND)nID);
}
if (nID != 0) // will be zero on a separator
{
AfxLoadString(nID,
szFullText);
strTipText=szFullText;
#ifndef _UNICODE
if (pNMHDR->code ==
TTN_NEEDTEXTA)
{
lstrcpyn(pTTTA->szText,
strTipText, sizeof(pTTTA->szText));
}
else
{
_mbstowcsz(pTTTW->szText,
strTipText, sizeof(pTTTW->szText));
}
#else
if (pNMHDR->code ==
TTN_NEEDTEXTA)
{
_wcstombsz(pTTTA->szText,
strTipText,sizeof(pTTTA->szText));
}
else
{
lstrcpyn(pTTTW->szText,
strTipText, sizeof(pTTTW->szText));
}
#endif
*pResult = 0;
// bring the tooltip window
above other popup windows
::SetWindowPos(pNMHDR->hwndFrom,
HWND_TOP, 0, 0, 0, 0,SWP_NOACTIVATE|
SWP_NOSIZE|SWP_NOMOVE|SWP_NOOWNERZORDER);
return TRUE;
}
}