←Select platform

Render Method

Summary
Renders an object.
Syntax
C#
Objective-C
C++/CLI
Java
Python
- (void)renderMapper:(LTAnnContainerMapper *)mapper object:(LTAnnObject *)annObject NS_SWIFT_NAME(render(mapper:object:)); 
void render(AnnContainerMapper mapper, AnnObject annObject); 
public:  
   void Render( 
      AnnContainerMapper^ mapper, 
      AnnObject^ annObject 
   ) 
def Render(self,mapper,annObject): 

Parameters

mapper
The mapper object to use for converting coordinates. This value must not be null.

annObject
The object to render. This value must not be null.

Remarks

This method is called by the framework to render an object. The IAnnObjectRenderer class is a base class and does not have any information on how to render an  annObject. Thus the Render method is an abstract method. Derived classes such as the rectangle renderer class or the polyline renderer class implements the Render method to do the actual rendering of the object.

For example, the rectangle renderer class will implements this method as follows:

  1. Casts an  annObject to AnnRectangleObject, (and will fail if the object is not of the correct type).

  2. Gets the points of the object stored in the annObject.Points property of the  annObject. Since this is a rectangle object, an array of 4 points is retrieved.

  3. These points are in container coordinates, therefore, mapper.PointsFromContainerCoordinates is called to convert these points to physical coordinates.

  4. The AnnRenderingEngine.Context property contains the destination context to render to. The renderer creates a closed path on this context for the rectangle shape. Note that the rectangle object can be rotated and hence the points returned in step 2 above are the 4 edges of the rectangle in its current transformation (top left, top right, right bottom and left bottom). This is why the renderer draws a path instead of a rectangle.

  5. Finally, the path is optionally stroked using the AnnObject.Stroke method and filled using the AnnObject.Fill method.

Note that if a state rendering engine is used (such as SVG or XAML rendering engine), then the engine will first call AddObject when the object is added before any Render calls. The engine will call RemoveObject when the object is removed.

Requirements

Target Platforms

Help Version 22.0.2023.7.31
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Annotations.Engine Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.