ATLPages:  Demonstrates the Implementation of a Property Page Using IPropertyPageImpl

Click to open or copy the ATLPages project files.

This sample demonstrates the implementation of a property page using IPropertyPageImpl.

This sample consists of:

• A property page class, CTextDocumentProperties, that uses the ITextDocument interface to display (and allow changes to) the properties of a text document.
  
  
• A helper component, CHelper, that exposes a simplified wrapper to the OleCreatePropertyFrame API to scripting languages.
  
  
• A simple test macro, ATLPagesTest in ATLPages.dsm, that uses the helper to display the property page for the active document within the Visual C++ editor.

To Run This Sample

• Build the ATLPages project.
  
  
• Copy ATLPages.dsm to your Visual C++ macros directory (e.g. C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Macros\).
  
  
• Load ATLPages.dsm into Visual C++ (Tools menu, Customize... command, Add-ins and Macro Files option).
  
  
• Run the ATLPagesTest macro (Tools menu, Macro... command).

If no text document is open when you run the macro, it does nothing. If a document is open, a property page for that document will be displayed indicating the name of the file and its read-only status. You can change either of these items - your changes will be applied when either the Apply or OK button is clicked. Changing the name of the file will cause the file to be saved to disk under the new name. Changing the read-only status of the file affects whether the file can be changed within the Visual C++ editor (it doesn't affect the read-only attribute of the file on disk).

Note   Changing the read-only property of files under source code control is not possible using this property page.

This sample uses the following keywords:

IPropertyPage, IPropertyPageImpl, OleCreatePropertyFrame, IPropertyPage::SetObjects, IPropertyPage::Activate, IPropertyPage::Apply, ITextDocument