Represents a control that displays a LEADTOOLS Leadtools.RasterImage in WPF/Silverlight. Supported in Silverlight, Windows Phone 7

Object Model

Syntax

Visual Basic (Declaration)
Public Class RasterImageBox Inherits ImageBox Implements ISupportInitialize, IFrameworkInputElement, IInputElement, IAddChild, IAnimatable

Visual Basic (Usage)	Copy Code
Dim instance As RasterImageBox

C#
public class RasterImageBox : ImageBox, ISupportInitialize, IFrameworkInputElement, IInputElement, IAddChild, IAnimatable

C++/CLI
public ref class RasterImageBox : public ImageBox, ISupportInitialize, IFrameworkInputElement, IInputElement, IAddChild, IAnimatable

Example

Visual Basic	Copy Code
Private Class MyWindow1 : Inherits Window Private theViewer As RasterImageBox Public Sub New() ' Create the viewer theViewer = New RasterImageBox() ' Create Dock Panel Dim panel As DockPanel = New DockPanel() Content = panel DockPanel.SetDock(theViewer, Dock.Bottom) theViewer.HorizontalAlignment = HorizontalAlignment.Center theViewer.VerticalAlignment = VerticalAlignment.Bottom theViewer.UseDpi = True panel.Children.Add(theViewer) ' Load an image into the viewer Using codecs As RasterCodecs = New RasterCodecs() theViewer.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"), 1, CodecsLoadByteOrder.Bgr, 1, 1) End Using Dim flip As FlipCommand = New FlipCommand() flip.Run(theViewer.Image) Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode) AddHandler theViewer.MouseDown, AddressOf theViewer_MouseClick End Sub Private Sub theViewer_MouseClick(ByVal sender As Object, ByVal e As MouseButtonEventArgs) Select Case theViewer.SizeMode Case SizeMode.Normal theViewer.SizeMode = SizeMode.Stretch Case SizeMode.Stretch theViewer.SizeMode = SizeMode.Fit Case SizeMode.Fit theViewer.SizeMode = SizeMode.FitAlways Case SizeMode.FitAlways theViewer.SizeMode = SizeMode.FitWidth Case SizeMode.FitWidth theViewer.SizeMode = SizeMode.Normal End Select Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode) End Sub End Class Public NotInheritable Class LEAD_VARS Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" End Class

Visual Basic

Copy Code

Private Class MyWindow1 : Inherits Window
      Private theViewer As RasterImageBox
      Public Sub New()
         ' Create the  viewer
         theViewer = New RasterImageBox()

         ' Create Dock Panel

         Dim panel As DockPanel = New DockPanel()
         Content = panel

         DockPanel.SetDock(theViewer, Dock.Bottom)

         theViewer.HorizontalAlignment = HorizontalAlignment.Center
         theViewer.VerticalAlignment = VerticalAlignment.Bottom
         theViewer.UseDpi = True

         panel.Children.Add(theViewer)

         ' Load an image into the viewer

         Using codecs As RasterCodecs = New RasterCodecs()
            theViewer.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"), 1, CodecsLoadByteOrder.Bgr, 1, 1)
         End Using

         Dim flip As FlipCommand = New FlipCommand()
         flip.Run(theViewer.Image)

         Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode)

         AddHandler theViewer.MouseDown, AddressOf theViewer_MouseClick
      End Sub

      Private Sub theViewer_MouseClick(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
         Select Case theViewer.SizeMode
            Case SizeMode.Normal
               theViewer.SizeMode = SizeMode.Stretch

            Case SizeMode.Stretch
               theViewer.SizeMode = SizeMode.Fit

            Case SizeMode.Fit
               theViewer.SizeMode = SizeMode.FitAlways

            Case SizeMode.FitAlways
               theViewer.SizeMode = SizeMode.FitWidth

            Case SizeMode.FitWidth
               theViewer.SizeMode = SizeMode.Normal
         End Select

         Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode)

      End Sub
   End Class

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

C#	Copy Code
class MyWindow1 : Window { RasterImageBox theViewer; public MyWindow1() { // Create the viewer theViewer = new RasterImageBox(); // Create Dock Panel DockPanel panel = new DockPanel(); Content = panel; DockPanel.SetDock(theViewer, Dock.Bottom); theViewer.HorizontalAlignment = HorizontalAlignment.Center; theViewer.VerticalAlignment = VerticalAlignment.Bottom; theViewer.UseDpi = true; panel.Children.Add(theViewer); // Load an image into the viewer using (RasterCodecs codecs = new RasterCodecs()) { theViewer.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"), 1, Leadtools.Codecs.CodecsLoadByteOrder.Bgr, 1, 1); } FlipCommand flip = new FlipCommand(); flip.Run(theViewer.Image); Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode); theViewer.MouseDown += new MouseButtonEventHandler(theViewer_MouseClick); } void theViewer_MouseClick(object sender, MouseButtonEventArgs e) { switch (theViewer.SizeMode) { case SizeMode.Normal: theViewer.SizeMode = SizeMode.Stretch; break; case SizeMode.Stretch: theViewer.SizeMode = SizeMode.Fit; break; case SizeMode.Fit: theViewer.SizeMode = SizeMode.FitAlways; break; case SizeMode.FitAlways: theViewer.SizeMode = SizeMode.FitWidth; break; case SizeMode.FitWidth: theViewer.SizeMode = SizeMode.Normal; break; } Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode); } } static class LEAD_VARS { public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; }

Copy Code

class MyWindow1 : Window
   {
      RasterImageBox theViewer;
      public MyWindow1()
      {
         // Create the  viewer
         theViewer = new RasterImageBox();

         // Create Dock Panel

         DockPanel panel = new DockPanel();
         Content = panel;

         DockPanel.SetDock(theViewer, Dock.Bottom);

         theViewer.HorizontalAlignment = HorizontalAlignment.Center;
         theViewer.VerticalAlignment = VerticalAlignment.Bottom;
         theViewer.UseDpi = true;

         panel.Children.Add(theViewer);

         // Load an image into the viewer

         using (RasterCodecs codecs = new RasterCodecs())
         {
            theViewer.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"), 1, Leadtools.Codecs.CodecsLoadByteOrder.Bgr, 1, 1);
         }

         FlipCommand flip = new FlipCommand();
         flip.Run(theViewer.Image);

         Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode);

         theViewer.MouseDown += new MouseButtonEventHandler(theViewer_MouseClick);
      }

      void theViewer_MouseClick(object sender, MouseButtonEventArgs e)
      {
         switch (theViewer.SizeMode)
         {
            case SizeMode.Normal:
               theViewer.SizeMode = SizeMode.Stretch;
               break;

            case SizeMode.Stretch:
               theViewer.SizeMode = SizeMode.Fit;
               break;

            case SizeMode.Fit:
               theViewer.SizeMode = SizeMode.FitAlways;
               break;

            case SizeMode.FitAlways:
               theViewer.SizeMode = SizeMode.FitWidth;
               break;

            case SizeMode.FitWidth:
               theViewer.SizeMode = SizeMode.Normal;
               break;
         }

         Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode);

      }
   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

SilverlightCSharp	Copy Code
class MyWindow1 : ChildWindow { RasterImageBox theViewer; public MyWindow1() { // Create the viewer theViewer = new RasterImageBox(); // Create Dock Panel StackPanel panel = new StackPanel(); Content = panel; theViewer.HorizontalAlignment = HorizontalAlignment.Center; theViewer.VerticalAlignment = VerticalAlignment.Bottom; theViewer.UseDpi = true; panel.Children.Add(theViewer); // Load an image into the viewer RasterCodecs codecs = new RasterCodecs(); theViewer.Image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp", 1, Leadtools.Codecs.CodecsLoadByteOrder.Bgr, 1, 1); FlipCommand flip = new FlipCommand(); flip.Run(theViewer.Image); Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode); theViewer.MouseLeftButtonDown += new MouseButtonEventHandler(theViewer_MouseLeftButtonDown); } void theViewer_MouseLeftButtonDown(object sender, MouseButtonEventArgs e) { switch (theViewer.SizeMode) { case SizeMode.Normal: theViewer.SizeMode = SizeMode.Stretch; break; case SizeMode.Stretch: theViewer.SizeMode = SizeMode.Fit; break; case SizeMode.Fit: theViewer.SizeMode = SizeMode.FitAlways; break; case SizeMode.FitAlways: theViewer.SizeMode = SizeMode.FitWidth; break; case SizeMode.FitWidth: theViewer.SizeMode = SizeMode.Normal; break; } Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode); } }

SilverlightCSharp

Copy Code

class MyWindow1 : ChildWindow
{
   RasterImageBox theViewer;
   public MyWindow1()
   {
      // Create the  viewer
      theViewer = new RasterImageBox();

      // Create Dock Panel

      StackPanel panel = new StackPanel();
      Content = panel;

      theViewer.HorizontalAlignment = HorizontalAlignment.Center;
      theViewer.VerticalAlignment = VerticalAlignment.Bottom;
      theViewer.UseDpi = true;

      panel.Children.Add(theViewer);

      // Load an image into the viewer

      RasterCodecs codecs = new RasterCodecs();
      theViewer.Image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp", 1, Leadtools.Codecs.CodecsLoadByteOrder.Bgr, 1, 1);

      FlipCommand flip = new FlipCommand();
      flip.Run(theViewer.Image);

      Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode);

      theViewer.MouseLeftButtonDown += new MouseButtonEventHandler(theViewer_MouseLeftButtonDown);
   }

   void theViewer_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
   {
      switch (theViewer.SizeMode)
      {
         case SizeMode.Normal:
            theViewer.SizeMode = SizeMode.Stretch;
            break;

         case SizeMode.Stretch:
            theViewer.SizeMode = SizeMode.Fit;
            break;

         case SizeMode.Fit:
            theViewer.SizeMode = SizeMode.FitAlways;
            break;

         case SizeMode.FitAlways:
            theViewer.SizeMode = SizeMode.FitWidth;
            break;

         case SizeMode.FitWidth:
            theViewer.SizeMode = SizeMode.Normal;
            break;
      }

      Title = string.Format("Size mode = {0}, double click to change", theViewer.SizeMode);
   }
}

SilverlightVB	Copy Code
Private Class MyWindow1 : Inherits ChildWindow Private theViewer As RasterImageBox Public Sub New() ' Create the viewer theViewer = New RasterImageBox() ' Create Dock Panel Dim panel As StackPanel = New StackPanel() Content = panel theViewer.HorizontalAlignment = HorizontalAlignment.Center theViewer.VerticalAlignment = VerticalAlignment.Bottom theViewer.UseDpi = True panel.Children.Add(theViewer) ' Load an image into the viewer Dim codecs As RasterCodecs = New RasterCodecs() theViewer.Image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path & "Image1.cmp", 1, CodecsLoadByteOrder.Bgr, 1, 1) Dim flip As FlipCommand = New FlipCommand() flip.Run(theViewer.Image) Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode) AddHandler theViewer.MouseLeftButtonDown, AddressOf theViewer_MouseLeftButtonDown End Sub Private Sub theViewer_MouseLeftButtonDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs) Select Case theViewer.SizeMode Case SizeMode.Normal theViewer.SizeMode = SizeMode.Stretch Case SizeMode.Stretch theViewer.SizeMode = SizeMode.Fit Case SizeMode.Fit theViewer.SizeMode = SizeMode.FitAlways Case SizeMode.FitAlways theViewer.SizeMode = SizeMode.FitWidth Case SizeMode.FitWidth theViewer.SizeMode = SizeMode.Normal End Select Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode) End Sub End Class

SilverlightVB

Copy Code

Private Class MyWindow1 : Inherits ChildWindow
   Private theViewer As RasterImageBox
   Public Sub New()
      ' Create the  viewer
      theViewer = New RasterImageBox()

      ' Create Dock Panel

      Dim panel As StackPanel = New StackPanel()
      Content = panel

      theViewer.HorizontalAlignment = HorizontalAlignment.Center
      theViewer.VerticalAlignment = VerticalAlignment.Bottom
      theViewer.UseDpi = True

      panel.Children.Add(theViewer)

      ' Load an image into the viewer

      Dim codecs As RasterCodecs = New RasterCodecs()
      theViewer.Image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path & "Image1.cmp", 1, CodecsLoadByteOrder.Bgr, 1, 1)

      Dim flip As FlipCommand = New FlipCommand()
      flip.Run(theViewer.Image)

      Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode)

      AddHandler theViewer.MouseLeftButtonDown, AddressOf theViewer_MouseLeftButtonDown
   End Sub

   Private Sub theViewer_MouseLeftButtonDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
      Select Case theViewer.SizeMode
         Case SizeMode.Normal
            theViewer.SizeMode = SizeMode.Stretch

         Case SizeMode.Stretch
            theViewer.SizeMode = SizeMode.Fit

         Case SizeMode.Fit
            theViewer.SizeMode = SizeMode.FitAlways

         Case SizeMode.FitAlways
            theViewer.SizeMode = SizeMode.FitWidth

         Case SizeMode.FitWidth
            theViewer.SizeMode = SizeMode.Normal
      End Select

      Title = String.Format("Size mode = {0}, double click to change", theViewer.SizeMode)
   End Sub
End Class

XAML	Copy Code
<Window x:Class="WPFSamples.RasterImageBox" Height="600" Width="800" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:Leadtools_Windows_Controls="clr-namespace:Leadtools.Windows.Controls;assembly=Leadtools.Windows.Controls"> <DockPanel> <Leadtools_Windows_Controls:RasterImageBox Name="theImage" Image="file:///c:\users\Public\Documents\LEADTOOLS Images\Image1.cmp" DockPanel.Dock="Bottom" HorizontalAlignment="Center" VerticalAlignment="Bottom" UseDpi="false" /> </DockPanel> <Window.Title> "RasterImageBox" </Window.Title> </Window>

XAML

Copy Code

<Window x:Class="WPFSamples.RasterImageBox" Height="600" Width="800" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:Leadtools_Windows_Controls="clr-namespace:Leadtools.Windows.Controls;assembly=Leadtools.Windows.Controls">
  <DockPanel>
    <Leadtools_Windows_Controls:RasterImageBox Name="theImage" Image="file:///c:\users\Public\Documents\LEADTOOLS Images\Image1.cmp" DockPanel.Dock="Bottom" HorizontalAlignment="Center" VerticalAlignment="Bottom" UseDpi="false" />
  </DockPanel>
  <Window.Title>
        "RasterImageBox"
      </Window.Title>
</Window>

Remarks

The RasterImageBox class derives from ImageBox and adds functionality to display a LEADTOOLS Leadtools.RasterImage object in WPF/Silverlight applications. To display a System.Windows.Media.ImageSource or one of its derived classes, use the ImageBox control.

In addition to all the features supported by the ImageBox class, RasterImageBox adds the following:

Viewing a LEADTOOLS Leadtools.RasterImage object in WPF/Silverlight applications using the Image property.
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.

Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
      System.Windows.DependencyObject
         System.Windows.Media.Visual
            System.Windows.UIElement
               System.Windows.FrameworkElement
                  System.Windows.Controls.Panel
                     Leadtools.Windows.Controls.ImageBox
                        Leadtools.Windows.Controls.RasterImageBox

Requirements

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

LEADTOOLS WPF and Silverlight (Leadtools.Windows.Controls assembly)	Send comments on this topic. \| Back to Introduction - All Topics \| Help Version 17.0.3.30
RasterImageBox Class
See Also Members

Object Model

Syntax

Example

Remarks

Inheritance Hierarchy

Requirements

See Also

Reference