Using the Extended View Extension - Implementation Details

A primary snap-in using the Extended View extension must register that extension for each extended node type. Additionally, to use the HTML details area of the Extended View, the primary snap-in must support the CCF_HTML_DETAILS property. Finally, to use the description area of the Extended View, the primary snap-in must support the CCF_DESCRIPTION property.

The following figure shows an example of the Extended View extension used by a snap-in.

Extended View extension example

In the preceding figure, the Extended View provides a title bar, which contains the icon and name of the selected scope node. Below the title bar, the right portion of the result pane contains the primary snap-in's list view (or OCX view or HTML view, depending on the scope node's result pane view style). The left portion of the result pane contains the name of the selected list item. These features are provided by registering the Extended View extension for the node type of the selected list item.

The figure depicts an HTML details area and description area as well. To use the HTML details area and description area, the snap-in supports the CCF_HTML_DETAILS and CCF_DESCRIPTION properties, respectively. A snap-in can support the CCF_HTML_DETAILS and CCF_DESCRIPTION properties by either implementing the INodeProperties interface where values returned for the CCF_HTML_DETAILS and CCF_DESCRIPTION properties are text strings, or by providing a clipboard format for the property by name (such as "CCF_HTML_DETAILS"). The example depicted above implements the INodeProperties interface. The appearance of the HTML details area (consisting of the user interface objects and the code associated with them) is controlled by the CCF_HTML_DETAILS property, whereas the description below the HTML details area is provided by the CCF_DESCRIPTION property.

Registering the Extended View extension

The node type that will use the Extended View extension must be registered as one of the node types for the primary snap-in, and the node type must contain an entry for the Extended View's CLSID.

Related topics

Using the Extended View Extension
Extending Views
INodeProperties
INodeProperties::GetProperty

 

 

Show: