Modifying the ATL DHTML Control

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at Modifying the ATL DHTML Control.

The ATL Control Wizard provides starter code so you can build and run the control, and so you can see how the methods are written in the project files and how the DHTML calls into the control's C++ code using the dispatch methods. You can add any dispatch method to the interface. Then, you can call the methods in the HTML resource.

To modify the ATL DHTML control

1. In Class View, expand the control project.

   Note that the interface that ends in "UI" has one method, OnClick. The interface that does not end in "UI" does not have any methods.

2. Add a method called MethodInvoked to the interface that does not end in "UI."

   This method will be added to the interface that is used in the control container for container interaction, not to the interface used by DHTML to interact with the control. Only the container can invoke this method.

3. Find the stubbed-out method in the .cpp file and add code to display a message box, for example:

   ::MessageBox(NULL, _T("I'm invoked"), _T("Your Container Message"), MB_OK);

4. Add another method called HelloHTML, only this time, add it to the interface that ends in "UI." Find the stubbed-out HelloHTML method in the .cpp file and add code to display a message box, for example:

   ::MessageBox(NULL, _T("Here's your message"), _T("HelloHTML"), MB_OK);

5. Add a third method, GoToURL, to the interface that does not end in "UI." Implement this method by calling IWebBrowser2::Navigate, as follows:

   m_spBrowser->Navigate(CComBSTR(L"www.microsoft.com"), NULL, NULL, NULL, NULL);

 You can use the **IWebBrowser2** methods because ATL provides a pointer to that interface for you in your .h file.  

Next, modify the HTML resource to invoke the methods you created. You will add three buttons for invoking these methods.

To modify the HTML resource

1. In Solution Explorer, double-click the .htm file to display the HTML resource.

   Examine the HTML, especially the calls to the external Windows dispatch methods. The HTML calls the project's OnClick method, and the parameters indicate the body of the control (theBody) and the color to assign ("red"). The text following the method call is the label that appears on the button.

2. Add another OnClick method, only change the color. For example:

<br>  
<br>  
<BUTTON onclick='window.external.OnClick(theBody, "white");'>Refresh</BUTTON>  

 This method will create a button, labeled **Refresh**, that the user can click to return the control to the original, white background.  

3. Add the call to the HelloHTML method you created. For example:

<br>  
<br>  
<BUTTON onclick='window.external.HelloHTML();'>HelloHTML</BUTTON>  

 This method will create a button, labeled **HelloHTML**, that the user can click to display the `HelloHTML` message box.  

You can now build and test the modified DHTML control.

See Also

Support for DHTML Control