LEADTOOLS WPF and Silverlight (Leadtools.Windows.Controls assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.30
Geometry Property
See Also 
Leadtools.Windows.Controls Namespace > ImageViewer Class : Geometry Property



Gets or sets the geometry object to frame or animate on top of this ImageViewer or RasterImageViewer control.

Syntax

Visual Basic (Declaration) 
Public Property Geometry As Geometry
Visual Basic (Usage)Copy Code
Dim instance As ImageViewer
Dim value As Geometry
 
instance.Geometry = value
 
value = instance.Geometry
C# 
public Geometry Geometry {get; set;}
C++/CLI 
public:
property Geometry^ Geometry {
   Geometry^ get();
   void set (    Geometry^ value);
}

Property Value

A ImageViewer.Geometry object to frame or animate on top of this ImageViewer or RasterImageViewer control. Default value is null (Nothing in Visual Basic).

Example

For XAML example, refer to ImageViewer.GeometryFrameType.

For C#/VB examples, refer to ImageViewer.GeometryFrameType.

Remarks

The ImageViewer.Geometry property can be used to put any shape on top of this control and frame it to indicate the current region of interest area.

The coordinates of the ImageViewer.Geometry must be in image coordinates, and accordingly, the geometry will be zoomed in and out and scrolled depending on current viewer zoom value and scroll position.

The ImageViewer control does not create a geometry object by itself, however you can set the value of ImageViewer.Geometry to any System.Windows.Media.Geometry object or one of its derived classes (for example, a System.Windows.Media.PathGeometry) to simulate a region of interest. How the coordinates are calculated and what to do with this area is up to you since WPF/Silverlight System.Windows.Media.ImageSource and its derived classes do not use a region of interest.

The RasterImageViewer control is used to view a LEADTOOLS Leadtools.RasterImage object. This object has support for a region of interest that can be used to limit image processing effects to a certain area of the image of example. The Leadtools.RasterImage region is expressed with a Leadtools.RasterRegion object and you can use the RasterRegionConverter.ConvertToGeometry to convert the Leadtools.RasterRegion object to a WPF/Silverlight System.Windows.Media.Geometry object. When the region inside the Leadtools.RasterImage object being used with this RasterImageViewer is changed, the control will automatically creates a new System.Windows.Media.Geometry object and set in the ImageViewer.Geometry property.

In either cases, to draw the geometry of the viewer, you must set the value of the ImageViewer.GeometryFrameType property to GeometryFrameType.Fixed or GeometryFrameType.Animated. This value is set to GeometryFrameType.None by default which instructs the control to not draw the geometry.

Requirements

Target Platforms: Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also