
Class Definition File | Settings.idl |
Class C++ Binding | Settings.xh |
Class Hierarchy |
SOMObject
ODObject
ODExtension
ODSettingsExtension
|
Description | An object of the ODSettingsExtension class represents a set of Properties notebook that a part editor can create and display. The Properties notebook provides access only to the standard information properties that all OpenDoc parts have. To allow the user to access properties specific to your parts, you can create a settings extension object to add additional pages to the notebook. You use a subclass of ODSettingsExtension to create and insert additional pages into the Properties notebook by overriding the ShowSettingsPages method. Once you implement it, OpenDoc accesses your settings extension object by calling your part's AcquireExtension method, which returns a reference to the extension object. For more information related to extension objects, see the class description for "ODExtension". |
Methods | The methods defined by the ODSettingsExtension class include: |
Overridden Methods | There are no methods overridden by the ODSettingsExtension class. |
This method stores information for sheets added to the property notebook for an application part.
Signature
void AddNotebookSheet (HWND pageHwnd,
ULONG pageId)
|
Parameters
Remarks
A part developer uses this method to notify ODInfo about additional pages that will be added to the property notebook. For each sheet added, the part is required to pass the handle to the page and its id. On OS/2, ODInfo needs this information so it can propagate global messages from the property notebook to each sheet.
This method initializes this settings extension object.
Signature
void InitSettingsExtension (ODPart *owner) |
Parameters
Returns
None.
Remarks
This method is not called directly to initialize this settings extension object, but is called by a subclass-specific initialization method. By convention, every subclass of ODSettingsExtension should have an override method that is called when an instance of that subclass is created. The override method may have additional parameters beyond those of the inherited InitSettingsExtension method. The override method should call the inherited InitSettingsExtension method at the beginning of its implementation. The inherited InitSettingsExtension method in turn calls the InitExtension method associated with this settings extension's base object ( "ODExtension") to prepare this settings extension for use.
If you subclass ODSettingsExtension, your subclass-specific initialization method, rather than its somInit method, should handle any initialization code that can potentially fail. For example, your initialization method may attempt to allocate memory for your settings extension.
Override Policy
If you subclass ODSettingsExtension, you must override this method. Your override method must call its inherited method at the beginning of your implementation.
Related Methods
This method provides the interface for the part developer to add additional pages to the property notebook.
Signature
void ShowSettingsPages (ODFacet *facet,
ODNotebook *notebook)
|
Parameters
Remarks
A part developer can add additional pages to the property page notebook as follows:
Override Policy
If you subclass ODSettingsExtension, you must override this method. Your override method must call its inherited method at the beginning of your implementation.
This method provides the interface for the part developer to add additional pages to the property notebook.
Signature
void ShowSettingsPages (ODFacet *facet,
HWND parent,
ULONG *notebookID)
|
Parameters
Remarks
A part developer can add additional pages to the property page notebook as follows:
Override Policy
If you subclass ODSettingsExtension, you must override this method. Your override method must call its inherited method at the beginning of your implementation.
This method provides the interface for the part developer to add additional pages to the property notebook.
Signature
void ShowSettingsPages (ODFacet *facet,
HWND hPropSheetDlg)
|
Parameters
Remarks
A part developer can add additional pages to the property page notebook as follows:
Override Policy
If you subclass ODSettingsExtension, you must override this method. Your override method must call its inherited method at the beginning of your implementation.