ShapeCanvas Class

Canvas displaying shape elements on a map.

See the Shape Layer Concept topic for an example.

Inheritance Hierarchy

SystemObject
  System.Windows.ThreadingDispatcherObject
    System.WindowsDependencyObject
      System.Windows.MediaVisual
        System.WindowsUIElement
          System.WindowsFrameworkElement
            System.Windows.ControlsPanel
              System.Windows.ControlsCanvas
                Ptv.XServer.Controls.Map.CanvasesMapCanvas
                  Ptv.XServer.Controls.Map.CanvasesWorldCanvas
                    Ptv.XServer.Controls.Map.Layers.ShapesShapeCanvas

Namespace: Ptv.XServer.Controls.Map.Layers.Shapes
Assembly: Ptv.XServer.Controls.Map (in Ptv.XServer.Controls.Map.dll) Version: 1.7.10.0

Syntax

C++

Copy

public class ShapeCanvas : WorldCanvas

Public Class ShapeCanvas
	Inherits WorldCanvas

public ref class ShapeCanvas : public WorldCanvas

type ShapeCanvas =  
    class
        inherit WorldCanvas
    end

The ShapeCanvas type exposes the following members.

Constructors

	Name	Description
	ShapeCanvas	Initializes a new instance of the ShapeCanvas class

Top

Properties

	Name	Description
	CanvasCategory	Gets or sets the CanvasCategory of the canvas. The canvas category defines the z order of the canvas in the map. (Inherited from MapCanvas.)
	MapView	Gets the parent map instance. (Inherited from MapCanvas.)

Top

Methods

	Name	Description
	BeforeUpdate	Callback to precede the updating of the map content. (Inherited from WorldCanvas.)
	CanvasToGeo	Converts a canvas point to a geographic point. (Inherited from MapCanvas.)
	CanvasToPtvMercator	This method implements a transformation from canvas coordinates to logical coordinates. (Inherited from WorldCanvas.)
	Dispose	Disposes the map canvas. During disposal the children of the canvas are removed and the viewport changed events are disconnected. (Overrides MapCanvasDispose.)
	GeoToCanvas(Point)	Converts a geographic point to a canvas point. (Inherited from MapCanvas.)
	GeoToCanvas(Point, String)	Converts a geographic point to a canvas coordinate. (Inherited from MapCanvas.)
	GetAnchor	Retrieves the Anchor of a certain shape element.
	GetLocation	Retrieves the location of a certain shape element.
	GetScale	Retrieves the scale factor of a certain shape element.
	GetScaleFactor	Retrieves the scale factor of a certain shape element.
	InitializeTransform	Initializes the transformation instance which is needed to transform coordinates from one format to another one. (Inherited from WorldCanvas.)
	NeedsUpdate	Check if an update of a shape object is necessary, according to the lazy mode or update mode.
	PtvMercatorToCanvas	This method implements a transformation from logical coordinates to canvas coordinates. (Inherited from WorldCanvas.)
	ReceiveWeakEvent	Receives events from the centralized event manager. (Inherited from MapCanvas.)
	SetAnchor	Sets the anchor of a certain shape element.
	SetLocation	Sets the location of a certain shape element.
	SetScale	Sets the scale factor of a certain shape element.
	SetScaleFactor	Sets the scale factor of a certain shape element.
	Update	Updates the map content. The map content consists of all elements of the canvas. This method is for example triggered when the viewport changes. (Overrides MapCanvasUpdate(UpdateMode).)
	UpdateScale	Updates the scale of a certain shape element.
	UpdateScales	Updates the scale of a whole set of shape elements. All shape elements which are currently visible on the displayed map section are updated.

Top

Fields

	Name	Description
	AnchorProperty	Anchor of a shape element.
	LocationProperty	Location of a shape element.
	ScaleFactorProperty	The ScaleFactor element defines the dependency between map scale and the size of map objects. A scale factor of 0 indicates a constant object size. The size of the map object is the size in pixel, without regarding the zoom factor. A scale factor of 1 indicates an object size in coordinate units. The object will be enlarged if the map is zoomed. It is also possible to choose a value between 0 and 1. According to that value, a nonlinear enlargement will be used.
	ScaleProperty	The Scale element defines the dependency between map scale and the size of map objects. An LSF of 0 indicates a constant object size. The size of the map object is the size in pixel, without regarding the zoom factor. An LSF of 1 indicates an object size in units. The object will be enlarged if the map is zoomed. It’s also possible to choose a value between 0 and 1. According to that value, a nonlinear enlargement will be used.
	transform	Transformation method which transforms the shape points from one coordinate format to another depending on the given spatial reference system.

Top

Attached Properties

	Name	Description
	Anchor	Anchor of a shape element.
	Location	Location of a shape element.
	Scale	The Scale element defines the dependency between map scale and the size of map objects. An LSF of 0 indicates a constant object size. The size of the map object is the size in pixel, without regarding the zoom factor. An LSF of 1 indicates an object size in units. The object will be enlarged if the map is zoomed. It’s also possible to choose a value between 0 and 1. According to that value, a nonlinear enlargement will be used.
	ScaleFactor	The ScaleFactor element defines the dependency between map scale and the size of map objects. A scale factor of 0 indicates a constant object size. The size of the map object is the size in pixel, without regarding the zoom factor. A scale factor of 1 indicates an object size in coordinate units. The object will be enlarged if the map is zoomed. It is also possible to choose a value between 0 and 1. According to that value, a nonlinear enlargement will be used.

Top

Extension Methods

	Name	Description
	FindRelativeT	Finds an object of type T for a framework element which is somewhere in the visual tree. (Defined by MapElementExtensions.)
	ToJson	Converts an object to a JSON string representation. (Defined by JSONWriter.)

Top

Reference

Ptv.XServer.Controls.Map.Layers.Shapes Namespace