TSTCON Sample: ActiveX Control Test Container
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.
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.
To get samples and instructions for installing them:
On the Visual Studio Help menu, click Samples.
For more information, see Visual Studio Samples.
The most recent version and complete list of samples is available online from the Visual Studio 2008 Samples page.
You can also locate samples on your computer's hard disk. By default, samples and a Readme file are copied into a folder under \Program Files\Visual Studio 9.0\Samples\. For Express editions of Visual Studio, all samples are located online.
To build and run the TSTCON sample
Open the solution tstcon.sln.
In the Property Pages for the TCProps project, expand the Configuration Properties node; then expand the Linker node. Under Manifest File, change the Enable User Account Control (UAC) option to No.
On the Build menu, click Build Solution.
Run the test container application as a stand-alone application so it can register itself with the system.
To launch a control in the container
In ActiveX Control Test Container, from the Edit menu, click Insert NewControl.
In the Insert New Control dialog box, from the list box, select CalendarControl, 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.
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
Select the calendar control by clicking the calendar's border.
From the Edit menu, click Properties. Test Container displays the Properties dialog box for the control.
Using this dialog box, you can edit the properties of the control. Change the control's properties and observe the changes.
Close the Properties dialog box.
To invoke methods on the control
From the Control menu, click Invoke Methods. The Invoke Method dialog box appears.
In the Method Name combo box, select BackColor (PropPut).
From theParameter Type combo box, select VT_COLOR.
Click Choose Color, choose a color from the color palette, and click OK.
In the Invoke Methoddialog 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.