Programming Guide: The Settings Extension

# Programming Guide

## The Settings Extension

The Properties notebook (see "Selection properties") is accessed by the user from the Document, View, or Edit menu and displayed by the Info object (ODInfo class). The information that OpenDoc displays in the Properties notebook consists of the part's Info properties. Info properties are those properties in a part's storage unit, separate from the part's contents property, that are intended to be visible to the user.

The Properties notebook provides access to only the standard Info properties that all OpenDoc parts have. To define and allow access to properties specific to your part editor, you can create a Settings extension to display a part specific Property page.

When you select the menu choice to display your part's properties, the ODInfo object queries your part for an ODSettingsExtension by calling the HasExtension method with the extension name kODSettingsExtension. If your part provides such an extension, your part's AcquireExtension is called and your part's property page is added to the standard Properties notebook. If your part does not provide one, the standard notebook is displayed.

[ Top | Previous | Next | Contents | Index | Documentation Homepage ]