IMcImageImportProperties Method

Sub ImportProperties ( 
	SourceImage As McImage,
	Optional ImportFilter As mcImportPropertiesFlags = mcImportPropertiesFlags.mcipfDefault
)

This method is called automatically for many operations that create new images. Most of these methods take a Flags parameter of type mcImageCreateFlags, into which can be Or'ed mcImportPropertiesFlags to specify which properties, if any are to be copied from the source to the destination. A few methods give you no control over which properties are copied (e.g., Duplicate where the ImportFlags are mcipfAll). In these cases, if you really need to change the properties copied, you may handle the DMcImageEvents.BeforeImportProperties event and substitute your own ImportFilter argument. However, it will almost always be easier to just call the general-purpose CopyToNewImage method, which gives you a great deal of control over the copy. If the mcipfFrameProperties ImportFilter flag is set (as it is by default), then frame properties in the SourceImage are copied to the corresponding frame in this McImage. Should there be fewer frames in the SourceImage than in this McImage, then source frames are reused as necessary to associate one source frame with each destination frame. During the internal call to ImportProperties from the CopyToNewImage method, the copied frames are automatically associated correctly. When the mcipfFrameProperties ImportFilter flag is set, the mcipfImage, mcipfUserProperties and mcipfPseudoColor flags determine which frame properties are copied for each frame. Incompatible properties are ignored and don't cause the method to fail.