Gets a collection of the descendant MapItems contained by the Map; IMapItemParent objects are added to the collection before their associated ChildItems.

Namespace:  ESRI.ArcGISExplorer.Mapping

Assembly:  ESRI.ArcGISExplorer (in ESRI.ArcGISExplorer.dll) Version: 2.0.0.1500 (2.0.0.1500)

Syntax

C#
public IEnumerable<MapItem> Descendants { get; }
Visual Basic (Declaration)
Public ReadOnly Property Descendants As IEnumerable(Of MapItem)

Field Value

An IEnumerable collection of all descendant MapItems in the Map.

Remarks

This property enables you to retrieve a flattened collection of all items contained by the Map, for example if your map contains a Folder, the Descendants collection will contain the Folder, and all of the MapItems contained by the Folder.

The same holds true for any IMapItemParent object in the Map: the IMapItemParent.ChildItems are included in the returned Descendants collection.

Use this property if you need to recurse all items in the Map, including those that are not direct children of the Map. In this respect, the Descendants property differs from Map.ChildItems that only returns a collection of the Maps immediate children.

The order of the items in the returned collection is different to the order of items in the DescendantsBottomUp collection. Both properties return the same number of items but Descendants returns a collection where IMapItemParent objects are added before their associated ChildItems. Conversely using the DescendantsBottomUp property will return a collection where IMapItemParent objects are added after their associated ChildItems.

See Also