This documentation is archived and is not being maintained.

TSTCON Sample: ActiveX Control Test Container 

Download sample

The TSTCON sample implements an ActiveX control container using MFC support for OLE embedding. You can use TSTCON to test ActiveX controls, change their properties, and invoke their methods. You can write scripts using the VBScript language to automate the testing of the controls. TSTCON can keep a log of the events and property change notifications fired by a control.


This sample requires the Microsoft Calendar Control, which is installed with Microsoft Access.

TSTCON also demonstrates several MFC programming topics, including the following topics:

  • CCheckListBox: A list box with a check box next for each item.

  • CDragListBox: A list box in which you can drag the items to rearrange their order.

  • Implementing an Active Scripting Engine host (VBScript).

  • Implementing context-sensitive help for dialog boxes.

Security noteSecurity Note

This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustrate the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code be used for purposes other than as intended.

Building and Running the Sample

To build and run the TSTCON sample

  1. Open the solution tstcon.sln.

  2. On the Build menu, click Build Solution.

  3. Run the test container application as a stand-alone application so it can register itself with the system.

Alternately, you can open the sample test container application from the Tools menu in Visual Studio, as follows:

To launch a control in the container

  1. In Visual Studio, from the Tools menu, launch the ActiveX Control Test Container.

  2. In ActiveX Control Test Container, from the Edit menu, click Insert New Control.

  3. In the Insert New Control dialog box, from the list box, select Calendar Control, and click OK.

    The Microsoft Calendar Control appears in the upper half of the splitter window. Note that this control is installed with Microsoft Access.

  4. Manipulate the calendar by changing month, year, and date. In the lower pane, observe how the logs, events, and property change notifications are fired by the control as you manipulate it.

To change the control's properties

  1. Select the calendar control by clicking the calendar's border.

  2. From the Edit menu, click Properties. Test Container displays the Properties dialog box for the control.

  3. Using this dialog box, you can edit the properties of the control. Change the control's properties and observe the changes.

  4. Close the Properties dialog box.

To invoke methods on the control

  1. From the Control menu, click Invoke Methods. The Invoke Method dialog box appears.

  2. In the Method Name combo box, select BackColor (PropPut).

  3. From the Parameter Type combo box, select VT_COLOR.

  4. Click Choose Color, choose a color from the color palette, and click OK.

  5. In the Invoke Method dialog box, click Invoke. The background color of the calendar control changes to the color you selected in the color palette.

For more information on how to use the Test Container, from the Help menu, click Help Topics.


Some samples, such as this one, have not been modified to reflect the changes in the Visual C++ wizards, libraries, and compiler, but still demonstrate how to complete your desired task.

See Also

Other Resources

MFC Samples