IMcObjectShadowMcObject Property

Property Value

Type: McObject

On read, the function always returns a non-Alias McObject. If this instance is an Alias type (mcobjTypeFlagAlias set in the Type property), then the object returned is the Shadow of the Alias. If the object is not an Alias, then this McObject instance is returned. Thus, this property can be accessed whenever you need to be sure that you are dealing with the McObject where data is stored. If this object is an Alias without any Shadow attached, then the returned value will be NULL. A Shadow McObject is associated by assigning to this property. One can assign the new Shadow object for this Alias object, or NULL to have no Shadow. If the Shadow is itself an Alias, then the Shadow's Shadow will be use (i.e., a Shadow will never be an Alias object itself). On assignment, attached standard notify sinks of this Alias are sent a ValueChanged notify whenever a valid ShadowMcObject is assigned. Any notify sinks of neither any old Shadow nor the new Shadow are notified of change. It is legal to assign a NULL ShadowMcObject, but this leaves the Alias object in a generally unusable state, since attempts to access any reflected property (e.g., Value, UserFlags, etc.) will result in an error. The value of ShadowMcObject can be read for any object, but on assignment, this must be an mcobjTypeFlagAlias object or the assignment fails with an "Invalid Handle" error.