LEADTOOLS WPF and Silverlight (Leadtools.Windows.Controls assembly)
LEAD Technologies, Inc

ConvertToSourceOptions Property (RasterImageBox)






Options to use when converting a LEADTOOLS Leadtools.RasterImage to a WPF/Silverlight System.Windows.Media.ImageSource. This is a dependency property. .NET support Silverlight support
Syntax
public ConvertToSourceOptions ConvertToSourceOptions {get; set;}
'Declaration
 
Public Property ConvertToSourceOptions As ConvertToSourceOptions
'Usage
 
Dim instance As RasterImageBox
Dim value As ConvertToSourceOptions
 
instance.ConvertToSourceOptions = value
 
value = instance.ConvertToSourceOptions
public ConvertToSourceOptions ConvertToSourceOptions {get; set;}
 get_ConvertToSourceOptions();
set_ConvertToSourceOptions(value);
public:
property ConvertToSourceOptions ConvertToSourceOptions {
   ConvertToSourceOptions get();
   void set (    ConvertToSourceOptions value);
}

Property Value

One or more Leadtools.Windows.Media.ConvertToSourceOptions enumeration members that specifies the options to use when this control must converts a LEADTOOLS Leadtools.RasterImage to a WPF/Silverlight System.Windows.Media.ImageSource. Default value is ConvertToSourceOptions.UseSetSource.
Remarks

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

In WPF/Silverlight, an image that is displayed must be an System.Windows.Media.ImageSource or one of its derived classes, the RasterImageBox control keeps the ImageBox.Source property synchronized with RasterImageBox.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 RasterImageBox 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.

Example

For XAML example, refer to RasterImageBox.

For C#/VB examples, refer to RasterImageBox.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

RasterImageBox Class
RasterImageBox Members

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.