Share via


Property Sheets and Property Pages in MFC

 

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 Property Sheets and Property Pages in MFC.

A property sheet, also known as a tab dialog box, is a dialog box that contains property pages. Each property page is based on a dialog template resource and contains controls. It is enclosed on a page with a tab on top. The tab names the page and indicates its purpose. Users click a tab in the property sheet to select a set of controls.

Use pages to group the controls in the property sheet into meaningful sets. The contained property sheet typically has several controls of its own. These apply to all pages.

Property sheets are based on class CPropertySheet. Property pages are based on class CPropertyPage.

A property sheet is a special kind of dialog box that is generally used to modify the attributes of some external object, such as the current selection in a view. The property sheet has three main parts: the containing dialog box, one or more property pages shown one at a time, and a tab at the top of each page that the user clicks to select that page. Property sheets are useful for situations where you have several similar groups of settings or options to change. A property sheet groups information in an easily understood manner.

Note

When you are trying to show a property sheet by using CPropertySheet::DoModal, the system might generate a first-chance exception. This exception occurs because the system is trying to change the Window Styles of the object before the object has been created. For more information about this exception, and also how to avoid it or handle it, see CPropertySheet::DoModal.

See Also

Property Sheets