←Select platform

Image Property

Summary

Gets or sets the Leadtools.RasterImage to be displayed in this control. This is a dependency property.

Syntax

C#
VB
C++
public RasterImage Image { get; set; } 
  
<TypeConverterAttribute("Leadtools.Codecs.RasterImageTypeConverter, Leadtools.Codecs, Version=19.0.4.0, Culture=neutral, PublicKeyToken=9cf889f53ea9b907")> 
Public Property Image As Leadtools.RasterImage 
[TypeConverterAttribute("Leadtools.Codecs.RasterImageTypeConverter, Leadtools.Codecs, Version=19.0.4.0, Culture=neutral, PublicKeyToken=9cf889f53ea9b907")] 
public: 
property Leadtools.RasterImage^ Image { 
   Leadtools.RasterImage^ get(); 
   void set (    Leadtools.RasterImage^ ); 
} 

Property Value

The LEADTOOLS Leadtools.RasterImage object to be displayed in this control. The default value is a null reference (Nothing in VB).

Remarks

When the value of the Image property changes to a valid image, the values of Source will contain the WPF/Silverlight equivalent image.

In WPF/Silverlight, an image that is displayed must be an System.Windows.Media.ImageSource or one of its derived classes, the RasterImageViewer control keeps the ImageViewer.Source property synchronized with RasterImageViewer.Image, any changes that occur to the LEADTOOLS Leadtools.RasterImage is reflected in the Source property and a standard System.Windows.FrameworkPropertyMetadata.AffectsMeasure or System.Windows.FrameworkPropertyMetadata.AffectsRender is performed. Also, this control will subscribe to the RasterImage.Changed to monitor any changes that may occur to the image (through image processing for example) and reflect these changes to the Source property.

If the Source property is changed, the RasterImageViewer must be informed so it can reflect the changes into the Image object. The UpdateImageFromSource can be used to perform this task.

The control uses the RasterImageConverter.ConvertToSource to convert the LEADTOOLS Leadtools.RasterImage to a WPF/Silverlight System.Windows.Media.ImageSource. The value of the ConvertToSourceOptions property is used as the options parameter to this method.

This control uses the LEADTOOLS Leadtools.Codecs.RasterImageTypeConverter when loading a Leadtools.RasterImage from a XAML file. Refer to that class for more information and examples.

You can show the current region of interest in this Leadtools.RasterImage object by setting the value of GeometryFrameType to GeometryFrameType.Fixed or GeometryFrameType.Animated. For more information, refer to GeometryFrameType.

Example

For XAML example, refer to RasterImageViewer.

For C#/VB examples, refer to RasterImageViewer.

Requirements

Target Platforms

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Windows.Controls Assembly