IIdentifyDialog Interface

Provides access to members that control Identifying layers by OID or a point. Note: the IIdentifyDialog interface has been superseded by IIdentifyDialog2. Please consider using the more recent version.

Product Availability

Members

	Name	Description
	AddLayerIdentifyOID	Add layer and show object of the given OID.
	AddLayerIdentifyPoint	Add layer and show objects that contain the given point.
	ClearLayers	Clear shown layers.
	Display	The display.
	Map	The map of identifying layers.
	Show	Show dialog.

Classes that implement IIdentifyDialog

Remarks

Identifying features, raster cells, and so on, is simplified by the Identify- Dialog object. The IdentifyDialog object automatically performs a search on all the layers specified and populates a standard dialog box with the search results. This object makes identification easier because you don�t have to manually call IIdentify::Identify on each desired layer the IdentifyDialog does this automatically and populates the results in a standard dialog box. To use the IdentifyDialog object, you must cocreate a new instance of it and set its properties this hooks it up to the current application. The object is global, however, if an instance has already been created for the application. In this case, cocreating a new one really finds the one already available. It is important to remember that only one Identify dialog box may be opened per session in ArcMap.

The primary interface on the IdentifyDialog object is IIdentifyDialog. There are two properties, Display and Map, which must be set before the object can be used. These properties tie the object to the current application, enabling it to perform searches. Typically, the Map property is set to the document�s focus map (IMxDocument::FocusMap), and the Display property is set to the focus map�s ScreenDisplay object. Features, rasters, and others are identified as they are added to the IdentifyDialog object. There are two methods for adding layers: AddLayerIdentifyOID and AddLayerIdentifyPoint. The first method searches for features based on a specific objectID (OID), and the latter searches for features based on an x,y location. Both method take an object that supports ILayer as input. Additionally the first method takes the OID of the feature to identify and the second one a couple of coordinates from which to locate the feature to identify.

The two other methods ClearLayers and Show will repectively clear the list of layers in the dialog and display the dialog.

See also IIdentifyDialogProps.