ATL COM Property Pages


The new home for Visual Studio documentation is Visual Studio 2017 Documentation on

The latest version of this topic can be found at ATL COM Property Pages.

COM property pages provide a user interface for setting the properties (or calling the methods) of one or more COM objects. Property pages are used extensively by ActiveX controls for providing rich user interfaces that allow control properties to be set at design time.

Property pages are COM objects that implement the IPropertyPage or IPropertyPage2 interface. These interfaces provide methods that allow the page to be associated with a site (a COM object representing the container of the page) and a number of objects (COM objects whose methods will be called in response to changes made by the user of the property page). The property page container is responsible for calling methods on the property page interface to tell the page when to show or hide its user interface, and when to apply the changes made by the user to the underlying objects.

Each property page can be built completely independently of the objects whose properties can be set. All that a property page needs is to understand a particular interface (or set of interfaces) and to provide a user interface for calling methods on that interface.

For more information, see Property Sheets and Property Pages in the Windows SDK.

In This Section

Specifying Property Pages
Lists the steps for specifying property pages for you control and shows an example class.

Implementing Property Pages
Lists the steps for implementing property pages, including methods to override. Walks you through a complete example based on the ATLPages sample program.

ATLPages Sample
The sample abstract for the ATLPages sample, which implements a property page using IPropertyPageImpl.

Provides links to conceptual topics on how to program using the Active Template Library.

See Also