removeObject Method (IAnnObjectRenderer)

Summary

Called by the state annotation rendering engine to remove the element for this object.

Syntax

JavaScript Syntax

IAnnObjectRenderer.prototype.removeObject = function(annObject)

TypeScript Syntax

removeObject(annObject: AnnObject): void;

Parameters

annObject

The annotation object being removed.

Remarks

This method should be implemented by state renderers to add the equivalent element for the annotation object.

The rendering engine will call AddObject when the annotation object is first rendered to a container. The object renderer should create the equiavalant state element (such as an SVG or XAML element) for the object at this point. It is best to use AnnObject.StateId to store the state (or element) ID at this point inside the object.

The engine will then call Render every time the object is changed. The object renderer can obtain the equivalent element using StateId and update it at this point.

When an annotation object is removed from the container, the rendering engine will call RemoveObject. The object renderer must then remove the object state (element) using StateId.

Implement this method only when you have a state rendering engine, such as SVG or XAML renderers. In stateless rendering engines, such as GDI+, you should implement this method but leave it empty.

Requirements

Target Platforms

See Also