IMcGraphOverlay2DefaultLayer Property

Property Value

Type: Int32

When a McGraphObj is created, its Layer property can be taken from the Layer property of its template or it can be assigned a default value, overriding the template object's Layer property. The DefaultLayer property controls this behavior. If DefaultLayer is -1 (its initial state), then newly created McGraphObj instances take the initial value of their Layer property from the template (in the same way that other properties are inherited from the template). If DefaultLayer is a value from 0 through 9 (the allowed values for the McGraphObj.Layer property), then the newly created object is assigned to that layer, irrespective of the template's Layer. This scheme allows two approaches to layering objects as you create them. In one case, objects of a each type go into the same layer, so that you could for example have all text objects go into layer 1, while all other types of objects were placed into layer zero. Alternately, all objects created could go into the layer specified by a non-negative DefaultLayer. This would allow placing graphic objects of any type into whichever layer you were currently working on. Assignments to DefaultLayer are silently clipped to the range from -1 to 9. It is legal to assign a DefaultLayer value that is currently not displayed (i.e., the LayerVisible property is False for the layer), but object creation tools may either fail or automatically set the LayerVisible property True for any Layer needed for an object they are creating.