ArcObjects Library Reference (CartoUI)  

IIdentifyDialog Interface

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

Product Availability

Available with ArcGIS Desktop.

Members

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

CoClasses that implement IIdentifyDialog

CoClasses and Classes Description
IdentifyDialog Identifying layers by OID or a point.

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 dont 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 documents focus map (IMxDocument::FocusMap), and the Display property is set to the focus maps 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.

.NET Snippets

Do Identify |