|
A dictionary used to redirect all objects of a specific type to a specific object ID.
For example a stamp annotation is an object that describes a rubber stamp image that floats over a page. This object will contain links to other objects which will describe features like the appearance of the stamp. However it also contains a link to the page on which it is located.
Suppose you want to copy this annotation to another document. When you call AddFamily with this annotation you want to include related items like the annotation appearance but you don't want to include the page on which it is located. In fact you actually want links to this page in the source document to be redirected to a different page in the final destination document.
By specifying a mapping from the "Page" object type to the ID of a page in the final destination you both stop looking for linked objects at the point at which a page is discovered and also allow references to the source page to be linked to the destination page at the point that CopyTo is called.
To be precise, each time an IndirectObject is encountered it is checked for a "Type" entry. If this entry matches an item in the RemapTypes dictionary then the object is not added and no items to which it referrers are added. Instead an item is added to the RemapIDs property specifying a mapping between the ID of the object in question and the ID specified in the RemapTypes entry.
|
