|Visual Basic (Declaration)|
Public MustInherit Class DynamicLayer Inherits Layer
public abstract class DynamicLayer : Layer
Implement this class if you want to create a custom dynamic layer and want to manage the creation, manipulation or download of the source bitmap data yourself. Note that if you only need to generate a URL to an image you should instead implement DynamicMapServiceLayer. That layer type automatically takes care of downloading the image based on a URL string.
As a minimum this layer must implement DynamicMapServiceLayer.GetSource and set the Layer.FullExtent to the extent of the layer. The FullExtent should include a default SpatialReference for the layer. The map uses this to determine when to draw the layer.
If you want to report image generation progress to the Map, call OnProgress(Int32) with a progress completion percentage value between 0 to 100.
If possible also override Cancel. This is called if the last request for an image has become outdated before the image was generated and is no longer needed. If you perform heavy image processing in a background thread, this thread should be stopped when Cancel is called. Similar if there's an ongoing download in progress this should likewise be cancelled.
Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family, Windows 7, Windows 8