PRB: ToolTips for Controls in ActiveX Document Server Are Hidden by the ActiveX Document Container (247382)

SYMPTOMS

To add ToolTips for controls in the ActiveX Document server, you can use the Microsoft Foundation Classes (MFC) default implementation by calling the EnableToolTips function, which works correctly. However, for more flexible functionality of the ToolTip, you can also use the CTooltipCtrl class to create your own ToolTip control object. If the ToolTips are created by using the CTooltipCtrl class, it is not shown in the ActiveX Document Container.

RESOLUTION

To work around the problem, set the z-order of the ToolTips to the topmost level after creating the ToolTips. This sample code illustrates the workaround:

void CTestView::OnInitialUpdate()
{
	CFormView::OnInitialUpdate();
	ResizeParentToFit();

	CButton * mButton = (CButton *)GetDlgItem(IDC_BUTTON1);

	if( !m_tooltip.Create(this,TTS_ALWAYSTIP))
		TRACE(_T("Unable to Create ToolTip"));
	else if( !m_tooltip.AddTool( mButton, "Show the tooltips"))
		 TRACE(_T("Unable to add tip for the control window"));
	else
	{
	    m_tooltip.SetWindowPos(&wndTopMost,0,0,0,0,SWP_SHOWWINDOW|
                                    SWP_NOSIZE |SWP_NOMOVE);    
	    m_tooltip.Activate(TRUE);
	}	
}

MORE INFORMATION

Steps to Reproduce Behavior

Use the MFC AppWizard to generate an ActiveX Document Server application. That is, at step 3 of 6, under the category "What compound document support would you like to include?", select Full-server and check Active Document Server. At step 6, select CFormView as the base class of the view.
Add a button, IDC_BUTTON1, to the form view's resource template.
Add a private member variable to the view class, as shown here:
```
CToolTipCtrl m_tooltip; 
						
```

In the OnInitialUpdate function of the view class, insert the following code snippet to create the ToolTip for the button.

CButton * mButton = (CButton *)GetDlgItem(IDC_BUTTON1);

if( !m_tooltip.Create(this,TTS_ALWAYSTIP))
	TRACE(_T("Unable to Create ToolTip"));
else if( !m_tooltip.AddTool( mButton, "Show the tooltips"))
        TRACE(_T("Unable to add tip for the control window"));
else
     m_tooltip.Activate(TRUE);

Override the PreTranslateMessage function of the view class and add the following code to it:

if(pMsg->message== WM_LBUTTONDOWN ||
   pMsg->message== WM_LBUTTONUP || 
   pMsg->message== WM_MOUSEMOVE)
	
   m_tooltip.RelayEvent(pMsg);

Build the application and run it once as a stand alone application. Move the pointer over the button. Note that the ToolTip is shown correctly.
Now use the MFC AppWizard to generate an ActiveX Document Container application. That is, at step 3 of 6, under the category "What compound document support would you like to include?", select Container and check Active Document Container. Choose the default settings similar the other steps except exclude step 3.
Build and run the container application. Under the menu item select Edit and Insert New Object. Choose the name of your server from the Insert Object dialog box and click OK
Move the pointer over the button. Notice that the ToolTip is not visible.