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

  • Live Event Date: September 17, 2014 @ 1:00 p.m. ET / 10:00 a.m. PT Another day, another end-of-support deadline. You've heard enough about the hazards of not migrating to Windows Server 2008 or 2012. What you may not know is that there's plenty in it for you and your business, like increased automation and performance, time-saving technical features, and a lower total cost of ownership. Check out this upcoming eSeminar and join Rich Holmes, Pomeroy's practice director of virtualization, as he discusses the …

  • The explosion in mobile devices and applications has generated a great deal of interest in APIs. Today's businesses are under increased pressure to make it easy to build apps, supply tools to help developers work more quickly, and deploy operational analytics so they can track users, developers, application performance, and more. Apigee Edge provides comprehensive API delivery tools and both operational and business-level analytics in an integrated platform. It is available as on-premise software or through …

Most Popular Programming Stories

More for Developers

Latest Developer Headlines

RSS Feeds