User Tools

Site Tools


thinkgeo.mapsuite.core.geocanvas

ThinkGeo.MapSuite.Core.GeoCanvas

Note: The page was created before Map Suite 10. Map Suite 10.0 organized many classes into new namespaces and assemblies as well as had a few minor breaks in compatibility. The majority of previously built code should work without modification assuming the new namespaces are added. For guidance on upgrading your existing code, please check out MapSuite 10 Upgrade Guide.

This class represents a canvas that is used to draw geographic shapes. It is intended to be inherited for the implementation of different drawing systems, such as GDI+ or WPF.

Inheritance Hierarchy

Members Summary

Public Constructors

Protected Constructors

GeoCanvas()

  • This method is the default constructor for the GeoCanvas.
Remarks
  • None
Parameters

Public Methods

CloneDeep()

  • Create a copy of GeoCanvas using the deep clone process.
Remarks
  • The difference between deep clone and shallow clone is as follows: In shallow cloning, only the object is copied; the objects within it are not. By contrast, deep cloning copies the cloned object as well as all the objects within.
Return Value
  • Type:GeoCanvas
  • Description:A cloned GeoCanvas.
Parameters

Clear(GeoBrush)

  • This method clears the current GeoCanvas using the color specified.
Remarks
  • Use this method to clear the GeoCanvas.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • fillBrush

DrawArea(Feature,GeoPen,DrawingLevel)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the area feature.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the area.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawArea(AreaBaseShape,GeoPen,DrawingLevel)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • shape
    • Description:This parameter is the area shape.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the area.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawArea(Feature,GeoBrush,DrawingLevel)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the AreaShape in well-known binary format.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawArea(AreaBaseShape,GeoBrush,DrawingLevel)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • shape
    • Description:This parameter is the area shape to be drawn.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill Brush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawArea(Feature,GeoPen,GeoBrush,DrawingLevel)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the AreaFeature to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the AreaShape.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawArea(AreaBaseShape,GeoPen,GeoBrush,DrawingLevel)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • shape
    • Description:This parameter is the area shape to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline pen that will be used to draw the AreaShape.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill Brush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawArea(Feature,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the AreaFeature to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the AreaShape.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature that will be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature that will be drawn.
  • penBrushDrawingOrder
    • Description:This parameter determines the PenBrushingDrawingOrder used when drawing the area type feature.

DrawArea(AreaBaseShape,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • shape
    • Description:This parameter is the area shape to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the AreaShape.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature to be drawn.
  • penBrushDrawingOrder
    • Description:This parameter determines the PenBrushDrawingOrder used when drawing the area type feature.

DrawArea(IEnumerable<ScreenPointF[]>,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • screenPoints
    • Type:IEnumerable<ScreenPointF[]>
    • Description:This parameter is the AreaShape in well-known binary format.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the AreaShape.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature to be drawn.
  • penBrushDrawingOrder
    • Description:This parameter determines the PenBrushDrawingOrder used when drawing the area type feature.

DrawLine(Feature,GeoPen,DrawingLevel)

  • Draws a line on the GeoCanvas.
Remarks
  • This method is used to draw a line on the GeoCanvas using the specified GeoPen.The DrawingLevel allows you to specify the level you will draw on when drawing multiple lines. This is very useful when you want to draw a road, for example. You can draw the black background on the lowest level, then draw a slightly thinner white line on a higher level. This will result in a great effect for a road.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the line feature.
  • linePen
    • Type:GeoPen
    • Description:This parameter describes the GeoPen that will be used to draw the line.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawLine(LineBaseShape,GeoPen,DrawingLevel)

  • Draws a line on the GeoCanvas.
Remarks
  • This method is used to draw a line on the GeoCanvas using the specified GeoPen.The DrawingLevel allows you to specify the level you will draw on when drawing multiple lines. This is very useful when you want to draw a road, for example. You can draw the black background on the lowest level, then draw a slightly thinner white line on a higher level. This will result in a great effect for a road.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • shape
    • Description:This parameter is the line shape to be drawn by GeoCannvas.
  • linePen
    • Type:GeoPen
    • Description:This parameter describes the GeoPen that will be used to draw the line.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawLine(Feature,GeoPen,DrawingLevel,Single,Single)

  • Draws a line on the GeoCanvas.
Remarks
  • This method is used to draw a line on the GeoCanvas using the specified GeoPen.The DrawingLevel allows you to specify the level you will draw on when drawing multiple lines. This is very useful when you want to draw a road, for example. You can draw the black background on the lowest level, then draw a slightly thinner white line on a higher level. This will result in a great effect for a road.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the line feature to be drawn by GeoCannvas.
  • linePen
    • Type:GeoPen
    • Description:This parameter describes the GeoPen that will be used to draw the line.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature to be drawn.

DrawLine(LineBaseShape,GeoPen,DrawingLevel,Single,Single)

  • Draws a line on the GeoCanvas.
Remarks
  • This method is used to draw a line on the GeoCanvas using the specified GeoPen.The DrawingLevel allows you to specify the level you will draw on when drawing multiple lines. This is very useful when you want to draw a road, for example. You can draw the black background on the lowest level, then draw a slightly thinner white line on a higher level. This will result in a great effect for a road.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • shape
    • Description:This parameter is the line shape to be drawn by GeoCannvas.
  • linePen
    • Type:GeoPen
    • Description:This parameter describes the GeoPen that will be used to draw the line.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature to be drawn.

DrawLine(IEnumerable<ScreenPointF>,GeoPen,DrawingLevel,Single,Single)

  • Draws the LineShape on the GeoCanvas.
Remarks
  • This method is used to draw a line on the GeoCanvas using the specified GeoPen.The DrawingLevel allows you to specify the level you will draw on when drawing multiple lines. This is very useful when you want to draw a road, for example. You can draw the black background on the lowest level, then draw a slightly thinner white line on a higher level. This will result in a great effect for a road.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoints
    • Type:IEnumerable<ScreenPointF>
    • Description:This parameter is the LineShape in well-known binary format.
  • linePen
    • Type:GeoPen
    • Description:This parameter describes the GeoPen that will be used to draw the LineShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature to be drawn.

DrawEllipse(Feature,Single,Single,GeoPen,DrawingLevel)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the center point feature.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawEllipse(PointBaseShape,Single,Single,GeoPen,DrawingLevel)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • shape
    • Description:This parameter is the center point shape.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.

DrawEllipse(Feature,Single,Single,GeoBrush,DrawingLevel)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerPointFeature
    • Type:Feature
    • Description:This parameter is the center point feature.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the the GeoBrush will draw on.

DrawEllipse(PointBaseShape,Single,Single,GeoBrush,DrawingLevel)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • shape
    • Description:This parameter is the center point shape.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the the GeoBrush will draw on.

DrawEllipse(Feature,Single,Single,GeoPen,GeoBrush,DrawingLevel)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the center point feature.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen or GeoBrush will draw on.

DrawEllipse(PointBaseShape,Single,Single,GeoPen,GeoBrush,DrawingLevel)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • shape
    • Description:This parameter is the center point shape.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen or GeoBrush will draw on.

DrawEllipse(Feature,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the center point feature.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen or GeoBrush will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the ellipse to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the ellipse to be drawn.
  • penBrushDrawingOrder
    • Description:This parameter determines the PenBrushDrawingOrder used when drawing the ellipse.

DrawEllipse(PointBaseShape,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • shape
    • Description:This parameter is the center point shape.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen or GeoBrush will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the ellipse to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the ellipse to be drawn.
  • penBrushDrawingOrder
    • Description:This parameter determines the PenBrushDrawingOrder used when drawing the ellipse.

DrawEllipse(ScreenPointF,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoint
    • Description:This parameter is the center point in screen coordinate.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen or GeoBrush will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the ellipse to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the ellipse to be drawn.

DrawWorldImageWithoutScaling(GeoImage,Double,Double,DrawingLevel)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.The X & Y in work coordinates is where the center of the image will be drawn.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw unscaled.
  • centerXInWorld
    • Type:Double
    • Description:The X coordinate of the center point of where you want to draw the image.
  • centerYInWorld
    • Type:Double
    • Description:The Y coordinate of the center point of where you want to draw the image.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.

DrawWorldImageWithoutScaling(GeoImage,Double,Double,DrawingLevel,Single,Single,Single)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.The X & Y in work coordinates is where the center of the image will be drawn.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw unscaled.
  • centerXInWorld
    • Type:Double
    • Description:The X coordinate of the center point (in world coordinates) of where you want to draw the image.
  • centerYInWorld
    • Type:Double
    • Description:The Y coordinate of the center point (in world coordinates) of where you want to draw the image.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawScreenImageWithoutScaling(GeoImage,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.The X & Y in work coordinates is where the center of the image will be drawn.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw unscaled.
  • centerXInScreen
    • Type:Single
    • Description:The X coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • centerYInScreen
    • Type:Single
    • Description:The Y coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawWorldImage(GeoImage,Double,Double,Single,Single,DrawingLevel)

  • Draws a scaled image on the GeoCanvas.
Remarks
  • Drawing an image scaled is slower than using the API that draws it unscaled.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw.
  • centerXInWorld
    • Type:Double
    • Description:The X coordinate of the center point of where you want to draw the image.
  • centerYInWorld
    • Type:Double
    • Description:The Y coordinate of the center point of where you want to draw the image.
  • widthInScreen
    • Type:Single
    • Description:The width you want to scale the image to. This is the width of the image that will be drawn.
  • heightInScreen
    • Type:Single
    • Description:The height you want to scale the image to. This is the height of the image that will be drawn.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.

DrawWorldImage(GeoImage,Double,Double,Double,DrawingLevel,Single,Single,Single)

  • Draws a world image on the GeoCanvas.
Remarks
  • Drawing an image scaled is slower than using the API that draws it unscaled.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw.
  • centerXInWorld
    • Type:Double
    • Description:The X coordinate of the center point of where you want to draw the image.
  • centerYInWorld
    • Type:Double
    • Description:The Y coordinate of the center point of where you want to draw the image.
  • imageScale
    • Type:Double
    • Description:The scale at which you want to draw the image. The final width and height will be caculated based on the scale.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawWorldImage(GeoImage,Double,Double,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws a world image on the GeoCanvas.
Remarks
  • Drawing an image scaled is slower than using the API that draws it unscaled.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw.
  • centerXInWorld
    • Type:Double
    • Description:The X coordinate of the center point of where you want to draw the image.
  • centerYInWorld
    • Type:Double
    • Description:The Y coordinate of the center point of where you want to draw the image.
  • widthInScreen
    • Type:Single
    • Description:The width you want to scale the image to. This is the width of the image that will be drawn.
  • heightInScreen
    • Type:Single
    • Description:The height you want to scale the image to. This is the height of the image that will be drawn.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawScreenImage(GeoImage,Single,Single,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws a screen image on the GeoCanvas.
Remarks
  • Drawing an image scaled is slower than using the API that draws it unscaled.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw.
  • centerXInScreen
    • Type:Single
    • Description:The X coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • centerYInScreen
    • Type:Single
    • Description:The Y coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • widthInScreen
    • Type:Single
    • Description:The width you want to scale the image to. This is the width of the image that will be drawn.
  • heightInScreen
    • Type:Single
    • Description:The height you want to scale the image to. This is the height of the image that will be drawn.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawTextWithScreenCoordinate(String,GeoFont,GeoBrush,Single,Single,DrawingLevel)

  • This method allows you to draw text at the specified location, using the specified brush and font parameters.
Remarks
  • This method is used to draw text on the GeoCanvas at specific screen coordinates. It provides you with a number of overloads that allow you to control how the text is drawn. This is useful especially when adding things such as legends, titles, etc.The DrawingLevel allows you to specify the level you will draw on when drawing multiple text items. This is very useful when you want to draw a drop shadow, for example. You can draw the black backdrop on the lowest level with an offset, then draw the normal text on a higher level without an offset.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:This parameter specifies the text you wish to draw.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font you wish to use to draw the text.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter specifies the kind of fill you want to use to draw the text.
  • upperLeftXInScreen
    • Type:Single
    • Description:This parameter is the upper left horizontal point in screen coordinates of where you want to start drawing the text from.
  • upperLeftYInScreen
    • Type:Single
    • Description:This parameter is the upper left vertical point in screen coordinates of where you want to start drawing the text from.
  • drawingLevel
    • Description:This parameter specifies the drawing level you wish to draw the text on. Higher levels overwrite lower levels.

DrawTextWithScreenCoordinate(String,GeoFont,GeoBrush,GeoPen,Single,Single,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • haloPen
  • upperLeftXInScreen
    • Type:Single
    • Description:N/A
  • upperLeftYInScreen
    • Type:Single
    • Description:N/A

DrawTextWithWorldCoordinate(String,GeoFont,GeoBrush,Double,Double,DrawingLevel)

  • This method allows you to draw text at the specified location, using the specified brush and font parameters.
Remarks
  • This method is used to draw text on the GeoCanvas at specific screen coordinates. It provides you with a number of overloads that allow you to control how the text is drawn. This is useful especially when adding things such as legends, titles, etc.The DrawingLevel allows you to specify the level you will draw on when drawing multiple text items. This is very useful when you want to draw a drop shadow, for example. You can draw the black backdrop on the lowest level with an offset, then draw the normal text on a higher level without an offset.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:This parameter specifies the text you wish to draw.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font you wish to use to draw the text.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter specifies the kind of fill you want to use to draw the text.
  • upperLeftXInWorld
    • Type:Double
    • Description:This parameter is the upper left horizontal point in world coordinates of where you want to start drawing the text from.
  • upperLeftYInWorld
    • Type:Double
    • Description:This parameter is the upper left horizontal point in world coordinates of where you want to start drawing the text from.
  • drawingLevel
    • Description:This parameter specifies the drawing level you wish to draw the text on. Higher levels overwrite lower levels.

DrawTextWithWorldCoordinate(String,GeoFont,GeoBrush,GeoPen,Double,Double,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • haloPen
  • upperLeftXInWorld
    • Type:Double
    • Description:N/A
  • upperLeftYInWorld
    • Type:Double
    • Description:N/A

DrawText(String,GeoFont,GeoBrush,IEnumerable<ScreenPointF>,DrawingLevel)

  • This method allows you to draw text at the specified location, using the specified brush and font parameters.
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:This parameter specifies the text you wish to draw.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font you wish to use to draw the text.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter specifies the kind of fill you want to use to draw the text.
  • textPathInScreen
    • Type:IEnumerable<ScreenPointF>
    • Description:This parameter specifies the path on which to draw the text.
  • drawingLevel
    • Description:This parameter specifies the drawing level you wish to draw the text on. Higher levels overwrite lower levels.

DrawText(String,GeoFont,GeoBrush,GeoPen,IEnumerable<ScreenPointF>,DrawingLevel,Single,Single,Single)

  • This method allows you to draw text at the specified location, using the specified brush and font parameters.
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:This parameter specifies the text you wish to draw.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font you wish to use to draw the text.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter specifies the kind of fill you want to use to draw the text.
  • haloPen
    • Type:GeoPen
    • Description:This parameter specifies the HaloPen that will be used to draw the text, when the HaloPen effect is needed.
  • textPathInScreen
    • Type:IEnumerable<ScreenPointF>
    • Description:This parameter specifies the path on which to draw the text.
  • drawingLevel
    • Description:This parameter specifies the drawing level you wish to draw the text on. Higher levels overwrite lower levels.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the text to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the text to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the text to be drawn.

MeasureText(String,GeoFont)

  • This method returns the rectangle that contains the specified text, when that text is drawn with the specified font.
Remarks
  • This method is typically used for labeling, to determine whether labels overlap.
Return Value
  • Description:This method returns the rectangle that contains the specified text, when that text is drawn with the specified font.
Parameters
  • text
    • Type:String
    • Description:This parameter represents the text you want to measure.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font of the text you want to measure.

BeginDrawing(Object,RectangleShape,GeographyUnit)

  • This method begins the act of drawing on the GeoCanvas.
Remarks
  • This is the first method that needs to be called before any drawing takes place. Calling this method will set the IsDrawing property to true. When you finish drawing, you must call EndDrawing to commit the changes to the image.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • nativeImage
    • Type:Object
    • Description:This parameter represents the image you want the GeoCanvas to draw on.
  • worldExtent
    • Description:This parameter is the world extent of the canvasImage.
  • drawingMapUnit
    • Description:This parameter is the map unit of the canvasImage.

ToNativeImage(GeoImage)

  • This method converts a GeoImage to a commonly-used object. In GdiPlus, this object is often a Bitmap.
Remarks
  • This method is a BaseClass API and will be implemented and used in its sub-concrete classes.
Return Value
  • Type:Object
  • Description:The returning object containing the same information as the passed-in geoImage.
Parameters
  • image
    • Type:GeoImage
    • Description:The target geoImage to convert.

ToGeoImage(Object)

  • This method converts an oboject to a GeoImage. In GdiPlus, this object is often a Bitmap.
Remarks
  • This method is a BaseClass API and will be implemented and used in its sub-concrete classes.
Return Value
  • Type:GeoImage
  • Description:The returning GeoImage containing the same information as the passed-in nativeImage.
Parameters
  • nativeImage
    • Type:Object
    • Description:The target object to be converted.

EndDrawing()

  • This method ends drawing and commits the drawing on the GeoCanvas.
Remarks
  • This method should be called when you are finished drawing. It will commit the image changes to the image you passed in on BeginDrawing. It will also set IsDrawing to false. After you call this method it will put the GeoCanvas into an invalid state, so if you then call any drawing methods it will raise an exception.
Return Value
  • Type:Void
  • Description:N/A
Parameters

GetStreamFromGeoImage(GeoImage)

  • Get the stream from the passed-in GeoImage. This API is an abstract API and will be implemented in each concrete sub-class.
Remarks
  • N/A
Return Value
  • Type:Stream
  • Description:The returning stream retrieved from the passed-in image.
Parameters
  • image
    • Type:GeoImage
    • Description:The parameter specifies the image to get the stream from.

Flush()

  • This method flush drawing and commits the drawing on the GeoCanvas.
Remarks
  • This method should be called when you are finished drawing. It will commit the image changes to the image you passed in on BeginDrawing. It will also set IsDrawing to false. After you call this method it will put the GeoCanvas into an invalid state, so if you then call any drawing methods it will raise an exception.
Return Value
  • Type:Void
  • Description:N/A
Parameters

ToString()

  • N/A
Remarks
  • N/A
Return Value
  • Type:String
  • Description:N/A
Parameters

Equals(Object)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Boolean
  • Description:N/A
Parameters
  • obj
    • Type:Object
    • Description:N/A

GetHashCode()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Int32
  • Description:N/A
Parameters

GetType()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Type
  • Description:N/A
Parameters

Protected Methods

OnDrawingProgressChanged(DrawingProgressChangedEventArgs)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters

ToWorldCoordinate(DrawingRectangleF)

  • N/A
Remarks
  • N/A
Return Value
Parameters

CloneDeepCore()

  • Create a copy of GeoCanvas using the deep clone process. The default implementation uses serialization.
Remarks
  • The difference between deep clone and shallow clone is as follows: In shallow cloning, only the object is copied; the objects within it are not. By contrast, deep cloning copies the cloned object as well as all the objects within.
Return Value
  • Type:GeoCanvas
  • Description:A cloned GeoCanvas.
Parameters

ClearCore(GeoBrush)

  • This method clears the current GeoCanvas using the color specified.
Remarks
  • Use this method to clear the GeoCanvas.This method is designed to be overridden by the deriving class.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter specifies the the brush that will be used to clear the GeoCanvas.

DrawAreaCore(IEnumerable<ScreenPointF[]>,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • This method draws an area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Parameters
  • screenPoints
    • Type:IEnumerable<ScreenPointF[]>
    • Description:This parameter is the AreaShape in well-known binary format.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the AreaShape.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the AreaShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature to be drawn.
  • penBrushDrawingOrder
    • Description:This parameter determines the PenBrushDrawingOrder used when drawing the area type feature.

DrawLineCore(IEnumerable<ScreenPointF>,GeoPen,DrawingLevel,Single,Single)

  • Draws the LineShape on the GeoCanvas.
Remarks
  • This method is used to draw a line on the GeoCanvas using the specified GeoPen.The DrawingLevel allows you to specify the level you will draw on when drawing multiple lines. This is very useful when you want to draw a road, for example. You can draw the black background on the lowest level, then draw a slightly thinner white line on a higher level. This will result in a great effect for a road.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoints
    • Type:IEnumerable<ScreenPointF>
    • Description:This parameter is the LineShape in well-known binary format.
  • linePen
    • Type:GeoPen
    • Description:This parameter describes the GeoPen that will be used to draw the LineShape.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the feature to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the feature to be drawn.

DrawEllipseCore(ScreenPointF,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • Draws a point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoint
    • Description:This parameter is the center point in well-known binary format.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen or GeoBrush will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the screenPoint to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the screenPoint to be drawn.
  • penBrushDrawingOrder
    • Description:This parameter determines the PenBrushDrawingOrder used when drawing the ellipse.

DrawScreenImageWithoutScalingCore(GeoImage,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw unscaled.
  • centerXInScreen
    • Type:Single
    • Description:The X coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • centerYInScreen
    • Type:Single
    • Description:The Y coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawScreenImageCore(GeoImage,Single,Single,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws a scaled image on the GeoCanvas.
Remarks
  • Drawing an image scaled is slower than using the API that draws it unscaled.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw.
  • centerXInScreen
    • Type:Single
    • Description:The X coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • centerYInScreen
    • Type:Single
    • Description:The Y coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • widthInScreen
    • Type:Single
    • Description:The width you want to scale the image to. This is the width of the image that will be drawn.
  • heightInScreen
    • Type:Single
    • Description:The height you want to scale the image to. This is the height of the image that will be drawn.
  • drawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawTextCore(String,GeoFont,GeoBrush,GeoPen,IEnumerable<ScreenPointF>,DrawingLevel,Single,Single,Single)

  • This method allows you to draw text at the specified location, using the specified brush and font parameters.
Remarks
  • This method is used to draw text on the GeoCanvas.The DrawingLevel allows you to specify the level you will draw on when drawing multiple text items. This is very useful when you want to draw a drop shadow, for example. You can draw the black backdrop on the lowest level with an offset, then draw the normal text on a higher level without an offset.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:This parameter specifies the text you wish to draw.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font you wish to use to draw the text.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter specifies the kind of fill you want to use to draw the text.
  • haloPen
    • Type:GeoPen
    • Description:This parameter specifies the HaloPen that will be used to draw the text, when the HaloPen effect is needed.
  • textPathInScreen
    • Type:IEnumerable<ScreenPointF>
    • Description:This parameter specifies the path on which to draw the text.
  • drawingLevel
    • Description:This parameter specifies the drawing level you wish to draw the text on. Higher levels overwrite lower levels.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the text to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the text to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the text to be drawn.

MeasureTextCore(String,GeoFont)

  • This method returns the rectangle that contains the specified text, when that text is drawn with the specified font.
Remarks
  • This method is typically used for labeling, to determine whether labels overlap.
Return Value
  • Description:This method returns the rectangle that contains the specified text, when that text is drawn with the specified font.
Parameters
  • text
    • Type:String
    • Description:This parameter represents the text you want to measure.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font of the text you want to measure.

BeginDrawingCore(Object,RectangleShape,GeographyUnit)

  • This method begins the act of drawing on the GeoCanvas.
Remarks
  • This is the first method that needs to be called before any drawing takes place. Calling this method will set the IsDrawing property to true. When you finish drawing, you must call EndDrawing to commit the changes to the image.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • nativeImage
    • Type:Object
    • Description:This parameter represents the image you want the GeoCanvas to draw on.
  • worldExtent
    • Description:This parameter is the world extent of the canvasImage.
  • drawingMapUnit
    • Description:This parameter is the map unit of the canvasImage.

ToNativeImageCore(GeoImage)

  • This method converts a GeoImage to a commonly-used object. In GdiPlus, this object is often a Bitmap.
Remarks
  • This method is a BaseClass API and will be used in its sub-concrete classes.
Return Value
  • Type:Object
  • Description:The returning object containing the same information as the passed-in geoImage.
Parameters
  • image
    • Type:GeoImage
    • Description:The target geoImage to convert.

ToGeoImageCore(Object)

  • This method converts an oboject to a GeoImage. In GdiPlus, this object is often a Bitmap.
Remarks
  • This method is a BaseClass API and will be implemented and used in its sub-concrete classes.
Return Value
  • Type:GeoImage
  • Description:The returning GeoImage containing the same information as the passed-in nativeImage.
Parameters
  • nativeImage
    • Type:Object
    • Description:The target object to be converted.

GetCanvasWidth(Object)

  • This method gets the canvas width of the passed-in native image object.
Remarks
  • This method is a BaseClass API and will be implemented and used in its sub-concrete classes.
Return Value
  • Type:Single
  • Description:The returning canvas width.
Parameters
  • nativeImage
    • Type:Object
    • Description:The native image that will be used to get the image width.

GetCanvasWidthCore(Object)

  • This method gets the canvas width of the passed-in native image object.
Remarks
  • This method is a BaseClass API and will be implemented and used in its sub-concrete classes.
Return Value
  • Type:Single
  • Description:The returning canvas width.
Parameters
  • nativeImage
    • Type:Object
    • Description:The native image that will be used to get the image width.

GetCanvasHeight(Object)

  • This method gets the canvas height of the passed-in native image object.
Remarks
  • This method is a BaseClass API and will be implemented and used in its sub-concrete classes.
Return Value
  • Type:Single
  • Description:The returning canvas height.
Parameters
  • nativeImage
    • Type:Object
    • Description:The native image that will be used to get the image height.

GetCanvasHeightCore(Object)

  • This method gets the canvas height of the passed-in native image object.
Remarks
  • This method is a BaseClass API and will be implemented and used in its sub-concrete classes.
Return Value
  • Type:Single
  • Description:The returning canvas height.
Parameters
  • nativeImage
    • Type:Object
    • Description:The native image will be used to get the image height.

DrawEvalWaterMarked(String)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • waterMarkedString
    • Type:String
    • Description:N/A

DrawFullWaterMarked(String)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • waterMarkedString
    • Type:String
    • Description:N/A

EndDrawingCore()

  • This method ends drawing and commits the drawing on the GeoCanvas.
Remarks
  • This methods should be called when you are finished drawing. It will commit the image changes to the image you passed in on BeginDrawing. It will also set IsDrawing to false. After you call this method it will put the GeoCanvas into an invalid state, so if you then call any drawing methods it will raise an exception.
Return Value
  • Type:Void
  • Description:N/A
Parameters

FlushCore()

  • This method flush drawing and commits the drawing on the GeoCanvas.
Remarks
  • This method should be called when you are finished drawing. It will commit the image changes to the image you passed in on BeginDrawing. It will also set IsDrawing to false. After you call this method it will put the GeoCanvas into an invalid state, so if you then call any drawing methods it will raise an exception.
Return Value
  • Type:Void
  • Description:N/A
Parameters

Finalize()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters

MemberwiseClone()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Object
  • Description:N/A
Parameters

Public Properties

ClippingArea

N/A

Remarks

N/A

Return Value

CurrentScale

This property gets the current scale of the canvas.

Remarks

N/A

Return Value
  • Type:Double

DrawingQuality

This property returns the drawing quality when rendering on the GeoCanvas.

Remarks

The DrawingQuality specifies whether BaseLineShapes, BasePointShapes, and BaseAreaShapes use anti-aliasing methods or other techniques that control the quality. In some cases you may want a higher quality rendering, and in other cases higher speed is more desirable. It is up to the implementer of the derived GeoCanvas class to control exactly what this setting means.

Return Value

MapUnit

This property returns the MapUnit passed in on the BeginDrawingAPI in the GeoCanvas.

Remarks

N/A

Return Value

Width

This property gets the width of the canvas.

Remarks

This property reflects the width of the canvas image that was passed in on BeginDrawing.

Return Value
  • Type:Single

Height

This property gets the height of the canvas.

Remarks

This property reflects the height of the canvas image that was passed in on BeginDrawing.

Return Value
  • Type:Single

CurrentWorldExtent

This property gets the adjusted current extent based on what was set when BeginDrawing was called.

Remarks

The extent that gets passed in on BeginDrawing is adjusted for the height and width of the physical media being drawn on. For example if the current extent is wider than taller but the bitmap being drawn on is square then the current extent needs to be adjusted. The extent will be adjusted larger so that we ensure that the entire original extent will still be represented.

Return Value

HasKeyColor

This property indicates whether a GeoCanvas has the KeyColor or not. If it has no KeyColor, it will throw an exception when you get or set the value of KeyColors property.

Remarks

The default value is false.

Return Value
  • Type:Boolean

KeyColors

Gets a value represents a collection of key colors. If HasKeyColor property is false, it will throw exception when you use KeyColors.

Remarks

It will make these colors transparent when draw image.

Return Value

NativeImage

The same reference to the parameter 'nativeImage' in BeginDrawing function.

Remarks

N/A

Return Value
  • Type:Object

IsDrawing

This property gets the drawing status of the GeoCanvas.

Remarks

This property is set to true when the BeginDrawing method is called, and false after the EndDrawing method is called.

Return Value
  • Type:Boolean

Dpi

The DPI value for the final drawing result, only valid when HasDpi set to true.

Remarks

N/A

Return Value
  • Type:Single

Protected Properties

HasDrawn

N/A

Remarks

N/A

Return Value
  • Type:Boolean

IsCancelled

N/A

Remarks

N/A

Return Value
  • Type:Boolean

Public Events

DrawingProgressChanged N/A

Remarks

N/A

Event Arguments:DrawingProgressChangedEventArgs

thinkgeo.mapsuite.core.geocanvas.txt · Last modified: 2017/03/16 21:59 (external edit)