Display help for dialog controls on the status bar

If the user passes the mouse over a button, extra help text for that button should appear in the status bar. To use status bar to display extra help for dialog controls is preaty easy. Every time the mouse passes over a window, the WM_SETCURSOR message is sent to the window's owner. If we catch the message through OnSetCursor, we can easy determine if the mouse is over a dialog control. Then, assuming the control has a string resource with the same ID, we pass the ID to a special function that sets the text in the first status bar pane.

1. Create function to handle WM_SETCURSOR
BOOL CAboutDlg::OnSetCursor(CWnd * pWnd, UINT nHitText, UINT message)
{
	// if the cursor is not over a child window control, revert
	// to the default status bar text

	if(pWnd == this)
		SetPaneText();
	else
		SetPaneText(pWnd->GetDlgCtrlID());

	return CDialog::OnSetCursor(pWnd, nHitTest, message);
}
2. Handle WM_DESTROY message to restore status bar text
void CAboutDlg::OnDestroy()
{
	SetPaneText();
	CDialog::OnDestroy();
}
3. Add SetPaneText helper function
// this part goes to CAboutDlg class declaration
protected:
	void SetPaneText(UINT nID = 0);

// and this is function implementation
void CAboutDlg::SetPaneText(UINT nID)
{
	if(nID == 0)
		nID = AFX_IDS_IDLEMESSAGE;

	CWnd * pWnd = AfxGetMainWnd()->GetDescendantWindow(AFX_IDW_STATUS_BAR);
	if(pWnd)
	{
		AfxGetMainWnd()->SendMessage(WM_SETMESSAGESTRING, nID);
		pWnd->SendMessage(WM_IDLEUPDATECMDUI);
		pWnd->UpdateWindow();
	}
}
4. And finally do not foget to add following include files
#include  // for WM_SETMESSAGESTRING and WM_IDLEUPDATECMDUI
#include  // for AFX_IDW_STATUS_BAR

Last updated: 11 May 1998



Comments

  • How about menu items

    Posted by Legacy on 10/31/2000 12:00am

    Originally posted by: Jeff Nygren

    This was just what I needed for displaying help text for my controls. I want to do the same thing for popup menu items. How can I detect when the user passes the mouse over the items in a popup menu?

    Reply
  • Missing includefiles on screen...

    Posted by Legacy on 11/20/1998 12:00am

    Originally posted by: Albert van Peppen

    The includefiles are AfxPriv.h and AfxRes.h (VC++ 5.0 at least ;)
    
    

    Greetings,

    Albert van Peppen

    Reply
Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • Wednesday, September 24, 2014 8:00 AM - 9:00 AM PDT According to a recent Forrester Research report, many companies are choosing low-code platforms over traditional programming platforms, due to the speed with which low-code apps can be assembled and tested. With customer-facing applications on the rise, traditional programming platforms simply can't keep up with the "short schedules and rapid change cycles" required to develop these applications. Check out this upcoming webinar and join Clay Richardson from …

  • Best-in-Class organizations execute on a strategy that supports the multi-channel nature of customer requests. These leading organizations do not just open up their service infrastructures to accommodate new channels, but also empower their teams to deliver an effective and consistent experience regardless of the channel selected by the customer. This document will highlight the key business capabilities that support a Best-in-Class customer engagement strategy.

Most Popular Programming Stories

More for Developers

Latest Developer Headlines

RSS Feeds